Financial Data Update in Operation
This endpoint allows updating the financial data in an operation, following the financial object pattern, which is also sent in the simulation endpoint.
Financial Data Update in Operation (PUT)
Request
ENDPOINT
/commercial_paper/operation/OPERATION-KEY/financialMETHOD
PUTPath Params
| Field | Type | Description | Max Characters |
|---|---|---|---|
OPERATION-KEY * | string | Unique operation key (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
| Field | Type | Description | Max Characters |
|---|---|---|---|
interest_type * | string | Type of interest applied. | interest_type Enumerators |
financial_base_date * | string | Operation base date (format "YYYY-MM-DD"). | - |
released_amount * | number | Total amount released in the operation. | - |
number_of_installments * | integer | Total number of installments. | - |
prefixed_interest_rate * | object | Object containing prefixed interest rate details. | prefixed_interest_rate Object |
fine_delay_rate * | object | Object containing delay penalty details. | fine_delay_rate Object |
contract_fine_rate * | number | Contract penalty applied as percentage. | - |
fees | array | List of fees associated with the operation. | fees Object |
prefixed_interest_rate Object
| Field | Type | Description | Max Characters |
|---|---|---|---|
interest_base * | string | Calculation base for interest. | interest_base Enumerators |
monthly_rate * | number | Monthly interest rate applied. | - |
fine_delay_rate Object
| Field | Type | Description | Max Characters |
|---|---|---|---|
interest_base * | string | Base for penalty calculation. | interest_base Enumerators |
monthly_rate * | number | Monthly penalty rate. | - |
fees Object
| Field | Type | Description | Max Characters |
|---|---|---|---|
amount * | number | Fee amount applied. | - |
amount_type * | string | Type of fee amount. | amount_type Enumerators |
fee_type * | string | Type of fee. | fee_type Enumerators |
type * | string | Fee recipient. | fee_recipient Enumerators |
interest_type Enumerators
| Enum | Description |
|---|---|
pre_price | Prefixed interest in Price model. |
pre_price_days | Prefixed interest in Price model by calendar days. |
pre_sac | Prefixed interest in SAC model. |
post_sac | Post-fixed interest in SAC model. |
interest_base Enumerators
| Enum | Description |
|---|---|
calendar_days | Calendar days base. |
calendar_days_365 | 365 calendar days base. |
workdays | Business days base. |
amount_type Enumerators
| Enum | Description |
|---|---|
percentage | Percentage value. |
absolute | Absolute currency value. |
fee_type Enumerators
| Enum | Description |
|---|---|
bookkeeping_fee | Financed bookkeeping fee. |
structuring_fee | Financed structuring fee. |
fee_recipient Enumerators
| Enum | Description |
|---|---|
internal | Fee paid to the bookkeeper. |
external | Rebate paid to the originator. |
Response
STATUS
200Response 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": [
{
"type": "internal",
"amount": 2.0,
"fee_type": "bookkeeping_fee",
"fee_amount": 20000.0,
"amount_type": "percentage"
},
{
"type": "external",
"amount": 5.0,
"fee_type": "structuring_fee",
"fee_amount": 50000.0,
"amount_type": "percentage"
}
],
"installment_list": [
{
"installment_number": 1,
"workdays": 20,
"calendar_days": 30,
"principal_amortization_unit_price": 0.18122484,
"principal_amortization_amount": 181224.84138231,
"interest_amount": 49298.45861769,
"amount": 230523.3,
"due_principal": 1000000.0,
"due_interest": 0.0,
"due_date": "2025-03-05",
"has_interest": true
},
{
"installment_number": 2,
"workdays": 21,
"calendar_days": 29,
"principal_amortization_unit_price": 0.19153595,
"principal_amortization_amount": 191535.95353305,
"interest_amount": 38987.34646695,
"amount": 230523.3,
"due_principal": 818775.15861769,
"due_interest": 0.0,
"due_date": "2025-04-03",
"has_interest": true
},
{
"installment_number": 3,
"workdays": 19,
"calendar_days": 32,
"principal_amortization_unit_price": 0.19748652,
"principal_amortization_amount": 197486.52331007,
"interest_amount": 33036.77668993,
"amount": 230523.3,
"due_principal": 627239.20508464,
"due_interest": 0.0,
"due_date": "2025-05-05",
"has_interest": true
},
{
"installment_number": 4,
"workdays": 21,
"calendar_days": 29,
"principal_amortization_unit_price": 0.21005991,
"principal_amortization_amount": 210059.90840452,
"interest_amount": 20463.39159548,
"amount": 230523.3,
"due_principal": 429752.68177457,
"due_interest": 0.0,
"due_date": "2025-06-03",
"has_interest": true
},
{
"installment_number": 5,
"workdays": 21,
"calendar_days": 30,
"principal_amortization_unit_price": 0.21969277,
"principal_amortization_amount": 219692.77337005,
"interest_amount": 10830.52662995,
"amount": 230523.3,
"due_principal": 219692.77337005,
"due_interest": 0.0,
"due_date": "2025-07-03",
"has_interest": true
}
]
},
"tags": [],
"investor_list": [
{
"investor_key": "a1a75b66-6f7e-4bcc-9ff5-6f8adf7cae09",
"investor_name": "Ultimate Cascade",
"investor_document_number": "31.424.651/0001-32",
"subscription_percentage": 100.0,
"subscription_quantity": 1000000,
"investor_onboarding_approved": true,
"bank_account": {
"account_type": "checking",
"account_digit": "3",
"account_branch": "0001",
"account_number": "33400254",
"financial_institution_ispb": "32402502",
"financial_institution_code_number": "329"
},
"updated_at": null
}
],
"related_party_list": [
{
"related_party_key": "1ac83d43-41cb-4ad0-a7ca-add6c3a3171c",
"name": "Blue Logic",
"document_number": "97.923.586/0001-06",
"role_type": "issuer",
"is_active": true,
"updated_at": null,
"trading_name": "Blue Logic",
"cnae_code": "47.21-1-02",
"company_type": "ltda",
"foundation_date": "2007-10-25",
"person_type": "legal",
"street": "Rua Romualdo de Souza Brito",
"neighborhood": "Centro",
"number": "89",
"postal_code": "08150-470",
"city": "São Paulo",
"state": "SP",
"complement": "Letra C",
"signer_group_list": [
{
"signer_group_key": "fa2cbede-a501-41e1-bf70-078bb0d4ac7b",
"minimum_required_signers": 1,
"signers": [
{
"name": "John Doe",
"email": "123.456.789-00@yopmail.com",
"phone_number": "+5511988887777",
"document_number": "123.456.789-00",
"is_group_mandatory": true
}
]
}
],
"document_list": [],
"contact_information_list": [
{
"name": "John Doe",
"email": "123.456.789-00@yopmail.com",
"is_default": true,
"phone_number": "+5516982399722",
"document_number": "123.456.789-00",
"issuer_contact_information_key": "6e9714f4-d652-4ca0-89e2-13e9e2ec3414"
}
]
},
{
"related_party_key": "bab03c76-a12a-4d88-aaf8-70799e3b1b30",
"name": "Ultimate Cascade",
"document_number": "31.424.651/0001-32",
"role_type": "investor",
"is_active": true,
"updated_at": null,
"trading_name": "Ultimate Cascade",
"cnae_code": "47.21-1-02",
"company_type": "ltda",
"foundation_date": "2007-10-25",
"person_type": "legal",
"street": "Rua Romualdo de Souza Brito",
"neighborhood": "Centro",
"number": "89",
"postal_code": "08150-470",
"city": "São Paulo",
"state": "SP",
"complement": "Letra C",
"signer_group_list": [
{
"signer_group_key": "ccb36b0b-40b5-42e0-bc41-0e8fce57f3ca",
"minimum_required_signers": 1,
"signers": [
{
"name": "John Doe",
"email": "123.456.789-00@yopmail.com",
"phone_number": "+5516982399722",
"document_number": "123.456.789-00",
"is_group_mandatory": true
}
]
}
],
"document_list": [],
"contact_information_list": [
{
"name": "John Doe",
"email": "123.456.789-00@yopmail.com",
"is_default": true,
"phone_number": "+5511988887777",
"document_number": "123.456.789-00",
"investor_contact_information_key": "26299c0f-2127-45d4-b22e-f2b494d2f7ae"
}
]
}
],
"collateral_list": [
{
"collateral_key": "d8fdb578-1e2a-4b79-8267-5b1763e56754",
"collateral_type": "fiduciary_alienation_property"
}
],
"metadata_list": [
{
"metadata_key": "convenio",
"metadata_value": "12398129038"
}
],
}
Response Body Params
| Field | Type | Description |
|---|---|---|
tenant_key * | string | Unique tenant key. |
operation_key * | string | Unique operation key. |
operation_status * | string | Operation status. |
issuer_key * | string | Unique issuer key. |
issuer_name * | string | Issuer name. |
issuer_document_number * | string | Issuer document. |
financial * | object | financial Object |
financial Response Object
| Field | Type | Description | Max Characters |
|---|---|---|---|
financial_base_date * | string | Financial base date of the operation (format "YYYY-MM-DD"). | - |
issue_amount * | number | Total issued amount of the operation. | - |
released_amount * | number | Net amount released in the operation. | - |
issue_quantity * | integer | Total quantity of units issued. | - |
unit_price * | number | Unit price of the issue. | - |
cet * | number | Total Effective Cost (CET) as percentage. | - |
annual_cet * | number | Annual CET as percentage. | - |
number_of_installments * | integer | Total number of installments. | - |
prefixed_interest_rate * | object | Object containing prefixed interest rate details. | prefixed_interest_rate Object |
fees | array | List of fees associated with the operation. | fees Object |
installments | array | List of installment details generated in the operation. | installments Object |
fine_delay_rate * | object | Object containing delay penalty details. | fine_delay_rate Object |
contract_fine_rate * | number | Contract penalty applied as percentage. | - |
prefixed_interest_rate Object
| Field | Type | Description | Max Characters |
|---|---|---|---|
interest_base * | string | Calculation base for interest. | interest_base Enumerators |
monthly_rate * | number | Monthly interest rate applied. | - |
daily_rate * | number | Daily interest rate applied. | - |
annual_rate * | number | Annual interest rate applied. | - |
fees Object
| Field | Type | Description | Max Characters |
|---|---|---|---|
amount * | number | Percentage value of the fee. | - |
fee_amount * | number | Monetary value corresponding to the fee. | - |
amount_type * | string | Type of fee amount. | amount_type Enumerators |
fee_type * | string | Type of fee. | fee_type Enumerators |
type * | string | Fee recipient. | fee_recipient Enumerators |
installments Object
| Field | Type | Description |
|---|---|---|
installment_number * | integer | Installment number. |
workdays * | integer | Business days until installment due date. |
calendar_days * | integer | Calendar days until installment due date. |
principal_amortization_amount * | number | Principal amortization amount. |
principal_amortization_unit_price * | number | Amortization amount per unit. |
interest_amount * | number | Interest amount applied in the installment. |
amount * | number | Total installment amount. |
due_date * | string | Installment due date (format "YYYY-MM-DD"). |