CNPJ na Receita Federal
Consulte dados cadastrais de empresas, como razão social, nome fantasia, situação cadastral, endereço, CNAEs, natureza jurídica, porte e quadro societário.
Custos
| Consulta | Créditos consumidos |
|---|---|
| Consulta de um CNPJ atendida pelo cache | 1 crédito |
| Consulta online de um CNPJ | 1 crédito |
Consulta de um CNPJ com optin dos sócios, em cache ou online | 1 crédito |
O custo é o total por requisição concluída sem erro. A estratégia de cache não altera esse valor. Retornos com erro não consomem créditos.
A opção optin dos sócios não acrescenta créditos: os dados ampliados estão incluídos no custo total de 1 crédito por requisição. O recurso depende de habilitação na conta; entre em contato com a equipe comercial para habilitá-lo.
Crédito é a unidade de consumo do plano. Consulte o valor dos planos e a tabela de Consumo por consulta.
Informações de entrada
Para realizar uma consulta na API CNPJ na Receita Federal, é necessário informar apenas o CNPJ. Os demais parâmetros são opcionais e permitem controlar o comportamento da consulta, especialmente o uso de cache.
CNPJ: Documento da empresa que será consultada. Pode ser enviado com ou sem pontuação, desde que completo.
Cache: Define por quantos dias uma consulta armazenada em cache ainda pode ser considerada válida. O valor padrão é 7 dias.
Cache Strategy: Define o comportamento da consulta, determinando a prioridade entre dados em cache e consulta em tempo real na Receita Federal.
Optin: Quando definido como 1, solicita a exibição do CPF dos sócios no quadro societário. Essa funcionalidade requer habilitação na conta; consulte as condições com a equipe comercial.
Optin ainda não está ativo na sua conta? Fale conosco para habilitar e consultar condições.
Parâmetros obrigatórios
- Name
cnpj- Type
- string
- Description
CNPJ completo da empresa. Pode ser informado com ou sem pontuação.
Exemplo:
15436940000103
Parâmetros opcionais
- Name
cache- Type
- number
- Description
Define por quantos dias uma consulta armazenada em cache ainda pode ser considerada válida. O valor padrão é 7 dias.
Esse parâmetro não altera sozinho a prioridade da requisição. Para priorizar cache, informe também uma estratégia compatível em
cache_strategy.
- Name
cache_strategy- Type
- string
- Description
Estratégia utilizada pela API para decidir entre reutilizar cache e consultar online na Receita Federal. O valor padrão é
ONLINE_PREFERENCIAL.Valores aceitos:
CACHE_SE_EXISTIR,CACHE_PREFERENCIAL,SO_ONLINE,ONLINE_PREFERENCIAL.
- Name
optin- Type
- string
- Description
Quando definido como
1, solicita a exibição do CPF dos sócios no quadro societário. Use0para desativar (padrão).Essa funcionalidade requer habilitação prévia na conta e não acrescenta créditos ao custo da consulta. Consulte a disponibilidade com a equipe comercial.
Optin ainda não está ativo na sua conta? Fale conosco para habilitar e consultar condições.
Estratégias de Cache
A API oferece diferentes estratégias para balancear entre disponibilidade, latência e atualização dos dados:
| Estratégia | Prioridade | Fallback | Descrição |
|---|---|---|---|
CACHE_SE_EXISTIR | Cache | Online | Utiliza o cache caso exista resultado armazenado para o CNPJ. Em cache miss, tenta consulta em tempo real na Receita Federal. |
CACHE_PREFERENCIAL | Cache válido | Online | Utiliza o cache quando estiver dentro da validade definida por cache. Caso contrário, tenta consulta em tempo real na Receita Federal. |
SO_ONLINE | Online | Nenhum | Sempre tenta consulta em tempo real na Receita Federal. Não utiliza cache como fallback quando a consulta falha. |
ONLINE_PREFERENCIAL | Online | Cache | Prioriza a consulta em tempo real na Receita Federal. Se houver falha ou indisponibilidade na consulta oficial, pode utilizar cache existente como fallback. Padrão. |
Receita Federal PJ
Esse endpoint retorna dados cadastrais de CNPJ, priorizando consulta em tempo real na Receita Federal por padrão e aplicando cache conforme a estratégia configurada.
Parâmetros de query string
- Name
cache- Type
- number
- Description
Define por quantos dias uma consulta armazenada em cache ainda pode ser considerada válida. O valor default é 7 dias.
- Name
cache_strategy- Type
- string
- Description
Estratégia de cache a ser utilizada. O valor default é
ONLINE_PREFERENCIAL.Valores aceitos:
CACHE_SE_EXISTIR,CACHE_PREFERENCIAL,SO_ONLINE,ONLINE_PREFERENCIAL.
- Name
optin- Type
- string
- Description
Quando definido como
1, solicita a exibição do CPF dos sócios no quadro societário. Requer habilitação na conta; consulte as condições com a equipe comercial.
Requisição
curl "https://api.sintegrapi.com.br/consultas/v2/cnpj-receita-federal/15436940000103" \
-H "x-api-key: SUA_API_KEY"
Resposta resumida
{
"request_id": "326dd48e-4039-4e27-b339-33ad3bedbefa",
"success": true,
"error": false,
"error_message": null,
"response": {
"cnpj": "15436940000103",
"identificador_matriz_filial": "Matriz",
"data_de_abertura": "2012-04-02",
"nome_empresarial": "AMAZON SERVICOS DE VAREJO DO BRASIL LTDA.",
"nome_fantasia": "Amazon.Com.Br",
"situacao_cadastral": "Ativa",
"data_da_situacao_cadastral": "2012-04-02",
"porte": "DEMAIS",
"natureza_juridica": {
"codigo": "2062",
"descricao": "Sociedade Empresária Limitada"
},
"atividade_economica_principal": {
"codigo": "4761001",
"descricao": "Comércio varejista de livros"
},
"logradouro": "Avenida Pres Juscelino Kubitschek",
"numero": "2041",
"bairro": "Vila Nova Conceicao",
"cep": "04543011",
"municipio": "São Paulo",
"uf": "SP",
"telefone": "1141302000",
"endereco_eletronico": "amzbr-tax-compliance@amazon.com"
}
}
Ver exemplo de resposta completo mais abaixo.
Exemplos de Uso
Consulta padrão (valores padrão)
GET /consultas/v2/cnpj-receita-federal/15436940000103
Equivalente a:
GET /consultas/v2/cnpj-receita-federal/15436940000103?cache_strategy=ONLINE_PREFERENCIAL&cache=7
Consulta priorizando cache por 30 dias
GET /consultas/v2/cnpj-receita-federal/15436940000103?cache_strategy=CACHE_PREFERENCIAL&cache=30
A API utilizará o cache se ele tiver até 30 dias de idade. Caso contrário, tentará uma nova consulta em tempo real na Receita Federal.
Consulta reutilizando qualquer cache existente
GET /consultas/v2/cnpj-receita-federal/15436940000103?cache_strategy=CACHE_SE_EXISTIR
Se houver cache para o CNPJ, ele será retornado sem validação de idade. Em cache miss, a API tentará a consulta em tempo real na Receita Federal.
Consulta sempre online
GET /consultas/v2/cnpj-receita-federal/15436940000103?cache_strategy=SO_ONLINE
A API tentará consultar diretamente a base oficial da Receita Federal em tempo real. Se falhar, não utiliza cache como fallback.
Consulta online com fallback para cache
GET /consultas/v2/cnpj-receita-federal/15436940000103?cache_strategy=ONLINE_PREFERENCIAL&cache=7
A API tentará primeiro a consulta em tempo real na Receita Federal. Se houver falha ou indisponibilidade na consulta oficial, poderá retornar cache existente.
Consulta com dados ampliados de sócios
GET /consultas/v2/cnpj-receita-federal/15436940000103?optin=socios_detalhados
Quando a conta possui o recurso habilitado, a resposta pode incluir dados ampliados do quadro societário. O custo total permanece em 1 crédito, conforme a seção Custos.
Observações Importantes
- O parâmetro
cachenão força a criação de um novo cache. Ele define apenas a idade máxima aceita para considerar um cache válido em estratégias aplicáveis. - O valor padrão de
cache_strategyéONLINE_PREFERENCIAL, portanto a API prioriza consulta em tempo real na Receita Federal quando a estratégia não é enviada. - Em
ONLINE_PREFERENCIAL, o fallback depende da existência de cache prévio para o CNPJ consultado. - Em
SO_ONLINE, qualquer indisponibilidade na consulta oficial da Receita Federal é retornada como falha, sem reaproveitamento de cache. - Em
CACHE_PREFERENCIAL, se o cache estiver expirado, sem data válida ou inexistente, a API tenta consulta em tempo real na Receita Federal. - Em
CACHE_SE_EXISTIR, qualquer cache armazenado pode ser reutilizado, independentemente da idade. - Após resposta online válida, os dados do CNPJ são atualizados no cache. Respostas incompletas, erros e timeouts não devem atualizar o cache.
Exemplo de resposta
{
"request_id": "a0741b74-4052-46ce-9721-8006669a8d7f",
"success": true,
"error": false,
"response": {
"cnpj": "15436940000103",
"identificador_matriz_filial": "Matriz",
"data_de_abertura": "2012-04-02",
"nome_empresarial": "AMAZON SERVICOS DE VAREJO DO BRASIL LTDA.",
"nome_fantasia": "Amazon.Com.Br",
"atividade_economica_principal": {
"codigo": "4761001",
"descricao": "Comércio varejista de livros"
},
"atividades_economicas_secundarias": [
{
"codigo": "4530703",
"descricao": "Comércio a varejo de peças e acessórios novos para veículos automotores"
},
{
"codigo": "4530705",
"descricao": "Comércio a varejo de pneumáticos e câmaras-de-ar"
},
{
"codigo": "4541206",
"descricao": "Comércio a varejo de peças e acessórios novos para motocicletas e motonetas"
},
{
"codigo": "4713004",
"descricao": "Lojas de departamentos ou magazines, exceto lojas francas (Duty free)"
},
{
"codigo": "4721104",
"descricao": "Comércio varejista de doces, balas, bombons e semelhantes"
},
{
"codigo": "4723700",
"descricao": "Comércio varejista de bebidas"
},
{
"codigo": "4729699",
"descricao": "Comércio varejista de produtos alimentícios em geral ou especializado em produtos alimentícios não especificados anteriormente"
},
{
"codigo": "4732600",
"descricao": "Comércio varejista de lubrificantes"
},
{
"codigo": "4744001",
"descricao": "Comércio varejista de ferragens e ferramentas"
},
{
"codigo": "4751201",
"descricao": "Comércio varejista especializado de equipamentos e suprimentos de informática"
},
{
"codigo": "4752100",
"descricao": "Comércio varejista especializado de equipamentos de telefonia e comunicação"
},
{
"codigo": "4753900",
"descricao": "Comércio varejista especializado de eletrodomésticos e equipamentos de áudio e vídeo"
},
{
"codigo": "4754701",
"descricao": "Comércio varejista de móveis"
},
{
"codigo": "4755503",
"descricao": "Comercio varejista de artigos de cama, mesa e banho"
},
{
"codigo": "4759899",
"descricao": "Comércio varejista de outros artigos de uso doméstico não especificados anteriormente"
},
{
"codigo": "4761003",
"descricao": "Comércio varejista de artigos de papelaria"
},
{
"codigo": "4763601",
"descricao": "Comércio varejista de brinquedos e artigos recreativos"
},
{
"codigo": "4763603",
"descricao": "Comércio varejista de bicicletas e triciclos; peças e acessórios"
},
{
"codigo": "4771704",
"descricao": "Comércio varejista de medicamentos veterinários"
},
{
"codigo": "4772500",
"descricao": "Comércio varejista de cosméticos, produtos de perfumaria e de higiene pessoal"
},
{
"codigo": "4773300",
"descricao": "Comércio varejista de artigos médicos e ortopédicos"
},
{
"codigo": "4774100",
"descricao": "Comércio varejista de artigos de óptica"
},
{
"codigo": "4789002",
"descricao": "Comércio varejista de plantas e flores naturais"
},
{
"codigo": "4789004",
"descricao": "Comércio varejista de animais vivos e de artigos e alimentos para animais de estimação"
},
{
"codigo": "4789005",
"descricao": "Comércio varejista de produtos saneantes domissanitários"
},
{
"codigo": "4789007",
"descricao": "Comércio varejista de equipamentos para escritório"
},
{
"codigo": "4789099",
"descricao": "Comércio varejista de outros produtos não especificados anteriormente"
},
{
"codigo": "5211799",
"descricao": "Depósitos de mercadorias para terceiros, exceto armazéns gerais e guarda-móveis"
},
{
"codigo": "5811500",
"descricao": "Edição de livros"
},
{
"codigo": "5911101",
"descricao": "Estúdios cinematográficos"
},
{
"codigo": "5911199",
"descricao": "Atividades de produção cinematográfica, de vídeos e de programas de televisão não especificadas anteriormente"
},
{
"codigo": "5913800",
"descricao": "Distribuição cinematográfica, de vídeo e de programas de televisão"
},
{
"codigo": "6202300",
"descricao": "Desenvolvimento e licenciamento de programas de computador customizáveis"
},
{
"codigo": "6203100",
"descricao": "Desenvolvimento e licenciamento de programas de computador não customizáveis"
},
{
"codigo": "6204000",
"descricao": "Consultoria em tecnologia da informação"
},
{
"codigo": "6311900",
"descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na Internet"
},
{
"codigo": "6319400",
"descricao": "Portais, provedores de conteúdo e outros serviços de informação na Internet"
},
{
"codigo": "6499999",
"descricao": "Outras atividades de serviços financeiros não especificadas anteriormente"
},
{
"codigo": "6619399",
"descricao": "Outras atividades auxiliares dos serviços financeiros não especificadas anteriormente"
},
{
"codigo": "7319002",
"descricao": "Promoção de vendas"
},
{
"codigo": "7319004",
"descricao": "Consultoria em publicidade"
},
{
"codigo": "7319099",
"descricao": "Outras atividades de publicidade não especificadas anteriormente"
},
{
"codigo": "7490104",
"descricao": "Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários"
},
{
"codigo": "8211300",
"descricao": "Serviços combinados de escritório e apoio administrativo"
},
{
"codigo": "8220200",
"descricao": "Atividades de teleatendimento"
},
{
"codigo": "8291100",
"descricao": "Atividades de cobrança e informações cadastrais"
},
{
"codigo": "8299799",
"descricao": "Outras atividades de serviços prestados principalmente às empresas não especificadas anteriormente"
}
],
"natureza_juridica": {
"codigo": "2062",
"descricao": "Sociedade Empresária Limitada"
},
"tipo_logradouro": "",
"logradouro": "Avenida Pres Juscelino Kubitschek",
"numero": "2041",
"bairro": "Vila Nova Conceicao",
"complemento": "Andar Rec5 6 8 9 10 12AO23PAVMTOANDAR 17 Parte",
"cep": "04543011",
"municipio": "São Paulo",
"uf": "SP",
"endereco_eletronico": "amzbr-tax-compliance@amazon.com",
"telefone": "1141302000",
"situacao_cadastral": "Ativa",
"data_da_situacao_cadastral": "2012-04-02",
"situacao_especial": "",
"porte": "DEMAIS",
"socios": [
{
"nome": "Ricardo Jose Thomaz Pagani",
"cpf_cnpj_socio": "123456789101",
"qualificacao_socio": "Administrador",
"data_entrada_sociedade": "2017-08-10 00:00:00",
"pais": "",
"faixa_etaria": "61-70"
},
{
"nome": "Juliana Soibelmann Sztrajtman",
"cpf_cnpj_socio": "123456789101",
"qualificacao_socio": "Administrador",
"data_entrada_sociedade": "2025-02-13 00:00:00",
"pais": "",
"faixa_etaria": "41-50"
},
{
"nome": "RAINFOREST HOLDCO 1 LLC",
"cpf_cnpj_socio": "28886481000101",
"qualificacao_socio": "Sócio Pessoa Jurídica Domiciliado no Exterior",
"data_entrada_sociedade": "2017-11-30 00:00:00",
"pais": "",
"documento_representante_legal": "***747448**",
"nome_representante_legal": "Fernando Gentil Monteiro"
}
]
}
}
Campos sem informação disponível podem ser retornados como null, string vazia ou coleção vazia, conforme o campo do contrato.
Códigos HTTP comuns
| Código | Significado |
|---|---|
200 | Requisição processada. Consulte success, error e error_message no corpo da resposta. |
400 | CNPJ inválido, estratégia inválida ou falha ao processar a consulta. |
401 | Chave de API ausente ou inválida. |
402 | Saldo insuficiente para realizar a consulta. |
429 | Limite de requisições excedido. |
500 | Erro interno inesperado. |
Consulte também a página de erros da API para orientações gerais de tratamento.
Boas práticas
- Para dados recentes com maior disponibilidade, mantenha o padrão
ONLINE_PREFERENCIAL. - Para impedir qualquer resposta de cache, utilize
SO_ONLINE. - Para reduzir latência em rotinas menos sensíveis à atualização, utilize
CACHE_PREFERENCIALcom uma validade adequada ao seu processo. - Não envie
cacheesperando que ele, isoladamente, altere a prioridade da consulta; defina tambémcache_strategyquando quiser priorizar cache. - Trate timeouts e erros transitórios com retentativas controladas e backoff exponencial.
- Não presuma que uma falha online sempre terá fallback: o cache pode não existir para o CNPJ consultado.
Integração com CRMs e ERPs
Use a API de CNPJ na Receita Federal para preencher e revisar cadastros empresariais a partir do documento informado pelo cliente ou fornecedor. A conexão com o ERP ou CRM é feita por requisições HTTPS autenticadas e mapeamento dos dados da resposta.
Cadastro de CNPJ no TOTVS Protheus, SAP Business One e Omie
Para integrar a consulta de CNPJ ao TOTVS Protheus, TOTVS RM, SAP S/4HANA, SAP Business One, Sankhya, Omie ou Bling, associe a empresa pelo CNPJ e mapeie os dados contidos em response. A implementação deve respeitar os campos, as permissões e as APIs disponíveis na versão contratada do ERP.
| Campo da resposta | Uso na integração |
|---|---|
response.cnpj | Identificar a empresa e evitar cadastros duplicados. |
response.nome_empresarial e response.nome_fantasia | Preencher a identificação do cliente ou fornecedor. |
response.atividade_economica_principal e response.atividades_economicas_secundarias | Registrar CNAEs para classificação comercial e cadastral. |
response.logradouro, response.municipio, response.uf e response.cep | Compor o endereço cadastral. |
response.situacao_cadastral e response.socios | Apoiar a revisão cadastral e do quadro societário. |
Enriquecimento de empresas no Salesforce, HubSpot e Pipedrive
No Salesforce, Microsoft Dynamics 365, HubSpot, Pipedrive ou Zoho CRM, a consulta pode compor um fluxo de enriquecimento de contas, segmentação por atividade e qualificação de fornecedores. Use o CNPJ como referência para conciliação e defina quais campos a integração pode sobrescrever.
Os dados ampliados dos sócios dependem da habilitação de optin e estão incluídos no custo de 1 crédito por consulta. Execute a chamada no servidor, preserve request_id e valide o conteúdo de response antes da atualização. O JSON Schema da resposta descreve os campos e suas estruturas.
JSON Schema da Resposta
O schema usa JSON Schema Draft 2020-12.
Os campos de negócio podem ser omitidos ou nulos quando não há informação disponível
ou quando ocorre um erro. Valide também success e error antes de atualizar
o cadastro. Propriedades adicionais são aceitas para permitir evolução compatível.
O schema descreve o corpo JSON; o código HTTP deve ser tratado separadamente.
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "CNPJ Receita Federal — Resposta",
"type": "object",
"properties": {
"request_id": { "type": "string", "format": "uuid" },
"success": {
"type": "boolean",
"description": "Resultado funcional da consulta; avalie junto com error."
},
"error": {
"type": "boolean",
"description": "Indica falha técnica ou de validação."
},
"error_message": {
"type": ["object", "null"],
"properties": {
"message": {
"type": ["string", "null"],
"description": "Mensagem pública da consulta."
},
"code": {
"type": ["string", "null"],
"description": "Código público, quando informado."
}
}
},
"response": {
"type": ["object", "null"],
"description": "Dados cadastrais retornados pela Receita Federal.",
"properties": {
"cnpj": {
"type": ["string", "null"],
"description": "CNPJ consultado, sem formatação."
},
"identificador_matriz_filial": {
"type": ["string", "null"],
"description": "Indica se o estabelecimento é a matriz ou uma filial."
},
"data_de_abertura": {
"type": ["string", "null"],
"format": "date",
"description": "Data de abertura da empresa no formato YYYY-MM-DD."
},
"nome_empresarial": {
"type": ["string", "null"],
"description": "Razão social da empresa."
},
"nome_fantasia": {
"type": ["string", "null"],
"description": "Nome fantasia da empresa, quando informado."
},
"atividade_economica_principal": {
"type": ["object", "null"],
"description": "CNAE principal da empresa.",
"properties": {
"codigo": { "type": ["string", "null"], "description": "Código CNAE." },
"descricao": {
"type": ["string", "null"],
"description": "Descrição da atividade econômica."
}
}
},
"atividades_economicas_secundarias": {
"type": ["array", "null"],
"description": "Lista de CNAEs secundários.",
"items": {
"type": ["object", "null"],
"properties": {
"codigo": { "type": ["string", "null"] },
"descricao": { "type": ["string", "null"] }
}
}
},
"natureza_juridica": {
"type": ["object", "null"],
"description": "Natureza jurídica da empresa.",
"properties": {
"codigo": {
"type": ["string", "null"],
"description": "Código da natureza jurídica."
},
"descricao": {
"type": ["string", "null"],
"description": "Descrição da natureza jurídica."
}
}
},
"logradouro": {
"type": ["string", "null"],
"description": "Nome da rua/avenida do endereço."
},
"numero": { "type": ["string", "null"], "description": "Número do endereço." },
"complemento": {
"type": ["string", "null"],
"description": "Complemento do endereço."
},
"bairro": { "type": ["string", "null"], "description": "Bairro do endereço." },
"cep": {
"type": ["string", "null"],
"description": "CEP do endereço, sem formatação."
},
"municipio": { "type": ["string", "null"], "description": "Nome do município." },
"uf": { "type": ["string", "null"], "description": "Sigla do estado (UF)." },
"endereco_eletronico": {
"type": ["string", "null"],
"description": "E-mail de contato da empresa, quando disponível."
},
"telefone": {
"type": ["string", "null"],
"description": "Telefone de contato, quando disponível."
},
"situacao_cadastral": {
"type": ["string", "null"],
"description": "Situação cadastral atual (ex: ATIVA, BAIXADA, SUSPENSA)."
},
"data_da_situacao_cadastral": {
"type": ["string", "null"],
"format": "date",
"description": "Data da última atualização da situação cadastral."
},
"porte": {
"type": ["string", "null"],
"description": "Porte da empresa (ex: MICRO EMPRESA, EMPRESA DE PEQUENO PORTE, DEMAIS)."
},
"socios": {
"type": ["array", "null"],
"items": {
"type": ["object", "null"],
"properties": {
"nome": { "type": ["string", "null"] },
"cpf_cnpj_socio": { "type": ["string", "null"] },
"qualificacao_socio": { "type": ["string", "null"] },
"pais": { "type": ["string", "null"] },
"documento_representante_legal": { "type": ["string", "null"] },
"nome_representante_legal": { "type": ["string", "null"] },
"faixa_etaria": { "type": ["string", "null"] },
"data_entrada_sociedade": {
"type": ["string", "null"],
"description": "Data e hora no formato YYYY-MM-DD HH:mm:ss.",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
}
}
}
},
"tipo_logradouro": { "type": ["string", "null"] },
"ente_federativo_responsavel": { "type": ["string", "null"] },
"situacao_especial": { "type": ["string", "null"] },
"data_da_situacao_especial": {
"type": ["string", "null"],
"description": "Data civil no formato YYYY-MM-DD.",
"format": "date"
}
}
}
},
"required": ["request_id", "success", "error"],
"additionalProperties": true
}
