Para validar o cadastro B2B, combine quatro leituras em um fluxo único: CNPJ e situação cadastral e CNAE na Receita Federal, Inscrição Estadual no SINTEGRA da UF de destino, e regime tributário por inferência de NF-e ou autodeclaração. Cada dado tem fonte, latência e volatilidade próprias. O Aprova CNPJ da Mastery orquestra essas consultas e devolve a aprovação do comprador.

Em resumo

Um cadastro B2B fiscalmente confiável valida quatro coisas: CNPJ ativo e situação cadastral, CNAE compatível com a venda, IE ativa na UF de destino e regime tributário do comprador. Quem precisa disso é qualquer operação digital de venda B2B que emite NF-e e calcula ICMS por UF e regime. O risco de não validar é pedido preso em aprovação manual, NF-e rejeitada e disputa com o cliente. A implementação orquestra Receita Federal, SINTEGRA estadual e bases complementares, com cache por tipo de dado e fallback de fontes. Este post concentra a decisão de cadastro; para o momento do checkout em tempo real, veja o post satélite de validação de CNPJ no checkout.

O que validar em um cadastro B2B fiscal

CNPJ ativo e situação cadastral

O CNPJ pode estar ativo, cancelado, suspenso, bloqueado ou inapto. Para venda B2B, ativo é o cenário padrão; suspenso exige análise; cancelado tende a inviabilizar; bloqueado ou inapto pede decisão gerencial. Validar a situação evita pedido preso por CNPJ inválido e NF-e rejeitada porque a empresa foi cancelada no período recente.

CNAE compatível com o tipo de venda

O CNAE define a atividade da empresa. Se a venda é de componentes industriais e o comprador tem CNAE de panificação como atividade principal, é um cenário atípico que merece revisão. Validar o CNAE ajuda a sinalizar atividade compatível, apoiar o NCM da operação e sustentar o cálculo com base na atividade.

IE válida na UF de destino

A Inscrição Estadual é habilitação estadual: uma empresa pode ter IE ativa em um estado e cancelada em outro, e isso muda o cálculo de ICMS. A validação depende do SINTEGRA da UF do contribuinte, e cada UF tem regras próprias de consulta.

Regime tributário do comprador

Os regimes principais são Simples Nacional, Lucro Presumido e Lucro Real, cada um com regras próprias de PIS/COFINS, ICMS e crédito. Ponto central: o regime é autodeclarado e não está em base pública consultável por API direta. Pode ser inferido a partir de NF-e anteriores emitidas pelo CNPJ, autodeclarado no cadastro, ou obtido por serviços que cruzam histórico. A Mastery combina inferência por histórico com autodeclaração.

Onde cada dado vive (e como consultar)

Fonte Cobre Não cobre Nota de latência
Receita Federal CNPJ, CNAE, situação cadastral IE por UF, regime Varia com a carga do serviço público; opere com timeout
SINTEGRA estadual IE, situação estadual CNPJ, regime Varia bastante entre UFs; sem padrão único
SERPRO e bases privadas Validação cruzada, restrições, saúde financeira (complementar) Varia por fornecedor e contrato

As bases privadas complementares (serviços de dados cadastrais de terceiros) podem agregar restrição e cruzamentos adicionais conforme o escopo da implementação. A velocidade de cada consulta é tratada como "praticamente instantânea" quando bem orquestrada, sem cravar número.

Por que fazer cada integração separada tende a não funcionar

Cada integração exige tratamento de erro, fallback, logging e documentação próprios; com várias, o custo de manutenção se multiplica. Se as consultas são feitas em sequência, a latência total é a soma, o que pesa no cadastro. E se uma fonte cai sem fallback, o fluxo para. Orquestração com fallback inteligente evita isso: se a primária cai, tenta a secundária; se nenhuma responde, usa cache com aviso ou pede nova tentativa.

Como orquestrar como serviço único

Cache por tipo de dado

CNAE e regime mudam raramente e aceitam cache mais longo; situação cadastral e IE mudam mais e pedem cache curto. Assim, reduz-se a consulta em tempo real mantendo os dados razoavelmente atualizados, respeitando a política de risco do contratante.

Fallback de fontes

Tenta a fonte primária com timeout, depois a secundária, depois o cache mais recente com aviso de "dados podem estar desatualizados"; em último caso, pede retry ao usuário.

Monitoramento periódico

Receita Federal e SINTEGRA não disponibilizam webhooks públicos para mudança cadastral. A Mastery monitora as bases periodicamente e atualiza o perfil fiscal do comprador conforme a política do contratante. Bases privadas, quando contratadas, podem oferecer notificação própria.

Exemplo de integração via API do Aprova CNPJ

Request

POST /api/validate-cadastro
{
  "cnpj": "12345678000199",
  "uf_destino": "SP",
  "inclui_restricoes": true
}

Response

{
  "status": "validado",
  "cnpj": { "numero": "12345678000199", "razao_social": "EMPRESA LTDA", "situacao": "ativa", "data_abertura": "2015-01-15" },
  "cnae": { "codigo": "26.20-4-04", "descricao": "Fabricacao de eletrodos e contatos", "ativo": true },
  "inscricao_estadual": { "numero": "123.456.789.012", "estado": "SP", "situacao": "ativa" },
  "regime_tributario": { "regime": "lucro_real", "origem": "inferencia_historico_nfe + autodeclaracao", "enquadramento": "contribuinte_icms" },
  "restricoes": { "federais": [], "estaduais": [], "privadas": [] },
  "fontes_consultadas": ["receita_federal", "sintegra_uf_destino", "base_privada_complementar"]
}

Tratamento de erro

{
  "status": "erro_validacao",
  "erro": { "codigo": "cnpj_cancelado", "mensagem": "CNPJ foi cancelado em data anterior", "acao_recomendada": "rejeitar_cadastro" }
}

Custo comparativo: integração própria vs Aprova CNPJ

Manter integrações próprias envolve esforço inicial e contínuo: desenvolvimento, fallback, monitoramento e atualização de regra de cada UF. Contratar um serviço orquestrado tende a reduzir esse esforço operacional, ao custo do contrato. Para um comparativo realista, modele o cenário considerando volume mensal, número de UFs ativas e tolerância a indisponibilidade.

Onde a Mastery entra

A validação e a aprovação de CNPJ para vendas online são o que o Aprova CNPJ faz (atende também D2C). Quando a operação também precisa de cálculo tributário avançado em tempo real no ERP ou no e-commerce, o Motor Fiscal B2B Mastery usa esse cadastro validado para calcular o imposto do pedido. A integração é fácil, por API. A Mastery valida o CNPJ e calcula o imposto; não recolhe nem paga tributos e não emite a nota.

Perguntas frequentes

Como validar CNPJ, CNAE e IE no mesmo fluxo?

Integre fontes públicas (Receita Federal para CNPJ e CNAE, SINTEGRA estadual para IE) e, quando aplicável, bases privadas. Use cache por tipo de dado e fallback de fontes. O Aprova CNPJ orquestra essas consultas e devolve a aprovação.

Como integrar o SINTEGRA estado por estado?

Cada UF tem regras próprias, e a validação de IE depende do SINTEGRA da UF do contribuinte. Pode ser necessária lógica condicional por UF ou contratar um serviço que abstraia essa diferença.

O regime tributário pode ser consultado por API pública?

Não. O regime é autodeclarado e não está em base pública consultável por API direta. Pode ser inferido por NF-e anteriores, autodeclarado no cadastro, ou obtido por serviços que cruzam histórico transacional.

O que fazer quando a Receita está fora do ar?

Use fallback: tenta a fonte primária com timeout, depois a alternativa, depois o cache mais recente com aviso; em último caso, sinaliza retry ao usuário. Serviços públicos podem ter janelas de manutenção fora do controle da operação.

Como manter o cadastro fiscal sempre atualizado?

Cache por tipo de dado e monitoramento periódico das bases. Como não há webhook público para mudança cadastral, a atualização depende de consulta periódica; bases privadas, quando contratadas, podem notificar.

Qual a diferença entre validar no cadastro e validar no checkout?

O cadastro concentra a decisão completa (CNPJ, CNAE, IE, regime, restrições) e alimenta o perfil do comprador. O checkout lê o estado no momento do pedido e devolve a decisão de aprovar, revisar ou recusar. Veja o post de validação de CNPJ no checkout.

Fontes oficiais

Este conteúdo tem caráter informativo e não substitui orientação contábil, fiscal ou jurídica especializada. Regras tributárias podem variar conforme UF, regime tributário, operação, produto, NCM, CNAE e perfil do comprador. Valide seu cenário com profissional habilitado.

Próximo passo: conhecer o Aprova CNPJ da Mastery.

Leituras relacionadas: Validar CNPJ no checkout B2B em tempo real · Perfil fiscal do comprador B2B · Guia de automação fiscal para e-commerce B2B