跳到主要内容

登记债券操作

此端点通过单个请求创建完整的债券操作。

信息

financial 对象为 必填，且必须以已计算好的形式提交，因为此端点不执行财务模拟。发行人及其银行账户必须事先登记。

Request​

ENDPOINT
/debenture/create_operation
MÉTODO
POST

请求体既可以是仅含 必填字段的负载（包含财务对象），也可以是同时包含关联方的 完整负载。两种变体见下文。

必填字段负载
{
    "tenant_key": "1d29d606-649a-487f-af1c-c0f5cb3e9814",
    "issuer_key": "48e2c597-f2ca-487e-9f06-2b628ecb831e",
    "issue_number": 10,
    "issue_series": 1,
    "issue_date": "2025-01-20",
    "investors": [
        {
            "investor_key": "70b1b638-ca56-4eb3-9a88-2fd5ffd077a7",
            "bank_account": {
                "account_number": "33400254",
                "account_digit": "3",
                "account_branch": "0001",
                "financial_institution_code_number": "329",
                "financial_institution_ispb": "32402502",
                "account_type": "checking"
            }
        }
    ],
    "financial": {
        "financial_base_date": "2025-01-20",
        "interest_type": "pre_price_days",
        "issue_amount": 1075268.82,
        "issue_quantity": 1075268,
        "unit_price": 1.0000007626,
        "released_amount": 1075268.82,
        "cet": 7.7,
        "annual_cet": 143.55,
        "first_due_date": "2025-02-20",
        "number_of_installments": 5,
        "prefixed_interest_rate": {
            "interest_base": "calendar_days_365",
            "monthly_rate": 0.05,
            "daily_rate": 0.0016053474,
            "annual_rate": 0.795856326
        },
        "fine_delay_rate": { "interest_base": "calendar_days_365", "monthly_rate": 0.01 },
        "contract_fine_rate": 0.02,
        "fees": [
            { "amount": 2.0, "fee_amount": 21505.38, "amount_type": "percentage", "fee_type": "bookkeeping_fee", "type": "internal" }
        ],
        "installments": [
            {
                "installment_number": 1,
                "due_date": "2025-02-20",
                "amount": 248113.17,
                "principal_amortization_amount": 193292.79655634,
                "principal_amortization_unit_price": 1.02,
                "interest_amount": 0.0,
                "calendar_days": 31,
                "workdays": 23
            }
        ]
    }
}
完整负载（含关联方）
{
    "tenant_key": "1d29d606-649a-487f-af1c-c0f5cb3e9814",
    "issuer_key": "48e2c597-f2ca-487e-9f06-2b628ecb831e",
    "issue_number": 10,
    "issue_series": 1,
    "contract_number": "DEB-2025-0001",
    "issue_date": "2025-01-20",
    "investors": [
        {
            "investor_key": "70b1b638-ca56-4eb3-9a88-2fd5ffd077a7",
            "subscription_percentage": 100,
            "bank_account": {
                "account_number": "33400254",
                "account_digit": "3",
                "account_branch": "0001",
                "financial_institution_code_number": "329",
                "financial_institution_ispb": "32402502",
                "account_type": "checking"
            }
        }
    ],
    "financial": {
        "financial_base_date": "2025-01-20",
        "interest_type": "pre_price_days",
        "issue_amount": 1075268.82,
        "issue_quantity": 1075268,
        "unit_price": 1.0000007626,
        "released_amount": 1075268.82,
        "cet": 7.7,
        "annual_cet": 143.55,
        "first_due_date": "2025-02-20",
        "number_of_installments": 5,
        "prefixed_interest_rate": {
            "interest_base": "calendar_days_365",
            "monthly_rate": 0.05,
            "daily_rate": 0.0016053474,
            "annual_rate": 0.795856326
        },
        "fine_delay_rate": { "interest_base": "calendar_days_365", "monthly_rate": 0.01 },
        "contract_fine_rate": 0.02,
        "fees": [
            { "amount": 2.0, "fee_amount": 21505.38, "amount_type": "percentage", "fee_type": "bookkeeping_fee", "type": "internal" }
        ],
        "installments": [
            {
                "installment_number": 1,
                "due_date": "2025-02-20",
                "amount": 248113.17,
                "principal_amortization_amount": 193292.79655634,
                "principal_amortization_unit_price": 1.02,
                "interest_amount": 0.0,
                "calendar_days": 31,
                "workdays": 23
            }
        ]
    },
    "related_party_list": [
        {
            "person_type": "legal",
            "name": "Garantidora S.A.",
            "document_number": "12.345.678/0001-90",
            "trading_name": "Garantidora",
            "cnae_code": "64.62-0-00",
            "company_type": "sa",
            "foundation_date": "2010-05-01",
            "street": "Av. Paulista",
            "number": "1000",
            "neighborhood": "Bela Vista",
            "postal_code": "01310-100",
            "city": "São Paulo",
            "state": "SP",
            "role_type": "guarantor"
        },
        {
            "person_type": "natural",
            "name": "João da Silva",
            "document_number": "123.456.789-00",
            "street": "Rua das Flores",
            "number": "123",
            "neighborhood": "Centro",
            "postal_code": "01001-000",
            "city": "São Paulo",
            "state": "SP",
            "role_type": "solidary_debtor",
            "is_pep": false
        }
    ]
}

Request Body Params​

字段类型描述最大字符数
tenant_key *stringtenant 的唯一键。-
issuer_key *string发行人的唯一键（须事先登记）。-
issue_number *integer发行编号。-
issue_series *integer发行系列。-
issue_date *string操作发行日期（格式："YYYY-MM-DD"）。-
investors *array相关投资人列表。investors 对象
financial *object操作的已计算财务数据。financial 对象
contract_numberstring合同编号。-
related_party_listarray操作的关联方（担保人、债务人等）。related_party 对象

investors 对象​

字段类型描述
investor_key *string投资人的唯一键（须事先登记）。
bank_account *object投资人的银行账户（bank_account 对象）。
subscription_percentagenumber认购比例。
subscription_quantitynumber认购数量。

bank_account 对象​

字段类型描述
account_number *string银行账户号码。
account_digit *string银行账户校验位。
account_branch *string银行账户支行。
financial_institution_code_numberstring金融机构代码。
financial_institution_ispb *string金融机构 ISPB 代码。
account_type *string账户类型（checking、savings、salary、payment）。

financial 对象​

字段类型描述
financial_base_date *string财务基准日期（格式："YYYY-MM-DD"）。
interest_type *string利率类型。
issue_amountnumber发行总金额。
issue_quantityinteger发行单位数量。
unit_pricenumber每单位发行价格。
released_amountnumber释放的净金额。
cet / annual_cetnumber有效总成本（月度与年度），百分比。
number_of_installments *integer期数。
prefixed_interest_rate *object固定利率。
fine_delay_rateobject滞纳金利率。
contract_fine_ratenumber合同罚款百分比。
feesarray费用列表。
installmentsarray已计算的期次列表。

related_party_list 中的每一项代表参与该操作的一方。

字段类型描述
person_type *string人员类型（natural 自然人，legal 法人）。
name *string关联方名称。
document_number *stringCPF（自然人）或 CNPJ（法人）。
role_type *string关联方在操作中的角色。role_type 枚举
street *string街道。
number *string门牌号。
neighborhoodstring街区。
postal_code *string邮政编码（格式："00000-000"）。
city *string城市。
state *string州/省（2 个字母）。
complementstring地址补充信息。
is_pepboolean（自然人）是否为政治公众人物。
marital_statusstring（自然人）婚姻状况。
property_systemstring（自然人）财产制度。
birthdatestring（自然人）出生日期。
mother_namestring（自然人）母亲姓名。
occupationstring（自然人）职业。
trading_namestring（法人）商号。
cnae_codestring（法人）CNAE 代码（格式："00.00-0-00"）。
company_typestring（法人）公司类型。
foundation_datestring（法人）成立日期。
注意

必填字段因 person_type 而异：

  • 自然人（natural）：除通用字段外，is_pep 为必填。
  • 法人（legal）：除通用字段外，trading_name、cnae_code、company_type 和 foundation_date 为必填。

role_type 枚举​

枚举值描述
issuer发行人。
investor投资人。
cosigner共同债务人。
fiduciary_debtor信托债务人。
solidary_debtor连带债务人。
guarantor担保人。
bonafide_depositary善意保管人。
intervening_guarantor介入担保人。
intervening_consentor介入同意人。
intervening_discharger介入清偿人。
assignor转让人。
endorser背书人。
consulting咨询方。
fund_administrator基金管理人。
fund_representative基金代表。
company_representative公司代表。
attestant见证人。
debtor债务人。
bestowal授予人。
manager管理人。
提示

担保和基础资产在操作创建后通过 单独的端点 提交。请参阅本节的 提交担保 页面。

Response​

STATUS
201
Response Body
{
    "tenant_key": "1d29d606-649a-487f-af1c-c0f5cb3e9814",
    "operation_key": "a846cc4a-b542-4f66-9823-b6d5458bd127",
    "operation_status": "finished",
    "issuer_key": "48e2c597-f2ca-487e-9f06-2b628ecb831e",
    "issuer_name": "Dynamic Enterprises",
    "issuer_document_number": "28980395000155",
    "issue_number": 10,
    "issue_series": 1,
    "related_party_list": [ ... ],
    "financial": { ... }
}

响应返回所创建操作的完整 JSON，包括 operation_key、投资人与关联方列表，以及已计算的财务对象。