NFC-e — Cupom Fiscal (modelo 65)

Nota Fiscal de Consumidor Eletrônica: venda presencial ao consumidor final (PDV, loja física). Autorização síncrona na maioria das UFs (SP e RS devolvem o protocolo na própria resposta do lote).

Emitir

POST /api/v1/nfce
Authorization: Bearer {token}
Content-Type: application/json
Idempotency-Key: pdv-1-venda-8842

Idempotency-Key é opcional, mas use sempre em integração: retry com a mesma chave devolve a mesma nota, sem emitir duas. Detalhes em Idempotência.

{
  "ide": { "serie": 6, "nNF": 118 },
  "det": [{
    "prod": {
      "cProd": "7891234567890", "cEAN": "7891234567890",
      "xProd": "ARROZ TIPO 1 5KG", "NCM": "10063021", "CFOP": "5102",
      "uCom": "UN", "qCom": "2", "vUnCom": "24.90", "vProd": "49.80",
      "cEANTrib": "7891234567890", "uTrib": "UN", "qTrib": "2",
      "vUnTrib": "24.90", "indTot": "1"
    },
    "imposto": {
      "ICMS":   { "ICMS40": { "orig": "0", "CST": "40" } },
      "PIS":    { "PISNT": { "CST": "06" } },
      "COFINS": { "COFINSNT": { "CST": "06" } }
    }
  }],
  "total": { "vProd": "49.80", "vNF": "49.80" },
  "pag": [{ "tPag": "01", "vPag": "49.80" }]
}

Pontos que a SEFAZ cobra na NFC-e

• Numeração é sua: ide.nNF é obrigatório — a NFC-e não auto-incrementa (o PDV é o dono da sequência).
• CSC: cadastrado na empresa (painel → Empresa), usado no QR Code. Sem ele a nota não valida.
• Pagamento em cartão (tPag 03/04) exige o grupo card — enviamos tpIntegra=2 (maquininha não integrada) por padrão; informe card.tpIntegra=1
  • CNPJ da credenciadora se o PDV for integrado (rejeição 391 sem isso).
• vTotTrib é calculado automaticamente quando ausente.
• Destinatário é opcional; para CPF na nota, informe dest.cpf.

Resposta

{
  "id": "uuid",
  "chave": "35260814295537000130650060000001181...",
  "status": "processando",
  "message": "NFC-e enfileirada"
}

Acompanhe por GET /api/v1/nfce/{id} — em UF síncrona a autorização chega em segundos. O webhook (se configurado) recebe o desfecho.

Cancelar

POST /api/v1/nfce/{id}/cancelar

{ "justificativa": "Erro de digitação no item da venda" }

⚠️ Prazo de cancelamento da NFC-e: 30 minutos após a autorização. Depois disso, o caminho é devolução (NF-e de entrada — POST /api/v1/nfe/devolucao).

Reemissão sobre número rejeitado

Nota rejeitada não consome numeração: reemitir com o mesmo nNF é permitido e correto (a tentativa rejeitada é substituída). Autorizada — mesmo cancelada depois — consome o número para sempre.

DANFE (cupom)

GET /api/v1/nfce/{id}/danfe — cupom térmico 80mm com QR Code, pronto para impressão.

Referência completa

Todos os campos e validações no Swagger interativo.