API Consulta CNPJ

A forma mais fácil, rápida, segura e econômica de buscar dados das empresas através do CNPJ

API Consulta CNPJ

Consulta CNPJ é uma API REST que executa consultas de empresas entregando os dados da Receita Federal. A API é integrada a qualquer sistema de gestão para:

  • manter seus cadastros atualizados de forma confiável
  • conciliar informações antes de processamentos
  • obter situações cadastrais das empresas
  • validação de dados

 

Quais são as vantagens:

  • Facilidade: você integra seu sistema de gestão de forma fácil e rápida.
  • Velocidade: temos uma estrutura robusta e distribuída de datacenters, que garante velocidade na entrega dos dados.
  • Segurança: os dados são constantemente atualizados.
  • Economia: temos o melhor preço do Brasil, para consultas ilimitadas!!!

 

Contato / Vendas

 

Caso deseja adquirir este produto, ou se ainda ficou alguma dúvida, favor entre em contato pelos canais abaixo:

 

Documentação

Disponibilizamos uma API REST para a consulta dos CNPJs.

 

Autenticação

A autenticação é feita através do fornecimento de um Token de acesso. Ele deve ser transmitido em todas as requisições no header access_token. Caso o token seja inválida ou não seja informado, será retornado HTTP 401.

Para obter o token de acesso, entre no menu Token de acesso da sua conta.

Veja um exemplo em CURL:

curl -H 'access_token: INFORME_AQUI_SEU_TOKEN_DE_ACESSO' \
     -X GET https://api.consulta.live/api/cnpj/191

 

Consulta de CNPJ

 

Requisição

Para efetuar a consulta dos dados de um CNPJ, realize uma chamada HTTP GET informando o número do CNPJ:

GET https://api.consulta.live/api/cnpj/{CNPJ}

Exemplo em CURL:

curl -X GET https://api.consulta.live/api/cnpj/00000000000191

 

Resposta

Ao fazer a requisição, são retornadas as seguintes informações sobre a empresa:

  • Dados do cadastro da empresa na Receita Federal (CNPJ)
  • Dados da empresa no SINTEGRA estadual
  • Dados da empresa no SUFRAMA

 

Detalhes sobre o SINTEGRA
  • Atualmente os estados (UF) não atendidos pela API, para a consulta do SINTEGRA são: AL, AP, BA, DE, PI, RO, RR, TO.
  • Os demais estados são atendidos pela API.
  • O sistema que consome e API deve estar preparado para tratar a situação quando o SINTEGRA apresenta mais de uma Inscrição Estadual. Neste caso, todas as Inscrições Estaduais serão retornadas pela API.
  • Caso uma situação operação for de 3 (erro), o sistema que consome a API, pode refazer a consulta, pois o erro na consulta eventualmente pode ser intermitente
    • A situação operação 3 indica que ocorreu um erro ao consultar o SINTEGRA.
    • {
"sintegra": {
    "situacaoOperacao": 3,
  • Quando a situação operação for 4 (UF não atendida), o sistema que consome a API deve tratar esta situação, buscando a informação da Inscrição Estadual da empresa por outros meios (exemplo: solicitar que o usuário digite a Inscrição Estadual da empresa)
    • A situação operação 4 indica que este estado (UF) não é atendido pela API.
    • {
"sintegra": {
    "situacaoOperacao": 4,

 

Resposta - Detalhes

Na tabela abaixo, segue descrição detalhada dos dados retornados pela API:

Campo Tipo Descrição
cnpj string string contendo somente os números do CNPJ. Ex: "00000000000191"
tipo int Indica o tipo de cadastro da empresa:
  • 0 - NaoInformado
  • 1 - MATRIZ
  • 2 - FILIAL
razaoSocial string Razão social.
nomeFantasia string Nome fantasia.
situacaoCadastral int Situacao cadastral da empresa:
  • 0 - NaoInformado
  • 1 - NULA
  • 2 - ATIVA
  • 3 - SUSPENSA
  • 4 - INAPTA
  • 8 - BAIXADA
dataSituacaoCadastral data Data da situção cadastral, no formato "yyyy-mm-dd".
motivoSituacaoCadastral object Contém um objeto com o código e a descrição do motivo da situação cadastral. Formato JSON: 
{
    "codigo": int,
    "descricao": "string"
}
naturezaJuridica object Contém um objeto com o código e a descrição da natureza jurídica da empresa. Formato JSON: 
{
      "codigo": int,
      "descricao": "string"
  }
dataInicioAtividade data Data de início da atividade da empresa, no formado "yyyy-mm-dd".
atividadePrincipal object Contém um objeto com o código e a descrição da atividade principal da empresa. Formato JSON: 
{
    "codigo": int,
    "descricao": "string"
}
logradouro string Descrição do logradouro.
numero string Número do endereço.
complemento string Complemento do endereço.
bairro string Bairro do endereço.
cep int CEP do endereço.
uf string Sigla da UF do endereço.
municipio string Nome do município do endereço.
mesoRegiao string Nome da mesorregião do endereço.
codigoUF int Código IBGE da UF do endereço
codigoMunicipio int Código IBGE do município do endereço
codigoMesoRegiao int Código IBGE da mesorregião do endereço
telefone string Telefone da empresa no formato "(00) 0000-0000" ou "(11) 1111-1111 / (22) 2222-2222" caso houver dois telefones.
email string Endereço de email.
capitalSocial decimal Valor do capital social da empresa, no formato 0.00.
porteEmpresa int Porte da empresa:
  • 0 - NaoInformado
  • 1 - ME
  • 3 - EPP
  • 5 - DEMAIS
simplesNacional int Opção pelo Simples Nacional:
  • 0 - Nao Optante
  • 1 - Optante do Simples Nacional
  • 2 - Excluído do Simples Nacional
dataSimplesNacional data Data de opção pelo Simples Nacional.
dataExclusaoSimples data Data de exclusão do Simples Nacional.
mei int Opção pelo MEI:
  • 0 - Nao Optante
  • 1 - Optante do MEI
situacaoEspecial string Descrição da situação especial da empresa.
dataSituacaoEspecial data Data da situação especial da empresa.
socios Array<object> Lista de objetos contendo informações dos sócios da empresa, conforme descrito abaixo em formato JSON: 
[
    {
        "qualificacao": {
            "codigo": int,
            "descricao": "string"
        },
        "nome": "string"
    }
]
atividadesSecundarias Array<object> Lista de objetos contendo informações das atividades secundárias da empresa, conforme descrito abaixo em formato JSON: 
[
      {
          "codigo": int,
          "descricao": "string"
      }
]
sintegra object Contém um objeto com as informações do SINTEGRA. Formato JSON: 

  "sintegra": {
    "situacaoOperacao": int,
    "inscricoesEstaduais": 
      [
        {
          "ie": "string",
          "situacaoContribuinte": int,
          "regimeApuracaoICMS": "string",
          "razaoSocial": "string",
          "logradouro": "string",
          "numero": "string",
          "complemento": "string",
          "bairro": "string",
          "cep": "string",
          "uf": "string",
          "municipio": "string",
          "mesoRegiao": "string",
          "codigoUF": int,
          "codigoMunicipio": int,
          "codigoMesoRegiao": int
        }
      ]
}
O campo inscricoesEstaduais trará uma lista de inscrições estaduais para o CNPJ.

Valores para situacaoOperacao:
  • 1 - Sucesso
  • 2 - Inexistente - CNPJ não cadastrado ou isento de Inscrição Estadual
  • 3 - Erro - houve algum erro ao buscar o SINTEGRA
  • 4 - UFNaoAtendida - ainda não foi implementado o SINTEGRA para esta UF no ConsultaCNPJ
Valores para situacaoContribuinte:
  • 0 - NaoHabilitado
  • 1 - Habilitado
suframa object Contém um objeto com as informações do SUFRAMA. Formato JSON: 

  "suframa": {
    "situacaoOperacao": int,
    "razaoSocial": "string",
    "inscricaoSuframa": "string",
    "situacaoCadastral": int,
    "posicaoEm": "data",
    "inscricoesSuframa": array,
    "endereco": "string",
    "bairro": "string",
    "municipio": "string",
    "uf": "string",
    "telefone": "string",
    "email": "string",
}
Valores para situacaoOperacao:
  • 1 - Existente
  • 2 - Inexistente - CNPJ não cadastrado no SUFRAMA
Valores para situacaoCadastral:
  • 0 - NaoHabilitado
  • 1 - Habilitado

O campo posicaoEm informa a data em que foi realizada a consulta no SUFRAMA.

O campo inscricaoSuframa é preenchido com o número de inscrição SUFRAMA mais atual cadastrada para a empresa.

O campo inscricoesSuframa é preenchido com todas as inscrições SUFRAMA cadastradas para a empresa.

 

Se tudo correr bem, a API retornará com Status HTTP 200 e o conteúdo em formato JSON, conforme exemplo abaixo:

{
  "cnpj": "06990590000123",
  "tipo": 1,
  "razaoSocial": "GOOGLE BRASIL INTERNET LTDA.",
  "nomeFantasia": null,
  "situacaoCadastral": 2,
  "dataSituacaoCadastral": "2004-09-01T00:00:00",
  "motivoSituacaoCadastral": null,
  "naturezaJuridica": {
      "codigo": 2062,
      "descricao": "Sociedade Empresária Limitada"
  },
  "dataInicioAtividade": "2004-09-01T00:00:00",
  "atividadePrincipal": {
      "codigo": 6319400,
      "descricao": "Portais, provedores de conteúdo e outros serviços de informação na Internet"
  },
  "logradouro": "AVENIDA BRIGADEIRO FARIA LIMA",
  "numero": "3477",
  "complemento": "ANDAR 17 A 20 TORRE SUL ANDAR 2 TORRE NORTE ANDAR 18 A 20 TORRE NORTE",
  "bairro": "ITAIM BIBI",
  "cep": "04538133",
  "uf": "SP",
  "municipio": "SAO PAULO",
  "mesoRegiao": "Metropolitana de São Paulo",
  "codigoUF": 35,
  "codigoMunicipio": 3550308,
  "codigoMesoRegiao": 3515,
  "telefone": "(11) 2395-8400",
  "email": "GOOGLEBRASIL@GOOGLE.COM",
  "capitalSocial": 56758501.0,
  "porteEmpresa": 5,
  "simplesNacional": 0,
  "dataSimplesNacional": null,
  "dataExclusaoSimples": null,
  "mei": 0,
  "situacaoEspecial": null,
  "dataSituacaoEspecial": null,
  "socios": [
      {
          "qualificacao": {
              "codigo": 37,
              "descricao": null
          },
          "nome": "GOOGLE INTERNATIONAL LLC"
      },
      {
          "qualificacao": {
              "codigo": 5,
              "descricao": "Administrador"
          },
          "nome": "FABIO JOSE SILVA COELHO"
      },
      {
          "qualificacao": {
              "codigo": 37,
              "descricao": null
          },
          "nome": "GOOGLE LLC"
      }
  ],
  "atividadesSecundarias": [
      {
          "codigo": 7319004,
          "descricao": "Consultoria em publicidade"
      },
      {
          "codigo": 4751201,
          "descricao": "Comércio varejista especializado de equipamentos e suprimentos de informática"
      },
      {
          "codigo": 6202300,
          "descricao": "Desenvolvimento e licenciamento de programas de computador customizáveis"
      },
      {
          "codigo": 6201501,
          "descricao": "Desenvolvimento de programas de computador sob encomenda"
      },
      {
          "codigo": 6311900,
          "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na Internet"
      },
      {
          "codigo": 6462000,
          "descricao": "Holdings de instituições não financeiras"
      }
  ],
  "sintegra": {
      "situacaoOperacao": 1,
      "inscricoesEstaduais": [
          {
              "ie": "149848403115",
              "situacaoContribuinte": 1,
              "regimeApuracaoICMS": "NORMAL - REGIME PERIÓDICO DE APURAÇÃO",
              "razaoSocial": "GOOGLE BRASIL INTERNET LTDA."
              "logradouro": "AVENIDA BRIGADEIRO FARIA LIMA",
              "numero": "3477",
              "complemento": "ANDAR 17 A 20 TORRE SUL   ANDAR 2 TORRE NORTE       ANDAR 18 A 20 TORRE NORTE",
              "bairro": "ITAIM BIBI",
              "cep": "04538133",
              "uf": "SP",
              "municipio": "SAO PAULO",
              "mesoRegiao": "Metropolitana de São Paulo",
              "codigoUF": 35,
              "codigoMunicipio": 3550308,
              "codigoMesoRegiao": 3515
          }
      ]
  },
  "suframa": {
      "situacaoOperacao": 2,
      "razaoSocial": null,
      "inscricaoSuframa": null,
      "situacaoCadastral": null,
      "posicaoEm": "2019-11-05T00:00:00",
      "inscricoesSuframa": [],
      "endereco": null,
      "bairro": null,
      "municipio": null,
      "uf": null,
      "telefone": null,
      "email": null,
      "situacaoCadastral": null      
  }
}

 

Os possíveis Status HTTP retornados são:

Status HTTP Significado Descrição
200 OK A consulta ocorreu com sucesso!
400 Bad request Houve algum erro nos dados passados na requisição como por exemplo:
  • não foi informado o CNPJ na requisição
  • O CNPJ informado é inválido
401 Unauthorized Você não está autorizado a acessar o recurso. Verifique a sessão Autenticação
404 Not Found O CNPJ pesquisado não foi encontrado em nossa base de dados.
429 Too Many Requests Você excedeu o limite de consultas por minuto. Aguarde e tente novamente.

 

Retorno de Erro

Quando a solicitação não pode ser processada, a API retornará HTTP Status diferente de 200 (poderá ser 400, 401, 404 ou 429). Também será retornado o motivo do erro em formato JSON, conforme exemplo abaixo: 

{
    Erro = "CNPJ não encontrado.",
    DetalhesErro = "Não possuímos informações do CNPJ informado."
}