Consulta de Operação por Chave
Este endpoint permite consultar os detalhes completos de uma operação específica, utilizando sua chave única.
Consulta de Operação (GET)
Request
ENDPOINT
/commercial_paper/operation/OPERATION-KEYMÉTODO
GETPath Params
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
OPERATION-KEY | string | Chave única da operação (UUID v4). | 36 |
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": "implementation_fee",
"fee_amount": 20000.0,
"amount_type": "percentage"
},
{
"type": "external",
"amount": 5.0,
"fee_type": "implementation_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": "real_estate",
"collateral_data": {
"value": 999
}
}
],
"metadata_list": [
{
"metadata_key": "convenio",
"metadata_value": "12398129038"
}
],
"integralization_key": "d8fdb578-1e2a-4b79-8267-5b1763e56754",
"security_key": "26299c0f-2127-45d4-b22e-f2b494d2f7ae"
}
Response Body Params
Campo | Tipo | Descrição | Caracteres Máx. |
---|---|---|---|
tenant_key * | string | Chave única do tenant (UUID v4). | 36 |
operation_key * | string | Chave única da operação (UUID v4). | 36 |
operation_type * | string | Tipo da operação. commercial_paper | - |
operation_status * | string | Status da operação. | Enumeradores operation_status |
issuer_key * | string | Chave única do emissor (UUID v4). | 36 |
issuer_name * | string | Nome do emissor. | - |
issuer_document_number * | string | Número do documento do emissor (CNPJ). | 18 |
issuer_bank_account * | object | Dados bancários do emissor. | Objeto bank_account |
issuer_onboarding_approved * | boolean | Indica se o onboarding do emissor foi aprovado. | - |
issue_number * | integer | Número da emissão. | - |
issue_series * | integer | Série da emissão. | - |
contract_number * | string | Número do contrato. | - |
issue_date * | string | Data da emissão (formato ISO 8601). | - |
financial_base_date * | string | Data base financeira da operação (formato ISO 8601). | - |
commercial_paper_template_key * | string | Chave única do template do commercial paper. | 36 |
commercial_paper_document_key * | string | Chave do documento do commercial paper. | - |
adhesion_term_template_key * | string | Chave única do template do termo de adesão. | 36 |
adhesion_term_document_key * | string | Chave do documento do termo de adesão. | - |
investor_list * | object | Lista de investidores. | Objeto investor |
Objeto bank_account
Campo | Tipo | Descrição | Caracteres Máx. |
---|---|---|---|
account_type * | string | Tipo da conta (ex: checking). | - |
account_digit * | string | Dígito da conta bancária. | - |
account_branch * | string | Agência bancária. | - |
account_number * | string | Número da conta bancária. | - |
financial_institution_ispb * | string | Código ISPB da instituição financeira. | - |
financial_institution_code_number * | string | Código da instituição financeira. | - |
Objeto financial
Campo | Tipo | Descrição | Caracteres Máx. |
---|---|---|---|
financial_base_date * | string | Data base financeira da operação (formato ISO 8601). | - |
issue_quantity * | integer | Quantidade total de unidades emitidas. | - |
unit_price * | float | Preço unitário da emissão. | - |
issue_amount * | float | Valor total da emissão. | - |
released_amount * | float | Valor total liberado. | - |
cet * | float | Custo Efetivo Total da operação (%). | - |
annual_cet * | float | Custo Efetivo Total anualizado (%). | - |
number_of_installments * | integer | Número total de parcelas da operação. | - |
prefixed_interest_rate * | object | Taxa de juros prefixada. | Objeto prefixed_interest_rate |
fine_delay_rate * | object | Taxa de multa por atraso | Objeto fine_delay_rate. |
contract_fine_rate * | float | Taxa de multa contratual (%). | - |
financial_index | string | Índice financeiro de referência (caso exista). | - |
post_fixed_interest_rate | object | Taxa de juros pós-fixada (se aplicável). | - |
fees * | array | Lista de taxas aplicáveis. | Objeto fees |
installment_list * | array | Lista de parcelas. | Objeto installment |
Objeto prefixed_interest_rate
Campo | Tipo | Descrição | Caracteres Máx. |
---|---|---|---|
daily_rate * | float | Taxa de juros diária (%). | - |
annual_rate * | float | Taxa de juros anualizada (%). | - |
monthly_rate * | float | Taxa de juros mensal (%). | - |
interest_base * | string | Base de cálculo da taxa de juros (calendar_days_365 ). | - |
Objeto fine_delay_rate
Campo | Tipo | Descrição | Caracteres Máx. |
---|---|---|---|
monthly_rate * | float | Taxa de multa mensal por atraso (%). | - |
interest_base * | string | Base de cálculo da taxa de juros (calendar_days_365 ). | - |
Objeto fees
Campo | Tipo | Descrição | Caracteres Máx. |
---|---|---|---|
type * | string | Tipo da taxa (internal , external ). | - |
amount * | float | Percentual da taxa aplicada. | - |
fee_type * | string | Tipo da taxa (implementation_fee ). | - |
fee_amount * | float | Valor absoluto da taxa aplicada. | - |
amount_type * | string | Tipo do valor (percentage , fixed ). | - |
Objeto installment
Campo | Tipo | Descrição | Caracteres Máx. |
---|---|---|---|
installment_number * | integer | Número da parcela. | - |
workdays * | integer | Quantidade de dias úteis até o vencimento. | - |
calendar_days * | integer | Quantidade de dias corridos até o vencimento. | - |
principal_amortization_unit_price * | float | Valor unitário de amortização do principal. | - |
principal_amortization_amount * | float | Valor total de amortização do principal. | - |
interest_amount * | float | Valor total dos juros da parcela. | - |
amount * | float | Valor total da parcela. | - |
due_principal * | float | Valor do principal a vencer após a parcela. | - |
due_interest * | float | Valor dos juros a vencer após a parcela. | - |
due_date * | string | Data de vencimento da parcela (formato ISO 8601). | - |
has_interest * | boolean | Indica se a parcela possui cobrança de juros. | - |
Objeto investor
Campo | Tipo | Descrição | Caracteres Máx. |
---|---|---|---|
investor_key * | string | Chave única do investidor (UUID v4). | 36 |
investor_name * | string | Nome do investidor. | - |
investor_document_number * | string | Número do documento do investidor (CNPJ/CPF). | 18 |
subscription_percentage * | float | Percentual de participação do investidor na operação. | - |
subscription_quantity * | integer | Quantidade de unidades subscritas pelo investidor. | - |
investor_onboarding_approved * | boolean | Indica se o onboarding do investidor foi aprovado. | - |
bank_account * | object | Informações bancárias do investidor. | Objeto bank_account. |
Enumeradores operation_status
Enum | Descrição |
---|---|
in_filling | Operação em fase de preenchimento. |
in_analysis | Operação em análise. |
waiting_onboarding_approval | Aguardando aprovação do onboarding do emissor. |
pending_signature_submission | Aguardando envio para assinatura. |
waiting_signature | Aguardando assinaturas dos envolvidos. |
issued | Operação emitida. |
finished | Operação concluída. |
signature_rejected | Assinatura rejeitada. |
onboarding_reproved | Onboarding do emissor reprovado. |
compliance_reproved | Reprovado por compliance. |
canceled | Operação cancelada. |