Recibo Digital com QR
Visão Geral
Após o fechamento de um pedido, o sistema gera um recibo digital acessível por link ou QR code. O cliente pode salvar ou compartilhar sem precisar de impressora térmica.
| Característica | Detalhe |
|---|---|
| URL pública | /t/:slug/orders/:orderNumber/receipt |
| Auth | Público (acesso pelo número do pedido — anti-enumeração pelo formato HEX) |
| Entrega | WhatsApp (opcional), e-mail (opcional), exibição na tela |
| Frontend | frontend-react/src/views/customer/ReceiptView.tsx (ou modal no Checkout) |
Conteúdo do Recibo
| Campo | Descrição |
|---|---|
| Número do pedido | YYYYMMDD-HEX10 |
| Data e hora | Timestamp de criação |
| Itens | Nome, quantidade, valor unitário, subtotal |
| Desconto | Se aplicado |
| Total | Valor total pago |
| Forma de pagamento | PIX / Cartão / Dinheiro / Misto |
| Chave PIX | Se pagamento foi por PIX |
| Troco | Se pagamento em dinheiro |
| CNPJ do estabelecimento | Se configurado |
| QR de consulta NF-e | Se nota fiscal foi emitida |
API
GET /t/:slug/orders/:orderNumber/receipt
→ HTML renderizado (para navegador)
→ Accept: application/json → JSON com campos do recibo
GET /t/:slug/orders/:orderNumber/receipt/pdf
→ PDF gerado via Puppeteer (se configurado)Entrega por WhatsApp
Se o tenant tem WhatsApp configurado (Evolution API) e o cliente forneceu telefone no checkout, o sistema pode enviar o link do recibo automaticamente após o pagamento:
"Obrigado pelo seu pedido! Aqui está seu recibo:
https://popinaflow.alojaweb.online/t/demo/orders/20260528-A3F9/receipt"Configuração: Admin → Configurações → WhatsApp → Enviar recibo automaticamente → Sim
Integração com Nota Fiscal
Se uma NF-e ou NFC-e foi emitida para o pedido, o recibo exibe:
- Número da nota
- Chave de acesso
- QR code de consulta na SEFAZ
- Link para o DANFE (se NF-e)
Impressora Térmica (fallback)
Para quem prefere impressão física, o PDV ainda permite imprimir o comprovante via ESC/POS. O recibo digital e a impressão são complementares — não se excluem.
Admin → Sistema → Impressão → Imprimir comprovante ao fechar pedido → Sim/Não