TF Fiscal
Documentação

Consulta cadastral

Consulta de CNPJ

Dados cadastrais oficiais de uma empresa a partir do CNPJ de 14 dígitos.

GET/openapi/v3/consultas/cnpj/{cnpj}
Requer os cabeçalhos de assinatura 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, capital social e opção pelo Simples Nacional e pelo MEI.

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*
stringCNPJ

* Campo obrigatório

200
Consulta realizada. Dados cadastrais da empresa.
ni
stringCNPJ
tipoEstabelecimento
stringTipo de estabelecimento
nomeEmpresarial
stringRazão social
nomeFantasia
stringNome fantasia
objectSituação cadastral
objectNatureza jurídica
dataAbertura
stringData de abertura
objectCNAE principal
objectEndereço registrado
objectMunicípio de jurisdição fiscal
arrayTelefones
correioEletronico
stringE-mail
capitalSocial
numberCapital social
porte
stringCódigo de porte
situacaoEspecial
stringSituação especial
dataSituacaoEspecial
stringData da situação especial
opcaoSimples
boolOptante do Simples
opcaoMei
boolOptante pelo MEI
arrayAtividades secundárias
dataReferencia
stringData de referência

opcaoSimples e opcaoMei servem para pré-preencher optanteSimplesNacional e mei de Registrar empresa. Peça ao usuário que confirme antes de enviar:

opcaoMeiopcaoSimplesPré-preencherCRT
truetrue ou falsemei=true, optanteSimplesNacional=true4 MEI
falsetruemei=false, optanteSimplesNacional=true1 Simples Nacional; com excesso de sublimite, mude para 2 no console
falsefalsemei=false, optanteSimplesNacional=false3 Regime Normal
Qualquer um vazioNão pré-preencha; pergunte ao usuário—

Os dois campos vêm da base de dataReferencia, não de uma consulta em tempo real: uma opção ou exclusão do Simples posterior a essa data ainda não aparece. Excesso de sublimite não aparece nos dados públicos. Veja «Regime tributário» em Empresas.

O que esta consulta não traz. Não devolve a inscrição estadual (IE) nem distingue Lucro Presumido de Lucro Real. A IE fica no cadastro da empresa: enviada em inscricaoEstadual no registro, ou obtida da SEFAZ no cadastro automático. Lucro Presumido ou Real é o regime de PIS/COFINS, configurado no console.