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

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
    }
  }'

Formas de Pagamento

| Código | Forma | |--------|-------| | 01 | Dinheiro | | 02 | Cheque | | 03 | Cartão de Crédito | | 04 | Cartão de Débito | | 05 | Crédito Loja | | 10 | Vale Alimentação | | 11 | Vale Refeição | | 13 | Vale Presente | | 15 | Boleto | | 99 | Outros |

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" }'

Próximos passos