查询认购

此端点允许查询进行中的认购。

---

查询认购 (GET)

Request

ENDPOINT

/integralization/integralization_process/INTEGRALIZATION-KEY/subscription/SUBSCRIPTION-KEY

MÉTODO

GET

Path Params

字段	类型	描述	字符数
INTEGRALIZATION-KEY	string	认缴的唯一键（UUID v4）。	36
SUBSCRIPTION-KEY	string	认购的唯一键（UUID v4）。	36

---

Response

STATUS

201

Response Body

{
    "subscription_key": "2f7e00b5-988f-4214-bb46-4728d9081148",
    "investor_key": "a76e408a-c733-4a68-963a-dc93ff0bc3e3",
    "investor_name": "Global Enterprises",
    "investor_document_number": "89206257000108",
    "investor_bank_account": {
        "account_digit": "0",
        "account_branch": "1234",
        "account_number": "12345678",
        "financial_institution_ispb": "12345678",
        "financial_institution_code_number": "001"
    },
    "subscription_date": "2025-01-27",
    "financial_base_date": "2025-01-27",
    "subscripted_quantity": 1000000,
    "unit_price": 1.0,
    "expected_amount": 1000000.0,
    "paid_amount": 1000000.0,
    "subscription_note_template_key": "6d4c5168-b7c7-4092-9931-4c76aea6af80",
    "subscription_note_document_key": "5ea88fca-4ca3-4dfe-aea4-35e431aef3c5/2f7e00b5-988f-4214-bb46-4728d9081148/subscription_note/f206d799-cb94-48d5-81c5-5988ecef8079",
    "envelope_signature_status": "pending_creation",
    "envelope_signature_url": "https://certifiqi.com.br/envelope_key",
    "envelope_key": "6d4c5168-b7c7-4092-9931-4c76aea6af80",
    "subscription_payment_list": []
}

---

Response Body Params

字段	类型	描述
subscription_key	string	认购的唯一键（UUID v4）。
investor_key	string	与认购关联的投资人唯一键（UUID v4）。
investor_name	string	投资人名称。
investor_document_number	string	投资人证件号码（CPF 或 CNPJ）。
investor_bank_account	object	investor_bank_account 对象。
subscription_date	string	认购日期（格式：YYYY-MM-DD）。
financial_base_date	string	认购财务基准日期（格式：YYYY-MM-DD）。
subscripted_quantity	integer	已认购的股份数量。
unit_price	number	已认购股份的单价。
expected_amount	number	认购预期总金额。
paid_amount	number	认购已支付总金额。
subscription_note_template_key	string	认购公告模板的唯一键（UUID v4）。
subscription_note_document_key	string	认购公告文件的唯一键。
envelope_signature_status	string	认购公告签名状态。
envelope_signature_url	string	认购公告签名 URL。
envelope_key	string	签名信封键。
subscription_payment_list	array	与认购关联的付款列表。subscription_payment_list 对象。

---

investor_bank_account 对象

字段	类型	描述
account_number	string	投资人银行账户号码。
account_digit	string	投资人银行账户校验位。
account_branch	string	投资人银行支行。
financial_institution_code_number	string	投资人金融机构代码。
financial_institution_ispb	string	投资人金融机构 ISPB。

subscription_payment_list 对象

字段	类型	描述
subscription_payment_key	string	认购付款的唯一键（UUID v4）。
payment_receipt_document_key	string	付款凭证文件键。
description	string	付款凭证说明。
amount	number	已登记的付款金额。
subscription_payment_status	string	付款状态。可能的值：waiting_confirmation、confirmed、denied。
updated_at	string	付款最后更新日期和时间（格式：ISO 8601）。