跳到主要内容

按基金类别查询金融申购

分页返回您的基金类别对其他基金份额进行的金融申购。

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

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

Request​

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_applications
MÉTODO
GET

Query Params​

参数类型描述
pageint页码，从 0 开始。默认：0。
limitint每页记录数。默认：10。最大：50。
quotation_date日期确切的份额确认日期（YYYY-MM-DD）。
quotation_date_from日期份额确认起始日期（YYYY-MM-DD）。
quotation_date_to日期份额确认结束日期（YYYY-MM-DD）。不得早于 quotation_date_from。
financial_application_status列表要包含的状态，以逗号分隔（例如：pending_manager_approval,pending_payment）。
not_financial_application_status列表要排除的状态，以逗号分隔。
document_numberstring被投资基金类别的 CNPJ，带标点。精确匹配。
internal_codes列表被投资系列的内部代码，以逗号分隔。
asset_typestring资产类型（例如：fidc_fund_quota、multi_market_fund_quota）。
sub_class_name列表被投资系列的子类名称，以逗号分隔（不区分重音和大小写）。
searchstring在被投资基金简称、系列名称、内部代码或 CNPJ 中进行部分匹配搜索。

可能的状态参见创建金融申购。

Response​

STATUS
200
示例 01：返回一笔申购
{
  "data": [
        {
            "amount": 0.00,
            "financial_application_key": "UUID",
            "asset_key": "UUID",
            "quotation_date": "YYYY-MM-DD",
            "status": "confirmed",
            "issuance_serie": {
                "issuance_serie_key": "UUID",
                "name": "Invested Issuance Serie Name",
                "subclass_name": "Invested Sub Class Name",
                "serie": 1,
                "quota_calculation_method": "quota_value",
                "internal_code": "Internal Code",
                "fund_class_name": "Invested Fund Class Name",
                "fund_class_short_name": "Invested Fund Class short name",
                "fund_class_document_number": "00.000.000/0000-00",
                "minimum_share_capital": 0.0,
                "investment_category": "multi_market",
                "payment_type": "transfer",
                "account_data": {
                    "account_digit": "0",
                    "account_branch": "0001",
                    "account_number": "12345",
                    "financial_institution_code": "329",
                    "financial_institution_ispb": "00000000"
                },
                "last_updated_date": "YYYY-MM-DD",
                "administrator": {
                    "administrator_key": "UUID",
                    "name": "Administrator Name",
                    "document_number": "00.000.000/0000-00"
                },
                "operation_periods": {
                    "redemption_request": {
                        "payment": {
                            "days": 1,
                            "type": "until",
                            "calendar_base": "calendar_365"
                        },
                        "quotation": {
                            "days": 1,
                            "type": "fixed",
                            "calendar_base": "calendar_365"
                        }
                    },
                    "amortization_request": {
                        "payment": {
                            "days": 0,
                            "type": "fixed",
                            "calendar_base": "workdays"
                        },
                        "quotation": {
                            "days": 0,
                            "type": "fixed",
                            "calendar_base": "workdays"
                        }
                    },
                    "financial_application": {
                        "payment": {
                            "days": 0,
                            "type": "fixed",
                            "calendar_base": "workdays"
                        },
                        "quotation": {
                            "days": 0,
                            "type": "fixed",
                            "calendar_base": "workdays"
                        }
                    }
                },
                "isin_code": "BR000000000"
            },
            "fund_class": {
                "fund_class_key": "UUID",
                "name": "Fund Class Name",
                "short_name": "Fund Class Short Name",
                "document_number": "00.000.000/0000-00",
                "accounting_date": "YYYY-MM-DD",
                "distributor": {
                    "name": "Distributor Name",
                    "distributor_key": "UUID",
                    "document_number": "00.000.000/0000-00"
                },
                "manager": {
                    "manager_key": "UUID",
                    "manager_name": "Manager Name",
                    "document_number": "00.000.000/0000-00"
                }
            }
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

Page​

字段类型描述
dataarrayFinancial Application 对象列表
limitint每页获取的对象数量上限
pageint所获取的页码
is_last_pageboolean指示所获取的页是否为最后一页

Financial Application​

字段类型描述
amountfloat申购金额
financial_application_keystring金融申购的唯一 key
asset_keystring相关资产的 key
quotation_datestring份额确认日期（YYYY-MM-DD）
payment_datestring付款日期（YYYY-MM-DD）
payment_methodstringwire_transfer 或 pix
payment_typestringtransfer 或 automatic_debit
statusstring申购状态
external_financial_application_keystring金融申购的外部标识
iof_amountfloat申购的 IOF；计算后返回
number_of_quotasfloat份额数量；份额确认后返回
issuance_serieJSONIssuance Serie 对象
fund_classJSONFund Class 对象

Issuance Serie​

字段类型描述
issuance_serie_keystring发行系列的唯一 key
namestring发行系列名称
subclass_namestring子类名称（例如：SUBORDINADA）
serieint系列编号
quota_calculation_methodstring份额计算方法（例如：quota_value）
internal_codestring系列的内部代码
fund_class_namestring该系列所属基金类别的名称
fund_class_short_namestring基金类别简称
fund_class_document_numberstring基金类别的 CNPJ
minimum_share_capitalfloat最低申购金额
investment_categorystring投资类别（例如：multi_market）
payment_typestring付款类型（例如：transfer）
account_dataJSONAccount Data 对象
last_updated_datestring最近更新日期（YYYY-MM-DD）
administratorJSONAdministrator 对象
operation_periodsJSONOperation Periods 对象
isin_codestring系列的 ISIN 代码

Administrator​

字段类型描述
administrator_keystring行政管理人的唯一 key
namestring行政管理人名称
document_numberstring行政管理人的 CNPJ

Operation Periods​

字段类型描述
redemption_requestJSON赎回的 份额确认与付款 期限对象
amortization_requestJSON摊销的 份额确认与付款 期限对象
financial_applicationJSON申购的 份额确认与付款 期限对象

Quotation and Payment​

字段类型描述
daysint天数
typestring计数类型（例如：fixed、until）
calendar_basestring日历基准（例如：workdays、calendar_365）

Account Data​

字段类型描述
account_digitstring银行账户校验位
account_branchstring银行分行编号
account_numberstring银行账号
financial_institution_codestring金融机构代码
financial_institution_ispbstring金融机构的 ISPB（巴西支付系统）

Fund Class​

字段类型描述
fund_class_keystring基金类别的唯一 key
namestring基金类别全称
short_namestring基金类别简称
document_numberstring基金类别的 CNPJ
accounting_datestring最近的会计日期
distributorJSONDistributor 对象
managerJSONManager 对象

Distributor​

字段类型描述
namestring分销商名称
distributor_keystring分销商的唯一 key
document_numberstring分销商的 CNPJ

Manager​

字段类型描述
manager_keystring管理人的唯一 key
manager_namestring基金类别管理人的名称
document_numberstring管理人的 CNPJ

错误​

状态码代码触发条件
400TFQ000218quotation_date_from 晚于 quotation_date_to。
403TFQ000054该基金类别不属于您的管理人。
404TFQ000005未找到基金类别。

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