发行 - 认缴

认缴

使用以下端点，可以对某次发行发起认缴。

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",
 "pricing_type": "yield_curve",
 "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	登记机构（escriturador）的 CNPJ	是*
`security_key`	string	资产的内部 key	是*
`unit_price`	number	认缴时的单价	是
`number_of_units`	number	买入的单位数量	是
`external_id`	string	买入交易的外部标识	是
`integralization_date`	string	认缴日期	是
`pricing_type`	string	资产在投资组合中的定价方式：`yield_curve` 或 `mark_to_market`。	是
`payment`	dict	用于结算的付款对象	是

重要 ( * )

结构化资产可以通过两种方式识别：

提供 security_key 字段 （内部 key）；或
同时提供 security_external_id 和 bookkeeper_document_number 两个字段。

请求体中必须至少包含一种识别方式。如两者都提供，以内部 key 为准。

付款

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

银行账户

字段	类型	描述	必填
`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"
}

错误

状态码	代码	触发条件
400	`QIT000001`	请求体无效：校验失败的字段见 `description`。

认证、权限和主机相关错误：参见 API 错误。

认缴​

Request​

定义​

买入交易​

付款​

银行账户​

Response​

错误​

认缴

Request

定义

买入交易

付款

银行账户

Response

错误