跳到主要内容

创建回购批次

创建用于汇集待回购或出售资产的批次（assignment）。批次创建后处于 pending_assets_insertion。

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

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

Request​

ENDPOINT
/trade_resolve/fund_class/FUND_CLASS_KEY/assignment
MÉTODO
POST
Request Body
{
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "assignment_date": "2024-04-01",
    "assignment_configuration_key": "d9308a2b-21fa-4724-9bbe-59ae65287b10",
    "source_account": {
        "document_number": "11.222.333/0001-81"
    }
}

Body Params​

字段类型描述字符数
external_id *string该批次在集成合作伙伴系统中的唯一标识 key。最多 50
assignment_date *string回购日期。必须等于基金当前的会计日期。YYYY-MM-DD
assignment_configuration_keystring回购配置的 key，由 QI Tech 提供。发送此字段或 assignment_type。36
assignment_typestring批次类型，在使用基金针对该类型的默认配置时填写：assignment_repurchase、wallet_sale 或 assignment_resolution。发送此字段或 assignment_configuration_key。最多 50
source_account *object向基金付款的账户-
批次配置

在 assignment_configuration_key 和 assignment_type 中只能发送一个。两者都不发送时，API 返回 TRR000017；两者都发送时，返回 TRR000016。

source account 对象​

字段类型描述字符数
document_number *string向基金付款方的 CPF 或 CNPJ，带格式。必须为有效证件号。14 到 18

Response​

STATUS
201
Response Body
{
    "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "assignment_status": "pending_assets_insertion"
}
重发与重复

如发生错误，请重发请求。重复（TRR000015）表示该资源已存在：请查询它，而不是重新创建。通过 assignor-api 查询的方式为 GET /trade_resolve/fund_class/{fund_class_key}/assignment/{external_id}；manager-api 和 consultant-api 不提供该查询，因此请将 TRR000015 视为批次已创建，继续进行资产插入。参见重发与重复。

错误​

状态码代码触发条件
400QIT000001请求体不符合接口契约：缺少必填字段、未知字段、格式无效
400TRR000014assignment_date 与基金的会计日期不同
400TRR000002source_account.document_number 不是有效的 CPF 或 CNPJ
400TRR000016同时发送了 assignment_configuration_key 和 assignment_type
400TRR000017既未发送 assignment_configuration_key，也未发送 assignment_type
400TRR000019回购配置未启用
403TRR000049该代理方无权访问此基金或此回购配置
404TRR000006不存在使用该 fund_class_key 的基金
404TRR000013未找到该基金的回购配置（或该基金没有针对该 assignment_type 的默认配置）
404TRR000018assignment_type 不存在
409TRR000015该基金中已存在使用此 external_id 的批次

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