Fallback fiscal no checkout B2B: o que fazer quando a validação ou o cálculo caem
Fontes de dado oscilam: a consulta ao CNPJ, o serviço de cálculo ou a base de uma UF podem ficar indisponíveis por segundos. O checkout B2B precisa de uma política para esse momento, sem congelar a jornada nem cravar dado errado na nota. Fallback fiscal é o conjunto de regras para quando uma fonte fiscal não responde a tempo.
Em resumo
Um bom fallback fiscal combina quatro peças: timeout curto para não travar a página, cache de dados recentes para responder sem depender da fonte no instante, degradação controlada que define o que segue e o que espera, e fila de revisão para o que não pôde ser resolvido na hora. O princípio é não deixar o pedido avançar com dado inventado nem barrar o comprador apto por uma falha momentânea. A própria NF-e tem contingência oficial; o checkout precisa da sua.
O problema: entre travar e errar
Quando uma fonte fiscal não responde, existem duas saídas ruins. Travar o checkout perde a venda de um comprador apto por causa de uma indisponibilidade que dura segundos. Deixar passar com um valor qualquer crava dado errado na nota e gera rejeição ou retrabalho depois. O fallback fiscal existe para evitar as duas: manter a jornada de pé e proteger a integridade do dado que vai para a emissão.
As quatro peças de uma política de fallback
Timeout. Definir um tempo máximo de espera pela fonte. Passado o limite, o checkout aciona o plano B em vez de segurar o comprador na tela. O tempo é curto para preservar a experiência, sem cravar número fixo aqui porque depende da operação.
Cache. Guardar o resultado recente da validação e do cálculo por uma janela definida. Um CNPJ validado há pouco e um cálculo já feito para a mesma combinação podem responder do cache enquanto a fonte se restabelece, sem nova consulta.
Degradação controlada. Definir, por regra, o que pode seguir e o que precisa esperar. Um comprador já aprovado e um item de tributação estável podem avançar; uma combinação nova e sensível vai para revisão. A degradação é planejada, não um efeito colateral.
Fila de revisão. O que não fecha na hora entra numa fila para conferência antes da emissão, em vez de bloquear a compra ou emitir errado. O pedido é aceito com o status certo e a nota só sai quando o dado fecha.
Tabela: estratégia de fallback por fonte
| Fonte que caiu | Resposta imediata | Barreira antes da emissão |
|---|---|---|
| Consulta de CNPJ | Usar cache recente ou aceitar com revisão | Revalidar antes de faturar |
| Serviço de cálculo | Recalcular do cache ou marcar pendência | Recalcular antes de emitir |
| Base de uma UF (IE, DIFAL) | Degradar para regra conhecida e sinalizar | Conferir a UF antes da nota |
A analogia oficial: contingência da NF-e
A própria emissão da NF-e tem modos oficiais de contingência para quando a autorização fica indisponível, descritos no Portal Nacional da NF-e e no Manual de Orientação do Contribuinte. Entre eles estão a SEFAZ Virtual de Contingência (SVC), o Evento Prévio de Emissão em Contingência (EPEC) e o Formulário de Segurança (FS-DA). A lógica é a mesma que o checkout precisa: quando o caminho principal falha, existe um caminho alternativo controlado, com acerto posterior, em vez de parar a operação. O fallback fiscal do checkout é a versão desse princípio aplicada à validação e ao cálculo, antes da emissão.
Como o Motor Fiscal B2B trata a resiliência
O Motor Fiscal B2B da Mastery calcula em tempo real, na página de produto e no checkout, e a aprovação do CNPJ é feita pelo Aprova CNPJ na origem. Por ser o hub de aprovação de CNPJ, o Aprova CNPJ já consulta várias bases fiscais e federais com redundância, então uma fonte indisponível não derruba a validação. Sobre isso, uma política de fallback mantém a resposta praticamente instantânea mesmo quando uma fonte oscila, apoiada em cache e em degradação controlada, e envia para revisão o que não pode fechar na hora. A Mastery calcula e valida na origem, sem recolher tributos nem emitir a nota: o objetivo do fallback é que o dado que chega ao emissor esteja correto, não apenas presente.
Passo a passo de uma política de fallback
- Definir timeout por fonte e por etapa.
- Manter cache de validação e de cálculo com janela de validade.
- Escrever a regra de degradação: o que segue, o que espera, o que barra.
- Criar a fila de revisão para pendências, com status claro para o comprador.
- Revalidar e recalcular antes da emissão, nunca depois.
- Registrar o evento para rastreabilidade interna e ajuste da política.
Dois exemplos concretos
Atacadista no pico de campanha: a consulta de CNPJ oscila sob carga. Com cache de compradores validados na hora e fila de revisão para os novos, a loja continua vendendo e nenhuma nota sai com dado inventado.
Indústria vendendo pela VTEX para várias UFs: a base de uma UF fica lenta. O checkout degrada para a regra conhecida daquele destino, sinaliza a pendência e confere a UF antes de emitir, sem travar os demais pedidos. Veja calcular imposto no checkout B2B em tempo real.
Perguntas frequentes
O que é fallback fiscal no checkout B2B?
É a política que define o que o checkout faz quando uma fonte de validação ou cálculo fica indisponível: usar cache, degradar de forma controlada, enfileirar para revisão e revalidar antes da emissão, sem travar a jornada nem cravar dado errado.
Como não travar o checkout quando o cálculo cai?
Com timeout curto e cache: passado o tempo de espera, o checkout responde do cache ou aceita o pedido com revisão, em vez de segurar o comprador. O acerto acontece antes da emissão.
O que é degradação controlada?
É definir por regra o que pode seguir e o que precisa esperar quando uma fonte falha, de forma planejada. Casos estáveis avançam; casos sensíveis vão para conferência.
Fallback fiscal deixa a nota sair errada?
Não, quando bem feito. A regra é nunca emitir com dado inventado: o que não fecha na hora vai para a fila e a nota só sai após revalidar e recalcular.
A NF-e tem contingência oficial?
Sim. O Portal Nacional da NF-e prevê modos de contingência como SVC, EPEC e FS-DA para quando a autorização fica indisponível. O fallback do checkout aplica o mesmo princípio à validação e ao cálculo, antes da emissão.
Cache não corre o risco de usar dado velho?
Por isso o cache tem janela de validade e o dado é revalidado antes de faturar. Ele serve para responder durante uma oscilação curta, não para substituir a validação final.
Fontes oficiais
- Portal Nacional da NF-e (contingência e Manual de Orientação do Contribuinte)
- Contingência da NF-e (SEFAZ/SP)
Continue no tópico
- Conceito: comprador, produto e destino no mesmo cálculo.
- Cálculo em tempo real: tecnologia da Mastery.
- Base: guia de automação fiscal para e-commerce B2B.
Este conteúdo é informativo e não constitui consultoria ou parecer tributário.
Perguntas frequentes
O que é fallback fiscal no checkout B2B?
É a política que define o que o checkout faz quando uma fonte de validação ou cálculo fica indisponível: usar cache, degradar de forma controlada, enfileirar para revisão e revalidar antes da emissão, sem travar a jornada nem cravar dado errado.
Como não travar o checkout quando o cálculo cai?
Com timeout curto e cache: passado o tempo de espera, o checkout responde do cache ou aceita o pedido com revisão, em vez de segurar o comprador. O acerto acontece antes da emissão.
O que é degradação controlada?
É definir por regra o que pode seguir e o que precisa esperar quando uma fonte falha, de forma planejada. Casos estáveis avançam; casos sensíveis vão para conferência.
Fallback fiscal deixa a nota sair errada?
Não, quando bem feito. A regra é nunca emitir com dado inventado: o que não fecha na hora vai para a fila e a nota só sai após revalidar e recalcular.
A NF-e tem contingência oficial?
Sim. O Portal Nacional da NF-e prevê modos de contingência como SVC, EPEC e FS-DA para quando a autorização fica indisponível. O fallback do checkout aplica o mesmo princípio à validação e ao cálculo, antes da emissão.
Cache não corre o risco de usar dado velho?
Por isso o cache tem janela de validade e o dado é revalidado antes de faturar. Ele serve para responder durante uma oscilação curta, não para substituir a validação final.