投资组合 - 审批

审批通过或拒绝验证投资组合。仅适用于状态为 pending_confirmation 的投资组合——投资组合准备好供您审核时即处于该状态，此时管理人会收到状态变更 webhook。

适用范围

角色	主机	所需权限
管理人	`manager-api`	写入

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

Request

ENDPOINT

/composition/fund_class/FUND_CLASS_KEY/composition/COMPOSITION_KEY

MÉTODO

PUT

Request Body — 审批通过
{
    "new_status": "confirmed"
}

Request Body — 拒绝
{
    "new_status": "reproved_by_agent",
    "reproved_reason": "Cota divergente do controle interno da gestora."
}

字段	类型	必填	描述
`new_status`	string	是	投资组合的新状态。见下方枚举值。
`reproved_reason`	string	是，当 `new_status` 为 `reproved_by_agent` 时	拒绝原因，1 到 255 个字符。

枚举值	描述
`confirmed`	审批通过投资组合。
`reproved_by_agent`	拒绝投资组合，并记录 `reproved_reason` 中填写的原因。
`reproved`	拒绝投资组合，不要求填写原因。建议优先使用 `reproved_by_agent`。

拒绝原因会记录在投资组合的历史中：投资组合查询的 status_events 字段会列出每次状态变更及其 metadata。

成功时，API 返回 204 No Content，不带响应体。可查询投资组合以查看新状态。

状态码	代码	触发条件
404	`CMP000013`	投资组合不处于 `pending_confirmation`（已审批通过、已拒绝或仍在处理中）。
404	`CMP000010`	`new_status` 不是 `confirmed`、`reproved_by_agent` 或 `reproved`。
404	`CMP000025`	`new_status` 为 `reproved_by_agent`，但未发送 `reproved_reason`。
404	`CMP000012`	所指定的基金类别下不存在该 `composition_key` 对应的投资组合。
404	`CMP000001`	不存在该 `fund_class_key` 对应的基金类别。
409	`CMP000022`	同一基金类别、同一日期、同一类型下已有另一份投资组合处于所请求的状态。
400	`QIT000001`	请求体不符合接口契约：缺少 `new_status` 或其值不在可接受范围内，或包含未定义的字段。
400	`QIT000004`	该 `fund_class_key` 属于其他管理人的基金类别。

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