跳到主要内容

按键查询赎回申请

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

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

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

Request​

ENDPOINT
/quota/investor/INVESTOR_KEY/redemption_request/REDEMPTION_REQUEST_KEY
MÉTODO
GET
STATUS
200

管理人只能查询其自身基金的赎回申请。

Responses​

案例 01：查询成功
{
    "redemption_request_key": "UUID",
    "redemption_request_type": "gross_redemption_value",
    "status": "quoted",
    "quotation_date": "2025-01-15",
    "payment_date": "2025-01-16",
    "payment_method": "regular",
    "request_datetime": "2025-01-14T13:05:00Z",
    "redemption_request_data": {
        "gross_redemption_value": 1000.0
    },
    "processed_value": 1000.0,
    "ir_value": 2.78,
    "iof_value": 0.0,
    "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",
        "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"
            }
        }
    },
    "payments": [
        {
            "payment_key": "UUID",
            "origin_key": "UUID",
            "total_value": 997.22,
            "payment_type": "redemption.investor",
            "payment_date": "2025-01-16",
            "status": "paid"
        }
    ],
    "status_events": [
        {
            "status": "pending_quote",
            "event_datetime": "2025-01-14T13:05:00Z"
        },
        {
            "status": "quoted",
            "event_datetime": "2025-01-15T21:00:00Z"
        }
    ]
}

Redemption Request​

字段类型描述
redemption_request_keystring赎回申请唯一键
redemption_request_typestringRedemption Request Type 枚举值
statusstringRedemption Request Status 枚举值
quotation_datestring计价日期
payment_datestring付款日期
payment_methodstringregular 或 b3
request_datetimestring申请创建的日期和时间（UTC）
redemption_request_dataobject创建时发送的金额（例如 gross_redemption_value、net_value）
processed_valuefloat赎回已处理金额
ir_valuefloat赎回的所得税（IR）
iof_valuefloat赎回的金融操作税（IOF）
investorobject投资者：investor_key、name、person_type、document_number 和 distributor
issuance_serieobject发行系列，包含 sub_class 和 sub_class.fund_class
paymentsarray生成的付款（投资者、IR、IOF）：payment_key、origin_key、total_value、payment_type、payment_date、status、status_events
status_eventsarray状态历史：status 和 event_datetime（UTC）
cancellation_dataobject取消数据，仅在申请已取消时返回

Redemption Request Type​

枚举值描述
gross_redemption_value按总额赎回
number_of_quotas按份额数量赎回
remaining_application_value按剩余持仓赎回
net_value_redemption按净额赎回

Redemption Request Status​

枚举值描述
created已创建
pending_manager_approval等待管理人审批
pending_quote待计价
processing_quotation计价处理中
pending_quotation_date_input等待设定计价日期
processing_issuance_serie_impacts正在处理对系列的影响
quoted已计价
canceled已取消
reprocessed已重新处理

错误​

状态代码发生情形
400QIT000004该赎回申请不属于该管理人的基金
404QTA000036未找到该投资者的赎回申请

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