A API Receita Federal da dbdireto permite consultar dados cadastrais de empresas e pessoas físicas em tempo real, eliminando o acesso manual ao portal da Receita. Cada chamada vai direto à base oficial e retorna informações completas, prontas para integrar com seu sistema.
Mais do que uma API CNPJ ou API CPF tradicional, oferecemos um conjunto de endpoints que cobre Receita Federal, PGFN, NF-e, Simples Nacional, RADAR e Certidões Negativas, atendendo fintechs, sistemas ERP (SAP, Dynamics, Totvs), contabilidade, plataformas de e-commerce e CRMs.
A partir da implantação da Nota Fiscal eletrônica (NF-e) e do SPED Fiscal, validar os dados cadastrais de clientes e fornecedores junto à Receita Federal tornou-se obrigatório. A não conformidade pode gerar multas, autuações fiscais e até a perda de créditos de ICMS. A API dbdireto garante essa validação automatizada de forma rápida e auditável.
O que você ganha com a API
-
01
Validação em tempo real
Consulta CNPJ e CPF direto na base oficial da Receita Federal e PGFN, em segundos.
-
02
Dados cadastrais completos
Razão social, CNAE, capital social, situação cadastral, endereço e ente federativo em uma chamada.
-
03
Conformidade LGPD
Operação em conformidade com a LGPD, com suporte técnico especializado e ambiente seguro.
Consulta CNPJ na Receita Federal
A consulta CNPJ pela API da Receita Federal retorna o conjunto completo de dados cadastrais de uma empresa a partir do número do documento (14 dígitos, com ou sem formatação). Ideal para automatizar o onboarding de fornecedores, validar clientes pré-faturamento e enriquecer cadastros existentes.
Dados retornados na consulta CNPJ:
- Razão social e nome fantasia
- Data de abertura da empresa
- Situação cadastral (ativa, baixada, suspensa, inapta)
- Natureza jurídica
- CNAE principal e secundários
- Capital social
- Endereço completo, telefone e e-mail
- Ente federativo responsável
Consulta CPF na Receita Federal
A consulta CPF pela API da Receita Federal permite validar a situação cadastral de pessoas físicas em tempo real, essencial para concessão de crédito, abertura de contas, prevenção a fraude e onboarding em fintechs e marketplaces.
Parâmetros de entrada:
- CPF (11 dígitos)
- Data de nascimento do titular
Dados retornados na consulta CPF:
- Nome completo
- Situação cadastral (regular, pendente, suspensa, cancelada)
- Código e data da consulta
- Data de inscrição
- Dígito verificador
Endpoints da API Receita Federal
Nossa API REST de consulta à Receita Federal vai além do básico CNPJ/CPF. Em uma única integração, sua aplicação acessa todos os endpoints abaixo:
- Consulta CNPJ — dados cadastrais completos da Receita Federal
- Consulta CPF — situação cadastral da pessoa física
- Consulta Simples Nacional — identifica optantes pelo Simples Nacional e SIMEI
- CND PJ — Certidão Negativa de Débitos para Pessoa Jurídica
- CND PF — Certidão Negativa de Débitos para Pessoa Física
- NF-e — consulta de Nota Fiscal eletrônica por chave de acesso (44 dígitos), com retorno completo se o cliente possuir certificado digital cadastrado
- RADAR — consulta de habilitação no Sistema RADAR para operações de comércio exterior
- Restituição IR — verificação de restituição do Imposto de Renda por exercício
Como integrar a API Receita Federal ao seu sistema
A integração da API Consulta Receita Federal ao seu sistema é direta e cobre os principais protocolos de mercado:
1. API REST — ideal para aplicações modernas, com retorno em JSON. Cada endpoint aceita os parâmetros do documento e um timeout opcional, e responde em segundos com o conjunto completo de dados.
2. Webservice SOAP — para sistemas legados que exigem o padrão SOAP/XML.
3. Consulta em lote — para validar bases inteiras de clientes ou fornecedores via FTPS ou pela interface web. Receba os resultados em Excel, CSV ou TXT, prontos para importação no seu ERP.
Toda a operação roda em Cloud Microsoft Azure, com manutenção 24x7 e SLA de 24 horas para questões técnicas. Disponibilizamos documentação técnica completa, exemplos de integração e ambiente de homologação para acelerar o seu deploy.
Casos de uso
- Onboarding de clientes em fintechs e bancos — KYC/KYB automatizado validando CPF e CNPJ direto na fonte oficial
- Cadastro de fornecedores em sistemas ERP — validação prévia antes da inclusão no SAP, Dynamics, Totvs ou qualquer sistema legado
- Prevenção a fraude em e-commerce — checagem de CPF e validação de dados de cobrança em tempo real
- Concessão de crédito — análise de situação cadastral, certidões negativas e RADAR para decisões de crédito
- Compliance fiscal e SPED — validação obrigatória pré-emissão de NF-e para evitar autuações
- Auditoria de bases existentes — saneamento periódico via consulta em lote para manter cadastros atualizados
Perguntas frequentes
Como consultar dados de CNPJ na Receita Federal via API?
Pela API dbdireto basta enviar o CNPJ (14 dígitos, com ou sem formatação). Em segundos você recebe razão social, nome fantasia, situação cadastral, CNAE primário e secundários, capital social, natureza jurídica, endereço completo e ente federativo, direto da base oficial da Receita Federal.
É possível consultar CPF pela API da Receita Federal?
Sim. A consulta CPF requer o número do CPF e a data de nascimento. O retorno inclui nome completo, situação cadastral, data de inscrição e dígito verificador, em conformidade com a LGPD.
A API retorna a Certidão Negativa de Débitos (CND)?
Sim. Oferecemos endpoints específicos para CND PJ (Certidão Negativa de Débitos Pessoa Jurídica) e CND PF (Pessoa Física), além da consulta na Procuradoria-Geral da Fazenda Nacional (PGFN).
É necessário validar dados cadastrais para emitir NF-e?
Sim. A partir da implantação do SPED Fiscal, a validação dos dados cadastrais junto à Receita Federal tornou-se obrigatória para a emissão correta da Nota Fiscal eletrônica. Dados inconsistentes podem gerar multas, autuações fiscais e perda de créditos de ICMS.
Vocês oferecem API gratuita para consulta de Receita Federal?
Trabalhamos com plano pago a partir de R$ 0,20 por consulta, com preço regressivo conforme o volume mensal. Oferecemos ambiente de homologação gratuito para testes durante a integração, mas a operação em produção é faturada por consulta realizada.