Pular para o conteúdo
LFD

Case 04 · Fiscal

NFC-e no balcão

Emissão de NFC-e integrada ao ERP da Fitacabo, sem software fiscal de terceiros — da venda no PDV à impressão do cupom.

Cliente
Fitacabo
Área
Fiscal
Período
2025 — 2026

01 · Contexto

A Fitacabo vende no balcão e precisava emitir o cupom fiscal eletrônico (NFC-e) direto do sistema, com a venda registrada no ERP.

02 · Problema

Depender de software fiscal de terceiros significava duplicar cadastro, pagar licença e não ter controle quando a SEFAZ devolvia algo inesperado.

03 · O que a LFD construiu

  • PDV web que envia só o essencial da venda; o backend monta a nota completa.
  • XML 4.00, chave de acesso e QR Code; assinatura digital com certificado A1 e comunicação SOAP com a SEFAZ — escritas pela LFD, sem bibliotecas fiscais prontas.
  • Emissão, cancelamento, inutilização e consulta de situação.
  • Classificador de retornos da SEFAZ: respostas ambíguas e timeouts viram estado indefinido, que dispara consulta antes de qualquer reemissão.
  • Cupom de 80 mm em PDF e impressão silenciosa por um serviço Windows local.
  • Grupos IBS/CBS da reforma tributária e CNPJ alfanumérico.
  • Telas de gestão das notas e dos parâmetros fiscais.

04 · Arquitetura

FIG. 04 — NFC-e no balcãoDa venda no balcão ao cupom impresso, com a SEFAZ no meio e o ERP sempre atualizado.
retorno ambíguo → consulta antes de reemitir01PDVReact02API .NETmódulo NFC-e03ERPpedido e nota04XML 4.00assinatura A105SEFAZautorização06CUPOMPDF 80 mm07IMPRESSORAserviço local

05 · Stack

FiscalNFC-e modelo 65 (layout 4.00) · XML Signature · certificado A1 · SOAP sobre HttpClient
BackendASP.NET Core 9 · EF Core · SQL Server
Cupom e impressãoHTML → PDF (Chromium headless) · Windows Service · impressão silenciosa
FrontReact · Vite · Tailwind

06 · Resultado

  • Emissão de NFC-e em produção no balcão, integrada ao ERP.
  • 35 endpoints fiscais e cerca de 110 testes automatizados na parte fiscal.
  • Um incidente real — nota presa após retorno ambíguo — virou regra: nenhuma reemissão sem consulta antes.
  • DANFE de NF-e em PDF gerado a partir do XML, substituindo o relatório antigo em Crystal.

07 · Aprendizado

Em integração fiscal, timeout não é falha: é dúvida. Primeiro se consulta, depois se decide — idempotência é o que evita nota duplicada.