NFCe — Nota Fiscal de Consumidor Eletrônica A NFCe (modelo 65) é o documento fiscal para vendas a consumidor final no varejo. Substitui o cupom fiscal e deve ser emitida no momento da venda.
Endpoint base: https://api.engineapi.com.br/nfce
Ponto de venda Ideal para varejo e e-commerce com venda direta
QR Code incluso Resposta inclui QR Code para consulta do consumidor
Cupom em HTML Download do cupom fiscal em HTML ou PDF
Diferenças NFe vs NFCe Aspecto NFe (modelo 55) NFCe (modelo 65) Destinatário Empresa ou pessoa física Consumidor final (CPF opcional) Identificador IE Obrigatório Não informado CFOP 5102, 6102… 5102 (sempre estadual) QR Code Não Sim (obrigatório) Uso B2B e B2C Somente B2C (varejo)
Emitir NFCe curl -X POST https://api.engineapi.com.br/nfce \ -H "x-api-key: SUA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "issuerId": "ISSUER_ID", "naturezaOperacao": "VENDA A CONSUMIDOR", "consumidor": { "cpf": "12345678901", "nome": "Consumidor Final" }, "itens": [{ "numero": 1, "codigo": "PROD001", "descricao": "Camiseta Azul M", "ncm": "61091000", "cfop": "5102", "unidade": "UN", "quantidade": 1, "valorUnitario": 89.90, "valorTotal": 89.90, "icms": { "origem": 0, "csosn": "400" } }], "pagamento": { "forma": "03", "valor": 89.90 } }'
const nfce = await fetch ( 'https://api.engineapi.com.br/nfce' , { method: 'POST' , headers: { 'x-api-key' : process . env . ENGINE_API_KEY ! , 'Content-Type' : 'application/json' , }, body: JSON . stringify ({ issuerId: 'ISSUER_ID' , naturezaOperacao: 'VENDA A CONSUMIDOR' , consumidor: { cpf: '12345678901' , nome: 'Consumidor Final' }, itens: [{ numero: 1 , codigo: 'PROD001' , descricao: 'Camiseta Azul M' , ncm: '61091000' , cfop: '5102' , unidade: 'UN' , quantidade: 1 , valorUnitario: 89.90 , valorTotal: 89.90 , icms: { origem: 0 , csosn: '400' }, }], pagamento: { forma: '03' , valor: 89.90 }, }), }). then ( r => r . json ()); console . log ( 'NFCe autorizada:' , nfce . accessKey ); console . log ( 'QR Code:' , nfce . qrCodeUrl );
Código Forma 01Dinheiro 02Cheque 03Cartão de Crédito 04Cartão de Débito 05Crédito Loja 10Vale Alimentação 11Vale Refeição 13Vale Presente 15Boleto 99Outros
Response de Sucesso { "success" : true , "nfce" : { "id" : "3fa85f64-5717-4562-b3fc-2c963f66afa6" , "accessKey" : "35260211222333000144650010000000011000000019" , "status" : "AUTHORIZED" , "protocol" : "135260000001234" , "qrCodeUrl" : "https://www.fazenda.sp.gov.br/nfce/qrcode?p=35260..." , "cupomUrl" : "/nfce/pdf/35260..." , "xmlUrl" : "/nfce/xml/35260..." , "createdAt" : "2026-04-27T02:00:00.000Z" } }
Download do Cupom Fiscal O cupom é retornado em HTML renderizável:
curl https://api.engineapi.com.br/nfce/pdf/ACCESS_KEY \ -H "x-api-key: SUA_API_KEY"
A resposta é HTML com layout de cupom fiscal 80mm, pronto para impressão em impressoras térmicas.
Cancelar NFCe curl -X POST https://api.engineapi.com.br/nfce/ID/cancelar \ -H "x-api-key: SUA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "motivo": "Erro na forma de pagamento informada" }'
O cancelamento é permitido em até 30 minutos após a autorização para NFCe (diferente dos 24h da NFe).
Próximos passos
Emitir NFe Para vendas B2B com dados completos do destinatário
Webhooks Receba eventos de NFCe em tempo real
