跳到主要内容

投资组合 - 下载投资组合

简介​

该接口以同步方式生成基金类别的报告，并以 base64 返回。

适用范围
角色主机所需权限
管理人manager-api读取
顾问consultant-apiView Compositions

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

Request​

ENDPOINT
/composition/fund_class/FUND_CLASS_KEY/report
MÉTODO
POST
STATUS
201
Request Body
{
    "report_type": "wallet_composition_by_composition",
    "composition_type": "final_quota",
    "reference_date": "2025-01-20"
}
字段类型必填描述
report_typestring是要生成的报告。见下表。
reference_datestring是参考日期，格式为 YYYY-MM-DD。
composition_typestring投资组合类报告需提供此字段或 composition_key 之一pre_quota、final_quota 或 opening_quota。使用 reference_date 当日该类型的投资组合。
composition_keystring投资组合类报告需提供此字段或 composition_type 之一特定投资组合的 key。

可用报告​

report_type内容是否需要指定投资组合
wallet_composition_by_composition投资组合电子表格（.xlsx）是
wallet_composition_by_composition_pdf投资组合 PDF是
xml_401_by_composition投资组合 XML 4.01——不接受 pre_quota是
xml_5_by_composition投资组合 XML 5.0——不接受 pre_quota是
cash_account_demonstrative现金账户明细否（仅需 reference_date）
pmts_reconciliationPMT 对账否（仅需 reference_date）

接口契约接受的其他值（wallet_composition_a_pagar、assets_wallet_composition_legacy、wallet_asset_installments_settlement_legacy、settlements_status_by_reference_date、discarded_settlements_on_payment_batch）不由该端点生成，会返回 CMP000027。

Response​

Response Body
{
    "document_b64": "UEsDBBQABgAIAAAAIQ..."
}

document_b64 为以 base64 编码的报告文件。

注意

对于投资组合类报告，投资组合必须处于 confirmed、pending_confirmation 或 reproved_by_agent 状态。处于其他状态时，返回 400（CMP000015）。

错误​

状态码代码触发条件
400CMP000015投资组合不处于 confirmed、pending_confirmation 或 reproved_by_agent。
400CMP000044投资组合类报告既没有 composition_key，也没有 composition_type。
400CMP000027该 report_type 不由此端点生成。
404CMP000026对 pre_quota 投资组合请求了 xml_401_by_composition 或 xml_5_by_composition。
404CMP000012不存在所指定 composition_key 的投资组合，或 reference_date 当日不存在该 composition_type 的投资组合。
400CMP000014报告生成器拒绝了请求；description 中给出原因。
400QIT000001请求体不符合接口契约：缺少必填字段、日期格式错误或包含未定义的字段。
400QIT000004该 fund_class_key 属于其他管理人的基金类别。

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