跳到主要内容

登记商业票据操作

此端点允许根据财务数据和投资人数据创建新的商业票据操作。

Request​

ENDPOINT
/commercial_paper/operation
MÉTODO
POST
Request Body
{
    "issuer_key": "48e2c597-f2ca-487e-9f06-2b628ecb831e",
    "issuer_bank_account": {
        "account_number": "4464541",
        "account_digit": "3",
        "account_branch": "0001",
        "financial_institution_code_number": "329",
        "financial_institution_ispb": "32402502",
        "account_type": "checking"
    },
    "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"
            }
        }
    ],
    "issue_date": "2025-01-23",
    "financial": {
        "interest_type": "pre_price_days",
        "financial_base_date": "2025-01-23",
        "released_amount": 1000000,
        "number_of_installments": 5,
        "prefixed_interest_rate": {
            "interest_base": "calendar_days_365",
            "monthly_rate": 0.05
        },
        "fine_delay_rate": {
            "interest_base": "calendar_days_365",
            "monthly_rate": 0.01
        },
        "contract_fine_rate": 0.02,
        "fees": [
            {
                "amount": 5,
                "amount_type": "percentage",
                "fee_type": "structuring_fee"
            }
        ]
    }
}

Request Body Params​

字段类型描述最大字符数
issuer_key *string发行人的唯一键。-
issuer_bank_account *object发行人的银行账户。issuer_bank_account 对象
investors *array相关投资人列表。investors 对象
issue_date *string操作发行日期（格式："YYYY-MM-DD"）。-
financial *object操作的财务数据。financial 对象

issuer_bank_account 对象​

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

investors 对象​

字段类型描述
investor_key *string投资人的唯一键。
subscription_percentage *number认购比例。
bank_account *object投资人的银行账户。

financial 对象​

字段类型描述
interest_type *string利率类型。
financial_base_date *string财务基准日期（格式："YYYY-MM-DD"）。
released_amountnumber释放金额。
issue_amountnumber发行金额。
number_of_installments *integer期数。
installmentsarrayinstallments 对象
prefixed_interest_rate *objectprefixed_interest_rate 对象
fine_delay_rate *object滞纳金利率。
contract_fine_rate *number合同罚款百分比。
feesarray费用列表。
注意

financial 对象必须包含有效的参数组合才能被处理。接受的组合为：发行/释放金额 + 利率、发行/释放金额 + 每期金额、每期金额 + 利率、发行/释放金额 + 利率 + 每期摊还比例。

installments 对象​

字段类型描述
due_date *string期次到期日（格式："YYYY-MM-DD"）。
amountnumber期次总金额。
principal_amortization_percentagenumber本金摊还百分比值。

prefixed_interest_rate 对象​

字段类型描述
interest_base *string利率计算基础。
daily_ratenumber适用的日利率。
monthly_ratenumber适用的月利率。
annual_ratenumber适用的年利率。

Response​

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

Response Body Params​

字段类型描述
tenant_key *stringtenant 的唯一键。
operation_key *string操作的唯一键。
operation_status *string操作的状态。
issuer_key *string发行人的唯一键。
issuer_name *string发行人的名称。
issuer_document_number *string发行人的证件号码。
financial *objectfinancial 对象

financial response 对象​

字段类型描述最大字符数
financial_base_date *string操作的财务基准日期（格式："YYYY-MM-DD"）。-
issue_amount *number操作发行的总金额。-
released_amount *number操作中释放的净金额。-
issue_quantity *integer发行的总单位数量。-
unit_price *number每单位发行价格。-
cet *number有效总成本（CET）百分比。-
annual_cet *number年化 CET 百分比。-
number_of_installments *integer总期数。-
prefixed_interest_rate *object包含固定利率详情的对象。prefixed_interest_rate 对象
feesarray与操作相关的费用列表。fees 对象
installmentsarray操作中生成的期数详情列表。installments 对象
fine_delay_rate *object包含滞纳金详情的对象。fine_delay_rate 对象
contract_fine_rate *number合同罚款百分比。-

prefixed_interest_rate response 对象​

字段类型描述
interest_base *string利率计算基础。
monthly_ratenumber适用的月利率。
daily_ratenumber适用的日利率。
annual_ratenumber适用的年利率。

fees 对象​

字段类型描述
amount *number费率百分比值。
fee_amount *number对应的货币金额。
amount_type *string费用值类型。
fee_type *string费用类型。
type *string费用收款方。

installments response 对象​

字段类型描述
installment_number *integer期数编号。
workdays *integer至到期日的工作日数。
calendar_days *integer至到期日的自然日数。
principal_amortization_amount *number本金摊还金额。
principal_amortization_unit_price *number每单位摊还金额。
interest_amount *number该期应计利息金额。
amount *number该期总金额。
due_date *string该期到期日（格式："YYYY-MM-DD"）。