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

Parâmetros de caminho

  • cnpjstringobrigatório

    14 dígitos, somente dígitos. CNPJs formatados são rejeitados: a / em 40.673.061/0001-34 seria interpretada como separador de caminho.

    Exemplo: 40673061000134

Respostas

200

Consulta realizada. Dados cadastrais da empresa.

  • nistring

    CNPJ, 14 dígitos.

  • tipoEstabelecimentostring

    Tipo de estabelecimento: 1 matriz, 2 filial.

    Valores:12
  • nomeEmpresarialstring

    Razão social registrada.

  • nomeFantasiastring

    Nome fantasia.

  • situacaoCadastralobject

    Situação cadastral.

  • naturezaJuridicaobject

    Natureza jurídica (código + descrição).

  • dataAberturastring

    Data de abertura, yyyy-MM-dd.

  • cnaePrincipalobject

    Atividade econômica principal (código + descrição).

  • enderecoobject

    Endereço registrado. Para montar a linha completa do logradouro, concatene tipoLogradouro + logradouro; a fonte os devolve separados.

  • municipioJurisdicaoobject

    Município de jurisdição fiscal (código + descrição).

  • telefonesarray

    Telefones.

  • correioEletronicostring

    E-mail.

  • capitalSocialnumber

    Capital social.

  • portestring

    Código de porte da empresa.

  • situacaoEspecialstring

    Situação especial (ex.: recuperação judicial); normalmente ausente.

  • dataSituacaoEspecialstring

    Data de vigência da situação especial.

Erros

CódigoHTTP
10016010400

Formato de CNPJ inválido (14 dígitos obrigatórios). Verifique caracteres de formatação indevidos.

10016011400

Dígitos verificadores do CNPJ inválidos. Valide localmente com o algoritmo mod-11 antes de chamar.

10016012400

CNPJ não encontrado no registro oficial.

10016020503

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.

Validação local e cobrança

Erros de formato e de dígito verificador (10016010, 10016011) são rejeitados localmente pela plataforma e nunca chegam à fonte upstream: 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.

AnteriorConsulta cadastralPróximoConsulta de CPF