获取发行信息
以分页方式列出某基金类别的份额发行。
适用范围
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 读取 |
各主机的 Base URL:环境(主机)。
Request
ENDPOINT
/quota_offering_control/fund_class/FUND_CLASS_KEY/quota_offeringsMÉTODO
GETSTATUS
200Query Params
| 参数 | 描述 |
|---|---|
limit | 每页条目数。默认 50,最大 500 |
page | 页码,从 0 开始。默认 0 |
sub_class_key | 子类别唯一标识键 |
issuance_serie_key | 发行系列唯一标识键 |
showOffers | active:仅返回有剩余金额的有效发行。closed:已关闭或已过到期日的发行 |
Responses
案例 01:有发行的基金
{
"data":[
{
"quota_offering_key":"UUID",
"status":"active",
"original_quota_offering_value":0.00,
"issued_number_of_quotas":0.00000000,
"remaining_quota_offering_value":0.00,
"start_date":"YYYY-MM-DD",
"issuance_serie":{
"name":"1",
"issuance_serie_key":"UUID",
"sub_class":{
"name":"SÊNIOR",
"sub_class_key":"UUID",
"subordination_level":1,
"fund_class":{
"fund_class_key":"UUID",
"name":"SAMPLE FUND CLASS NAME",
"document_number":"00.000.000/0000-00",
"short_name":"SAMPLE FUND CLASS SHORT NAME"
}
},
"classification":"general / qualified / professional",
"market_type":"primary / secondary"
},
"type":"public / private",
"subscription_note_template_key":"UUID",
"subscription_note_generation_type":"internal / external",
"regulatory_type":"exclusive_fund",
"cvm_registration":{
"date":"YYYY-MM-DD",
"number":"AAA/BBB/CCC/DDD/EEE/YYYY/000"
},
"lead_coordinator":{
"name":"SAMPLE LEAD COORDINATOR NAME",
"address":{
"uf":"SP",
"city":"São Paulo",
"number":"0000",
"street":"Sample street name",
"complement":"Sample complement"
},
"document_number":"00.000.000/0000-00"
},
"status_events":[
{
"status":"active",
"event_datetime":"YYYY-MM-DD HH:MM:SS"
}
]
}
],
"limit":50,
"page":0,
"is_last_page":true
}
案例 02:没有发行的基金
{
"data":[],
"limit":50,
"page":0,
"is_last_page":true
}
Response Fields
| 字段 | 类型 | 描述 |
|---|---|---|
data | array | Quota Offering 对象列表 |
limit | int | 每页返回的对象数量上限 |
page | int | 返回的页码 |
is_last_page | boolean | 表示返回的页面是否为最后一页 |
Quota Offering
| 字段 | 类型 | 描述 |
|---|---|---|
quota_offering_key | string | 发行唯一标识键 |
status | string | created / active / processing_closing / pending_closing_at_cvm / pending_closing_at_anbima / pending_divulgation / closed |
subscription_note_generation_type | string | internal(文件由 QI 生成)/ external |
subscription_note_template_key | string | 认购公告模板键 |
regulatory_type | string | 发行的监管类型 |
status_events | array | 状态历史(status、event_datetime) |
original_quota_offering_value | float | 发行原始金额 |
issued_number_of_quotas | float | 已认购份额数量 |
remaining_quota_offering_value | float | 发行剩余金额 |
start_date | string | 发行起始日期 |
issuance_serie | string | Issuance Serie 对象 |
type | string | 公开/私募发行类型 |
cvm_registration | JSON | CVM 登记数据。未填写时不返回 |
lead_coordinator | JSON | 牵头协调人数据。未填写时不返回 |
maturity_date | string | 到期日期。未填写时不返回 |
original_number_of_quotas | float | 原始份额数量。未填写时不返回 |
cvm_registration
{
"date":"YYYY-MM-DD",
"number":"AAA/BBB/CCC/DDD/EEE/YYYY/000"
}
lead_coordinator
{
"name":"SAMPLE LEAD COORDINATOR NAME",
"address":{
"uf":"SP",
"city":"São Paulo",
"number":"0000",
"street":"Sample street name",
"complement":"Sample complement"
},
"document_number":"00.000.000/0000-00"
}
Issuance Serie
| 字段 | 类型 | 描述 |
|---|---|---|
name | string | 发行系列名称 |
issuance_serie_key | string | 发行系列唯一标识键 |
sub_class | JSON | Sub Class 对象 |
classification | string | 专业 / 合格 / 普通 |
market_type | string | 一级 / 二级 |
serie | integer | 发行系列在子类别内的顺序编号(1、2、3……),同一子类别内不重复 |
Sub Class
| 字段 | 类型 | 描述 |
|---|---|---|
name | string | 子类别名称 |
sub_class_key | string | 子类别唯一标识键 |
subordination_level | int | 子类别从属级别 |
fund_class | JSON | Fund Class 对象 |
Fund Class
| 字段 | 类型 | 描述 |
|---|---|---|
name | string | 基金类别名称 |
fund_class_key | string | 基金类别唯一标识键 |
document_number | string | 基金类别 CNPJ |
short_name | string | 基金类别简称 |
错误
| 状态 | 代码 | 发生情形 |
|---|---|---|
| 400 | QIT000004 | 该基金类别不由该管理人管理 |
| 404 | QOF000007 | 未找到基金类别 |
认证、权限和主机相关错误:参见 API 错误。