Validar CNPJ no checkout B2B é ler o estado da empresa no momento do pedido, não só conferir o formato dos 14 dígitos. O checkout consulta situação cadastral, CNAE, IE e regime e devolve uma decisão ao motor de aprovação: aprovar, encaminhar para revisão ou recusar. Com o Aprova CNPJ da Mastery, essa leitura roda em tempo real, sem travar a conversão.
Em resumo
No checkout B2B, o dado cadastral é decisão: define o cálculo fiscal, o crédito, a emissão da NF-e e a cobrança. Ler o estado do CNPJ no momento do pedido evita problema em todas as etapas seguintes. Este post trata do recorte do checkout (leitura de estado e roteamento da decisão). A arquitetura completa de fontes, cache e fallback fica no canônico: como validar CNPJ, CNAE, IE e regime no cadastro B2B.
O que significa validar CNPJ no checkout
Validar não é conferir formato. É ler estado, em quatro níveis:
- Formato: os 14 dígitos com dígito verificador. Filtro mínimo, descarta erro óbvio de digitação.
- Existência: o CNPJ existe na base da Receita Federal.
- Situação cadastral: ativo, suspenso, inapto, baixado ou nulo. Cada status tem implicação fiscal e operacional distinta.
- Aderência ao perfil: o CNAE é compatível com a operação do vendedor, e o regime bate com o tratamento aplicado.
Para B2B, os quatro importam. As fontes de cada dado (Receita Federal, SINTEGRA, bases complementares) e a orquestração ficam detalhadas no canônico; aqui o foco é o que decidir com o resultado.
Por que isso importa no momento do pedido
- Decisão fiscal: CNAE, regime e IE mudam o cálculo apresentado no checkout.
- Decisão de crédito: CNPJ ativo e regular é pré-requisito; suspenso ou inapto deve disparar revalidação, não aprovação automática.
- Decisão de NF-e: CNPJ inválido ou suspenso gera rejeição na Sefaz, com tempo e custo evitáveis.
- Decisão de cobrança: boleto e faturamento a prazo dependem de CNPJ regular.
Como tratar cada situação cadastral
O CNPJ não é binário. A política de tratamento por status é decisão da empresa, conforme apetite de risco e padrão setorial.
| Situação | Leitura | Ação comum no checkout |
|---|---|---|
| Ativo | Empresa regular | Segue para cálculo e aprovação |
| Suspenso | Irregularidade temporária | Fila de revisão, pede revalidação ao comprador |
| Inapto | Parou de cumprir obrigações | Recusa com mensagem de regularização |
| Baixado | Empresa encerrada | Recusa |
| Nulo | Cancelado por irregularidade grave | Recusa |
O ganho de validar no momento do pedido é bloquear o problema antes da emissão, não depois. Aprovar automaticamente um CNPJ suspenso costuma gerar rejeição de NF-e, contestação e cobrança travada mais tarde.
Sinais que compõem a decisão
A decisão de checkout combina a leitura cadastral com dois sinais adicionais:
- Score de crédito do bureau do cliente: para pedido a prazo, sintetiza o risco de inadimplência da empresa. Esse sinal vem do bureau do próprio cliente, não da Mastery.
- Histórico interno: para compradores recorrentes, volume, ticket médio, devoluções e inadimplência anterior refinam a decisão.
A combinação dá uma leitura consistente; faltar um sinal enfraquece a decisão.
Como o Aprova CNPJ devolve a decisão ao checkout
O Aprova CNPJ recebe o CNPJ informado no checkout, consulta as fontes em paralelo e devolve ao motor de checkout, em tempo real: razão social, situação cadastral, CNAE principal, regime, IE válida na UF e classificação interna (revenda, uso e consumo, indústria, consumidor final empresa). O motor combina isso com o cálculo fiscal e devolve uma decisão única ao fluxo de aprovação: aprovado, revisão ou recusado. CNPJs recorrentes recebem reavaliação periódica, e eventos críticos podem disparar reavaliação imediata. A política de fallback trata a indisponibilidade pontual de uma fonte.
Cuidados operacionais
- Política por status documentada e versionada, compartilhada com fiscal, comercial e atendimento, para decisão consistente entre pedidos similares.
- Mensagem ao comprador em caso de recusa: clara, sem expor sinal sensível, com convite a revalidar. No B2B, recusa mal comunicada queima a relação.
- Conformidade com a LGPD: o CNPJ pode envolver dado de pessoa física (sócios); trate com política de retenção e minimização.
- Registro de cada validação com timestamp, fontes consultadas, resposta e decisão, para revisão de política e conferência interna.
Perguntas frequentes
Como consultar a situação cadastral de um CNPJ em tempo real no checkout?
Consulte, em paralelo, a Receita Federal (situação, CNAE, regime), o SINTEGRA ou a Sefaz estadual (IE). O Aprova CNPJ orquestra essas consultas às bases fiscais e federais e devolve a decisão ao motor de checkout. O detalhe de fontes e cache está no canônico de cadastro.
O que fazer quando o CNPJ está suspenso no checkout?
Encaminhe para fila com mensagem específica ao comprador e peça revalidação ou regularização. Aprovação automática de CNPJ suspenso costuma gerar rejeição de NF-e e cobrança travada.
Validar CNPJ no checkout atrapalha a conversão?
Não quando roda em tempo real, com consultas em paralelo e cache para CNPJs frequentes. O comprador vê a decisão sem perceber atraso, e casos de exceção seguem para revisão sem congelar o checkout.
O que validar no CNPJ além do formato?
Existência na Receita Federal, situação cadastral (ativo, suspenso, inapto, baixado, nulo), CNAE, regime e IE por UF.
Como o Aprova CNPJ resolve a validação no checkout?
Consulta em paralelo às bases fiscais e federais, compõe a resposta com situação, CNAE, regime e IE, e devolve a decisão integrada (aprovado, revisão, recusado) ao motor, em tempo real.
O que fazer quando uma fonte de consulta está indisponível no checkout?
Use a política de fallback: tenta a fonte primária com timeout, depois a alternativa, depois o cache mais recente com aviso; em último caso, sinaliza nova tentativa ao comprador. Isso evita congelar o checkout por indisponibilidade pontual.
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: testar a validação de CNPJ no checkout com o Aprova CNPJ.
Leituras relacionadas: Como validar CNPJ, CNAE, IE e regime no cadastro B2B · Perfil fiscal do comprador B2B · Guia de automação fiscal para e-commerce B2B