Troubleshooting e glossário
Este capítulo reúne os erros e dúvidas mais comuns sobre contingência, as regras de qual Sefaz Virtual é usada por estado, a tabela de tipos de emissão e um glossário dos termos.
Problemas comuns
"Já existe uma contingência cadastrada no período, exclua ou edite a contingência existente!"
Causa: já há uma contingência para a mesma UF com período sobreposto.
Solução: localize e edite a contingência existente daquele estado (ajuste datas/documentos) em vez de criar uma nova.
As notas continuam saindo em contingência mesmo com a SEFAZ no ar.
Causa: existe uma contingência ativa cuja Data Fim ainda não passou.
Solução: edite a contingência e ajuste a Data Fim para o momento atual (ver capítulo 4).
As transmissões em contingência por SVC estão falhando.
Causa: a opção "Enviar para a Sefaz Virtual" está marcada, mas a SVC daquele documento não está realmente "Em Operação".
Solução: confira a SVC na Consulta de Status do Serviço. Se a SVC estiver vermelha, mude para contingência offline (desmarque a opção).
A consulta de status não roda / pede certificado.
Causa: o emitente selecionado não tem certificado digital válido ou está vencido.
Solução: selecione um emitente com certificado em dia. A SEFAZ exige certificado válido até para consultar o status.
Não acho onde "desligar" a contingência. Não há botão de desligar: o encerramento é feito pela Data Fim (ou excluindo o registro). Ver capítulo 4.
Qual Sefaz Virtual (SVC) é usada por estado
Quando a contingência é online, o sistema escolhe automaticamente o autorizador virtual conforme a UF do emitente. As tabelas abaixo refletem o roteamento atual do sistema.
NF-e
| Autorizador virtual | UFs roteadas |
|---|---|
| SVC-AN (Ambiente Nacional) | AC, AL, AP, MG, PB, RJ, RS, RO, RR, SC, SE, SP, TO, DF |
| SVC-RS (Rio Grande do Sul) | AM, BA, CE, ES, GO, MA, MT, MS, PA, PE, PI, RN, PR (demais UFs) |
CT-e
| Autorizador virtual | UFs roteadas |
|---|---|
| SVC-RS (Rio Grande do Sul) | MS, MT, SP, PE, AP, RR |
| SVC-SP (São Paulo) | PR, MG, RS (demais UFs) |
Esse roteamento é definido pela legislação/SEFAZ e pode ser revisado pelo fisco. O usuário não precisa escolher a SVC manualmente — o sistema aplica a regra acima sozinho.
Tabela de tipos de emissão (tpEmis)
Internamente, cada documento guarda um "tipo de emissão" que indica por qual caminho ele foi gerado. Esta tabela ajuda a interpretar relatórios e o XML:
| Código | Tipo de emissão | Observação |
|---|---|---|
| 1 | Normal | Operação normal, sem contingência. |
| 2 | Contingência FS-IA | Formulário de Segurança – Impressor Autônomo (offline, legado). |
| 3 | Contingência SCAN | Modelo antigo, desativado pela SEFAZ. |
| 4 | Contingência EPEC / DPEC | Evento Prévio de Emissão em Contingência (offline com registro prévio). |
| 5 | Contingência FS-DA | Formulário de Segurança – Documento Auxiliar (offline). |
| 6 | SVC-AN | Sefaz Virtual de Contingência – Ambiente Nacional (online). |
| 7 | SVC-RS | Sefaz Virtual de Contingência – Rio Grande do Sul (online). |
| 8 | SVC-SP | Sefaz Virtual de Contingência – São Paulo (online, usado para CT-e). |
| 9 | Contingência off-line da NFC-e | NFC-e impressa e transmitida depois. |
Status retornados pela SEFAZ (mais comuns)
| Código | Significado |
|---|---|
| 107 | Serviço em Operação (tudo certo — linha verde). |
| 108 | Serviço paralisado momentaneamente (curto prazo). |
| 109 | Serviço paralisado sem previsão. |
Os códigos 108/109 (e erros de conexão) são os gatilhos que indicam queda e podem disparar a contingência automática de NF-e (capítulo 4).
Glossário
| Termo | Definição |
|---|---|
| Contingência | Modo de emissão alternativo usado quando a SEFAZ normal está indisponível. |
| SEFAZ de origem / autorizador normal | O ambiente da Secretaria da Fazenda do estado do emitente que normalmente autoriza os documentos. |
| SVC | Sefaz Virtual de Contingência — autorizador alternativo (em outro estado) que recebe documentos quando a SEFAZ de origem cai. Existe para NF-e e CT-e. |
| SVC-AN / SVC-RS / SVC-SP | As três Sefaz Virtuais: Ambiente Nacional, Rio Grande do Sul e São Paulo. Qual é usada depende da UF e do documento. |
| "Enviar para a Sefaz Virtual" | Opção do cadastro que liga a contingência online (via SVC). Vale apenas para NF-e e CT-e. |
| Contingência offline | Documento gerado e impresso na hora, transmitido à SEFAZ depois. Usado quando a SVC não está disponível, e sempre para NFC-e/MDF-e. |
| EPEC / FS-DA | Modalidades de contingência offline de NF-e/CT-e. |
| SAT | Sistema Autenticador e Transmissor — equipamento exigido em SP para vendas ao consumidor quando a NFC-e está indisponível (substitui a contingência offline da NFC-e em SP). |
| tpEmis | Campo do documento que registra o tipo de emissão (ver tabela acima). |
| Status 107 | Código que significa "Serviço em Operação" — autorizador no ar. |
| Regularização | Transmissão e autorização, junto à SEFAZ, dos documentos emitidos offline, feita quando o serviço normal volta. |