NFER
Visão GeralQuick StartAutenticaçãoAmbientesConfiguração InicialExemplos de RequisiçãoGlossário FiscalChecklist de Go-LiveFAQModelo de DadosCiclo de Vida & FluxoContingência AutomáticaLimites & Rate LimitEvitando DuplicidadeErros e RetransmissãoSplit Fiscal HíbridoNovoConceitosEmissão Passo a PassoConceitosEmissão Passo a PassoConceitosEmissão Passo a PassoCódigos de ServiçoConceitosEmissão Passo a PassoNovoRegimes, CST e CFOPEventos FiscaisVisão Geral & CronogramaNovos Campos na APITabela cClassTribDevoluções & AnulaçõesChecklist de MigraçãoVisão Geral & NSUCorporate+NF-e Recebidas & MD-eCorporate+NFS-e Tomadas (ADN)Corporate+CT-e Fretes & DesacordoCorporate+White-Label & Org APIEmpresaCertificado A1 & CSCHabilitação SEFAZCadastrosNumeraçãoPlanos

Emissão NFC-e Passo a Passo

Venda balcão, cupom térmico ESC/POS, contingência offline e cancelamento.

Guia passo a passo para emissão de NFC-e (Nota Fiscal de Consumidor Eletrônica — Modelo 65) no varejo presencial e delivery. A API oferece velocidade de autorização para o ponto de venda (PDV), geração de QR Code da SEFAZ e suporte nativo a comandos térmicos ESC/POS (80mm e 58mm).

BASE URL
https://api.nfer.me/v1

Requisitos Prévios: CSC e ID CSC

Antes da primeira emissão, a empresa precisa ter o Código de Segurança do Contribuinte (CSC) e o ID do CSC vinculados no cadastro. Eles são gerados no portal da SEFAZ estadual e utilizados na assinatura criptográfica do QR Code impresso no cupom.

Configuração Rápida do CSC

Veja como cadastrar suas credenciais de varejo em Conceitos e CSC de NFC-e.

Passo 1: Emitir o Cupom Fiscal (POST /v1/nfce)

No PDV, a identificação do comprador é opcional. Se o cliente solicitar CPF na nota, basta enviar o CPF e o nome:

POST/v1/nfce

Emite cupom fiscal modelo 65 com cálculo tributário automático.

curl -s -X POST https://api.nfer.me/v1/nfce \
-H "X-API-Key: $NFER_KEY" \
-H "Content-Type: application/json" \
-d '{
"naturezaOperacao": "VENDA AO CONSUMIDOR",
"indPres": "1",
"serie": 1,
"destinatario": {
"cpf": "12345678901",
"nome": "Consumidor Final"
},
"itens": [
{
"id": "e4c5b6a7-8901-4def-1234-56789abcdef0",
"numero": 304,
"serie": 1,
"modelo": "65",
"status": "rascunho",
"naturezaOperacao": "VENDA AO CONSUMIDOR",
"valorTotal": 38.00,
"created_at": "2026-09-20T21:00:00.000Z"
}

Após criar o rascunho com o próximo número reservado atomicamente, transmita à SEFAZ para autorização em tempo real:

POST/v1/nfce/:id/send

Transmite e enfileira a NFC-e para assinatura e autorização SEFAZ.

curl -s -X POST https://api.nfer.me/v1/nfce/e4c5b6a7-8901-4def-1234-56789abcdef0/send \
-H "X-API-Key: $NFER_KEY"
{
"message": "NFC-e queued for sending",
"jobId": "job_nfce_987654"
}

Passo 2: Impressão Térmica Direta (ESC/POS)

Após a autorização na SEFAZ, o NFER entrega o buffer pronto com o QR Code pré-renderizado no protocolo nativo ESC/POS (80mm ou 58mm):

GET/v1/nfce/:id/escpos

Retorna stream binário ou buffer Base64 formatado para 80mm ou 58mm.

# Baixar bytes binários prontos para envio à porta da impressora (COM / USB / TCP)
curl -s "https://api.nfer.me/v1/nfce/e4c5b6a7-8901-4def-1234-56789abcdef0/escpos?largura=80" \
-H "X-API-Key: $NFER_KEY" \
-o cupom_terminal.bin

Cancelamento de NFC-e (Prazo de 30 Minutos)

Diferente da NF-e (prazo padrão de 24h), a legislação de NFC-e na maioria das Unidades Federativas exige que o cancelamento ocorra em no máximo 30 minutos após a autorização e desde que a mercadoria não tenha saído da loja. O cancelamento utiliza o endpoint unificado de notas fiscais:

POST/v1/nfe/:id/cancel

Enfileira cancelamento do cupom NFC-e (modelo 65) perante a SEFAZ.

curl -s -X POST https://api.nfer.me/v1/nfe/e4c5b6a7-8901-4def-1234-56789abcdef0/cancel \
-H "X-API-Key: $NFER_KEY" \
-H "Content-Type: application/json" \
-d '{
"justificativa": "Cliente solicitou cancelamento no caixa antes da entrega"
}'

Vedada a Carta de Correção (CC-e)

Conforme o Ajuste SINIEF 19/2016, não existe Carta de Correção Eletrônica para NFC-e. Erros de dados exigem o cancelamento do cupom e a emissão de um novo documento.

Próximos Passos

AnteriorConceitosPróximoConceitos