跳到主要内容

发送已签署认购公告


简介​

本资源旨在向我们发送投资者对某基金份额发行的认购公告签署证明。

注意

本资源仅适用于担任分销商角色的集成。请使用分销商配置文件的 API 密钥和主机:参见 环境(主机)。

Input / Output:​

作为输入,需发送认购信息、投资者所认购的份额发行 UUID、签署方式,以及根据签署方式进行验证所需的内容。示例如下。

作为输出,将返回所创建认购公告的完整对象,其中包含用于标识该认购公告的 subscription_note_key。认购公告创建时即为 active 状态(若 remaining_subscription_note_value 为零,则为 sold_off)。

Request​

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

Request 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_valuenumber认购公告金额。最小值为 0。不得超过发行的剩余金额是
quota_offering_keystring份额发行的 UUID。该发行必须为 active 状态、有剩余金额,且没有待处理的补充协议是
transaction_typestringted 或 b3是
signature_methodstring所用签署方式。使用 opt_in 时发送 opt_in_hash;使用其他任何方式时发送 document_b64是
opt_in_hashstringopt-in 哈希值(最多 250 个字符)否
document_b64string以 base64 编码的已签署认购公告否
number_of_quotasnumber认购公告的份额数量否
remaining_subscription_note_valuenumber认购公告剩余余额。不得大于 original_subscription_note_value否
start_datestring开始日期(YYYY-MM-DD)。如省略,则使用当前日期(UTC)否
maturity_datestring到期日期(YYYY-MM-DD)。不得为过去的日期否
注意

在集成过程中,将要求提供对所发送哈希值进行认证的方式。

Response​

响应格式与申请认购公告的响应相同。

错误​

状态代码发生情形
400QOF000020maturity_date 为过去的日期
400QOF000026认购公告金额大于发行的剩余金额
400QOF000046transaction_type 无效
400QOF000047投资者分类不允许认购该发行
400QOF000068signature_method 无效
400QOF000069signature_method 为 opt_in,但未发送 opt_in_hash
400QOF000072signature_method 不是 opt_in,但未发送 document_b64
400QOF000150remaining_subscription_note_value 大于 original_subscription_note_value
400QIT000004该集成不是该投资者的分销商
404QOF000017未找到投资者
404QOF000019未找到份额发行
404QOF000039该发行未激活、已到期或没有剩余金额
409QOF000152该发行有一份待审批的补充协议

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