Perfil e enriquecimento cadastral

Objetivo

Preencher ou atualizar cadastros internos a partir de um CNPJ válido, preservando a versão da fonte usada.

Endpoint

GET /v1/cnpjs/00000000000191
X-API-Key: $CNPJ_API_KEY

O perfil retorna empresa, estabelecimento, simples, resumos, fontes e snapshot_fingerprint. Campos úteis incluem razão social, nome fantasia, situação cadastral, CNAE principal/secundários, endereço, porte e indicadores de Simples/MEI.

Para expandir relações:

GET /v1/cnpjs/00000000000191/estabelecimentos?limite=100&offset=0
GET /v1/cnpjs/00000000000191/socios?limite=100&offset=0

Os estabelecimentos e sócios são consultados pela raiz de oito dígitos, permitindo identificar matriz/filiais e quadro societário associados à empresa base.

Erros e limites

• 422 para CNPJ inválido;
• 404 para CNPJ válido ausente no snapshot;
• 503 quando o snapshot CNPJ não está publicado;
• informações cadastrais refletem a versão pública indicada em fontes.cnpj.versao;
• CNAEs são códigos brutos; descrições de catálogo não são enriquecidas pela API atual;
• não existe busca por nome, fuzzy matching ou histórico de alterações.

Origem e atualização

Fonte: dados públicos de CNPJ da Receita Federal. Periodicidade externa e SLA de atualização: a confirmar; consulte /health/sources e a versão da resposta.