Fiscal no caixa: NFC-e, contingência e monitor#
Esta página explica o que o operador precisa saber do fiscal para não travar a fila: como conferir se a NFC-e está pronta antes de vender, o que aparece quando a nota não pôde ser emitida na hora e o que fazer com o monitor fiscal e o DANFE. É para o operador e para o supervisor do caixa.
Antes de começar
- O terminal precisa ter sincronizado o pacote fiscal pelo menos uma vez. É ele que traz para o caixa o que a contingência offline exige.
- A NFC-e é assinada no próprio PDV quando a conexão cai. Sem o pacote completo, a contingência fica bloqueada — mas a venda não é bloqueada.
Passo a passo#
AConferir a prontidão fiscal antes de começar#
- No rodapé da tela do caixa (perfil Mercado), procure o indicador Fiscal pronto ou Fiscal pendente.
- Abra Status do PDV e localize a linha NFC-e. A mensagem diz uma de duas coisas:
Contingencia offline pronta neste caixa.Contingencia bloqueada: <motivo>.(ou… e mais <n>, quando há vários bloqueios)
- Para forçar nova sincronização, use o botão Atualizar pacote fiscal dessa linha.
- Confira também o painel Carga do servidor: o item Contingência fiscal mostra
pronta para emitirouaguardando pacote fiscal.
BVender com a NFC-e normal#
- Lance os itens e receba normalmente.
- Ao finalizar, o PDV monta e assina a NFC-e localmente e grava a venda.
- A mensagem de retorno diz o que aconteceu:
Venda finalizada e sincronizada.Venda finalizada em contingencia. NFC-e local pronta para envio.Venda finalizada offline. NFC-e em revisao fiscal.
- Entregue o cupom ao cliente. O cupom é a representação da venda; a nota fiscal eletrônica segue o fluxo da retaguarda.
CQuando a nota fica em revisão fiscal#
- A venda está concluída e gravada. Não repita a venda e não peça o dinheiro de novo.
- Aparece
Venda finalizada offline. NFC-e em revisao fiscal. - A pendência aparece no painel fiscal local com a mensagem de validação e a lista de bloqueios.
- Se o alerta estiver aceso, clique em Monitor fiscal e leia a linha da NFC-e: ela mostra o status (Em revisao), a ação operacional esperada e a chave resumida (
Chave NFC-e ...12345678). - Ação de operação: avise a retaguarda e siga vendendo. A correção e o reprocessamento fiscal são trabalho da retaguarda, não do caixa.
DUsar o Monitor fiscal NFC-e#
- No painel do caixa, clique em Monitor fiscal (o botão só aparece quando há pendência).
- O diálogo abre com a contagem:
N alerta(s), N DANFE(s) e N encerrado(s). - Leia os Alertas ativos — cada linha traz o que a NFC-e precisa.
- Na seção DANFE fiscal autorizado, imprima ou registre a impressão do DANFE liberado.
- Use Encerrar monitoramento apenas quando a pendência estiver realmente resolvida. Se encerrar cedo, o alerta sai da tela e o problema continua existindo.
Sem pendência a tela diz: Nenhuma NFC-e exigindo ação fiscal agora.
EAssistente do caixa#
- Abra o Assistente do caixa quando não souber o que a pendência significa.
- Ele responde em português claro com o que aconteceu, a próxima ação e um código.
- Feche em Entendi.
O assistente é orientação de operação; ele não corrige a nota.
FImprimir o DANFE fiscal e o cupom#
- No Monitor fiscal, localize o DANFE na lista de autorizados.
- Clique para imprimir e registre a impressão.
- Se aparecer
Impressora desativada para DANFE NFC-e., a impressão de DANFE está desligada na configuração do terminal — veja Hardware e periféricos.
GCancelar um cupom já finalizado#
- Abra Comprovantes e escolha o cupom.
- Confirme em Cancelar cupom, informando o Motivo.
- O cancelamento exige a permissão
cancelar_cupom; se o seu perfil não tiver, o gerente autoriza na hora. - O PDV responde
Cupom cancelado localmente.
HRegistrar devolução ou troca#
A devolução estorna dinheiro do caixa. O fluxo está em Vender, seção K, e exige a
permissão devolucao.
ISaber onde o assunto continua#
Tudo o que o caixa não resolve é trabalho de outra ponta do sistema:
| Assunto | Onde |
|---|---|
| Configurar NFC-e, perfis fiscais, certificado, SPED e falar com o contador | Fiscal |
| Conferir o que subiu do caixa, corrigir cadastro e reprocessar nota | Retaguarda |
| Resolver um sintoma específico que já apareceu | Solução de problemas |
Campos e o que significam#
Indicadores de prontidão fiscal#
| Mensagem | Significa |
|---|---|
Fiscal pronto / Contingencia offline pronta neste caixa. | o pacote fiscal está completo: o caixa consegue emitir NFC-e offline |
Fiscal pendente / Contingencia bloqueada: <motivo>. | falta algum item do pacote — a venda continua, a nota vai para revisão |
Contingencia bloqueada: <motivo> e mais <n>. | há mais de um bloqueio; o primeiro é mostrado |
Motivos de bloqueio da contingência#
| Motivo mostrado | O que falta |
|---|---|
pacote fiscal ausente | o terminal nunca sincronizou o pacote fiscal |
permissao ausente | a loja não tem contingência offline permitida |
certificado A1 ausente | o certificado digital não chegou ao caixa |
senha A1 ausente | a senha do certificado não chegou |
ID do CSC ausente / CSC ausente | o identificador ou o token do CSC não chegaram |
CNPJ ausente | o emitente está sem CNPJ no pacote |
inscricao estadual ausente | o emitente está sem inscrição estadual |
municipio ausente / UF ausente | o endereço fiscal do emitente está incompleto |
serie invalida | a série da NFC-e do terminal está inválida |
prazo invalido | o prazo de envio da contingência está inválido |
CNPJ alfanumerico aguardando layout SEFAZ | o CNPJ alfanumérico depende de layout ainda não disponível |
Status da NFC-e no monitor#
| Status mostrado | O que é |
|---|---|
| Autorizada | a SEFAZ autorizou a nota |
| Transmitida | enviada, aguardando retorno |
| Aguardando assinatura | falta assinar o XML |
| Aguardando envio | assinada e na fila de transmissão |
| Em revisao | não foi possível emitir agora; a venda está gravada e a pendência é da retaguarda |
| Rejeitada | a SEFAZ recusou; exige correção |
| Cancelada, Denegada, Inutilizada | estados finais |
Ações operacionais que o monitor mostra#
| Ação mostrada | O que significa para o caixa |
|---|---|
Imprimir DANFE fiscal | o DANFE foi liberado; imprima e registre |
Corrigir cadastro e reenviar | o cadastro é corrigido na retaguarda; depois sincronize |
Consultar contador | envolve o contador antes de seguir |
Encerrar monitoramento | a pendência foi resolvida; tira o alerta da tela |
Reenviar quando houver internet | nada a fazer no caixa além de manter a rede |
Assinar XML | falta a assinatura da nota |
Revisar dados fiscais | os dados fiscais do emitente ou do item precisam de revisão |
Aguardar autorizacao / Acompanhar status | aguardar; o caixa não tem ação |
Enviar cancelamento NFC-e | cancelamento solicitado no PDV, aguardando a retaguarda |
Resultado esperado#
- Com o pacote completo, o rodapé mostra Fiscal pronto e a linha NFC-e diz
Contingencia offline pronta neste caixa. - Sem internet, a venda finaliza e o cupom sai; a mensagem diferencia contingência pronta de revisão fiscal.
- O botão Monitor fiscal aparece no painel sempre que existir pendência fiscal local.
- O valor da venda continua entrando no caixa e no turno, mesmo com a nota em revisão.
Se algo der errado#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
Fiscal pendente no rodapé | pacote fiscal incompleto ou nunca sincronizado | clique em Atualizar pacote fiscal; se o bloqueio persistir, chame a retaguarda |
Aguardando pacote fiscal no painel de carga | o item Contingência fiscal ainda não chegou | mesma ação acima |
Venda finalizada offline. NFC-e em revisao fiscal. | a NFC-e local não pôde ser gerada | a venda está concluída: não repita a venda; abra o Monitor fiscal e avise a retaguarda |
Venda finalizada em contingencia. NFC-e local pronta para envio. | a nota foi assinada no caixa e aguarda transmissão | mantenha o terminal ligado e sincronizando; nada mais no caixa |
Contingencia bloqueada: certificado A1 ausente e mais N. | o pacote não trouxe o certificado | a venda continua; a correção é da retaguarda |
Impressora desativada para DANFE NFC-e. | impressão de DANFE desligada na configuração | ligue a impressão de DANFE no terminal ou avise a retaguarda |
| Cupom cancelado com NFC-e autorizada | o cancelamento foi agendado na SEFAZ | não há como desfazer no caixa; comunique a retaguarda no mesmo dia |
Nenhuma NFC-e exigindo ação fiscal agora. | não há pendência | nada a fazer |
Como funciona por dentro#
- O pacote fiscal é o passaporte da contingência. O PDV pede
GET /api/v1/pdvs/{pdv_id}/pacote-fiscale guarda o retorno no banco local. É dele que saem certificado, senha, CSC, série, dados do emitente e prazo de envio da contingência. - Prontidão é conferida antes de gerar. Antes de montar a NFC-e local o PDV reavalia o pacote; faltando qualquer item obrigatório, a contingência fica bloqueada e a venda cai em
em_revisaocom o motivo junto — sem isso o operador não saberia qual produto ou regra travou. - A recusa fiscal do item não derruba a venda. Erro de cálculo fiscal também termina em
em_revisao, e não em exceção que travaria o caixa com o cliente na frente. - Tudo local primeiro. A NFC-e é montada com dados que já estão no terminal; a tela do operador não espera transmissão. A transmissão e a conciliação são assíncronas e idempotentes por UUID.
- Assinatura local é a fiscalmente válida. O marcador de assinatura não fiscal existe apenas para teste e compatibilidade — ele não libera NFC-e fiscal.
- Norma do meio de pagamento. Crédito e débito são declarados separadamente na nota (exigência da IN 87/2025): por isso o PDV separa as duas formas em vez de usar um "cartão" genérico.
Divergência conhecida#
O documento de fluxo da origem descreve o pedido do pacote fiscal "com código de ativação do
PDV". No código atual a rota aceita token de dispositivo OU código de ativação, e um terminal
já pareado manda o token. Para o operador o efeito é nenhum; para quem for depurar um 401 na
sincronização fiscal, a diferença importa.
O que é de fábrica e o que a sua loja pode ter mudado#
| Ponto | Padrão de fábrica | Como fica diferente |
|---|---|---|
| Emitir NFC-e em contingência quando a internet ou a SEFAZ cai | ligado (nfce.emitir_contingencia_automaticamente nasce habilitado) | desligado, a venda fica sem documento até a conexão voltar |
| Assinatura local no terminal | depende do pacote fiscal presente no caixa (certificado A1, senha, CSC, série e config fiscal da loja) | sem pacote completo, a contingência fica bloqueada e a venda sobe com status_nfce = em_revisao — a venda não é bloqueada |
| Ambiente fiscal (homologação ou produção) e série do terminal | vêm do pacote fiscal, não da tela do caixa | definidos na retaguarda, em Fiscal › Perfis fiscais e na ficha da loja |
| Prazo de envio da contingência | janela configurável da empresa — o sistema não prova prazo legal | o prazo legal é norma externa da sua UF; quem decide é o contador |
Os valores vigentes da sua loja ficam em Administração › Parâmetros; a tabela completa está em Parâmetros e valores padrão.