申请认购公告

---

简介

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

输入/输出：

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

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

请求

ENDPOINT

/quota_offering_control/investor/INVESTOR_KEY/subscription_note

方法

POST

状态

201

路径参数

参数	描述
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_value	number	认购公告金额。最小值 0。不能超过发行的剩余金额	是
quota_offering_key	string	份额发行的 UUID（36 个字符）。发行必须存在且状态为 active	是
transaction_type	string	ted 或 b3。若为 b3，基金类别必须已注册 B3 账户	是
signature_method	string	签署方式枚举值。若省略，服务将根据主体类型确定：natural_person → qi_sign，legal_person → certifiqi	否
signer_group_key	string	签署人组的 UUID（36 个字符）。若省略，使用投资者的默认签署人组	否

签署方式

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

响应

Response Body

{
  "subscription_note_key": "UUID",
  "status": "created",
  "original_number_of_quotas": 500,
  "original_subscription_note_value": 50000.00,
  "issued_number_of_quotas": 0,
  "remaining_subscription_note_value": 50000.00,
  "start_date": "YYYY-MM-DD",
  "transaction_type": "ted",
  "signature_method": "certifiqi",
  "investor": {
    "distributor": {
      "distributor_key": "UUID",
      "document_number": "00.000.000/0000-00",
      "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": "SENIOR",
        "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",
      "selected_agent": "distributor"
    }
  ]
}

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