按键查询金融申请

按键返回投资者的某笔金融申请。

适用范围

角色	主机	所需权限
管理人	`manager-api`	读取
顾问	`consultant-api`	由集成团队开通

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

Request

ENDPOINT

/quota/investor/INVESTOR_KEY/financial_application/FINANCIAL_APPLICATION_KEY

MÉTODO

GET

STATUS

200

管理人只能查询与其关联的投资者；顾问只能查询其拥有权限的基金中的申请。

Responses

案例 01：查询成功

{
    "financial_application_key": "UUID",
    "external_id": "SEU_ID_EXTERNO",
    "share_capital": 1000.0,
    "status": "quoted",
    "financial_application_type": "primary_market",
    "payment_method": "regular",
    "central_depositary": "unregistered",
    "quotation_date": "2025-01-10",
    "original_number_of_quotas": 998.12345678,
    "original_number_of_quotas_str": "998.12345678",
    "current_number_of_quotas": 998.12345678,
    "current_principal_value": 1000.0,
    "acquisition_cost": 1000.0,
    "status_events": [
        {
            "event_datetime": "2025-01-09T14:30:00Z",
            "status": "pending_payment"
        },
        {
            "event_datetime": "2025-01-10T21:00:00Z",
            "status": "quoted"
        }
    ],
    "redemptions": [],
    "amortizations": [],
    "investor": {
        "investor_key": "UUID",
        "name": "INVESTIDOR EXEMPLO",
        "person_type": "natural_person",
        "document_number": "969.698.790-03",
        "distributor": {
            "distributor_key": "UUID",
            "document_number": "11.222.333/0001-81",
            "name": "DISTRIBUIDORA EXEMPLO",
            "account_data": {}
        }
    },
    "issuance_serie": {
        "issuance_serie_key": "UUID",
        "name": "SERIE 1",
        "serie": 1,
        "status": "active",
        "remuneration_type": "yield_curve",
        "original_quota_value": 1.0,
        "current_quota_value": 1.0018,
        "minimum_share_capital": 0.0,
        "sub_class": {
            "name": "COTA SÊNIOR",
            "sub_class_key": "UUID",
            "subordination_level": 1,
            "fund_class": {
                "name": "FUNDO EXEMPLO",
                "fund_class_key": "UUID",
                "document_number": "11.222.333/0001-81"
            }
        }
    },
    "water_mark_events": []
}

可选字段（external_id、original_number_of_quotas、current_number_of_quotas、current_principal_value、acquisition_cost、quotation_date）仅在有值时返回。列表 status_events、redemptions、amortizations 和 reserved_taxable_yields 为空时不返回。

Financial Application

字段	类型	描述
`financial_application_key`	string	金融申请唯一键
`external_id`	string	外部标识符
`share_capital`	float	申请金额
`status`	string	Financial Application Status 枚举值
`financial_application_type`	string	`primary_market`（申请）或 `secondary_market`（二级市场）
`payment_method`	string	`regular`（Pix 或 TED）或 `b3`
`central_depositary`	string	`unregistered` 或 `cetip`
`quotation_date`	string	计价日期（`yyyy-mm-dd`）
`original_number_of_quotas`	float	计价时的份额数量（`_str`：以字符串表示的同一数值，不做舍入）
`current_number_of_quotas`	float	当前份额数量
`current_principal_value`	float	当前本金
`acquisition_cost`	float	取得成本
`status_events`	array	状态历史：`status` 和 `event_datetime`（UTC）
`redemptions`	array	消耗该申请的赎回：`redemption_key`、`redemption_type`、`number_of_quotas`、`total_value`、`ir_value`、`iof_value`、`yield_value`、`taxable_yield_value`、`redemption_date`
`amortizations`	array	已支付的摊销：`amortization_key`、`payment_date`、`total_value`、`principal_reduction`、`acquisition_cost_reduction`，以及（如有）`yield_value`、`taxable_yield_value`、`ir_value`、`iof_value`
`reserved_taxable_yields`	array	预留的应税收益（come-cotas）
`investor`	object	投资者：`investor_key`、`name`、`person_type`、`document_number` 和 `distributor`
`issuance_serie`	object	发行系列，包含 `sub_class` 和 `sub_class.fund_class`
`water_mark_quota_value`	float	高水位线（业绩报酬）的参考份额价值（如有）
`water_mark_reference_date`	string	高水位线参考日期（如有）
`water_mark_events`	array	高水位线事件

Financial Application Status

枚举值	描述
`created`	已创建
`pending_formalization`	待正式化（认购公告）
`pending_payment`	待付款
`processing_quotation`	计价处理中
`pending_quote`	待计价
`processing_issuance_serie_impacts`	正在处理对系列的影响
`quoted`	已计价
`settled`	已全部摊销
`redeemed`	已全部赎回
`canceled`	已取消
`reprocessed`	已重新处理

错误

状态	代码	发生情形
400	`QIT000004`	管理人未与该投资者关联
403	`QTA000315`	顾问对该申请所属基金没有权限
404	`QTA000021`	未找到投资者
404	`QTA000260`	未找到该投资者的金融申请

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

Request​

Responses​

Financial Application​

Financial Application Status​

错误​

Request

Responses

Financial Application

Financial Application Status

错误