跳到主要内容

更新操作的财务数据

此端点允许更新操作中的财务数据，遵循与模拟端点中发送的 financial 对象相同的标准。

更新操作的财务数据 (PUT)​

Request​

ENDPOINT
/commercial_paper/operation/OPERATION-KEY/financial
MÉTODO
PUT

Path Params​

字段类型描述最大字符数
OPERATION-KEY *string操作的唯一键（UUID v4）。36
Request Body
{
    "interest_type": "pre_price_days",
    "financial_base_date": "2025-02-03",
    "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",
            "type": "external"
        }
    ]
}

Request Body Params​

字段类型描述最大字符数
interest_type *string适用的利率类型。interest_type 枚举
financial_base_date *string操作基准日期（格式："YYYY-MM-DD"）。-
released_amount *number操作释放的总金额。-
number_of_installments *integer总期数。-
prefixed_interest_rate *object包含固定利率详情的对象。prefixed_interest_rate 对象
fine_delay_rate *object包含滞纳金详情的对象。fine_delay_rate 对象
contract_fine_rate *number合同罚款百分比。-
feesarray与操作相关的费用列表。fees 对象

prefixed_interest_rate 对象​

字段类型描述最大字符数
interest_base *string利率计算基础。interest_base 枚举
monthly_rate *number适用的月利率。-

fine_delay_rate 对象​

字段类型描述最大字符数
interest_base *string罚款计算基础。interest_base 枚举
monthly_rate *number月罚款率。-

fees 对象​

字段类型描述最大字符数
amount *number适用的费率值。-
amount_type *string费用值类型。amount_type 枚举
fee_type *string费用类型。fee_type 枚举
type *string费用收款方。fee_recipient 枚举

interest_type 枚举​

枚举值描述
pre_pricePrice 模型的固定利率。
pre_price_days按自然日计算的 Price 模型固定利率。
pre_sacSAC 模型的固定利率。
post_sacSAC 模型的浮动利率。

interest_base 枚举​

枚举值描述
calendar_days自然日基础。
calendar_days_365365 自然日基础。
workdays工作日基础。

amount_type 枚举​

枚举值描述
percentage百分比值。
absolute货币绝对值。

fee_type 枚举​

枚举值描述
bookkeeping_fee融资书写费。
structuring_fee融资结构费。

fee_recipient 枚举​

枚举值描述
internal支付给书写方的费用。
external支付给发起方的返佣。

Response​

STATUS
200
Response Body
{
    "tenant_key": "13a6a1d5-7a3c-4627-a0a6-9fd746662ca4",
    "operation_key": "dc368e4d-c288-4971-ad8d-5c9c31616e74",
    "operation_type": "commercial_paper",
    "operation_status": "issued",
    "backoffice_analysis_status": "approved",
    "issuer_key": "9e08fd62-ce43-4c95-99e0-4386e980d618",
    "issuer_name": "Blue Logic",
    "issuer_document_number": "97.923.586/0001-06",
    "issuer_bank_account": {
        "account_type": "checking",
        "account_digit": "3",
        "account_branch": "0001",
        "account_number": "4464541",
        "financial_institution_ispb": "32402502",
        "financial_institution_code_number": "329"
    },
    "issuer_onboarding_approved": true,
    "issue_number": 1,
    "issue_series": 1,
    "contract_number": "0000000001",
    "issue_date": "2025-02-03",
    "financial_base_date": "2025-02-03",
    "commercial_paper_template_key": "68956441-d46c-44ed-93b9-b1806dd6ada9",
    "commercial_paper_document_key": "dc368e4d-c288-4971-ad8d-5c9c31616e74/commercial_paper/2cb87abc-8bdf-4df3-be98-b7afb53b14c8",
    "adhesion_term_template_key": "58743ab9-99bd-439a-93af-16e4c5fccd6f",
    "adhesion_term_document_key": "dc368e4d-c288-4971-ad8d-5c9c31616e74/adhesion_term/fe74eaed-2f44-45b4-b972-83fa222cbf1c",
    "envelope_signature_status": "signed",
    "envelope_key": "4d7f28b4-185f-482d-929e-d1af937cb27b",
    "envelope_signature_url": "https://sandbox.certifiqi.com.br/sign?batch-group=c4747fe6-2cc0-41a9-8972-84b44f8fff8a",
    "envelope_signed_files_key": "dc368e4d-c288-4971-ad8d-5c9c31616e74/signed_files",
    "financial": {
        "financial_base_date": "2025-02-03",
        "issue_quantity": 1000000,
        "unit_price": 1.0,
        "issue_amount": 1000000.0,
        "released_amount": 1000000.0,
        "cet": 5.0,
        "annual_cet": 79.59,
        "number_of_installments": 5,
        "prefixed_interest_rate": {
            "daily_rate": 0.0016053474,
            "annual_rate": 0.795856326,
            "monthly_rate": 0.05,
            "interest_base": "calendar_days_365"
        },
        "fine_delay_rate": {
            "monthly_rate": 0.01,
            "interest_base": "calendar_days_365"
        },
        "contract_fine_rate": 0.02,
        "financial_index": null,
        "post_fixed_interest_rate": null,
        "fees": [],
        "installment_list": []
    },
    "tags": [],
    "investor_list": [],
    "related_party_list": [],
    "collateral_list": [],
    "metadata_list": []
}

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 对象​

字段类型描述最大字符数
interest_base *string利率计算基础。interest_base 枚举
monthly_rate *number适用的月利率。-
daily_rate *number适用的日利率。-
annual_rate *number适用的年利率。-

fees 对象​

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

installments 对象​

字段类型描述
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"）。