跳到主要内容

金融申请结算分页查询

按基金类别或按申请，列出金融申请的每日结算（会计持仓）。

按基金类别​

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

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

ENDPOINT
/quota/fund_class/FUND_CLASS_KEY/financial_application_closings
MÉTODO
GET
STATUS
200

Query Params​

参数描述
accounting_date特定结算会计日期（yyyy-mm-dd）
from_date周期起始日期（yyyy-mm-dd）
to_date周期结束日期（yyyy-mm-dd）
investor_document_number投资者 CPF/CNPJ
limit每页条目数（默认 75，最大 75）
page页码，从 0 开始（默认 0）
注意

发送 accounting_date 或 from_date 与 to_date 这一对参数，二者不可同时发送。两者都未发送时，API 返回 QTA000026；同时发送时，返回 QIT000001。不在此列表中的参数同样会被拒绝，并返回 QIT000001。

结果按会计日期从新到旧排序。

按投资者和金融申请​

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

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

ENDPOINT
/quota/investor/INVESTOR_KEY/financial_application/FINANCIAL_APPLICATION_KEY/financial_application_closings
MÉTODO
GET
STATUS
200

Query Params​

参数描述
last_financial_application_closing布尔值。为 true 时，仅返回该申请的最近一次结算（默认 false）
limit每页条目数（默认 50，最大 500）
page页码，从 0 开始（默认 0）

Response​

案例 01：查询成功
{
    "data": [
        {
            "financial_application": {
                "financial_application_key": "UUID",
                "share_capital": 1000.0,
                "status": "quoted",
                "financial_application_type": "primary_market",
                "payment_method": "regular",
                "quotation_date": "2025-01-10",
                "investor": {
                    "investor_key": "UUID",
                    "name": "INVESTIDOR EXEMPLO",
                    "person_type": "natural_person"
                },
                "issuance_serie": {
                    "issuance_serie_key": "UUID"
                }
            },
            "total_value": 1012.35,
            "number_of_quotas": 998.12345678,
            "principal_value": 1000.0,
            "acquisition_cost": 1000.0,
            "yield_value": 12.35,
            "ir_value": 2.78,
            "iof_value": 0.0,
            "taxable_yield_value": 12.35,
            "accounting_date": "2025-01-31"
        }
    ],
    "limit": 75,
    "page": 0,
    "is_last_page": true
}
字段类型描述
dataarrayFinancial Application Closing 对象列表
limitint每页条目数
pageint返回的页码
is_last_pageboolean没有更多页时为 true

Financial Application Closing​

字段类型描述
financial_applicationobject完整的金融申请，格式同 按键查询金融申请
total_valuefloat结算时申请的总价值
number_of_quotasfloat结算时的份额数量
principal_valuefloat结算时的本金价值
acquisition_costfloat结算时份额的取得成本
yield_valuefloat总收益
ir_valuefloat所得税（IR）
iof_valuefloat金融操作税（IOF）
taxable_yield_valuefloat应税收益
accounting_datestring结算的会计日期

错误​

状态代码发生情形
400QTA000026按类别查询时既未发送 accounting_date，也未发送 from_date/to_date
400QIT000001参数无效或未知、limit 超过 75，或 accounting_date 与 from_date/to_date 同时发送
400QIT000004该基金不属于该管理人
404QTA000020未找到投资者（API 返回的是未找到分销商的错误）
404QTA000023未找到该投资者的金融申请

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