Consulta cadastral
Consulta de CNPJ
Dados cadastrais oficiais de uma empresa a partir do CNPJ de 14 dígitos.
/openapi/v3/consultas/cnpj/{cnpj}token, timestamp e sign, veja Autenticação.Devolve os dados cadastrais de um número de inscrição de pessoa jurídica de 14 dígitos: razão social, nome fantasia, situação cadastral, natureza jurídica, CNAE, endereço registrado, contatos e capital social.
A resposta é um objeto simples, sem envelope da plataforma. A tabela de campos lista todos os campos possíveis; quando a fonte não tem dado para um campo, ele volta vazio, e esses campos foram omitidos do exemplo. Requisição GET: o corpo assinado é a string vazia e o CNPJ faz parte do caminho assinado.
Parâmetros de caminho
cnpj* | string | CNPJ |
* Campo obrigatório
ni | string | CNPJ |
tipoEstabelecimento | string | Tipo de estabelecimento |
nomeEmpresarial | string | Razão social |
nomeFantasia | string | Nome fantasia |
| object | Situação cadastral |
| object | Natureza jurídica |
dataAbertura | string | Data de abertura |
| object | CNAE principal |
| object | Endereço registrado |
| object | Município de jurisdição fiscal |
| array | Telefones |
correioEletronico | string | |
capitalSocial | number | Capital social |
porte | string | Código de porte |
situacaoEspecial | string | Situação especial |
dataSituacaoEspecial | string | Data da situação especial |
Erros de formato e de dígito verificador (10016010, 10016011) são rejeitados localmente pela plataforma: não consomem cota nem são cobrados. Erros de autenticação (401 / 403 / 429) usam o envelope da plataforma; veja o modelo de erros em Consulta cadastral.
tipoEstabelecimentoTipo de estabelecimento
| Valores | Significado |
|---|---|
| 1 | Matriz |
| 2 | Filial |
situacaoCadastral.codigoSituação cadastral
| Valores | Significado |
|---|---|
| 1 | Nula |
| 2 | Ativa |
| 3 | Suspensa |
| 4 | Inapta |
| 8 | Baixada |
| Código | HTTP | |
|---|---|---|
| 10016010 | 400 | Formato de CNPJ inválido (14 dígitos obrigatórios). Verifique caracteres de formatação indevidos. |
| 10016011 | 400 | Dígitos verificadores do CNPJ inválidos. Valide localmente com o algoritmo mod-11 antes de chamar. |
| 10016012 | 400 | CNPJ não encontrado no registro oficial. |
| 10016020 | 503 | Fonte de dados upstream temporariamente indisponível. Repita com backoff exponencial (inicie em 1 s, dobre até 30 s, adicione jitter); se persistir, contate a plataforma. |