结束资产插入
在批次中插入所有所需资产后,使用该端点表明插入已完成。自此,批次不再接收新资产。当所有资产都完成单项审查(pre_approved、pending_formalization、denied 或 registry_denied)后,系统会自动评估整个批次的合格性。
适用范围
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
| 顾问 | consultant-api | Batches |
| 转让方 | assignor-api | 写入 |
各主机的 Base URL:环境(主机)。
无需等待资产的 webhook
插入资产后,您可以随时结束插入。无需等待所有资产完成单项合格性审查:系统会等到所有资产审查完成后,再进行批次的合格性审查。
Request
ENDPOINT
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}MÉTODO
PUTPath params
| 参数 | 类型 | 描述 |
|---|---|---|
assignment_external_id | string | 创建批次时提供的 external_id。 |
Request Body
{
"assignment_status": "completed_assets_insertion"
}
请求体属性
| 字段 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
assignment_status | string | 必填 | 如需结束资产插入,请发送 completed_assets_insertion。批次必须处于 pending_assets_insertion。 |
Response
STATUS
200Response Body
{
"assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
"external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
"status": "completed_assets_insertion",
"number_of_approved_assets": 0,
"assignment_total_value": 15230.75
}
响应属性
| 字段 | 类型 | 描述 |
|---|---|---|
assignment_key | string | 批次的唯一标识(UUID)。 |
external_id | string | 合作伙伴提供的批次外部 key。 |
status | string | 批次的新状态:completed_assets_insertion;当批次的 assignment_date 晚于基金会计日期时为 waiting_assignment_date,此时批次会在转让日期进入 completed_assets_insertion。 此状态变更不发送 webhook。 |
number_of_approved_assets | integer | 在此调用中始终为 0:已审批资产的计数只在审批时进行。 |
assignment_total_value | number | 未被拒绝(denied/registry_denied)资产的 total_purchase_value 之和,以雷亚尔为单位。在替换批次中,已扣除被回购资产的金额。 |
错误
| 状态码 | 代码 | 触发条件 |
|---|---|---|
| 400 | TRC000023 | assignment_status 的值不被接受。该端点接受的值为 completed_assets_insertion、pending_assets_insertion、approved 和 denied。 |
| 400 | TRC000024 | 批次不处于 pending_assets_insertion。 |
| 400 | TRC000042 | 批次中没有任何审查中或已审批的资产。结束前请至少插入一个资产。 |
| 400 | TRC000160 | 批次中的所有资产均已被拒绝。 |
| 400 | TRC000092 | 替换批次:新资产的金额低于被回购资产的金额。 |
| 400 | TRC000093 | 替换批次中没有任何回购资产。 |
| 404 | TRC000018 | 该转让配置中没有使用此 external_id 的批次。 |
认证、权限和主机相关错误:参见 API 错误。
后续步骤
结束插入后,流程自动继续:
- 资产合格性审查——逐一审查每项资产。您会收到告知审批通过或拒绝的资产 webhook。
- 批次合格性审查——所有资产审查完成后,评估批次的合格性。结果通过批次 webhook 通知。
- 审批——如转让配置要求,由顾问和/或管理人审批该批次。