Acessar minha contaAbrir uma conta
GET/api/v2/kyc/background-check/legal-person/{cnpj}

Pessoa jurídica

Este endpoint permite a consulta e análise de informações de uma empresa a partir do seu CNPJ. Os dados retornados incluem situação cadastral, estrutura societária, histórico de funcionários, atividade econômica e estimativas financeiras.

Parâmetros

Content-TypeObrigatório
header

Tipo de conteúdo da requisição

Tipo:string
cnpjObrigatório
path

Número do CNPJ a ser consultado (somente números)

Tipo:string

Parâmetros da URL

ParâmetroTipoObrigatórioDescrição
cnpjstringSimNúmero do CNPJ da empresa a ser consultada (somente números).

Possíveis Erros

CódigoMensagemDescrição
400Invalid CNPJ formatO CNPJ informado está em um formato inválido.
401UnauthorizedToken de acesso ausente ou inválido.
404Company not foundNenhuma empresa foi encontrada para o CNPJ informado.
500Internal Server ErrorErro interno no servidor.

Exemplo de Resposta (200 - Sucesso)

  1. Informações Cadastrais
    • CNPJ: Identificação da empresa.
    • Razão Social: Nome registrado oficialmente.
    • Natureza Jurídica: Tipo de empresa (ex.: Sociedade Empresária Limitada).
    • Porte: Classificação do porte empresarial (ex.: ME, EPP, etc.).
    • Situação Cadastral: Indica se a empresa está ativa ou inativa, junto com a data da última atualização.
  2. Atividade Econômica
    • CNAE Principal: Código e descrição da atividade principal da empresa.
    • CNAEs Secundários: Outras atividades associadas à empresa.
  3. Estrutura Societária
    • Sócios: Lista de sócios e administradores, incluindo nome, CPF/CNPJ, participação societária e qualificação.
    • Sócios na Junta Comercial: Informações sobre sócios registrados oficialmente na junta comercial.
  4. Localização
    • Endereço: Rua, número, bairro, cidade, estado e CEP.
    • MesoRegião: Região administrativa onde a empresa está localizada.
  5. Funcionários e Ex-Funcionários
    • Total de Funcionários: Número atual de funcionários da empresa.
    • Ex-Funcionários: Lista de ex-colaboradores com datas de admissão e desligamento.
    • Histórico de Crescimento: Variação no número de funcionários por ano.
  6. Dados Financeiros
    • Faturamento Estimado: Faixa de faturamento anual individual e por grupo.
    • Faturamento Presumido: Estimativa baseada em modelos de mercado.
    • Capital Social: Valor do capital registrado da empresa.
  7. Regime Tributário
    • Optante do Simples Nacional: Indica se a empresa faz parte do regime tributário simplificado.
    • Optante do MEI: Indica se a empresa está registrada como Microempreendedor Individual.
    • Situação Tributária: Classificação da saúde tributária da empresa.
  8. Bens e Veículos
    • Total de Veículos: Quantidade de veículos registrados pela empresa, categorizados por tempo de uso.
    • Veículos Pesados: Número de veículos put-api-v2-pagamentos-documents-idde grande porte, como caminhões e ônibus.
  9. Processos Judiciais
    • Valor Total em Disputa: Montante total envolvido em processos judiciais ativos e passivos.
  10. Telefones
    • Número de Contato: Telefones registrados para a empresa.

Notas

  • Este endpoint é ideal para validar informações de empresas antes de estabelecer relações comerciais, garantindo segurança e conformidade com normas regulatórias.
curl --location 'https://api-h.nuvende.com.br/api/v2/kyc/background-check/legal-person/11222333000181' \
--header 'Authorization: Bearer {{ access_token }}' \
--header 'Content-Type: application/json'

const axios = require("axios");

const config = {
  method: "get",
  url: "https://api-h.nuvende.com.br/api/v2/kyc/background-check/legal-person/11222333000181",
  headers: {
    Authorization: "Bearer {{ access_token }}",
    "Content-Type": "application/json",
  },
};

axios(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

import requests

url = "https://api-h.nuvende.com.br/api/v2/kyc/background-check/legal-person/11222333000181"

headers = {
    'Authorization': 'Bearer {{ access_token }}',
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v2/kyc/background-check/legal-person/11222333000181',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer {{ access_token }}',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

{
  "cnpj": "11222333000181",
  "razaoSocial": "Empresa Exemplo LTDA",
  "naturezaJuridica": "Sociedade Empresária Limitada",
  "porte": "ME",
  "situacaoCadastral": {
    "situacao": "ATIVA",
    "dataUltimaAtualizacao": "2024-01-15"
  },
  "atividadeEconomica": {
    "cnaePrincipal": {
      "codigo": "6201-5/00",
      "descricao": "Desenvolvimento de programas de computador sob encomenda"
    },
    "cnaesSecundarios": [
      {
        "codigo": "6202-3/00",
        "descricao": "Desenvolvimento e licenciamento de programas de computador customizáveis"
      }
    ]
  },
  "endereco": {
    "logradouro": "Rua Comercial, 456",
    "numero": "456",
    "bairro": "Centro Empresarial",
    "municipio": "São Paulo",
    "uf": "SP",
    "cep": "01234567"
  },
  "socios": [
    {
      "nome": "João Empresário",
      "cpf": "12345678901",
      "participacao": "50%",
      "qualificacao": "Administrador"
    }
  ],
  "funcionarios": {
    "total": 25,
    "crescimentoAnual": "+15%"
  },
  "faturamento": {
    "estimado": "R$ 1.000.000 - R$ 5.000.000",
    "presumido": "R$ 2.500.000"
  },
  "regimeTributario": {
    "simplesNacional": true,
    "mei": false
  }
}