发送已签署认购公告
简介
本资源旨在向我 们发送投资者对某基金份额发行的认购公告签署证明。
注意
本资源仅适用于担任分销商角色的集成。请使用分销商配置文件的 API 密钥和主机:参见 环境(主机)。
Input / Output:
作为输入,需发送认购信息、投资者所认购的份额发行 UUID、签署方式,以及根据签署方式进行验证所需的内容。示例如下。
作为输出,将返回所创建认购公告的完整对象,其中包含用于标识该认购公告的 subscription_note_key。认购公告创建时即为 active 状态(若 remaining_subscription_note_value 为零,则为 sold_off)。
Request
ENDPOINT
/quota_offering_control/investor/INVESTOR_KEY/signed_subscription_noteMÉTODO
POSTSTATUS
201Request body
请求体
{
"number_of_quotas": 500.0,
"original_subscription_note_value": 50000.00,
"start_date": "2026-01-15",
"maturity_date": "2026-12-31",
"quota_offering_key": "UUID",
"transaction_type": "ted",
"signature_method": "opt_in",
"opt_in_hash" : "OPT_IN_HASH"
}
| 字段 | 类型 | 描述 | 必填 |
|---|---|---|---|
original_subscription_note_value | number | 认购公告金额。最小值为 0。不得超过发行的剩余金额 | 是 |
quota_offering_key | string | 份额发行的 UUID。该发行必须为 active 状态、有剩余金额,且没有待处理的补充协议 | 是 |
transaction_type | string | ted 或 b3 | 是 |
signature_method | string | 所用签署方式。使用 opt_in 时发送 opt_in_hash;使用其他任何方式时发送 document_b64 | 是 |
opt_in_hash | string | opt-in 哈希值(最多 250 个字符) | 否 |
document_b64 | string | 以 base64 编码的已签署认购公告 | 否 |
number_of_quotas | number | 认购公告的份额数量 | 否 |
remaining_subscription_note_value | number | 认购公告剩余余额。不得大于 original_subscription_note_value | 否 |
start_date | string | 开始日期(YYYY-MM-DD)。如省略,则使用当前日期(UTC) | 否 |
maturity_date | string | 到期日期(YYYY-MM-DD)。不得为过去的日期 | 否 |
注意
在集成过程中,将要求提供对所发送哈希值进行认证的方式。
Response
响应格式与申请认购公告的响应相同。
错误
| 状态 | 代码 | 发生情形 |
|---|---|---|
| 400 | QOF000020 | maturity_date 为过去的日期 |
| 400 | QOF000026 | 认购公告金额大于发行的剩余金额 |
| 400 | QOF000046 | transaction_type 无效 |
| 400 | QOF000047 | 投资者分类不允许认购该发行 |
| 400 | QOF000068 | signature_method 无效 |
| 400 | QOF000069 | signature_method 为 opt_in,但未发送 opt_in_hash |
| 400 | QOF000072 | signature_method 不是 opt_in,但未发送 document_b64 |
| 400 | QOF000150 | remaining_subscription_note_value 大于 original_subscription_note_value |
| 400 | QIT000004 | 该集成不是该投资者的分销商 |
| 404 | QOF000017 | 未找到投资者 |
| 404 | QOF000019 | 未找到份额发行 |
| 404 | QOF000039 | 该发行未激活、已到期或没有剩余金额 |
| 409 | QOF000152 | 该发行有一份待审批的补充协议 |
认证、权限和主机相关错误:参见 API 错误。