Análise de Crédito - Pessoa Jurídica

Para realizar a análise de crédito de uma pessoa jurídica, utilize o endpoint de Legal Person.

No momento em que uma análise de crédito de pessoa jurídica for realizada, os seguintes dados deverão ser enviados para o nosso servidor.

Definição do Objeto Legal Person

Request Body

{
  "id": "12345678",
  "credit_request_date": "2021-03-31T10:30:00-03:00",
  "credit_type": "student_loan",
  "legal_name": "QI Tech Tecnologia LTDA",
  "trading_name": "QI Tech",
  "document_number": "35.472.523/0001-15",
  "constitution_date": "2019-11-11",
  "constitution_type": "llc",
  "email": "suporte.caas@qitech.com.br",
  "monthly_revenue": 50000000,
  "client_category": "Premium User",
  "client_since": "2021-02-11",
  "address": {
    "country": "BRA",
    "street": "Av. Brigadeiro Faria Lima",
    "number": "2391",
    "neighborhood": "Jardim Paulistano",
    "city": "São Paulo",
    "uf": "SP",
    "postal_code": "01452-905"
  },
  "phones": [
    {
      "international_dial_code": "55",
      "area_code": "11",
      "number": "32234611",
      "type": "residential"
    }
  ],
  "shareholders": [
    {
      "name": "Anna Pinto Azevedo",
      "document_number": "261.026.462-31",
      "birthdate": "1972-08-22",
      "email": "annapintoazevedo@sample.com",
      "nationality": "BRA",
      "mother_name": "Beatrice Rodrigues Pinto",
      "father_name": "Luís Azevedo",
      "monthly_income": 800000,
      "declared_assets": 18600000,
      "occupation": "law",
      "gender": "female",
      "address": {
        "country": "BRA",
        "street": "Rua Derviche Djouki",
        "number": "598",
        "complement": "Ap 857",
        "neighborhood": "Chora Menino",
        "city": "São Paulo",
        "uf": "SP",
        "postal_code": "02463-080"
      },
      "phones": [
        {
          "international_dial_code": "55",
          "area_code": "11",
          "number": "55988644",
          "type": "mobile"
        }
      ]
    }
  ],
  "guarantors": [
    {
      "name": "Melissa Lima Melo",
      "document_number": "677.498.846-61",
      "birthdate": "1960-11-21",
      "email": "exemplo2@sample.com",
      "nationality": "BRA",
      "mother_name": "Raíssa Lima",
      "father_name": "Ronaldo Melo",
      "monthly_income": 800000,
      "declared_assets": 18600000,
      "occupation": "law",
      "gender": "female",
      "address": {
        "country": "BRA",
        "street": "Rua Castro Alves",
        "number": "100",
        "complement": "Ap 202",
        "neighborhood": "Parque Estrela Dalva I",
        "city": "Luziânia",
        "uf": "GO",
        "postal_code": "72804-050"
      },
      "phones": [
        {
          "international_dial_code": "55",
          "area_code": "11",
          "number": "21158745",
          "type": "residential"
        }
      ]
    }
  ],
  "financial": {
    "amount": 100000,
    "currency": "BRL",
    "interest_type": "cdi_plus",
    "annual_interest_rate": 2.32,
    "cdi_percentage": 100,
    "number_of_installments": 4
  },
  "warrants": [
    {
      "warrant_type": "real_estate",
      "address": {
        "country": "BRA",
        "street": "Rua Curitiba",
        "number": "150",
        "complement": "Bl 3 apt 122",
        "neighborhood": "Paraíso",
        "city": "São Paulo",
        "uf": "SP",
        "postal_code": "04005-030"
      },
      "property_type": "house",
      "estimated_value": 100000000,
      "forced_selling_value": 60000000
    }
  ],
  "source": {
    "channel": "website",
    "ip": "132.23.161.75",
    "session_id": "2bb684f9-6c00-4993-bcd7-18b9eccd7c9d"
  },
  "scr_parameters" : {
    ...
  }
}

Uma análise de crédito deve ser enviada para a API antes do desembolso e pode ser utilizada para se tomar a decisão de conceder ou não o crédito. Os dados enviados também podem, mediante acordo com o cliente, ser utilizados para a prevenção a fraudes.

Os objetos utilizados na composição do objeto CreditProposal e não definidos nesta seção estão disponíveis na seção Objetos Compartilhados.

nome	tipo	descrição
id	string	Identificador da proposta de crédito no seu sistema. É essencial que este número seja único para cada processo de análise de crédito
registration_id	string	Identificador do cadastro no sistema do cliente. Para realizar mais de uma análise referente a um mesmo cadastro,
credit_request_date	datetime	A data e hora quando o crédito foi requisitado pelo tomador
credit_type	enum	Tipo de crédito sendo concedido. No momento são suportados: clean, student_loan, credit_card_limit
legal_name	string	Razão social
trading_name	string	Nome fantasia
document_number	string	O CNPJ, formatado conforme padrão estabelecido nesta documentação
monthly_revenue	integer	Receita mensal bruta em centavos
client_category	string	Categoria do cliente de acordo com a classificação da sua plataforma ou seu programa de fidelidade
client_since	date	Data de início da prestação de serviços para este cliente
constitution_date	data	A data de constituição da companhia, conforme junta comercial
constitution_type	enum	O tipo de constituição da empresa: LLC, corp
email	string	O email do representante da empresa
address	Address	O endereço da matriz da companhia
phones	list of Phones	Os telefones colhidos da companhia
shareholders	list of NaturalPerson	Os sócios da companhia, no modelo de pessoa física (Objeto NaturalPerson)
guarantors	list of Person	Garantidores da operação, Pessoa física (NaturalPerson) ou jurídica (LegalPerson)
financial.amount	integer	O valor total sendo requerido pelo tomador, que será liberado em caso de aprovação
financial.currency	enum	A unidade monetária referente ao valor total: BRL, USD, EUR
interest_type	enum	O indexador da dívida que será utilizado: cdi_plus, cdi_percentage, price, pre_fixed
annual_interest_rate	number	O valor da parte pré-fixada do juros, em percentual ao ano
cdi_percentage	number	O percentual do CDI (Pós) do juros a ser cobrado
number_of_installments	integer	Número de parcelas
warrants	Warrant	Dados de garantias reais oferecidas na operação. Deverá ser acordada antes da entrada em produçao. Atualmente os seguintes tipos são aceitos: real_estate
source	Source	O canal de venda do crédito. Atualmente são aceitos: website e app
scr_parameters	ScrParameters	Objeto com as informações necessárias para a utilização das informações do SCR na análise de crédito

Enviar uma Proposta de Crédito - Pessoa Jurídica

Request Body

  {
    "id": "12345678",
    ...
  }

Response Body

{
  "id": "12345678",
  "analysis_status": "automatically_approved",
  "reason": "rule_decision_enum"
}

Para realizar a avaliação de uma proposta de crédito, basta enviar um objeto do tipo LegalPerson ao seguinte endpoint:

POST https://api.caas.qitech.app/credit_analysis/legal_person

Análise de Crédito - Pessoa Jurídica

Definição do Objeto Legal Person​

Enviar uma Proposta de Crédito - Pessoa Jurídica​

Definição do Objeto Legal Person

Enviar uma Proposta de Crédito - Pessoa Jurídica