Emissão NFC-e Passo a Passo
Venda balcão, cupom térmico ESC/POS, contingência offline e cancelamento.
A NFC-e (Nota Fiscal de Consumidor Eletrônica, modelo 65) é o documento fiscal oficial para operações de varejo presencial e entrega a domicílio (delivery) direto ao consumidor final. Substitui o antigo cupom fiscal ECF e o SAT, trazendo velocidade de autorização no checkout e geração de QR Code oficial da SEFAZ.
Para operações com empresas (B2B), atacado ou mercadorias com DANFE A4 em trânsito, utilize Emissão de NF-e (modelo 55).
Exemplo de Criação no PDV
Requisição padrão de checkout no balcão com CPF na nota opcional e pagamento via PIX ou Cartão:
Fluxo de Emissão em 3 Etapas
Criar Cupom
Gera o rascunho com o próximo número fiscal reservado e valida os itens. Responde 201 Created em ~50ms com o ID da nota.
Transmitir à SEFAZ
Assina com Certificado A1, calcula o hash SHA-1 do QR Code com o CSC e transmite à SEFAZ via fila rápida (202 Accepted).
Imprimir Cupom
Envie comandos binários nativos ESC/POS (80mm/58mm) direto para a impressora do caixa ou baixe o PDF térmico formatado.
Estrutura do Payload
Principais grupos de dados no cupom fiscal de consumidor:
| Bloco | Campo | Propósito e Conteúdo |
|---|---|---|
| Modo de Emissão | transmitir | Boolean (opcional, default: false). Se true (ou transmit: true), aciona a Emissão Direta em 1 passo: grava o cupom e já enfileira imediatamente a transmissão para a SEFAZ com status "processando", dispensando chamar o endpoint /send. Se false ou omitido, salva como rascunho. |
| Destinatário | destinatario | Opcional no PDV. Se o cliente solicitar CPF/CNPJ no cupom, informe cpfCnpj e nome. |
| Disparo de E-mail | enviarEmail | Boolean (opcional). Controla o envio automático do DANFE NFC-e e XML ao e-mail informado em destinatario.email após a autorização na SEFAZ. Se true, força o envio; se false, desativa para este cupom. Se omitido, respeita a configuração global da empresa. |
| Itens do Cupom | itens[] | Lista de mercadorias: descrição, NCM, quantidade, valorUnitario e tributação (ou tipoItem / fiscalProfileId). |
| Pagamentos | pagamentos[] | Formas de pagamento da venda (01 Dinheiro, 03 Crédito, 04 Débito, 17 PIX, etc.) com suporte a pagamentos mistos e dados de maquininha TEF/POS. |
| Presença / Delivery | indPres | "1" para operação presencial no caixa ou "4" para entrega em domicílio (delivery). |
| Intermediador Delivery | intermediador | Obrigatório para pedidos de delivery intermediados por apps (iFood, Rappi, etc.): CNPJ da plataforma e identificador do pedido. |
| Reforma Tributária | reformaTributaria | Detalhamento do IVA Dual no item: cClassTrib, CST de IBS/CBS e alíquotas proporcionais de teste. |
Operações Relacionadas
Endpoints dedicados para o ciclo completo da NFC-e no ponto de venda:
| Operação | Método e Rota | Referência Técnica |
|---|---|---|
| Criar Cupom NFC-e | POST /v1/nfce | Ver Parâmetros & Presets → |
| Transmitir à SEFAZ | POST /v1/nfce/:id/send | Ver Transmissão Imediata → |
| Consultar Cupom | GET /v1/nfce/:id | Ver Retorno e Status → |
| Stream ESC/POS (80mm/58mm) | GET /v1/nfce/:id/escpos | Ver Buffer Térmico → |
| Baixar DANFE NFC-e (PDF) | GET /v1/nfce/:id/danfe | Ver PDF Cupom → |
| Baixar XML Protocolado | GET /v1/nfce/:id/xml | Ver Download do XML → |
| Cancelar Cupom (Até 30 min) | POST /v1/nfe/:id/cancel | Ver Regras de Cancelamento → |
Próximos Passos
- Teste o endpoint com presets prontos em Referência da API NFC-e.
- Entenda como operar sem internet em Contingência Offline no PDV.
- Receba confirmação em tempo real configurando Webhooks NFC-e.