NFC-e

Contingência Offline na NFC-e (tpEmis = 9) para PDV: QR Code, Prazo de 24h e Retransmissão via API

Guia de arquitetura para implementar contingência offline na NFC-e (Modelo 65, tpEmis = 9) em sistemas de PDV: tags dhCont e xJust, cálculo do QR Code offline, impressão térmica 80mm e retransmissão idempotente sem Rejeição 539.

Fábio Magalhães CostaAtualizado em 22/11/2026
Arquitetura de contingência offline (tpEmis = 9) para PDV e frente de caixa emitindo NFC-e Modelo 65

Arquitetura de contingência offline (tpEmis = 9) para PDV e frente de caixa emitindo NFC-e Modelo 65

Quem desenvolve PDV, frente de caixa para restaurantes, supermercados ou varejo físico aprende uma regra dura logo na primeira Black Friday: a fila do caixa não pode parar quando a internet da loja cai ou quando a SEFAZ do estado fica lenta.

Diferente da NF-e (Modelo 55), que usa contingência em nuvem via SVC-AN / SVC-RS, a NFC-e (Modelo 65) foi desenhada para operar em Contingência Offline (tpEmis = 9). Nesse modo, o cupom fiscal é montado, assinado e impresso na hora para o cliente sair da loja com a mercadoria — e transmitido para a SEFAZ assim que a conexão voltar.

O problema é que implementar tpEmis = 9 sem arquitetura cuidadosa gera duplicidade de numeração (Rejeição 539), QR Code inválido (Rejeição 878) e notas rejeitadas após o prazo legal de 24 horas. Abaixo, detalho o fluxo completo de produção para implementar contingência offline de forma segura.


Como funciona o fluxo técnico da Contingência Offline (tpEmis = 9)

Quando o PDV detecta timeout da SEFAZ (ex.: > 5 segundos sem resposta na autorização síncrona) ou queda total de internet local, ele muda o tipo de emissão de 1 (Normal) para 9 (Contingência Offline):

⚡ Fluxo Resiliente de Contingência Offline no PDV:

  • 1. Gatilho de Timeout / Offline: A requisição normal falha por rede ou estoura o SLA do caixa (recomendado: 5s a 8s).
  • 2. Montagem em tpEmis = 9: O documento recebe tpEmis = 9, data/hora de entrada em contingência (dhCont) e justificativa mínima de 15 caracteres (xJust).
  • 3. Nova Chave de Acesso (44 dígitos): Como o dígito do tpEmis (posição 35 da chave) muda de 1 para 9, a chave de acesso muda completamente e o dígito verificador (cDV) é recalculado.
  • 4. Impressão do DANFE NFC-e 80mm: O PDV imprime o cupom com o aviso obrigatório "EMITIDA EM CONTINGÊNCIA — Pendente de autorização" e o QR Code offline (que inclui dia, vNF e digVal).
  • 5. Fila Local + Retransmissão (até 24h): Um worker em background monitora a conectividade e retransmite os cupons pendentes com a mesma chave de acesso e externalId idempotente até receber cStat = 100 (ou 150 se fora do prazo).

Regras obrigatórias da SEFAZ para tpEmis = 9

Antes de codificar o modo offline no seu PDV, valide estas 5 exigências fiscais:

  1. Prazo legal de transmissão: A NFC-e emitida em contingência offline deve ser transmitida para a SEFAZ em até 24 horas após a emissão (regra geral do Ajuste SINIEF 19/2016; alguns estados definem janelas até o primeiro dia útil subsequente). Passado esse prazo, a nota ainda pode ser autorizada fora do prazo (cStat = 150), mas fica sujeita a fiscalização estadual.
  2. Proibido alterar dados após a impressão: Na retransmissão, o XML enviado à SEFAZ deve ser exatamente o mesmo que gerou a chave e o QR Code impressos no papel do cliente. Mudar um centavo ou o cNF gera outra chave e invalida o cupom entregue ao consumidor.
  3. Impressão em 2 vias (ou guarda eletrônica): A legislação exige a impressão do DANFE NFC-e em duas vias (uma para o consumidor e outra para o estabelecimento manter à disposição do Fisco até a autorização), sendo dispensada a segunda via caso o PDV mantenha o XML armazenado de forma segura até a transmissão.
  4. QR Code v2 offline exige digVal e CSC: No modo offline, a URL do QR Code inclui o dia da emissão, o valor total (vNF), o DigestValue da assinatura XML em hexadecimal (digVal), o cIdToken e o hash SHA-1 assinado com o CSC (Código de Segurança do Contribuinte). Qualquer erro de codificação aqui dispara a Rejeição 402 ou 878 da SEFAZ.
  5. Atenção a estados com regras específicas: Em estados com legislação própria de contingência (ou onde o SAT/MFE já foi descontinuado e migrado para NFC-e), verifique se a série utilizada em contingência pode ser a mesma do caixa normal ou se a contabilidade prefere uma série dedicada (ex.: série 900) para evitar colisão de numeração.

Como evitar Rejeição 539 na retransmissão do PDV

O erro mais comum em PDVs que reenviam notas de contingência acontece quando o caixa tenta primeiro no modo normal (tpEmis = 1), toma timeout de rede (mas a SEFAZ na verdade recebeu e autorizou!), e imediatamente gera outra nota com o mesmo número e série em tpEmis = 9.

Quando a internet volta e o PDV tenta transmitir a nota tpEmis = 9, a SEFAZ devolve Rejeição 539: Duplicidade de NFC-e, com diferença na Chave de Acesso.

Como blindar seu PDV contra esse cenário:

  • Nunca reutilize o mesmo número após um timeout sem consultar antes: se o número 1042 (série 1) sofreu timeout em tpEmis = 1, emita a contingência tpEmis = 9 com o próximo número (1043) ou em uma série separada de contingência — e depois reconcilie o número 1042 via consulta de protocolo (cancelando ou inutilizando caso não tenha sido autorizado).
  • Use externalId idempotente na API: toda tentativa de retransmissão da mesma venda deve enviar o mesmo externalId (ex.: pdv_cx02_venda_99210), garantindo que o backend nunca dispare duas autorizações concorrentes. Veja o padrão completo em nosso guia sobre Rejeições 539 e 204 e Idempotência em NF-e/NFC-e.

Payload JSON para envio de NFC-e em Contingência via API da Notaas

Quando seu PDV entra em contingência por instabilidade da SEFAZ estadual (com a loja ainda conectada à internet, ou ao retransmitir o lote pendente), você envia os parâmetros de contingência de forma explícita no endpoint unificado POST /api/v1/emitir da Notaas:

{
  "tipo": "nfce",
  "ambiente": "homologacao",
  "externalId": "pdv_loja01_cx03_venda_55401",
  "naturezaOperacao": "Venda ao consumidor",
  "presencaComprador": 1,
  "contingencia": {
    "tipoEmissao": 9,
    "dataHora": "2026-11-22T18:42:10-03:00",
    "justificativa": "Instabilidade no webservice autorizador da SEFAZ estadual durante pico de caixa"
  },
  "itens": [
    {
      "codigo": "BEB-019",
      "descricao": "Agua Mineral sem Gas 500ml",
      "ncm": "22011000",
      "cfop": "5102",
      "unidade": "UN",
      "quantidade": 2,
      "valorUnitario": 4.50,
      "origem": 0,
      "icms": {
        "csosn": "102"
      }
    }
  ],
  "pagamentos": [
    {
      "forma": "17",
      "valor": 9.00
    }
  ]
}

Worker simples de retransmissão em TypeScript (PDV → API Notaas)

interface PendingOfflineSale {
  saleId: string;
  payload: Record<string, unknown>;
}

export async function flushOfflineNfceQueue(
  pendingSales: PendingOfflineSale[],
  apiKey: string
) {
  for (const sale of pendingSales) {
    const res = await fetch("https://platform.notaas.com.br/api/v1/emitir", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-API-Key": apiKey,
      },
      body: JSON.stringify({
        ...sale.payload,
        externalId: `pdv_offline_${sale.saleId}`,
      }),
    });

    const data = await res.json();

    if (res.ok && (data.status === "authorized" || data.status === "processing")) {
      // Marque a venda como sincronizada no SQLite/IndexedDB local do PDV
      console.log(`NFC-e ${sale.saleId} sincronizada:`, data.id);
    } else {
      console.error(`Falha ao retransmitir ${sale.saleId}:`, data);
    }
  }
}

Prepare seu PDV para alta disponibilidade

Na Notaas, você emite NFC-e (Modelo 65), NF-e (Modelo 55) e NFS-e pelo mesmo contrato JSON, com DANFE térmico 80mm personalizado com logotipo, lock transacional contra Rejeição 539 e 20 notas gratuitas por mês em produção real (1 CNPJ) + até 5 CNPJs em homologação via Org API.

Notaas — Infraestrutura Fiscal Multi-Tenant para SaaS, ERPs e BPOs

Escale a emissão de NFS-e, NF-e, NFC-e, CT-e e MDF-e para dezenas de CNPJs

Integre a API de Nota Fiscal da Notaas no seu software: provisione clientes via Org API Multi-CNPJ, isole certificados A1 em nuvem, receba webhooks assinados com HMAC e gere DANFSe v2.0 local. Sandbox ilimitado e planos sob medida para operações em escala.

Artigos Relacionados em NFC-e

Guias Pilares de Integração Fiscal