查询发行系列

分页返回可供申购份额的已注册基金发行系列。可使用返回的 issuance_serie_key 创建申购或赎回申请。

适用范围

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

对于顾问，列表仅包含与该顾问关联的基金类别的系列；如无关联，data 为空。

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

Request

ENDPOINT

/trade_fund_quota/issuance_series

MÉTODO

GET

Query Params

参数	类型	描述
page	int	页码，从 0 开始。默认：0。
limit	int	每页记录数。默认：10。最大：100。
fund_class_document_number	string	该系列所属基金的 CNPJ，带标点（例如：11.222.333/0001-81）。部分匹配。
fund_class_name	string	该系列所属基金的名称。部分匹配。
internal_code	string	系列的内部代码。部分匹配。
internal_codes	列表	内部代码，以逗号分隔。精确匹配。
status	列表	要包含的状态：created、active、inactive、pre_operational。不使用此筛选时，不返回 inactive 系列。
not_status	列表	要排除的状态，以逗号分隔。
sub_class_name	列表	子类名称，以逗号分隔（不区分重音和大小写）。
search	string	在基金简称、系列名称、内部代码或 CNPJ 中进行部分匹配搜索。

Response

STATUS

200

示例 01：返回一个系列

{
  "data": [
    {
        "issuance_serie_key": "UUID",
        "name": "Invested Issuance Serie Name",
        "subclass_name": "Invested Sub Class Name",
        "serie": 1,
        "quota_calculation_method": "quota_value",
        "condominium_type": "open_ended",
        "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",
        "asset_type": "multi_market_fund_quota",
        "payment_type": "transfer",
        "status": "active",
        "financial_institution_code": "329",
        "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",
            "status": "active"
        },
        "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"
    }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

Page

字段	类型	描述
data	array	Issuance Serie 对象列表
limit	int	每页获取的对象数量上限
page	int	所获取的页码
is_last_page	boolean	指示所获取的页是否为最后一页

Issuance Serie

字段	类型	描述
issuance_serie_key	string	发行系列的唯一 key
name	string	发行系列名称
subclass_name	string	子类名称（例如：SUBORDINADA）
serie	int	系列编号
quota_calculation_method	string	份额计算方法（例如：quota_value）
internal_code	string	系列的内部代码
fund_class_name	string	该系列所属基金类别的名称
fund_class_short_name	string	基金类别简称
fund_class_document_number	string	基金类别的 CNPJ
minimum_share_capital	float	最低申购金额
investment_category	string	投资类别（例如：multi_market）
payment_type	string	付款类型（例如：transfer）
condominium_type	string	open_ended（开放式）或 close_ended（封闭式）。只有 open_ended 系列接受赎回。
asset_type	string	资产类型（例如：multi_market_fund_quota）
status	string	created、active、inactive 或 pre_operational
financial_institution_code	string	自动扣款所使用的金融机构代码
account_data	JSON	Account Data 对象
last_updated_date	string	最近更新日期（YYYY-MM-DD）
administrator	JSON	Administrator 对象
operation_periods	JSON	Operation Periods 对象
isin_code	string	系列的 ISIN 代码

Administrator

字段	类型	描述
administrator_key	string	行政管理人的唯一 key
name	string	行政管理人名称
document_number	string	行政管理人的 CNPJ
status	string	active 或 blocked

Operation Periods

字段	类型	描述
redemption_request	JSON	赎回的 份额确认与付款 期限对象
amortization_request	JSON	摊销的 份额确认与付款 期限对象
financial_application	JSON	申购的 份额确认与付款 期限对象

Quotation and Payment

字段	类型	描述
days	int	天数
type	string	计数类型（例如：fixed、until）
calendar_base	string	日历基准（例如：workdays、calendar_365）

Account Data

字段	类型	描述
account_digit	string	银行账户校验位
account_branch	string	银行分行编号
account_number	string	银行账号
financial_institution_code	string	金融机构代码
financial_institution_ispb	string	金融机构的 ISPB（巴西支付系统）

错误

状态码	代码	触发条件
404	TFQ000002	该集成所属的管理人未在平台上注册。

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