O que validar em um cadastro B2B fiscal

CNPJ ativo e situação cadastral

CNPJ pode estar:

Para e-commerce B2B, CNPJ ativo costuma ser o cenário padrão para venda. CNPJ suspenso exige análise. CNPJ cancelado tende a inviabilizar venda. CNPJ bloqueado ou inapto requer decisão gerencial.

Validar situação cadastral ajuda a evitar pedidos presos em aprovação manual por CNPJ inválido, NF-e rejeitada porque a empresa foi cancelada no período recente, ou disputas porque o cliente não consegue aproveitar a nota.

CNAE compatível com tipo de venda

CNAE (Classificação Nacional de Atividades Econômicas) 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 CNAE pode ajudar a:

Cabe lembrar que regras fiscais podem variar por UF, regime, NCM, operação e CNAE.

IE válida na UF do destino

Inscrição Estadual é habilitação estadual. Uma empresa pode ter IE ativa em um estado, mas IE cancelada em outro. Isso afeta o cálculo de ICMS.

Validar IE depende da consulta ao SINTEGRA da UF do contribuinte. Cada UF tem regras próprias de consulta e de retorno. Validação por UF de destino ajuda a:

Regime tributário do comprador

Há regimes principais no Brasil: Simples Nacional, Lucro Presumido, Lucro Real. Cada um costuma ter regras diferentes para PIS/COFINS, ICMS e direito a crédito.

Ponto importante: regime tributário é autodeclarado pelo contribuinte 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 pelo cliente no cadastro, ou obtido via serviços que cruzam histórico transacional. A Mastery oferece inferência via histórico combinada com autodeclaração do cliente.

Se a venda assume um regime e o cliente está em outro, o cálculo pode ficar incorreto, gerando questionamentos e cancelamentos.

Onde cada dado vive (e como consultar)

Receita Federal

CNPJ, CNAE e situação cadastral vivem na Receita Federal. A consulta tem caráter público:

Latência: típico em condições normais entre 100 e 500 ms, podendo variar conforme carga do serviço público e janelas de manutenção.

Cobre: identificação, CNAE, situação cadastral.

Não cobre: IE por UF e regime tributário (regime é autodeclarado pelo contribuinte ou inferível por histórico, não está em base pública consultável).

SINTEGRA estadual

SINTEGRA (Sistema Integrado de Informações sobre Operações Interestaduais com Mercadorias e Serviços) é base de dados estadual de Inscrição Estadual.

Cada estado tem o seu SINTEGRA, com padrões e disponibilidade próprios. Validar IE depende da consulta ao SINTEGRA da UF do contribuinte. Não há padrão único entre estados; cada UF tem regras próprias.

Latência: pode variar bastante entre estados. Alguns são consistentes, outros oscilam mais.

Cobre: IE, situação estadual.

SERPRO e bases privadas complementares

SERPRO oferece serviços que podem complementar a validação. Bases privadas (Neoway, bureau de crédito, Boa Vista e outras) podem agregar dados de restrição, saúde financeira e cruzamentos adicionais, conforme o escopo da implementação.

Latência: típico em condições normais, mas pode variar conforme fornecedor e contrato.

Cobre: validação cruzada, restrições, saúde financeira (dependendo do fornecedor).

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

Custo de manutenção

Cada integração exige:

Com várias integrações, o trabalho de manutenção se multiplica.

Latência somada

Se a consulta a uma fonte é feita após a outra em sequência, a latência total é a soma. Em checkout, isso pesa. Em paralelo, a latência total tende a ser próxima da pior fonte do conjunto, ainda assim percebida pelo usuário.

Falhas em cascata

Se uma fonte cai e não há fallback, o checkout para. Orquestração com fallback inteligente costuma evitar isso: se a fonte primária cai, tenta-se a secundária. Se nenhuma responde, usa-se cache com aviso, ou solicita-se nova tentativa.

Como orquestrar como serviço único

Cache inteligente

Nem todo dado muda na mesma frequência. Estratégia comum:

Com isso, há redução de consultas em tempo real mantendo dados razoavelmente atualizados, respeitando políticas de risco do contratante.

Fallback de fontes

Quando a fonte primária falha:

  1. Tenta a fonte primária com timeout adequado
  2. Se falha, tenta a secundária com timeout adequado
  3. Se nenhuma responde, usa cache mais recente disponível e sinaliza “dados podem estar desatualizados”
  4. Se nada está disponível, pede retry ao usuário

Monitoramento periódico

A Receita Federal e os SINTEGRA estaduais não disponibilizam webhooks públicos para mudanças cadastrais. A Mastery monitora as bases periodicamente via integração própria e atualiza o DNA Tributário do comprador conforme política do contratante. Bases privadas, quando contratadas, podem oferecer notificações próprias dependendo do fornecedor.

Exemplo de integração via API DNA Tributário

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 para produtos eletronicos",
 "ativo": true
 },
 "inscricao_estadual": {
 "numero": "123.456.789.012",
 "estado": "SP",
 "situacao": "ativa",
 "data_validacao": "2025-11-05T10:30:00Z"
 },
 "regime_tributario": {
 "regime": "lucro_real",
 "origem": "inferencia_historico_nfe + autodeclaracao",
 "enquadramento": "contribuinte_icms"
 },
 "restricoes": {
 "federais": [],
 "estaduais": [],
 "municipais": [],
 "privadas": [
 {
 "tipo": "consulta_base_privada",
 "resultado": "sem_restricoes"
 }
 ]
 },
 "fontes_consultadas": [
 "receita_federal",
 "sintegra_uf_destino",
 "base_privada_complementar"
 ],
 "cache": {
 "cnae_desde": "2025-10-30T15:00:00Z",
 "regime_desde": "2025-10-30T15:00:00Z",
 "ie_desde": "2025-11-05T10:00:00Z"
 }
}

Tratamento de erros

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

Ou:

{
 "status": "aviso",
 "aviso": {
 "codigo": "ie_inativa_uf_destino",
 "mensagem": "IE consta inativa na UF de destino; pode estar em processo de reativacao",
 "acao_recomendada": "solicitar_documentacao_complementar"
 }
}

Custo comparativo: integração própria vs API DNA Tributário

O custo de cada integração varia conforme volume e fornecedor. Cálculos detalhados devem considerar o caso da operação, o volume mensal, os SLAs contratados e a equipe disponível para manutenção.

Em geral, manter integrações próprias envolve esforço inicial e contínuo (desenvolvimento, fallbacks, monitoramento, atualizações de regras de cada UF). Contratar um serviço orquestrado tende a reduzir esse esforço operacional, ao custo do contrato com o fornecedor.

Para um comparativo realista, recomenda-se modelar o cenário específico da operação considerando volume esperado, número de UFs ativas e tolerância a downtime.

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 complementares. Use cache inteligente em janelas compatíveis com cada dado e fallback de fontes. A latência total dependerá do mix de fontes e do volume.

Qual o custo médio de cada validação cadastral?

O custo de cada integração varia conforme volume e fornecedor. Cálculos detalhados devem considerar o caso da operação. Valores podem variar significativamente entre cenários.

Como integrar SINTEGRA estado por estado?

Cada UF tem regras próprias. Validar IE depende da consulta ao SINTEGRA da UF do contribuinte, com padrão técnico que pode variar entre estados. Pode ser necessária lógica condicional por UF ou contratar um serviço que abstraia isso.

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

Não. Regime tributário é autodeclarado pelo contribuinte e não está disponível 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 via serviços que cruzam histórico transacional.

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

Use fallback inteligente: tenta a fonte primária com timeout, depois alternativa, depois cache mais recente com aviso. Em última instância, sinaliza ao usuário para retry. Cabe lembrar que serviços públicos podem ter janelas de manutenção fora do controle do contratante.

Como manter cadastro fiscal sempre atualizado?

Cache inteligente por tipo de dado e monitoramento periódico das bases ajudam a manter os dados razoavelmente atualizados. A Receita Federal e os SINTEGRA estaduais não disponibilizam webhooks públicos para mudanças cadastrais; a atualização depende de consulta periódica. Bases privadas, quando contratadas, podem oferecer mecanismos de notificação próprios.

Próximo passo: Documentação API DNA Tributário

Leituras relacionadas: DNA Tributário Empresarial: a base do cálculo fiscal correto · Tecnologia Mastery

Dimensão financeira: Análise de Crédito B2B

A validação cadastral (CNPJ, CNAE, IE, regime tributário) trata da dimensão fiscal e legal do comprador. A dimensão financeira fica com a Análise de Crédito B2B da Mastery, que utiliza como base o score de CNPJ de bureau de crédito. Combinadas, as duas camadas reduzem a dependência de aprovação manual em pedidos B2B.

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.