Validação de CNPJ e Inscrição Estadual para marketplaces B2B e distribuidoras
Confira o CNPJ e a IE do comprador no cadastro, decida se ele é contribuinte do ICMS e revalide a base. Por API ou planilha.
10 consultas grátis de IE e CNPJ por mês, direto no painel.
O problema
- O comprador se cadastra sozinho. CNPJ baixado ou IE inativa só aparecem quando a nota volta rejeitada.
- Contribuinte ou não do ICMS muda a nota: o indIEDest, a IE informada e, entre estados, o DIFAL.
- O cadastro envelhece: a IE ativa no onboarding pode estar baixada na próxima compra.
Como funciona
1. No cadastro: o CNPJ na Receita
Situação cadastral, CNAE e endereço. A partir de 16/11/2026, destinatário com CNPJ fora de ATIVA gera a rejeição 182.
- GET /api/consultar-cnpj?cnpj=...
2. Antes da nota: a IE na UF do comprador
Habilitado: indIEDest 1, com a IE. Nenhuma IE na UF: 9. Não habilitado: revise antes de emitir.
- GET /api/consultar?uf=PR&cnpj=...
3. Todo mês: revalide a base
Sem código: planilha de até 20.000 linhas no painel. Com código: um job seu, dentro do limite do plano (5, 20, 60 ou 120 requisições por minuto).
Ver a consulta em massaExemplo de resposta
Exemplo fictício. Nomes e números foram inventados (os CNPJs e as IEs nem passam no dígito verificador).
No painel: a base revalidada
| CNPJ | Inscrição Estadual | Razão social | Situação |
|---|---|---|---|
| 11.222.333/0001-00 | 234.567.890.111SP | MERCADO EXEMPLO LTDACAMPINAS | Habilitado |
| 22.333.444/0001-00 | 23456789-01PR | PADARIA MODELO LTDAMARINGA | Não habilitado |
| 33.444.555/0001-00 | Nenhuma IE encontrada nos 27 estados. | ||
CNPJ: 11.222.333/0001-00
MERCADO EXEMPLO LTDACAMPINAS
Inscrição Estadual: 234.567.890.111 · SPHabilitadoCNPJ: 22.333.444/0001-00
PADARIA MODELO LTDAMARINGA
Inscrição Estadual: 23456789-01 · PRNão habilitadoCNPJ: 33.444.555/0001-00
Nenhuma IE encontrada nos 27 estados.
Na API: o comprador do PR
GET /api/consultar-cnpj?cnpj=22333444000100
{
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"cnpj": "22333444000100",
"cached": false,
"source_status": { "status": "success" },
"result": {
"razao_social": "PADARIA MODELO LTDA",
"situacao_cadastral": "ATIVA",
"data_situacao_cadastral": "2019-04-02",
"cnae_principal_codigo": "4721-1/02",
"cnae_principal_descricao": "PADARIA E CONFEITARIA COM PREDOMINANCIA DE REVENDA",
"endereco": { "municipio": "MARINGA", "uf": "PR" }
}
}GET /api/consultar?uf=PR&cnpj=22333444000100
{
"request_id": "6f1c2b9a-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
"document": "22333444000100",
"document_type": "cnpj",
"uf": "PR",
"cached": false,
"results": [
{
"inscricao_estadual": "2345678901",
"razao_social": "PADARIA MODELO LTDA",
"situacao_ie": "Não habilitado",
"tipo_ie": "IE Normal",
"municipio": "MARINGA",
"uf_ie": "PR",
"situacao_nfe": "",
"situacao_cadastral": ""
}
]
}Leitura: a Padaria Modelo está ATIVA na Receita, mas a IE do PR está Não habilitado. Não emita com essa IE: revise o cadastro. O Mercado Exemplo segue contribuinte em SP (indIEDest 1). A terceira empresa não tem IE: não contribuinte (indIEDest 9).
Endpoints usados
GET /api/consultar-cnpj
Razão social, situação, CNAE, endereço e sócios na Receita Federal
GET /api/consultar
IE numa UF, por CNPJ, CPF ou IE
GET /api/consultar-ie-todos
IEs do CNPJ nos 27 estados, quando a UF não é conhecida
Autenticação pelo header X-API-Key.
Documentação: Consultar CNPJ · Consultar IE por UF · Limite de requisições
Preço
Cada consulta conta como 1 do plano, inclusive a varredura nos 27 estados e o CNPJ na base da Receita. O CNPJ ao vivo conta como 3. Consulta que falha não é cobrada.
Painel e API usam a mesma conta e o mesmo saldo. A chave da API exige um plano ativo ou recarga.
Perguntas frequentes
Como preencher o indIEDest com o resultado?
IE Habilitado na UF do comprador: 1, com a IE na nota. Nenhuma IE na UF: 9, sem IE. IE encontrada mas Não habilitado: revise antes de emitir. O 2 (isento de inscrição) não sai da consulta: o comprador precisa comprovar.
Qual IE usar quando o comprador tem filiais?
A do estabelecimento que recebe a mercadoria. Cada filial tem CNPJ e IE próprios: consulte o CNPJ da filial na UF dela.
Tenho milhares de compradores. Preciso programar?
Não. Suba a planilha no painel, até 20.000 linhas por arquivo, e baixe o resultado. Para rotina automática, use a API num job seu.
A FiscalAPI avisa quando um comprador muda de situação?
Não há aviso automático. Para acompanhar, revalide a base de tempos em tempos, pela planilha ou por um job seu.
Comece pelo painel.
Teste com os CNPJs dos seus compradores antes de integrar.
10 consultas grátis de IE e CNPJ por mês, direto no painel.