API de Consulta Simples Nacional
e SIMEI por CNPJ
Integre a verificação de optantes ao seu próprio sistema ou ERP — com a situação de cada CNPJ no Simples Nacional e no SIMEI em tempo real, direto da Receita Federal.
Verificação de optantes
integrada ao seu sistema
Consulte o Simples Nacional e o SIMEI por CNPJ via integração e use a resposta dentro do seu próprio fluxo.
A API de consulta do Simples Nacional permite que o seu sistema verifique a situação de um CNPJ sem ninguém abrir o portal da Receita Federal. Você envia o CNPJ pela integração e recebe de volta, de forma estruturada, se a empresa é optante do Simples Nacional, optante do SIMEI ou não optante — junto com o comprovante oficial, pronto para gravar no cadastro do cliente.
O que a API faz
O objetivo é simples: consultar a situação de um CNPJ no Simples Nacional e no SIMEI por integração e devolver a resposta em um formato que o seu sistema consegue ler e usar. Em vez de uma pessoa consultar empresa por empresa, a verificação acontece automaticamente no ponto do seu fluxo em que ela faz sentido — no cadastro, na emissão de uma nota ou em uma rotina de conferência. A informação é a mesma da consulta oficial; o que muda é que ela chega dentro do seu software.
Casos de uso
A integração se encaixa em qualquer momento em que a situação fiscal de um CNPJ importa:
- Onboarding e cadastro de clientes: ao cadastrar um novo cliente ou fornecedor, o seu sistema já consulta o CNPJ e registra se é optante do Simples Nacional ou do SIMEI, evitando erro de enquadramento desde o início.
- Atualização cadastral em massa: rode a verificação sobre toda a base periodicamente para detectar quem entrou, saiu ou sofreu desenquadramento ao longo do ano.
- Conferência fiscal: antes de emitir notas ou aplicar retenções, confirme a situação atual do CNPJ para tratar cada empresa pelo regime correto.
Como se encaixa com a consulta em lote por planilha
A API é o caminho para quem quer automatizar a verificação dentro de um sistema. Quem prefere não desenvolver uma integração pode chegar ao mesmo resultado pela consulta de CNPJ em massa por planilha: basta enviar um arquivo Excel com os CNPJs e receber o relatório com a situação de cada um e os comprovantes oficiais. São dois caminhos para a mesma informação — escolha o que se encaixa no seu fluxo. Escritórios contábeis encontram o processo completo na página consulta para contadores, e os pacotes de crédito estão em planos.
Integração da API
em 3 etapas simples
Do acesso à situação e ao comprovante, direto no seu sistema.
Solicite seu acesso
Crie sua conta e habilite o acesso à integração de consulta.
Envie o CNPJ na integração
O seu sistema envia o CNPJ pela API no ponto certo do seu fluxo.
Receba a situação e o comprovante
A resposta estruturada com a situação e o comprovante oficial chega ao seu sistema.
Perguntas frequentes
sobre a API de consulta
Tire suas dúvidas sobre a integração de consulta do Simples Nacional e do SIMEI.
Para cada CNPJ enviado, a API retorna a situação da empresa no Simples Nacional e no SIMEI — se é optante, não optante, além das datas e do histórico de enquadramento — em uma resposta estruturada, pronta para o seu sistema gravar ou exibir. Junto vem o comprovante oficial com os dados retornados pela Receita Federal.
Sim. A mesma consulta identifica se o CNPJ é optante do SIMEI (MEI), optante do Simples Nacional ou não optante. Você recebe a situação completa em uma única chamada, sem precisar de integrações separadas.
Não. A consulta pela integração não exige certificado digital A1 ou A3. Basta enviar o CNPJ pela API e receber a situação e o comprovante de volta.
Sim. Cada consulta gera um comprovante oficial com os dados retornados pela Receita Federal, incluindo data e hora da verificação, que você pode armazenar junto ao cadastro do cliente no seu sistema.
As consultas feitas pela API usam os mesmos créditos da plataforma. Cada CNPJ consultado consome crédito da sua conta, seja pela integração ou pela importação de planilha. Os valores e pacotes estão na página de planos.
Sim. Se você não quer desenvolver uma integração, pode usar a consulta de CNPJ em massa por planilha: envie um arquivo Excel com os CNPJs e receba o relatório e os comprovantes. A API e a planilha são caminhos diferentes para o mesmo resultado.
Consultas relacionadas
Outras formas de verificar a situação de um CNPJ.
Consulta de CNPJ em massa
Sem integração: envie uma planilha Excel e receba a situação de cada CNPJ com comprovante.
Consulta para contadores
O fluxo completo para escritórios manterem a carteira de clientes sempre atualizada.
Planos e créditos
Pacotes de crédito usados tanto na API quanto na consulta por planilha.
Comece a consultar
o Simples Nacional agora
Crie sua conta, ganhe 5 créditos gratuitos e consulte seus primeiros CNPJs hoje mesmo. Sem mensalidade.