跳到主要内容

批次审批

当转让配置要求人工审批时，通过合格性审查的批次会等待顾问（pending_consultant_approval）和/或管理人（pending_manager_approval）作出决定。该端点用于记录此决定：审批通过或拒绝批次。

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

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

转让方可通过 assignor-api 访问同一端点来结束插入，但不能发送 approved 或 denied（TRC000059）。

各状态下由谁决定
批次状态管理人顾问
pending_consultant_approval可以拒绝（denied）或重新开放（pending_assets_insertion）。不能审批通过。可以审批通过、拒绝或重新开放。
pending_manager_approval可以审批通过、拒绝或重新开放。不能操作（TRC000087）。

同样的决定也可以在 Portal do Gestor 或 Portal do Consultor 中作出。

我在流程中的哪一步？

此步骤发生在批次合格性审查之后。您会收到状态为 pending_consultant_approval 或 pending_manager_approval 的 webhook，表示该批次等待决定。如需在审批前移除资产，请参见从批次中移除资产。

Request​

ENDPOINT
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}
MÉTODO
PUT

Path params​

参数类型描述
assignment_external_idstring创建批次时提供的 external_id。
Request Body — 审批通过
{
    "assignment_status": "approved",
    "disbursement_account_key": "764746ce-a530-4a71-af66-3f7c879627df",
    "number_of_approved_assets": 45,
    "assignment_total_value": 150000.00
}
Request Body — 拒绝
{
    "assignment_status": "denied",
    "denial_reason": {
        "reason_type": "manager",
        "denial_reason": "Concentração por sacado acima do limite do fundo"
    }
}

请求体属性​

字段类型是否必填描述
assignment_statusstring必填approved 审批通过批次；denied 拒绝批次。
disbursement_account_keystring可选仅用于审批通过。接收付款的转让方账户的 key（UUID），须为转让方准入时注册的账户之一。省略时使用转让方的默认账户。当批次已确定放款账户，或转让合同固定了其他账户时会被拒绝。
transfer_typestring可选仅用于审批通过。向转让方付款的方式：pix 或 wire_transfer。省略时使用批次或转让配置中的方式。
number_of_approved_assetsinteger可选仅用于审批通过。您预期批次中已审批资产的数量。如发送，则 assignment_total_value 也必填，两者会在审批前与批次进行核对。用于确保审批的内容与您审查的完全一致。 仅在作出最终决定的审批中进行核对：当顾问的审批使批次进入 pending_manager_approval 时，这两个字段会被忽略。
assignment_total_valuenumber可选仅用于审批通过。您预期的批次总金额，以雷亚尔为单位。与 number_of_approved_assets 一同发送。
denial_reasonobject可选仅用于拒绝。拒绝原因：reason_type（对象内必填；使用 manager 或 consultant）和 denial_reason（自由文本）。记录在获取批次的 status_events[].denial_reason 和 status_events[].denial_metadata 中。

Response​

STATUS
200
Response Body — 审批通过
{
    "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "status": "waiting_assets_to_formalize",
    "number_of_approved_assets": 45,
    "assignment_total_value": 150000.00
}
Response Body — 拒绝
{
    "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "status": "denied"
}

响应属性​

字段类型描述
assignment_keystring批次的唯一标识（UUID）。
external_idstring合作伙伴提供的批次外部 key。
statusstring批次的新状态。审批通过时：pending_manager_approval（顾问已审批，仍需管理人审批）、pending_assets_registry（要求资产登记的配置）或 waiting_assets_to_formalize。拒绝时：denied。
number_of_approved_assetsinteger仅审批通过时返回。批次中已审批资产的数量。批次转交管理人时为 0。
assignment_total_valuenumber仅审批通过时返回。转让总额，以雷亚尔为单位。
最终审批不发送 webhook

当审批使批次进入 pending_assets_registry 或 waiting_assets_to_formalize 时，此次状态转换不会发送任何批次 webhook：请使用响应中的 status。下一个批次 webhook 会在后续步骤（转让协议书、托管或付款）发送。转换到 pending_manager_approval 时会正常发送 webhook。

被拒绝（denied）的批次无法通过 API 回到流程中。在当日会计关账时，其状态变为 discarded。

错误​

状态码代码触发条件
400TRC000024批次所处状态不接受该决定（例如已审批通过，或仍在合格性审查中）。请查询获取批次。
400TRC000087管理人试图审批通过处于 pending_consultant_approval 的批次，或顾问试图操作处于 pending_manager_approval 的批次。
400TRC000059转让方发送了 approved 或 denied。
400TRC000095number_of_approved_assets 和 assignment_total_value 只发送了其中一个。
400TRC000096assignment_total_value 与批次当前金额不符。
400TRC000097number_of_approved_assets 与已审批资产的数量不符。
400TRC000118发送了 disbursement_account_key，但批次已确定放款账户。
400TRC000149对转让方的扣减超过该批次允许的上限。
400TRC000185disbursement_account_key 与转让合同中固定的账户不同。
422TRC000186转让合同中固定的放款账户在转让人登记信息中已不再有效。请联系集成团队。
404TRC000018该转让配置中没有使用此 external_id 的批次。
404TRC000116disbursement_account_key 不对应转让方的任何账户。

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

后续步骤​

审批通过后，流程自动继续：

  1. 资产登记与正式化——取决于转让配置的登记类型。
  2. 转让协议书——生成协议书并发送签署。您会收到状态为 pending_assignment_term_signature 的 webhook。可通过转让文件查询该文件。
  3. 付款——签署后，系统向转让方付款，并发送状态为 pending_payment 的 webhook。
  4. 纳入投资组合——资产纳入基金投资组合，批次以 completed 状态结束。