跳到主要内容

创建转让批次

这是信用权利转让流程的第一步。创建批次（assignment）会预留一个分组，后续步骤中将向基金转让的资产都将插入该分组。

适用范围
角色主机所需权限
管理人manager-api写入
顾问consultant-apiBatches
转让方assignor-api写入

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

前提条件

创建批次之前，您需要准备好：

  • fund_class_key——受让基金的唯一 key。
  • assignment_configuration_key——转让配置的唯一 key，可在转让方准入或转让配置列表中获取。该配置的状态必须为 active。

这两个 key 构成所有转让端点的路径：

/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}

Request​

ENDPOINT
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment
MÉTODO
POST
Request Body
{
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "assignment_date": "2024-04-01"
}

请求体属性​

字段类型是否必填描述
external_idstring必填该批次在您系统中的标识，1 到 50 个字符。在整个平台中唯一，而不仅限于该基金：请使用 UUID。您通过它查询批次，webhook 也通过它标识批次。
assignment_datestring可选转让日期，格式为 YYYY-MM-DD。不得早于基金当前的会计日期。省略时取当前会计日期。如为未来日期，批次在结束插入后处于 waiting_assignment_date，到该日期才进入流程。
payment_typestring可选向转让方付款的方式：pix 或 wire_transfer。省略时使用转让配置中定义的方式。
disbursementobject可选该批次专用的放款账户，填写在 target_account 字段中（见下文）。省略时，在审批时确定账户。当转让合同固定了唯一放款账户时会被拒绝。
assignor_discountsarray可选给转让方的扣减项，从转让付款中扣除。仅当转让配置允许扣减时接受（见下文）。
assignment_numbernumber可选批次编号。省略时由 QI Tech 生成。

disbursement.target_account 属性​

字段类型是否必填描述
account_branchstring必填分行，4 位数字。
account_numberstring必填账号，不含校验位。
account_digitstring必填账户校验位（1 个字符）。
account_typestring必填checking_account 或 escrow_account。
financial_institution_ispbstring必填机构的 ISPB，8 位数字。
financial_institution_codestring可选机构的 COMPE 代码，3 位数字。
owner.document_numberstring必填账户持有人的 CPF 或 CNPJ，带标点。

assignor_discounts 中每一项的属性​

字段类型是否必填描述
assignor_discount_typestring必填expense_reimbursement（费用报销）或 others。
total_valuenumber必填扣减金额，以雷亚尔为单位。最小值 0.01。
descriptionstring必填扣减描述，1 到 500 个字符。
assignor_discount_keystring可选扣减项的 UUID v4。省略时由 QI Tech 生成。

Response​

STATUS
201
Response Body
{
    "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "status": "pending_assets_insertion"
}

响应属性​

字段类型描述
assignment_keystringQI Tech 生成的批次唯一标识（UUID）。
external_idstring与请求中提供的外部 key 相同。
statusstring批次的初始状态：pending_assets_insertion，可接收资产。

重发与重复​

如发生错误，请重发请求。重复（TRC000041）表示该批次已存在：请通过获取批次查询它，而不是重新创建。参见重发与重复。

错误​

状态码代码触发条件
400TRC000014转让配置未启用。
400TRC000083assignment_date 早于基金当前的会计日期。请省略该字段或发送当前会计日期。
400TRC000136发送了 assignor_discounts，但转让配置不允许对转让方进行扣减。
400TRC000185发送了 disbursement，但转让合同固定了唯一放款账户。
404TRC000016fund_class_key 与 assignment_configuration_key 的组合不对应任何转让配置。
409TRC000041已存在使用该 external_id 的批次。参见重发与重复。
422TRC000161该配置要求对资产进行登记，但未配置登记机构。请联系集成团队。

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

后续步骤​

  1. 插入资产——添加将转让给基金的资产（CCB、duplicata 等）。
  2. 提交文件——为每项资产提交所需文件。
  3. 结束插入——表明所有资产均已插入，以便批次进入合格性审查。