插入回购资产

用于在替换批次中插入将由转让方回购的基金投资组合资产的端点。被回购资产的金额会从同一批次中新资产的转让付款中扣除。

适用范围

角色	主机	所需权限
管理人	`manager-api`	写入
顾问	`consultant-api`	Batches

各主机的 Base URL：环境（主机）。

替换批次

该端点只接受在回购类转让配置（assignment_configuration_type = repurchase_configuration）下创建的批次。批次必须处于 pending_assets_insertion。在批次开放期间，回购资产和新资产可以按任意顺序插入。

如需结束插入，批次中必须至少有一个回购资产，且新资产的金额不得低于被回购资产的金额——参见结束资产插入。

我在流程中的哪一步？

在此之前，您应已创建批次。还需插入将替换被回购资产的新资产。

Request

ENDPOINT

/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}/repurchased_asset

MÉTODO

POST

Request Body
{
    "asset_type": "duplicata_mercantil",
    "external_id": "88c2304e-8eb3-44e0-acb4-25811ae20cf1",
    "assignor_document_number": "11.222.333/0001-81",
    "repurchase_value": 1000.00,
    "settlement_type": "asset_settlement"
}

请求体属性

字段	类型	是否必填	描述
`asset_type`	string	必填	将被回购资产的类型（例如：`ccb`、`duplicata_mercantil`、`discounted_contract`）。
`external_id`	string	必填	该资产最初转让给基金时使用的 `external_id`。1 到 50 个字符。
`assignor_document_number`	string	必填	将该资产转让给基金的转让方的 CPF 或 CNPJ，带标点。
`settlement_type`	string	必填	回购方式。见下表。
`repurchase_value`	number	可选	回购金额，以雷亚尔为单位。最小值 `0.01`。省略时取该资产在基金投资组合中的当前公允价值。

settlement_type 的值：

值	描述
`asset_settlement`	资产全额回购。
`asset_amortization`	资产部分回购（摊销）。

Response

STATUS

201

Response Body（assignment 已简化）
{
    "repurchased_asset_key": "a6115a17-8b4d-49a3-aed6-47c9574eab88",
    "asset_type": "duplicata_mercantil",
    "asset_key": "65bbce6d-e0b4-4471-a702-e0ced4542e5b",
    "external_id": "88c2304e-8eb3-44e0-acb4-25811ae20cf1",
    "assignor": {
        "assignor_key": "c1d2e3f4-a5b6-4890-abcd-ef1234567890",
        "document_number": "11.222.333/0001-81",
        "name": "Cedente Exemplo Ltda"
    },
    "status": "pending_assignment_validation",
    "assignment": {
        "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
        "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
        "name": "CESSÃO #12345",
        "assignment_number": "12345",
        "assignment_date": "2024-04-01",
        "status": "pending_assets_insertion",
        "origin_type": "client"
    },
    "repurchase_value": 1000.00,
    "contract_number": "000123",
    "maturity_date": "2024-09-30"
}

响应属性

字段	类型	描述
`repurchased_asset_key`	string	QI Tech 生成的回购唯一标识（UUID）。
`asset_type`	string	被回购资产的类型。
`asset_key`	string	该资产在基金投资组合中的标识（UUID）。
`external_id`	string	资产的 `external_id`，与请求中提供的一致。
`assignor`	object	转让该资产的转让方：`assignor_key`、`document_number` 和 `name`。
`status`	string	回购状态。见下表。
`assignment`	object	替换批次，结构与获取批次相同，不含 `status_events`。
`repurchase_value`	number	回购金额，以雷亚尔为单位。
`contract_number`	string	被回购资产的合同编号（如有）。
`maturity_date`	string	被回购资产的到期日，格式为 `YYYY-MM-DD`。

回购状态：

状态	描述
`pending_assignment_validation`	回购已登记，等待批次继续流程。
`sending_to_wallet`	回购正在基金投资组合中清算。
`completed`	回购已完成。
`discarded`	回购随批次一起被废弃。

错误

状态码	代码	触发条件
400	`TRC000088`	批次的转让配置不是回购配置。
400	`TRC000089`	批次不处于 `pending_assets_insertion`。
400	`TRC000090`	在基金投资组合中未找到该转让方、类型和 `external_id` 对应的资产，或该资产不能被回购。
404	`TRC000005`	没有使用该 `assignor_document_number` 的转让方。
404	`TRC000012`	`asset_type` 不存在。
404	`TRC000018`	该转让配置中没有使用此 `external_id` 的批次。

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

后续步骤

插入新资产——添加将替换被回购资产的资产。
提交文件——为每项新资产提交所需文件。
结束插入——表明所有资产均已插入，以便批次进入合格性审查。

Request​

请求体属性​

Response​

响应属性​

错误​

后续步骤​

Request

请求体属性

Response

响应属性

错误

后续步骤