NFC-e (Modelo 65 & QR Code)
A NFC-e (Nota Fiscal de Consumidor Eletrônica - Modelo 65) substitui o cupom fiscal tradicional emitido em frentes de caixa (PDV) e varejo presencial ou delivery.
Particularidades da NFC-e
Diferente da NF-e convencional (modelo 55):
- Destinatário Opcional: Para vendas até o limite legal da UF (geralmente R$ 10.000,00), a identificação do CPF/CNPJ do consumidor não é obrigatória.
- QR Code Obrigatório: O DANFE simplificado deve conter uma matriz bidimensional QR Code para conferência e consulta imediata do consumidor via smartphone.
- Código de Segurança do Contribuinte (CSC): A montagem da URL do QR Code exige o cadastramento do CSC (Token) e do respectivo identificador (
idCSC) fornecidos pela SEFAZ estadual do emitente.
Formato do QR Code (Padrão ENCAT)
A API calcula o hash SHA-1 do QR Code de forma transparente seguindo a fórmula oficial do Manual de Padrões Técnicos do DANFE NFC-e:
text
URL_SEFAZ?chNFe=3526...&nVersao=100&tpAmb=1&dhEmi=...&vNF=50.00&vICMS=0.00&digVal=...&cIdToken=000001&cHashQRCode=...GERAÇÃO REAL E AUDITADA
Nenhum QR Code gerado por esta API utiliza placeholders ou mockups. A imagem vetorial e o código de barras são sintetizados em conformidade matemática estrita com as tabelas de autorizadores estaduais.
Exemplo de Emissão de NFC-e
bash
curl --request POST \
--url http://localhost:3333/v1/invoices/nfce \
--header 'Content-Type: application/json' \
--header 'x-api-key: fylee_live_...' \
--data '{
"naturezaOperacao": "VENDA A CONSUMIDOR",
"items": [
{
"code": "CAF-01",
"description": "Café Espresso Duplo",
"ncm": "09012100",
"cfop": "5102",
"quantity": 1,
"unitPrice": 12.00,
"icms": { "csosn": "102", "orig": 0 }
}
],
"payments": [
{ "paymentType": "01", "amount": 12.00 }
]
}'