Ir para o conteúdo
clabor Manual do ERPia

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#

  1. No rodapé da tela do caixa (perfil Mercado), procure o indicador Fiscal pronto ou Fiscal pendente.
  2. 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)
  3. Para forçar nova sincronização, use o botão Atualizar pacote fiscal dessa linha.
  4. Confira também o painel Carga do servidor: o item Contingência fiscal mostra pronta para emitir ou aguardando pacote fiscal.

BVender com a NFC-e normal#

  1. Lance os itens e receba normalmente.
  2. Ao finalizar, o PDV monta e assina a NFC-e localmente e grava a venda.
  3. 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.
  4. 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#

  1. A venda está concluída e gravada. Não repita a venda e não peça o dinheiro de novo.
  2. Aparece Venda finalizada offline. NFC-e em revisao fiscal.
  3. A pendência aparece no painel fiscal local com a mensagem de validação e a lista de bloqueios.
  4. 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).
  5. 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#

  1. No painel do caixa, clique em Monitor fiscal (o botão só aparece quando há pendência).
  2. O diálogo abre com a contagem: N alerta(s), N DANFE(s) e N encerrado(s).
  3. Leia os Alertas ativos — cada linha traz o que a NFC-e precisa.
  4. Na seção DANFE fiscal autorizado, imprima ou registre a impressão do DANFE liberado.
  5. 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#

  1. Abra o Assistente do caixa quando não souber o que a pendência significa.
  2. Ele responde em português claro com o que aconteceu, a próxima ação e um código.
  3. Feche em Entendi.

O assistente é orientação de operação; ele não corrige a nota.

FImprimir o DANFE fiscal e o cupom#

  1. No Monitor fiscal, localize o DANFE na lista de autorizados.
  2. Clique para imprimir e registre a impressão.
  3. 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#

  1. Abra Comprovantes e escolha o cupom.
  2. Confirme em Cancelar cupom, informando o Motivo.
  3. O cancelamento exige a permissão cancelar_cupom; se o seu perfil não tiver, o gerente autoriza na hora.
  4. 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:

AssuntoOnde
Configurar NFC-e, perfis fiscais, certificado, SPED e falar com o contadorFiscal
Conferir o que subiu do caixa, corrigir cadastro e reprocessar notaRetaguarda
Resolver um sintoma específico que já apareceuSolução de problemas

Campos e o que significam#

Indicadores de prontidão fiscal#

MensagemSignifica
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 mostradoO que falta
pacote fiscal ausenteo terminal nunca sincronizou o pacote fiscal
permissao ausentea loja não tem contingência offline permitida
certificado A1 ausenteo certificado digital não chegou ao caixa
senha A1 ausentea senha do certificado não chegou
ID do CSC ausente / CSC ausenteo identificador ou o token do CSC não chegaram
CNPJ ausenteo emitente está sem CNPJ no pacote
inscricao estadual ausenteo emitente está sem inscrição estadual
municipio ausente / UF ausenteo endereço fiscal do emitente está incompleto
serie invalidaa série da NFC-e do terminal está inválida
prazo invalidoo prazo de envio da contingência está inválido
CNPJ alfanumerico aguardando layout SEFAZo CNPJ alfanumérico depende de layout ainda não disponível

Status da NFC-e no monitor#

Status mostradoO que é
Autorizadaa SEFAZ autorizou a nota
Transmitidaenviada, aguardando retorno
Aguardando assinaturafalta assinar o XML
Aguardando envioassinada e na fila de transmissão
Em revisaonão foi possível emitir agora; a venda está gravada e a pendência é da retaguarda
Rejeitadaa SEFAZ recusou; exige correção
Cancelada, Denegada, Inutilizadaestados finais

Ações operacionais que o monitor mostra#

Ação mostradaO que significa para o caixa
Imprimir DANFE fiscalo DANFE foi liberado; imprima e registre
Corrigir cadastro e reenviaro cadastro é corrigido na retaguarda; depois sincronize
Consultar contadorenvolve o contador antes de seguir
Encerrar monitoramentoa pendência foi resolvida; tira o alerta da tela
Reenviar quando houver internetnada a fazer no caixa além de manter a rede
Assinar XMLfalta a assinatura da nota
Revisar dados fiscaisos dados fiscais do emitente ou do item precisam de revisão
Aguardar autorizacao / Acompanhar statusaguardar; o caixa não tem ação
Enviar cancelamento NFC-ecancelamento 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#

SintomaCausa provávelO que fazer
Fiscal pendente no rodapépacote fiscal incompleto ou nunca sincronizadoclique em Atualizar pacote fiscal; se o bloqueio persistir, chame a retaguarda
Aguardando pacote fiscal no painel de cargao item Contingência fiscal ainda não chegoumesma ação acima
Venda finalizada offline. NFC-e em revisao fiscal.a NFC-e local não pôde ser geradaa 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ãomantenha o terminal ligado e sincronizando; nada mais no caixa
Contingencia bloqueada: certificado A1 ausente e mais N.o pacote não trouxe o certificadoa venda continua; a correção é da retaguarda
Impressora desativada para DANFE NFC-e.impressão de DANFE desligada na configuraçãoligue a impressão de DANFE no terminal ou avise a retaguarda
Cupom cancelado com NFC-e autorizadao cancelamento foi agendado na SEFAZnão há como desfazer no caixa; comunique a retaguarda no mesmo dia
Nenhuma NFC-e exigindo ação fiscal agora.não há pendêncianada a fazer

Como funciona por dentro#

  • O pacote fiscal é o passaporte da contingência. O PDV pede GET /api/v1/pdvs/{pdv_id}/pacote-fiscal e 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_revisao com 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#

PontoPadrão de fábricaComo fica diferente
Emitir NFC-e em contingência quando a internet ou a SEFAZ cailigado (nfce.emitir_contingencia_automaticamente nasce habilitado)desligado, a venda fica sem documento até a conexão voltar
Assinatura local no terminaldepende 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 terminalvêm do pacote fiscal, não da tela do caixadefinidos na retaguarda, em Fiscal › Perfis fiscais e na ficha da loja
Prazo de envio da contingênciajanela configurável da empresa — o sistema não prova prazo legalo 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.