# Fallback na integração fiscal > Fallback na integração fiscal é o plano alternativo que um sistema aciona automaticamente quando o caminho principal de emissão de documentos fiscais falha, como uma SEFAZ fora do ar, uma API lenta ou um erro de comunicação. Ele garante que a venda não pare, guardando, redirecionando ou emitindo o documento por outra via autorizada. **Também conhecido como:** Plano de contingência técnica, Rota alternativa de emissão, Mecanismo de fallback, Fallback **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** F ## O que significa fallback na emissão de notas fiscais? Fallback é uma palavra em inglês que pode ser traduzida como plano B ou alternativa de reserva. Na integração fiscal, é o comportamento que o sistema adota quando a forma normal de emitir uma nota não funciona naquele momento. Imagine uma loja virtual que envia cada venda para ser transformada em NF-e. Se o serviço responsável pela autorização estiver indisponível, o sistema precisa decidir o que fazer: tentar de novo, guardar a nota para depois ou usar um caminho alternativo previsto pela legislação. Essa decisão, planejada com antecedência, é o fallback. ## Para que serve o fallback? O principal objetivo é evitar que uma falha técnica pare a operação da empresa. Sem um plano alternativo, um caixa pode ficar travado, um caminhão pode não sair com a carga ou um pedido pode ficar sem nota. Ele também protege contra erros mais silenciosos, como notas duplicadas ou perdidas. Um fallback bem desenhado garante que cada venda tenha exatamente um documento fiscal, mesmo que o caminho até a autorização tenha sido mais longo que o normal. ## Como funciona o fallback na prática? Primeiro, o sistema precisa perceber que algo deu errado: um timeout, uma resposta de erro do servidor ou um aviso de indisponibilidade. Em seguida, aplica a regra definida para aquele tipo de falha. As estratégias mais comuns são: colocar o documento em uma fila para reenvio automático; redirecionar o envio para um ambiente de contingência autorizado, como a SVC no caso da NF-e; registrar previamente a nota por meio do EPEC; ou, na NFC-e, emitir em contingência offline e transmitir depois. Na NFS-e, alguns municípios permitem a emissão de um RPS para posterior conversão em nota. Depois que o caminho principal volta a funcionar, o sistema conclui o que ficou pendente, como transmitir as notas emitidas em contingência dentro do prazo exigido. ## Qual a diferença entre fallback, retry e contingência? Retry é tentar a mesma operação de novo, pelo mesmo caminho, geralmente com intervalos crescentes. Fallback é mudar de estratégia quando as tentativas não resolvem ou quando já se sabe que o caminho principal está fora do ar. Contingência é o termo usado pelo Fisco para os modos alternativos oficiais de emissão, como SVC, EPEC e a emissão offline da NFC-e. Ou seja, a contingência fiscal é um tipo específico de fallback, com regras definidas pela legislação. O retry costuma ser a primeira etapa, e o fallback entra quando ele não basta. ## Quais cuidados são necessários ao usar fallback? O cuidado mais importante é evitar duplicidade. Se o sistema reenvia uma nota que, na verdade, já tinha sido autorizada, pode gerar dois documentos para a mesma venda. Por isso, o fallback deve trabalhar junto com idempotência e consulta de status antes de reemitir. Também é preciso respeitar as regras de cada modo de contingência, como prazos para transmissão posterior e informações obrigatórias no documento. Por fim, todo acionamento de fallback deve ficar registrado em log, para que a equipe saiba o que aconteceu e consiga auditar depois. ## Como o fallback se aplica a quem usa uma API fiscal? Quando a empresa emite por meio de uma API fiscal, parte do fallback fica com o provedor, que acompanha o documento até a autorização e lida com as comunicações com SEFAZ e prefeituras. Ainda assim, o sistema do cliente precisa ter seu próprio plano para quando a própria API não responder, por exemplo guardando o pedido em fila e reenviando com a mesma chave de idempotência. Na prática, o ERP ou a plataforma de vendas define o que fazer com a venda enquanto aguarda, e a API informa o status final por webhook ou consulta, devolvendo XML e PDF quando a nota for autorizada. ## Exemplos de Fallback na integração fiscal - Um e-commerce envia uma NF-e e recebe timeout. O sistema consulta o status antes de reenviar, descobre que a nota não foi registrada e a coloca na fila para nova tentativa automática. - Durante uma indisponibilidade da SEFAZ de origem, a emissão de NF-e é redirecionada para a SVC, e a empresa continua faturando normalmente. - Um caixa de supermercado perde a conexão com a internet e passa a emitir NFC-e em contingência offline, transmitindo os documentos assim que a conexão retorna. - Um ERP integrado a uma API fiscal guarda os pedidos localmente quando a API está em janela de manutenção e os envia ao fim dela, usando a mesma chave de idempotência para evitar notas duplicadas. ## Perguntas frequentes ### Fallback é o mesmo que contingência fiscal? Não exatamente. Fallback é qualquer plano alternativo técnico. Contingência fiscal é o modo oficial de emissão alternativa previsto pelo Fisco, como SVC, EPEC ou NFC-e offline. A contingência é um tipo de fallback com regras legais específicas. ### O fallback pode gerar notas duplicadas? Pode, se for mal implementado. Para evitar, o sistema deve consultar o status do documento antes de reenviar e usar idempotência, garantindo que a mesma venda não vire duas notas. ### Toda empresa precisa configurar fallback? Qualquer empresa que dependa da emissão automática de notas se beneficia de ter um plano alternativo. Quanto maior o volume e mais crítica a emissão para a operação, mais importante é definir o fallback com antecedência. ## Termos relacionados - [Retry na integração fiscal](https://conota.dev/glossario/retry-na-integracao-fiscal.md) - [SVC](https://conota.dev/glossario/svc.md) - [EPEC](https://conota.dev/glossario/epec.md) - [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md) - [Timeout na emissão fiscal](https://conota.dev/glossario/timeout-na-emissao-fiscal.md) - [Fila de emissão fiscal](https://conota.dev/glossario/fila-de-emissao-fiscal.md) --- Fonte: [Fallback na integração fiscal](https://conota.dev/glossario/fallback-na-integracao-fiscal/) · Atualizado em 2026-10-22