发行 - 整合认购

---

整合认购

使用以下端点，可以开始对某一发行进行整合认购。

Request

ENDPOINT

/trade_security/fund_class/FUND_CLASS_KEY/integralization

MÉTODO

POST

Request Body

{
 "security_external_id": "a23c006c-befd-40e0-bc3d-fbd2dfbbea5d",
 "bookkeeper_document_number": "00.000.000/0000-00",
 "security_key": "272a394a-e3d0-4484-b00e-e18a4e22bb5e",
 "unit_price": "2.00",
 "number_of_units": "100.00",
 "external_id": "90b679c0-2674-4cad-917a-5c786b0bf992",
 "integralization_date": "2025-05-27",
 "payment": {
   "target_account": {
    "account_branch": "0001",
    "account_digit": "0",
    "account_number": "12345",
    "financial_institution_code": "329",
    "financial_institution_ispb": "32402502"
   }
  }
}

定义

买入操作

字段	类型	描述	必填
security_external_id	string	资产的外部标识	是*
bookkeeper_document_number	string	记账员的 CNPJ 编号	是*
security_key	string	资产的内部标识键	是*
unit_price	float	整合认购时的单价	是
number_of_units	float	购买的单位数量	是
external_id	string	买入操作的外部标识	是
integralization_date	string	整合认购日期	是
payment	dict	用于清算的付款对象	是

⚠️ 重要 ( * )

结构化资产的标识可通过以下两种方式之一进行：

1. 提供 security_key 字段**(内部标识键)**；或
2. 同时提供 security_external_id 和 bookkeeper_document_number 字段。

请求体中必须存在至少一种标识方式。若两者均存在，将优先使用内部标识键。

付款

字段	类型	描述	必填
target_account	string	用于清算的银行账户对象	是

银行账户

字段	类型	描述	必填
account_branch	string	银行账户支行	是
account_digit	string	账户校验位	是
account_number	string	银行账户号码	是
financial_institution_code	string	金融机构代码	是
financial_institution_ispb	string	金融机构 ISPB 代码	是

Response

STATUS

201

Response Body

{
 "integralization_key": "1568b67b-088e-43be-938b-0f817b805f7a",
 "external_id": "90b679c0-2674-4cad-917a-5c786b0bf992",
 "status": "pending_administrator_approval",
}