跳到主要内容

创建待回购/出售的资产

将基金投资组合中的一项资产插入处于 pending_assets_insertion 的批次。每个资产发送一个请求。

适用范围
角色主机所需权限
管理人manager-api写入
顾问consultant-api由集成团队开通
转让方assignor-api写入

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

Request​

ENDPOINT
/trade_resolve/fund_class/FUND_CLASS_KEY/assignment/ASSIGNMENT_EXTERNAL_ID/asset
MÉTODO
POST

ASSIGNMENT_EXTERNAL_ID 是批次的 external_id，在创建批次时提供。请求体中的 external_id 是资产的标识。

Request Body
{
    "external_id": "7c2d5a10-3f4e-4b8a-9d61-0e2f4a6b8c90",
    "sale_value": 1234.56
}

Body Params​

字段类型描述字符数
external_idstring资产的标识，与其纳入投资组合时使用的标识相同。发送此字段或 contract_number。最多 50
contract_numberstring资产的合同编号，可替代 external_id。适用于 ccb、structured_cci、duplicata_servicos、duplicata_mercantil 和 cte。最多 50
borrower_document_numberstring债务人的证件号，用于在查找资产时消除歧义11 到 18
sale_valuenumber注销资产所依据的金额。发送此字段或 calculation_method。2 位小数
calculation_methodstring计算出售金额，而不是直接提供。唯一可接受的值：current_fair_value（资产当前的会计公允价值）。最多 255
规则
  • 资产必须在基金投资组合中处于有效状态，且其资产类型与批次配置一致。
  • 在 external_id 和 contract_number 中只能发送一个，在 sale_value 和 calculation_method 中也只能发送一个。
  • 在 assignment_resolution 批次中，sale_value 必须等于资产的购入金额（TRR000053）。

Response​

STATUS
201
Response Body
{
    "asset_key": "0b6f6c55-5d1b-4b6e-8f3a-6c1f0f7f2b10",
    "asset_resolve_key": "e4a1c9d2-7b3f-4e8a-a5c6-1d2e3f4a5b6c",
    "asset_status": "pending_wallet_sale"
}
asset_status情形
pending_wallet_sale出售价格与资产会计公允价值的偏差不超过 5%。资产继续流程。
pending_validation出售价格与会计公允价值的偏差超过 5%。资产会被暂留，直至确认；API 不提供确认操作：请与 integracao.dtvm@qitech.com.br 协商。
重发与重复

如发生错误，请重发请求。重复（TRR000042）表示该资产已在一个未废弃的批次中：请勿再次插入。参见重发与重复。

错误​

状态码代码触发条件
400QIT000001请求体不符合接口契约：未知字段或格式无效
400TRR000050既未发送 sale_value，也未发送 calculation_method
400TRR000051同时发送了 sale_value 和 calculation_method
400TRR000052calculation_method 不是 current_fair_value
400TRR000071既未发送 external_id，也未发送 contract_number
400TRR000070同时发送了 external_id 和 contract_number
400TRR000072批次的资产类型不接受 contract_number：请使用 external_id
400TRR000021批次不处于 pending_assets_insertion（已关闭或已废弃）
400TRR000029找到多个资产：请提供 borrower_document_number 或使用 external_id
400TRR000053assignment_resolution 批次中 sale_value 与购入金额不同
403TRR000049该代理方无权访问此基金或此批次
404TRR000006不存在使用该 fund_class_key 的基金
404TRR000020未找到使用该 external_id 的批次
404TRR000028在基金投资组合中未找到使用该 external_id 的有效资产
404TRR000073未找到使用该 contract_number 的资产
409TRR000042该资产已在一个批次中，且未被废弃

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