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
05 · Stack
| Fiscal | NFC-e modelo 65 (layout 4.00) · XML Signature · certificado A1 · SOAP sobre HttpClient |
|---|---|
| Backend | ASP.NET Core 9 · EF Core · SQL Server |
| Cupom e impressão | HTML → PDF (Chromium headless) · Windows Service · impressão silenciosa |
| Front | React · 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.