Integração
API para Emissão de NFC-e: Como Emitir Cupom Fiscal Eletrônico no Varejo e PDV via REST
Guia completo sobre a API REST para emissão de NFC-e (modelo 65): contingência offline nativa para PDVs, geração de QR Code oficial, cálculo automático de impostos e impressão térmica instantânea com o NFER.
A Nota Fiscal de Consumidor Eletrônica (NFC-e), modelo 65, revolucionou o comércio varejista no Brasil. Ao substituir os antigos e caros Emissores de Cupom Fiscal (ECF) — que exigiam lacres físicos, intervenções técnicas constantes e impressoras homologadas pelo governo —, a NFC-e transferiu a emissão de cupons fiscais para o ambiente 100% digital e em nuvem.
Seja para supermercados de alto volume, redes de fast-food, lojas de shopping, postos de combustível, totens de autoatendimento ou aplicativos móveis de delivery, a velocidade no ponto de venda (PDV) é o fator mais crítico: uma fila de caixa não pode esperar mais do que 1 ou 2 segundos para liberar o cliente.
Com a API de NFC-e do NFER, desenvolvedores de software house, criadores de ERPs e operadores de e-commerce conectam qualquer frente de caixa à SEFAZ via JSON, com cálculo automático de tributos, criptografia de QR Code e suporte robusto a contingência offline.
O Que É a NFC-e (Modelo 65) e Onde Ela É Obrigatória?
A NFC-e é o documento fiscal eletrônico emitido nas operações comerciais presenciais de venda no varejo ou de entrega em domicílio (delivery) destinadas a pessoa física ou jurídica que seja consumidora final.
- Varejo Presencial: Checkout de lojas, supermercados, farmácias, padarias, boutiques e lojas de conveniência.
- Food Service & Restaurantes: Sistemas de comanda eletrônica, fechamento de conta na mesa e totens de autoatendimento.
- SmartPOS e Vendas Móveis: Emissão fiscal direta em máquinas de cartão inteligentes (POS Android da Cielo, Stone, PagBank, Rede, Gertec).
- Delivery Local: Pedidos enviados via frota própria ou motoboy no mesmo município.
Os 5 Maiores Desafios de Desenvolver um Emissor de NFC-e
Construir um módulo de NFC-e internamente é um projeto repleto de armadilhas regulamentares e de infraestrutura:
- Geração e Assinatura do QR Code com Token CSC: Cada empresa precisa cadastrar na SEFAZ o Código de Segurança do Contribuinte (CSC). O XML e o DANFE impresso exigem a composição de um hash SHA-1 criptografado com o IdCSC e o token secreto.
- Contingência Offline Obrigatória no PDV: Se a internet da loja cair ou a SEFAZ oscilar, a fila do caixa não pode parar. O sistema deve emitir a nota em modo offline instantaneamente, imprimir o DANFE com aviso regulamentar e sincronizar os lotes com a SEFAZ em até 24 horas.
- Formatação Térmica (ESC/POS de 80mm e 58mm): O DANFE NFC-e possui layout gráfico rigoroso que precisa caber perfeitamente em impressoras térmicas não fiscais (Epson, Elgin, Bematech, Zebra) ou ser enviado em PDF limpo por WhatsApp/E-mail.
- Múltiplas Formas de Pagamento no Mesmo Cupom: A SEFAZ exige a discriminação exata de valores pagos em Dinheiro, Cartão de Crédito, Cartão de Débito, PIX, Vale Refeição, Vale Alimentação e Carteira Digital.
- Prazos Curtos de Cancelamento: Diferente da NF-e modelo 55 (que geralmente permite até 24h para cancelamento), a NFC-e em vários estados só pode ser cancelada em até 30 minutos após a autorização.
Como a API REST do NFER Simplifica a Emissão de NFC-e
A API NFER elimina 100% da burocracia de XMLs, certificados e criptografia de QR Code. Com um único POST JSON:
- Smart Mode Tributário: O NFER calcula automaticamente alíquotas de ICMS, CSOSN, PIS, COFINS, NCM e CEST conforme o regime tributário da sua empresa.
- Cálculo Automático do QR Code Oficial: O NFER gerencia seu CSC Token na nuvem e gera automaticamente a URL oficial de consulta e o QR Code formatado.
- Tempo de Resposta Ultrarrápido: Autorização na SEFAZ e devolução dos links em menos de 1,2 segundo.
- DANFE Térmico e Envio Digital: Retorno com link direto do PDF formatado para bobinas térmicas de 80mm e 58mm, além de endpoint para envio por e-mail.
Exemplo Prático: Emitindo NFC-e via API REST
Veja como emitir um Cupom Fiscal Eletrônico (NFC-e Modelo 65) com múltiplos pagamentos via cURL:
E a resposta estruturada retornada em JSON pela API do NFER:
Tabela de Formas de Pagamento Suportadas (SEFAZ tPag)
| Código SEFAZ | Forma de Pagamento | Uso no Payload NFER |
|---|---|---|
| 01 | Dinheiro | "forma": "dinheiro" |
| 02 | Cheque | "forma": "cheque" |
| 03 | Cartão de Crédito | "forma": "cartao_credito" (com bandeira e adquirente) |
| 04 | Cartão de Débito | "forma": "cartao_debito" (com bandeira) |
| 10 | Vale Alimentação | "forma": "vale_alimentacao" |
| 11 | Vale Refeição | "forma": "vale_refeicao" |
| 15 | Boleto Bancário | "forma": "boleto" |
| 17 | PIX Dinâmico / Estático | "forma": "pix" |
| 18 | Transferência Bancária / Carteira Digital | "forma": "carteira_digital" (Mercado Pago, PicPay) |
| 90 | Sem Pagamento (Troca/Garantia) | "forma": "sem_pagamento" |
Casos de Uso Ideais para a API de NFC-e NFER
- Software Houses e Desenvolvedores de PDV: Embarque emissão fiscal em seu sistema de frente de caixa com poucas linhas de código.
- Redes de Franquias e Lojas Físicas: Controle centralizado de múltiplos caixas e filiais via painel Multi-CNPJ.
- Totens de Autoatendimento e Kiosks: Emissão autônoma e silenciosa com corte automático de papel.
- Dark Kitchens e Delivery: Emissão automática sincronizada com a impressão da comanda na cozinha.
Automatize seu PDV com a API de NFC-e mais rápida do Brasil
Crie sua conta no NFER agora mesmo. Experimente 30 dias de teste grátis com ambiente de homologação e produção sem burocracia.
Experimentar NFER Grátis por 30 Dias
