跳到主要内容

申请认购公告


简介​

本资源旨在为投资者创建对某基金份额发行的认购公告申请。基于此申请,系统将根据发行中配置的生成类型生成认购公告文件。

Input / Output:​

作为输入,需发送投资者所认购的份额发行 UUID、认购公告金额、交易类型,以及可选的签署方式和签署人组。示例如下。

作为输出,将返回所创建认购公告的完整对象,其中包含 subscription_note_key。subscription_note_key 用于标识认购公告。

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

该发行必须属于该管理人的基金。各主机的 Base URL:环境(主机)。

Request​

ENDPOINT
/quota_offering_control/investor/INVESTOR_KEY/subscription_note
MÉTODO
POST
STATUS
201

Path Params​

参数描述
INVESTOR_KEY投资者的 UUID

Request body​

请求体
{
"original_subscription_note_value": 50000.00,
"quota_offering_key": "UUID",
"transaction_type": "ted",
"signature_method": "certifiqi",
"signer_group_key": "UUID"
}

Subscription Note​

字段类型描述必填
original_subscription_note_valuenumber认购公告金额。最小值为 0。不得超过发行的剩余金额是
quota_offering_keystring份额发行的 UUID(36 个字符)。该发行必须存在且状态为 active是
transaction_typestringted 或 b3。使用 b3 时,基金类别必须已登记 B3 账户是
signature_methodstring签署方式枚举值。如省略,将根据主体类型确定:natural_person → qi_sign,legal_person → certifiqi否
signer_group_keystring签署人组的 UUID(36 个字符)。如省略,则使用投资者的默认签署人组否
number_of_quotasnumber认购公告的份额数量。最小值为 0否
start_datestring认购公告开始日期(YYYY-MM-DD)。如省略,则使用当前日期(UTC)否
maturity_datestring认购公告到期日期(YYYY-MM-DD)。不得为过去的日期否

Signature Method​

枚举值描述
certifiqi通过 CertifiQi 签署(数字证书)
qi_sign通过 QI Sign 签署(电子签名)

Response​

响应体
{
"subscription_note_key": "UUID",
"status": "send_to_generate_document",
"original_number_of_quotas": 500,
"original_subscription_note_value": 50000.00,
"issued_number_of_quotas": 0,
"remaining_subscription_note_value": 50000.00,
"total_assignment_value": 0.00,
"start_date": "YYYY-MM-DD",
"transaction_type": "ted",
"signature_method": "certifiqi",
"investor": {
"distributor": {
"distributor_key": "UUID",
"document_number": "11.222.333/0001-81",
"name": "SAMPLE DISTRIBUTOR NAME"
},
"investor_key": "UUID",
"name": "SAMPLE INVESTOR NAME",
"person_type": "natural_person / legal_person",
"document_number": "00.000.000/0000-00"
},
"quota_offering": {
"quota_offering_key": "UUID",
"status": "active",
"original_quota_offering_value": 10000000.00,
"issued_number_of_quotas": 25000.00,
"remaining_quota_offering_value": 7500000.00,
"start_date": "YYYY-MM-DD",
"issuance_serie": {
"name": "1",
"issuance_serie_key": "UUID",
"external_id": "SERIE-001",
"sub_class": {
"name": "SÊNIOR",
"sub_class_key": "UUID",
"subordination_level": 1,
"fund_class": {
"fund_class_key": "UUID",
"document_number": "00.000.000/0000-00",
"name": "SAMPLE FUND CLASS NAME",
"short_name": "SAMPLE FUND CLASS SHORT NAME",
"manager": {
"name": "SAMPLE MANAGER NAME",
"manager_key": "UUID",
"document_number": "00.000.000/0000-00"
},
"administrator": {
"name": "SAMPLE ADMINISTRATOR NAME",
"administrator_key": "UUID",
"document_number": "00.000.000/0000-00",
"data": {}
},
"b3_account": "123456"
}
},
"classification": "general / qualified / professional",
"market_type": "primary / secondary",
"serie": 1,
"issuance_serie_configuration": {}
},
"type": "public / private",
"subscription_note_template_key": "UUID",
"subscription_note_generation_type": "internal / external",
"regulatory_type": "exclusive_fund",
"maturity_date": "YYYY-MM-DD",
"status_events": [
{
"status": "created",
"event_datetime": "YYYY-MM-DD HH:MM:SS"
},
{
"status": "active",
"event_datetime": "YYYY-MM-DD HH:MM:SS"
}
]
},
"financial_application_events": [],
"status_events": [
{
"status": "created",
"event_datetime": "YYYY-MM-DD HH:MM:SS"
},
{
"status": "send_to_generate_document",
"event_datetime": "YYYY-MM-DD HH:MM:SS"
}
]
}

Quota Offering、Investor 和 Financial Application Event 对象的详细说明请参阅 认购公告信息 页面。

当发行在内部生成文件时(subscription_note_generation_type: internal),认购公告创建时为 send_to_generate_document 状态;外部生成时则为 pending_manual_inputs。maturity_date 和 original_number_of_quotas 仅在有值时才出现在响应中。

错误​

状态代码发生情形
400QIT000004该发行不属于该管理人的基金
400QOF000020maturity_date 为过去的日期
400QOF000026认购公告金额大于发行的可用金额
400QOF000043未找到投资者注册信息
400QOF000046transaction_type 不是 ted 或 b3
400QOF000047投资者分类不允许认购该发行
400QOF000076投资者在该发行中已有两份有效的认购公告
400QOF000082投资者注册信息已过期
400QOF000090投资者在该发行的系列中已有一份未签署的有效认购公告
400QOF000103投资者没有签署人组(或 signer_group_key 不存在)
400QOF000104该发行为专属发行,且投资者不在允许的投资者之列
400QOF000130投资者注册处于非运营状态
404QOF000017未找到投资者
404QOF000019未找到份额发行
404QOF000039该发行未激活、已到期或没有剩余金额
404QOF000053transaction_type 为 b3,但基金类别未登记 B3 账户
404QOF000073未找到 signature_method
409QOF000025投资者在该发行的系列中已有一份待签署的认购公告
409QOF000152该发行有一份待审批的补充协议

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