在操作中添加担保品

此端点集合允许添加与操作关联的担保品。担保品（collateral）将与操作文件一同提交签名。每种担保品类型都有其所需文件的规则，所有担保品类型均在本文档中涵盖。

---

提交担保品 (POST)

Request

ENDPOINT

/commercial_paper/operation/OPERATION-KEY/collateral

MÉTODO

POST

Path Params

字段	类型	描述	最大字符数
OPERATION-KEY *	string	操作的唯一键（UUID v4）。	36

---

担保品系统支持添加不同类型的工具，每种类型都有其附加文件的配置。本节涵盖所有可用的担保品模型及其相应的 payload。

担保品类型

1 - 不动产信托转让

2 - 车辆信托转让

3 - 航空器信托转让

4 - 设备/产品/库存信托转让

5 - 艺术品信托转让

6 - 有价证券信托转让

7 - 股份和份额信托转让

8 - 信贷权信托转让

9 - 不动产抵押

10 - 船舶抵押

11 - 保证人

12 - 担保人

13 - 银行保函

14 - 信用卡应收款

15 - 库存担保

16 - 担保品监控

17 - 其他担保品

不动产信托转让

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "fiduciary_alienation_property",
    "additional_documents": [
        {
            "document_type": "property_appraisal_report",
            "document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff"
        },
        {
            "document_type": "property_registration_updated",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        },
        {
            "document_type": "property_full_content_certificate",
            "document_key": "210c38b5-6b61-4b74-b042-19ebef77e360"
        },
        {
            "document_type": "property_insurance_policy",
            "document_key": "4cc6d706-551f-4d5e-8539-1b59b2f96cff"
        }
    ]
}

文件类型

枚举值	描述
property_appraisal_report**	不动产评估报告。
property_registration_updated**	最新产权登记。
property_full_content_certificate**	产权完整内容证明。
property_insurance_policy	保险单（合同规定时要求）。
others	其他文件。

注意

(**) 不动产信托转让必须提供

车辆信托转让

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "fiduciary_alienation_vehicle",
    "additional_documents": [
        {
            "document_type": "vehicle_appraisal_report",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        },
        {
            "document_type": "vehicle_inspection_report",
            "document_key": "210c38b5-6b61-4b74-b042-19ebef77e360"
        },
        {
            "document_type": "vehicle_crv_certificate",
            "document_key": "4cc6d706-551f-4d5e-8539-1b59b2f96cff"
        }
    ]
}

文件类型

枚举值	描述
vehicle_appraisal_report**	车辆评估报告（最多延迟30天）或 FIPE 表。
vehicle_inspection_report**	车辆检验报告。
vehicle_crv_certificate**	最新车辆登记证书（CRLV）。
others	其他文件。

注意

(**) 车辆信托转让必须提供

航空器信托转让

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "fiduciary_alienation_aircraft",
    "additional_documents": [
        {
            "document_type": "aircraft_certificate_anac",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        },
        {
            "document_type": "aircraft_rab_consult",
            "document_key": "210c38b5-6b61-4b74-b042-19ebef77e360"
        },
        {
            "document_type": "aircraft_insurance_policy",
            "document_key": "4cc6d706-551f-4d5e-8539-1b59b2f96cff"
        },
        {
            "document_type": "aircraft_appraisal_report",
            "document_key": "df608f78-5293-4f96-ab60-31185633b52c"
        }
    ]
}

文件类型

枚举值	描述
aircraft_certificate_anac**	登记证书 - ANAC。
aircraft_rab_consult**	巴西航空登记册中的航空器查询。
aircraft_insurance_policy**	保险单 - 受益人为基金。
aircraft_appraisal_report**	航空器评估报告。
others	其他文件。

注意

(**) 航空器信托转让必须提供

设备产品和库存信托转让

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "fiduciary_alienation_equipment",
    "additional_documents": [
        {
            "document_type": "equipment_purchase_invoice",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        },
        {
            "document_type": "fiduciary_depositary_declaration",
            "document_key": "210c38b5-6b61-4b74-b042-19ebef77e360"
        },
        {
            "document_type": "equipment_appraisal_report",
            "document_key": "4cc6d706-551f-4d5e-8539-1b59b2f96cff"
        },
        {
            "document_type": "equipment_insurance_policy",
            "document_key": "df608f78-5293-4f96-ab60-31185633b52c"
        }
    ]
}

文件类型

枚举值	描述
equipment_purchase_invoice**	发票 - 购买记录。
equipment_appraisal_report**	设备评估报告（最多延迟30天）。
equipment_insurance_policy	设备保险单（合同规定时要求）。
fiduciary_depositary_declaration	忠实保管人声明。
others	其他文件。

注意

(**) 设备/产品/库存信托转让必须提供

艺术品信托转让

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "fiduciary_alienation_artwork",
    "additional_documents": [
        {
            "document_type": "artwork_appraisal_report",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        },
        {
            "document_type": "artwork_storage_certificate",
            "document_key": "210c38b5-6b61-4b74-b042-19ebef77e360"
        }
    ]
}

文件类型

枚举值	描述
artwork_appraisal_report**	艺术品评估报告。
artwork_storage_certificate**	带合规证书的存储地点。
artwork_insurance_policy	保险单（合同规定时要求）。
others	其他文件。

注意

(**) 艺术品信托转让必须提供

有价证券信托转让

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "fiduciary_alienation_securities",
    "additional_documents": [
        {
            "document_type": "securities_negotiation_block",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        }
    ]
}

文件类型

枚举值	描述
securities_negotiation_block**	在托管方处的交易冻结。
securities_registration_gravame	带合规证书的存储地点。
others	其他文件。

注意

(**) 有价证券信托转让必须提供

股份和份额信托转让

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "fiduciary_assignment_shares",
    "additional_documents": [
        {
            "document_type": "share_registration_book",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        }
    ]
}

文件类型

枚举值	描述
share_registration_book**	带质押注记的记名股份登记簿。
others	其他文件。

注意

(**) 股份/份额信托转让/质押必须提供

信贷权信托转让

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "fiduciary_assignment_shares"
}

文件类型

枚举值	描述
others	其他文件。

不动产抵押

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "mortgage_property",
    "additional_documents": [
        {
            "document_type": "property_appraisal_report",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        },
        {
            "document_type": "property_registration",
            "document_key": "210c38b5-6b61-4b74-b042-19ebef77e360"
        },
        {
            "document_type": "property_insurance_policy",
            "document_key": "4cc6d706-551f-4d5e-8539-1b59b2f96cff"
        },
        {
            "document_type": "property_full_content_certificate",
            "document_key": "df608f78-5293-4f96-ab60-31185633b52c"
        }
    ]
}

文件类型

枚举值	描述
property_appraisal_report**	不动产评估报告。
property_registration**	最新产权登记。
property_full_content_certificate**	产权完整内容证明。
property_insurance_policy	保险单（合同规定时要求）。
others	其他文件。

注意

(**) 不动产抵押必须提供

船舶抵押

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "mortgage_ship",
    "additional_documents": [
        {
            "document_type": "ship_registration",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        },
        {
            "document_type": "ship_appraisal_report",
            "document_key": "210c38b5-6b61-4b74-b042-19ebef77e360"
        },
        {
            "document_type": "ship_insurance_policy",
            "document_key": "4cc6d706-551f-4d5e-8539-1b59b2f96cff"
        }
    ]
}

文件类型

枚举值	描述
ship_registration**	最新船舶产权登记。
ship_appraisal_report**	船舶评估报告（最多延迟3个月）。
ship_insurance_policy	船舶保险单（合同规定时要求）。
others	其他文件。

注意

(**) 船舶抵押必须提供

保证人

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "guarantor",
    "additional_documents": [
        {
            "document_type": "guarantor_civil_status_declaration",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        },
        {
            "document_type": "guarantor_personal_document",
            "document_key": "210c38b5-6b61-4b74-b042-19ebef77e360"
        }
    ]
}

文件类型

枚举值	描述
guarantor_civil_status_declaration**	保证人婚姻状况声明。
guarantor_personal_document**	保证人个人证件。
guarantor_income_tax_declaration	保证人所得税申报表。
others	其他文件。

注意

(**) 保证人必须提供

担保人

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "surety",
    "additional_documents": [
        {
            "document_type": "surety_civil_status_declaration",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        },
        {
            "document_type": "surety_personal_document",
            "document_key": "210c38b5-6b61-4b74-b042-19ebef77e360"
        },
        {
            "document_type": "surety_income_tax_declaration",
            "document_key": "4cc6d706-551f-4d5e-8539-1b59b2f96cff"
        }
    ]
}

文件类型

枚举值	描述
surety_civil_status_declaration**	担保人婚姻状况声明。
surety_personal_document**	担保人个人证件。
surety_income_tax_declaration	担保人所得税申报表。
others	其他文件。

注意

(**) 担保人必须提供

银行保函

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "bank_surety",
    "additional_documents": [
        {
            "document_type": "others",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        }
    ]
}

文件类型

枚举值	描述
others	其他文件。

信用卡应收款

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "card_receivables",
    "additional_documents": [
        {
            "document_type": "others",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        }
    ]
}

文件类型

枚举值	描述
others	其他文件。

库存担保

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "stock_guarantee",
    "additional_documents": [
        {
            "document_type": "others",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        }
    ]
}

文件类型

枚举值	描述
others	其他文件。

担保品监控

Request Body

{
    "collateral_document_key": "a14e8b2c-bda7-4f3d-aebb-ae63822428ff",
    "collateral_type": "monitoring_guarantee",
    "additional_documents": [
        {
            "document_type": "guarantee_contract",
            "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04"
        },
        {
            "document_type": "guarantee_agent_contract",
            "document_key": "210c38b5-6b61-4b74-b042-19ebef77e360"
        }
    ]
}

文件类型

枚举值	描述
guarantee_contract**	担保合同。
guarantee_agent_contract**	担保代理合同。
others	其他文件。

注意

(**) 担保品监控必须提供

---

Request Body Params

字段	类型	描述	必填
collateral_document_key *	string	担保工具的键。	是
collateral_type *	string	担保品类型。	collateral_type 枚举
collateral_data	object	与担保品相关的元数据结构。	是
additional_documents	list	与担保品相关的文件。	-

additional_documents 列表

字段	类型	描述	必填
document_key *	string	担保工具的键。	是
document_type *	string	担保品文件类型。	是

collateral_type 枚举

枚举值	描述
fiduciary_alienation_property	不动产信托转让。
fiduciary_alienation_vehicle	车辆信托转让。
fiduciary_alienation_aircraft	航空器信托转让。
fiduciary_alienation_equipment	设备/产品/库存信托转让。
fiduciary_alienation_artwork	艺术品信托转让。
fiduciary_alienation_securities	有价证券信托转让。
fiduciary_assignment_shares	股份/份额信托转让/质押。
fiduciary_assignment_credit_rights	信贷权信托转让。
mortgage_property	不动产抵押。
mortgage_ship	船舶抵押。
guarantor	保证人。
surety	担保人。
bank_surety	银行保函。
card_receivables	信用卡应收款。
stock_guarantee	库存担保。
monitoring_guarantee	担保品监控。
others	其他担保品。