跳到主要内容

分页查询金融申请

Requests​

按份额持有人查询：此端点将返回某份额持有人的所有金融申请
ENDPOINT
/quota/investor/INVESTOR_KEY/financial_applications
MÉTODO
GET
STATUS
200
按基金查询：此端点将返回某基金的所有金融申请
ENDPOINT
/quota/fund_class/FUND_CLASS_KEY/financial_applications
MÉTODO
GET
STATUS
200

Query Params​

参数描述
quotation_date申请的报价日期
status所需的 Financial Application Status 列表
application_from_datetime仅返回申请日期时间大于或等于所提供值的金融申请。
application_to_datetime仅返回申请日期时间小于或等于所提供值的金融申请。

Responses​

情况01：查询成功
{
    "data": [
        {
        "external_id": "",
        "financial_application_key": "UUID",
        "share_capital": 0.00,
        "investor_position": {
            "investor": {
                "investor_key": "UUID",
                "document_number": "999.999.999-99" | "99.999.999/9999-99",
                "name": "",
                "person_type": "natural_person" | "legal_person",
                "account_data": {
                    "owner": {
                        "name": "",
                        "document_number": "99.999.999/9999-99"
                    },
                    "account_digit": "0",
                    "account_branch": "0000",
                    "account_number": "00000",
                    "financial_institution_code": "000",
                    "financial_institution_ispb": "00000000"
                },
                "distributor": {
                    "distributor_key": "UUID",
                    "document_number": "99.999.999/9999-99",
                    "name": "",
                    "account_data": {
                        "owner": {
                            "name": "",
                            "document_number": "99.999.999/9999-99"
                        },
                        "account_digit": "0",
                        "account_branch": "0000",
                        "account_number": "00000",
                        "financial_institution_code": "000",
                        "financial_institution_ispb": "00000000"
                    },
                }
            },
            "total_net_worth": 0.00,
            "total_number_of_quotas": 0.00000000,
            "issuance_serie": {},
            "investor_position_key":"UUID"
        },
        "original_principal_value": 0.00000000,
        "current_principal_value": 0.00000000,
        "original_number_of_units": 0.00000000,
        "current_number_of_units": 0.00000000,
        "quotation_date": "yyyy-mm-dd",
        "application_datetime": "YYYY-MM-DDTHH:MM:SSZ",
        "status": "pending_payment" | "pending_quote" | "quoted" | "settled" | "redeemed" | "canceled",
        "status_events": [
            {
                "event_datetime": "yyyy-mm-dd HH:MM:SS:ms",
                "status": "pending_payment" | "pending_quote" | "quoted" | "settled" | "redeemed" | "canceled",
            }
        ],
        "capital_returns": [
            {
                "capital_return_key": "UUID",
                "origin_key": "UUID",
                "net_value": 0.00,
                "iof_value": 0.00,
                "ir_value": 0.00,
                "payment_date": "yyyy-mm-dd",
                "capital_return_date": "yyyy-mm-dd",
                "status": "",
                "capital_return_type": "",
                "number_of_units": "",
            }
        ],
        }
    ],
    "limit": 50,
    "page": 0,
    "is_last_page": true
}

Page​

字段类型描述
dataarrayFinancial Application 对象列表
limitint每页返回的对象数量限制
pageint返回的页码
is_last_pageboolean指示返回的页面是否为最后一页的信息

Financial Application​

字段类型描述字符数
external_idstring外部标识符最多100
financial_application_keystring金融申请的唯一标识键36
share_capitalfloat投资金额-
investor_positionJSONInvestor Position 对象-
original_principal_valuefloat每单位原始本金价值-
current_principal_valuefloat每单位当前本金价值-
original_number_of_unitsfloat原始份额数量-
current_number_of_unitsfloat当前份额数量-
quotation_datestring报价日期-
application_datetimestring金融申请创建日期-
statusstringFinancial Application Status 枚举值-
status_eventsarrayStatus Event 对象列表-
capital_returnsarrayCapital Return 对象列表-

Financial Application Status​

枚举值描述
pending_payment待支付
pending_quote待报价
quoted已报价
settled已完全摊销
redeemed已完全赎回
canceled已取消

Investor Position​

字段类型描述
investorJSONInvestor 对象
total_net_worthfloat投资者持仓净资产
total_number_of_quotasfloat投资者持仓份额数量
issuance_serieJSONIssuance Serie 对象
investor_position_keyJSON投资者持仓唯一标识键

Investor​

字段类型描述字符数
namestring投资者姓名最多255
investor_keystring投资者唯一标识键36
document_numberstring投资者 CPF/CNPJ14或18
person_typestring自然人 / 法人 / 基金类别最多50
distributorJSONDistributor 对象-
account_dataJSONAccount Data 对象-

Distributor​

字段类型描述字符数
namestring分销商名称最多255
distributor_keystring分销商唯一标识键-
document_numberstring分销商 CPF/CNPJ14或18
account_dataJSONAccount Data 对象-

Account Data​

字段类型描述
account_digitstring银行账户校验位
account_branchstring银行账户支行编号
account_numberstring银行账户号码
financial_institution_codestring金融机构代码
financial_institution_ispbstring金融机构在巴西支付系统中的标识符

Issuance Serie​

字段类型描述字符数
namestring发行系列名称最多255
issuance_serie_keystring发行系列唯一标识键36
cetip_codestring发行系列在 CETIP 中作为资产的代码10
start_datestring发行系列开始日期10
maturity_datestring发行系列到期日期10
original_quota_valuefloat原始份额价值-
remuneration_typestring收益曲线 / 残差最多50
investment_categorystringFIDC / 多市场最多50
condominum_typestring开放式 / 封闭式最多50
tax_classificationstring短期 / 长期最多50
investment_restriction_typestring无限制 / 合格投资者 / 专业投资者最多50
minimum_share_capitalfloat最低投资金额-
accounting_datestring发行系列记账日期10
sub_classJSONSub Class 对象-

Sub Class​

字段类型描述字符数
namestring子类别名称最多255
sub_class_keystring子类别唯一标识键36
subordination_levelint子类别从属级别-
fund_classJSONFund Class 对象-

Fund Class​

字段类型描述字符数
namestring基金类别名称最多255
fund_class_keystring基金类别唯一标识键36
document_numberstring基金类别 CNPJ-

Capital Return​

字段类型描述
capital_return_keystring资本回报唯一标识键
origin_keystring资本回报来源唯一标识键
net_valuefloat资本回报净值
iof_valuefloat资本回报 IOF 金额
ir_valuefloat资本回报 IR 金额
payment_datestring资本回报支付日期
capital_return_datestring资本回报创建日期
statusstring发送至管理员 / 待支付 / 已支付
capital_return_typestring摊销 / 赎回申请 / Come-cotas
number_of_unitsfloat资本回报份额数量