Emissão de dívida PJ
Com a API de emissão de dívida é possível solicitar a emissão de uma dívida para uma pessoa jurídica. Não é necessário realizar o cadastro prévio do tomador, basta informar os dados cadastrais no momento da solicitação da dívida.
A QI Tech oferece uma solução de Oboarding de novos clientes e Anti-fraude.
Confira aqui a documentação das APIs deste serviço.
Para receber uma cotação, entre em contato com nosso time comercial:
comercial@qitech.com.br ou (11) 3522-1301
A API de dívida foi desenhada para ser executada em apenas uma requisição, após um prévio envio dos arquivos (upload de documentos). O formato de assinatura do header e do body desta requisição é descrito em detalhes aqui.
Request
Request Body
{
"borrower": {
"name": "RAZAO SOCIAL EMPRESA",
"email": "emailempresa@email.com",
"phone": {
"number": "991112222",
"area_code": "11",
"country_code": "055"
},
"address": {
"city": "São Paulo",
"state": "SP",
"number": "215",
"street": "Rua Gilberto Sabino",
"complement": "3 andar",
"postal_code": "05425020",
"neighborhood": "Pinheiros"
},
"cnae_code": "6822-6/00",
"role_type": "issuer",
"person_type": "legal",
"company_type": "ltda",
"trading_name": "NOME FANTASIA DA EMPRESA",
"foundation_date": "2019-07-05",
"attached_documents_list": [],
"company_document_number": "80282008000127",
"company_statute": "aa28e598-55e2-40f1-8884-671772c541a1",
"company_representatives": [
{
"name": "NOME DO REPRESENTANTE",
"email": "nomedorepresentante@email.com",
"phone": {
"number": "990121234",
"area_code": "11",
"country_code": "055"
},
"is_pep": false,
"spouse": {
"name": "NOME CONJUGE REPRESENTANTE",
"email": "conjugerepresentante@email.com",
"phone": {
"number": "988881234",
"area_code": "11",
"country_code": "055"
},
"birth_date": "1994-12-04",
"person_type": "natural",
"is_pep": false,
"mother_name": "NOME DA MAE DO CONJUGE DO REPRESENTANTE",
"individual_document_number": "26571990032",
"document_identification_number": "10101010100",
"address": {
"city": "São Paulo",
"state": "SP",
"number": "215",
"street": "Rua Gilberto Sabino",
"complement": "3 andar",
"postal_code": "05425020",
"neighborhood": "Pinheiros"
}
},
"address": {
"city": "São Paulo",
"state": "SP",
"number": "215",
"street": "Rua Gilberto Sabino",
"complement": "3 andar",
"postal_code": "05425020",
"neighborhood": "Pinheiros"
},
"role_type": "company_representative",
"birth_date": "1993-09-10",
"profession": "DIRETOR",
"mother_name": "NOME DA MAE DO REPRESENTANTE",
"nationality": "BRASILEIRO",
"person_type": "natural",
"marital_status": "married",
"property_system": "partial_communion_of_goods",
"attached_documents_list": [],
"individual_document_number": "31057466093",
"document_identification_number": "20202020200"
}
]
},
"financial": {
"disbursed_amount": 10000,
"interest_type": "pre_price_days",
"credit_operation_type": "ccb",
"monthly_interest_rate": 0.03,
"disbursement_date": "2023-05-04",
"first_due_date": "2023-06-03",
"interest_grace_period": 0,
"principal_grace_period": 0,
"number_of_installments": 1,
"fine_configuration": {
"contract_fine_rate": 0.02,
"interest_base": "calendar_days",
"monthly_rate": 0.01
}
},
"disbursement_bank_account": {
"name": "RAZAO SOCIAL EMPRESA",
"document_number": "80282008000127",
"bank_code": "341",
"branch_number": "8615",
"account_number": "22110",
"account_digit": "2",
"account_type": "checking_account"
},
"purchaser_document_number": "32402502000135"
}
Response
A resposta desse pedido de dívida retornará o plano de pagamento assim como uma DEBT-KEY, que é o identificador da dívida na QI SCD.
Response Body
{
"data": {
"additional_iof": 38.57988,
"annual_cet": "71,3492%",
"assignment_amount": 10254.13,
"base_iof": 12.487704111671501,
"borrower": {
"document_number": "80282008000127",
"name": "RAZAO SOCIAL EMPRESA",
"related_party_key": "7620181e-f46a-45c1-a4ea-60439b9662ad"
},
"cet": "4,5900%",
"collaterals": [],
"contract": {
"number": "0000069971/RSE",
"signature_information": [
{
"signature_url": null,
"signer_document_number": "31057466093",
"signer_email": "nomedorepresentante@email.com",
"signer_external_key": null,
"signer_name": "NOME DO REPRESENTANTE",
"signer_role": "issuer"
}
],
"urls": [
"https://storage.googleapis.com/sandbox-doc-api/documents/df3e4530-3deb-4ba8-ad4e-c28ebeffb831/20230504122831.pdf"
]
},
"contract_fee_amount": 101.53,
"contract_fees": [
{
"fee_amount": 101.53,
"fee_type": "tac"
}
],
"external_contract_fee_amount": 101.53,
"external_contract_fees": [
{
"fee_amount": 101.53,
"fee_type": "spread",
"net_fee_amount": 92.14,
"tax_amount": 9.39
},
{
"fee_amount": 0,
"fee_type": "tac",
"net_fee_amount": 0,
"tax_amount": 0
}
],
"installments": [
{
"accrual_reference_date": null,
"additional_costs": [],
"advanced_paid_amount": 0,
"bank_slip_key": null,
"business_due_date": "2023-06-05",
"calendar_days": 30,
"digitable_line": null,
"due_date": "2023-06-03",
"due_interest": 0,
"due_principal": 10152.6,
"fine_amount": null,
"has_interest": true,
"installment_history": [],
"installment_key": "0eb42a83-557a-437a-9819-099b5364cde9",
"installment_number": 1,
"installment_payment": [],
"installment_status": "created",
"installment_type": "principal",
"original_due_principal": 10152.6,
"original_pre_fixed_amount": 300.3450311613816,
"original_principal_amortization_amount": 10152.60496883862,
"original_total_amount": 10452.95,
"paid_amount": 0,
"paid_at": null,
"post_fixed_amount": 0,
"pre_fixed_amount": 300.3450311613816,
"principal_amortization_amount": 10152.60496883862,
"qr_code_key": null,
"qr_code_url": null,
"renegotiation_proposal_key": null,
"tax_amount": 12.487704111671501,
"total_accrual_amount": null,
"total_amount": 10452.95,
"total_paid_amount": 0,
"workdays": 21
}
],
"iof_charge_method": "financed",
"issue_amount": 10152.6,
"net_external_contract_fee_amount": 92.14,
"number_of_installments": 1,
"prefixed_interest_rate": {
"annual_rate": 0.42576089,
"created_at": "2023-05-04T12:28:30",
"daily_rate": 0.00097227,
"interest_base": "calendar_days_365",
"monthly_rate": 0.03
},
"requester_identifier_key": "feceb7fe-1305-45eb-899d-c87d36bcc534",
"total_iof": 51.07,
"total_pre_fixed_amount": 300.3450311613816
},
"event_datetime": "2023-05-04 12:28:35",
"key": "feceb7fe-1305-45eb-899d-c87d36bcc534",
"status": "waiting_signature",
"webhook_type": "debt"
}
Objeto Request Body
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
borrower * | object | Objeto Borrower - Devedor da operação de crédito | - |
guarantor | object | Objeto Guarantor - Garantidores da operação da operação de crédito | - |
disbursement_bank_account * | object | Objeto Disbursement Bank Account - Dados da conta bancária para desembolso da operação | - |
financial * | object | Objeto Financial - Dados da conta bancária para desembolso da operaçãoIdentificador de que o objeto enviado é uma pessoa física. Deve conter SEMPRE o valor "natural" para borrower PF | - |
purchaser_document_number * | string | CNPJ do cessionário (comprador) da operação de crédito | - |
Objeto Borrower
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
name * | string | Razão social da empresa | 100 |
trading_name * | string | Nome fantasia | |
email * | string | Email institucional da empresa | 254 |
phone * | object | Objeto Phone - Telefone da empresa | - |
is_pep * | boolean | Indicador de PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep) | - |
address * | object | Objeto Address - Endereço do devedor | - |
role_type * | enum | default: issuer | - |
person_type * | string | Indicador de pessoa jurídica - default: legal | - |
company_document_number * | string | CNPJ (apenas números) | - |
cnae_code * | string | Classificação Nacional de Atividades Econômicas | |
company_representatives * | array of objects | Lista de representante legais da empresa | Objeto Company Representatives |
company_type * | enum | Tipo da empresa: "ltda", "sa", "micro_enterprise" ou "freelancer" | - |
company_statute * | string | document_key do PDF do estatuto da empresa | |
directors_election_minute | string | document_key do PDF da Ata de eleição da empresa (obrigatório apenas para emrpresas com company_type "sa") | |
foundation_date * | date | Data de abertura da empresa (formato "AAAA-MM-DD") |
Como mostrado acima tanto o campo "borrower" quanto os campos "guarantors" podem ser populados por Objeto PF ou Objeto PJ. Objeto PJ é o descritivo de uma pessoa jurídica na QI Tech.
Objeto Company Representatives
Campo | Descrição | Exemplo | Máx. Caract. |
---|---|---|---|
person_type * | string | Identificador de que o objeto enviado é uma pessoa física ou jurídica. | natural |
name * | string | Razão social em caso de operações PJ ou Nome da pessoa em caso de operações PF. Limitado a 100 caracteres. | |
mother_name * | string | Nome da mãe do cliente em caso de PF. Limitado a 100 caracteres. | |
birth_date * | string | Data de nascimento da pessoa (formato "AAAA-MM-DD") | - |
profession * | string | Profissão do cliente. Limitado a 64 caracteres. | 64 |
nationality * | string | Nacionalidade do cliente. | 50 |
marital_status * | string | Estado civil do cliente. | |
property_system * | string | Regime de separação de bens (obrigatório apenas para pessoas com marital_status "married"). | Enumeradores property_system |
wedding_certificate * | string | DOCUMENT_KEY do PDF do certificado de casamento da pessoa (enviado previamente). No caso de marital_status ser "single", o valor deste campo deve ser NULL. | |
spouse * | string | Objeto Spouse (obrigatório apenas quando "compulsory_separation_of_goods" for "total_communion_of_goods", "partial_communion_of_goods", "final_participation_of_acquisitions" ou "compulsory_separation_of_goods"). No caso de marital_status ser "single", o valor deste campo deve ser NULL. | Objeto Spouse |
is_pep * | boolean | Declaraç ão se a pessoa é PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep). | true/false |
individual_document_number * | string | CPF da pessoa (apenas números). | 10 |
document_identification * | string | DOCUMENT_KEY do PDF do documento de identificação da pessoa com foto (RG ou CNH) (enviado previamente) | |
document_identification_back | string | DOCUMENT_KEY do PDF da parte de trás do documento de identificação da pessoa com foto (RG ou CNH) (enviado previamente). | |
document_identification_type * | string | Qual o tipo do documento de identificação enviado. | |
document_identification_number * | string | Número do documento de identificação da pessoa enviado em "document_identification". | 16 |
email * | string | Email do cliente. | 254 |
phone * | object | Telefone do cliente | Objeto Phone |
address | object | Endereço do cliente. | Objeto Address |
proof_of_residence | string | DOCUMENT_KEY do PDF do comprovante de endereço do endereço enviado (enviado previamente). | - |
Objeto Spouse
Campo | Descrição | Exemplo | Máx. Caract. |
---|---|---|---|
person_type * | string | Identificador de que o objeto enviado é uma pessoa física ou jurídica. | natural |
name * | string | Razão social em caso de operações PJ ou Nome da pessoa em caso de operações PF. Limitado a 100 caracteres. | |
mother_name * | string | Nome da mãe do cliente em caso de PF. Limitado a 100 caracteres. | |
birth_date * | string | Data de nascimento da pessoa (formato "AAAA-MM-DD") | - |
profession * | string | Profissão do cliente. Limitado a 64 caracteres. | 64 |
is_pep * | boolean | Declaração se a pessoa é PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep). | true/false |
individual_document_number * | string | CPF da pessoa (apenas números). | 10 |
document_identification_number * | string | Número do documento de identificação da pessoa enviado em "document_identification". | 16 |
email * | string | Email do cliente. | 254 |
phone * | object | Telefone do cliente | Objeto phone |
address | object | Endereço do cliente. | Objeto address |
Objeto Address
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
city * | string | Cidade do endereço | 100 |
state * | string | Estado do endereço (com dois caracteres maiúsculos) | 2 |
number * | string | Número do endereço | 10 |
street * | string | Rua do endereço | 100 |
complement * | string | Complemento do endereço (texto livre) | 100 |
postal_code * | string | CEP do endereço (http://www.buscacep.correios.com.br/sistemas/buscacep/) | 8 |
neighborhood * | string | Bairro do endereço | 100 |
Objeto Phone
Campo | Descrição | Exemplo | Máx. Caract. |
---|---|---|---|
number * | string | Número de telefone | 10 |
area_code * | string | Código DDD do telefone (https://ddd.guiamais.com.br/) | 2 |
country_code * | string | Código DDI do telefone (https://ddi.guiamais.com.br/) | 3 |
Objeto Disbursement Bank Account
Uma emissão de dívida deve conter as informações bancárias para desembolso, por padrão, uma conta de titularidade do devedor.
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
name | string | Nome do titular da conta | 50 |
document_number | string | CPF do titular da conta | 11 |
bank_code * | string | Código COMPE da instituição financeira (https://www.bcb.gov.br/pom/spb/estatistica/port/ASTR003.pdf) | 3 |
branch_number * | string | Número da agência (não informar o dígito verificador da agência!) | 4 |
account_number * | string | Número da conta (sem o dígito verificador da conta!) | 10 |
account_digit * | string | Dígito verificador da conta (informar zero no lugar de letras) | 1 |
account_type | enum | Enumerador Account Type Tipo da conta | 1 |
Objeto Financial
O objeto financial descreve as informações financeiras da emissão. Aqui são definidas a taxa de juros, carência e valor da dívida entre outros. O Objeto Financeiro possui os campos descritos abaixo, porém é importante notar que alguns campos são opicionais e excludentes (caso um esteja disponível o outro não deverá ser enviado).
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
amout | float | Valor de emissão/nominal da operação de crédito | - |
interest_type | object | Enumerador Interest Type - Método de amortização e forma de cálculo de juros | - |
credit_operation_type | object | Enumerador Credit Operation Type - Tipo do contrato de crédito | - |
annual_interest_rate | float | Taxa de juros pré-fixada expressa em decimal ao ano | - |
disbursement_date | date | Data do desembolso da operação | - |
interest_grace_period | int | Carência de juros (em meses) | - |
principal_grace_period | int | Período carência de principal | - |
number_of_installments | int | Número de parcelas da operação de crédito | - |
fine_configuration | object | Objeto Fine Configuration - Configuração de juros e multa por atraso | - |
Objeto Fine Configuration
No Objeto Fine Configuration são informados os valor de multa e juros por atraso da operação de crédito.
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
contract_fine_rate | float | Percentual de multa por atraso | - |
interest_base | enum | Enumerador Interest Base - Base de cálculo de juros | - |
monthly_rate | float | Percentual de juros de atraso ao mês | - |
Objeto Rebates
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
fee_type * | enum | Tipo da tarifa. | - |
amount_type * | object | Tipo do valor a ser cobrado. | - |
amount * | object | Valor da tarifa. Se o tipo da tarifa for percentual, o valor deverá ser entre 0 e 100. | - |
Response Body
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
data[n].data | object | Objeto Data | - |
data[n].event_datetime | date | Momento da geração da operação de crédito | - |
data[n].key | string | DEBT-KEY - Chave única da operação de crédito dentro da QI | - |
data[n].status | string | Possívies Status de uma dívida | - |
data[n].type | string | debt | - |
Enumeradores
Enumerador Person Type
Enumerador | Descrição |
---|---|
legal | Pessoa juridica |
natural | Pesso física |
Enumerador Amount Type
Enumerador | Descrição |
---|---|
tac | Tarifa cobrada do tomador. |
spread | Tarifa cobrada do fundo adicionada ao preço de cessão da operação. |
Enumerador Account Type
Enumerador | Descrição |
---|---|
checking_account | Conta corrente |
deposit_account | Conta de depósito |
guaranteed_account | Conta de garantia |
investment_account | Conta de investimento |
payment_account | Conta de pagamento |
saving_account | Conta poupança |
salary_account | Conta salário |
Enumerador Interest Type
Enumerador | Descrição |
---|---|
pre_price_days | Método de amortização Price (parcelas iguais) com cálculo do juros pré-fixado ao dia |
pre_price | Método de amortização Price (parcelas iguais) com cálculo do juros pré-fixado em períodos fixos (30 dias) |
pre_sac | Método de amortização SAC (amortização constante) com cálculo do juros pré-fixado ao dia |
post_sac | Método de amortização SAC (amortização constante) com cálculo do juros baseado em uma taxa pré-fixada + indexador pós-fixado (cdi, ipca ou igpm) ao dia |
post_price | Método de amortização Price (parcelas iguais) com cálculo do juros baseado em uma taxa pré-fixada + indexador pós-fixado (cdi, ipca ou igpm) em períodos fixos (30 dias) |
post_price_days | Método de amortização Price (parcelas iguais) com cálculo do juros baseado em uma taxa pré-fixada + indexador pós-fixado (cdi, ipca ou igpm) ao dia |
Enumerador Credit Operation Type
Enumerador | Descrição |
---|---|
ccb | Cédula de Crédito Bancário |
cce | Cédula de Crédito à Exportação |
cci | Cédula de Crédito Imobiliário |
nce | Nota de Crédito à Exportação |
ncom | Nota Comercial |
Enumerador Interest Base
Enumerador | Descrição |
---|---|
workdays | Base de cálculo de juros em dias úteis considerando um ano de 252 dias |
calendar_days | Base de cálculo de juros em dias corridos considerando um ano de 360 dias |
calendar_days_365 | Base de cálculo de juros em dias corridos considerando um ano de 365 dias |
Enumerador Fee Type
Cada tipo de fee deve ser previamente habilitado e configurado pela QI Tech
Enumerador | Descrição |
---|---|
tac | Tarifa de abertura de cadastro |
spread | Ágio cobrado no valor de aquisição da operação de crédito |
warranty_analysis | Tarifa de análise de garantias |
ted_fee | Tarifa de TED |
spread_ted_fee | Ágio da tarifa de TED cobrado no valor de aquisição da operação de crédito |