跳到主要内容

从批次中移除资产

如需在审批之前从批次中移除某项资产，请将该资产的状态更新为 denied。该资产不再属于该批次，其金额也会从转让总额中扣除。如还需添加资产，请重新开放批次、调整资产，然后再次结束插入。

各角色何时可以移除资产

资产必须处于 pending_eligibility、pending_invoice_validation、pending_documentation 或 pre_approved。批次必须处于以下状态之一：

角色可移除资产的批次状态
管理人pending_assets_insertion、completed_assets_insertion、pending_consultant_approval、pending_manager_approval
顾问pending_assets_insertion、completed_assets_insertion、pending_consultant_approval
转让方pending_assets_insertion、completed_assets_insertion

管理人可以在不重新开放批次的情况下，从处于 pending_manager_approval 的批次中移除资产，然后审批该批次。

移除资产​

每项要移除的资产发送一个请求。

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

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

Request​

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

Path params​

参数类型描述
assignment_external_idstring批次的 external_id。
asset_external_idstring要移除资产的 external_id。
Request Body
{
    "asset_status": "denied",
    "denial_reason": {
        "reason_type": "manager",
        "denial_reason": "Sacado fora da política do fundo"
    }
}

请求体属性​

字段类型是否必填描述
asset_statusstring必填唯一可接受的值：denied。
denial_reasonobject可选移除原因：reason_type（对象内必填；使用 manager、consultant 或 assignor）和 denial_reason（自由文本）。未提供该对象时，记录的来源为您的角色。

Response​

STATUS
200

响应为更新后的资产，格式与批次资产查询中的每一项相同，包含业务对象（credit_operation、discounted_credit_right 或 contract）。节选：

Response Body（节选）
{
    "asset_key": "f4348106-01c4-4c59-a261-7c09db811c47",
    "external_id": "9eec85be-97c9-41e0-88b3-b17a39869b36",
    "total_purchase_value": 1231.21,
    "asset_type": "ccb",
    "status": "denied",
    "denied_by": "manager",
    "denial_reason": "Sacado fora da política do fundo"
}

重新开放和关闭批次​

如需向已结束插入的批次添加新资产，请使用 pending_assets_insertion 重新开放该批次，插入或移除资产，然后再次使用 completed_assets_insertion 结束插入。结束后，批次会再次经过合格性审查和审批。

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

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

当批次处于 completed_assets_insertion、pending_consultant_approval 或 pending_manager_approval 时可以重新开放。顾问不能重新开放处于 pending_manager_approval 的批次。

Request​

ENDPOINT
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}
MÉTODO
PUT
Request Body — 重新开放
{
    "assignment_status": "pending_assets_insertion"
}
字段类型是否必填描述
assignment_statusstring必填发送 pending_assets_insertion 以重新开放。如需再次结束插入，请发送 completed_assets_insertion——参见结束资产插入。

Response​

STATUS
200
Response Body
{
    "assignment_key": "8e515a17-8b4d-49a3-aed6-47c9574e426a",
    "external_id": "9eec85be-97c9-41e0-88b3-b17a39869b36",
    "status": "pending_assets_insertion",
    "number_of_approved_assets": 0,
    "assignment_total_value": 1234.99
}
字段类型描述
assignment_keystring批次的唯一标识（UUID）。
external_idstring合作伙伴提供的批次外部 key。
statusstring批次的新状态：pending_assets_insertion。
number_of_approved_assetsinteger在此调用中始终为 0。
assignment_total_valuenumber该批次最近一次计算的总金额，以雷亚尔为单位。在下次结束插入时重新计算。

错误​

状态码代码触发条件
400TRC000086资产不处于 pending_eligibility、pending_invoice_validation、pending_documentation 或 pre_approved（例如已被拒绝或已正式化）。
400TRC000023asset_status 不是 denied，或 assignment_status 的值不被接受。
400TRC000087批次状态不允许您的角色移除资产或重新开放批次（见上表）。
400TRC000024对不处于 completed_assets_insertion、pending_consultant_approval 或 pending_manager_approval 的批次请求重新开放。
404TRC000018该转让配置中没有使用此 external_id 的批次。
404TRC000020批次中没有使用该 asset_external_id 的资产。

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