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.

Atenção!

A QI Tech oferece uma solução de Onboarding 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

ENDPOINT

/debt

MÉTODO

POST

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,
                "final_beneficiary": true,
                "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.

STATUS

200

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
final_beneficiary	boolean	Declaração se o representante é beneficiário final da empresa.	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, CNH ou CIN) (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, CNH ou CIN) (enviado previamente).
document_identification_type *	enum	Tipo do documento de identificação. Valores aceitos: `rg`, `rne`, `cnh`, `ctps`, `class_document`, `passport`, `other`, `cin`. Quando `cin`, o campo `document_identification_number` deve ser igual ao CPF.
document_identification_number *	string	Número do documento de identificação da pessoa enviado em "document_identification". Quando `document_identification_type` for `cin`, deve ser igual ao CPF (`individual_document_number`).	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
spread_merchant	Ágio destinado à remuneração do lojista, cobrado no valor de aquisição (cessão) da operação de crédito
tac_assignment_discount	Parcela da tarifa de abertura de cadastro (TAC) destinada ao fundo (cessionário), cobrada do tomador; compõe o valor de emissão da operação

Request​

Response​

Objeto Request Body​

Objeto Borrower​

Objeto Company Representatives​

Objeto Spouse​

Objeto Address​

Objeto Phone​

Objeto Disbursement Bank Account​

Objeto Financial​

Objeto Fine Configuration​

Objeto Rebates​

Response Body​