Atualização de dados dos investidores na Operação
Este endpoint permite a atualização dos dados dos investidores em uma operação.
Atualização de dados dos investidores na Operação (PUT)
Request
ENDPOINT
/commercial_paper/operation/OPERATION-KEY/investorsMÉTODO
PUTPath Params
| Campo | Tipo | Descrição | Caracteres Máx. |
|---|---|---|---|
OPERATION-KEY * | string | Chave única da operação (UUID v4). | 36 |
Request Body
{
"investors": [
{
"investor_key": "a1a75b66-6f7e-4bcc-9ff5-6f8adf7cae09",
"investor_name": "Ultimate Cascade",
"investor_document_number": "31.424.651/0001-32",
"subscription_quantity": 1000000,
"bank_account": {
"account_type": "checking",
"account_digit": "3",
"account_branch": "0001",
"account_number": "33400254",
"financial_institution_ispb": "32402502",
"financial_institution_code_number": "329"
}
}
]
}
Request Body Params
Objeto investors
| Campo | Tipo | Descrição |
|---|---|---|
investor_key * | string | Chave única do investidor. |
subscription_percentage * | number | Percentual de subscrição. |
bank_account * | object | Conta bancária do investidor. |
Objeto bank_account
| Campo | Tipo | Descrição |
|---|---|---|
account_number * | string | Número da conta bancária. |
account_digit * | string | Dígito da conta bancária. |
account_branch * | string | Agência da conta bancária. |
financial_institution_code_number * | string | Código da instituição financeira. |
financial_institution_ispb * | string | Código ISPB da instituição financeira. |
account_type * | string | Tipo da conta (checking, savings). |
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
| Campo | Tipo | Descrição |
|---|---|---|
tenant_key * | string | Chave única do tenant. |
operation_key * | string | Chave única da operação. |
operation_status * | string | Status da operação. |
issuer_key * | string | Chave única do emissor. |
issuer_name * | string | Nome do emissor. |
issuer_document_number * | string | Documento do emissor. |
financial * | object | Objeto financial |
Objeto financial response
| Campo | Tipo | Descrição | Caracteres Máx. |
|---|---|---|---|
financial_base_date * | string | Data base financeira da operação (formato "YYYY-MM-DD"). | - |
issue_amount * | number | Valor total emitido da operação. | - |
released_amount * | number | Valor líquido liberado na operação. | - |
issue_quantity * | integer | Quantidade total de unidades emitidas. | - |
unit_price * | number | Preço unitário da emissão. | - |
cet * | number | Custo Efetivo Total (CET) em percentual. | - |
annual_cet * | number | CET anual em percentual. | - |
number_of_installments * | integer | Número total de parcelas. | - |
prefixed_interest_rate * | object | Objeto contendo detalhes da taxa de juros prefixada. | Objeto prefixed_interest_rate |
fees | array | Lista de taxas associadas à operaç ão. | Objeto fees |
installments | array | Lista de detalhes das parcelas geradas na operação. | Objeto installments |
fine_delay_rate * | object | Objeto contendo detalhes da multa por atraso. | Objeto fine_delay_rate |
contract_fine_rate * | number | Multa contratual aplicada em percentual. | - |
Objeto prefixed_interest_rate
| Campo | Tipo | Descrição | Caracteres Máx. |
|---|---|---|---|
interest_base * | string | Base de cálculo para os juros. | Enumeradores interest_base |
monthly_rate * | number | Taxa de juros mensal aplicada. | - |
daily_rate * | number | Taxa de juros diária aplicada. | - |
annual_rate * | number | Taxa de juros anual aplicada. | - |
Objeto fees
| Campo | Tipo | Descrição | Caracteres Máx. |
|---|---|---|---|
amount * | number | Valor percentual da taxa. | - |
fee_amount * | number | Valor monetário correspondente à taxa. | - |
amount_type * | string | Tipo do valor da taxa. | Enumeradores amount_type |
fee_type * | string | Tipo da taxa. | Enumeradores fee_type |
type * | string | Destinatário da taxa. | Enumeradores fee_recipient |
Objeto installments
| Campo | Tipo | Descrição |
|---|---|---|
installment_number * | integer | Número da parcela. |
workdays * | integer | Dias úteis até o vencimento da parcela. |
calendar_days * | integer | Dias corridos até o vencimento da parcela. |
principal_amortization_amount * | number | Valor amortizado do principal. |
principal_amortization_unit_price * | number | Valor amortizado por unidade. |
interest_amount * | number | Valor dos juros aplicados na parcela. |
amount * | number | Valor total da parcela. |
due_date * | string | Data de vencimento da parcela (formato "YYYY-MM-DD"). |