262 lines
7.5 KiB
Markdown
262 lines
7.5 KiB
Markdown
# 🚀 Guia Rápido - Sistema de Parcelas com PIX
|
||
|
||
## ⚡ Início Rápido (3 Passos)
|
||
|
||
### 1️⃣ Execute no Supabase SQL Editor
|
||
```sql
|
||
CREATE TABLE IF NOT EXISTS venda_parcelas (
|
||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||
venda_id UUID NOT NULL REFERENCES vendas(id) ON DELETE CASCADE,
|
||
numero_parcela INTEGER NOT NULL,
|
||
valor DECIMAL(10,2) NOT NULL,
|
||
data_vencimento DATE NOT NULL,
|
||
status TEXT DEFAULT 'pendente' CHECK (status IN ('pendente', 'pago', 'vencida', 'cancelada')),
|
||
data_pagamento TIMESTAMP WITH TIME ZONE,
|
||
pix_payment_id TEXT,
|
||
pix_qr_code TEXT,
|
||
pix_qr_code_base64 TEXT,
|
||
observacoes TEXT,
|
||
created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
|
||
updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
|
||
UNIQUE(venda_id, numero_parcela)
|
||
);
|
||
|
||
CREATE INDEX IF NOT EXISTS idx_venda_parcelas_venda ON venda_parcelas(venda_id);
|
||
CREATE INDEX IF NOT EXISTS idx_venda_parcelas_status ON venda_parcelas(status);
|
||
CREATE INDEX IF NOT EXISTS idx_venda_parcelas_vencimento ON venda_parcelas(data_vencimento);
|
||
|
||
CREATE TRIGGER update_venda_parcelas_updated_at
|
||
BEFORE UPDATE ON venda_parcelas
|
||
FOR EACH ROW
|
||
EXECUTE FUNCTION update_updated_at_column();
|
||
|
||
ALTER TABLE venda_parcelas ENABLE ROW LEVEL SECURITY;
|
||
CREATE POLICY "Enable all operations for authenticated users" ON venda_parcelas FOR ALL USING (true);
|
||
```
|
||
|
||
### 2️⃣ Reinicie o Servidor
|
||
```bash
|
||
# Ctrl+C para parar
|
||
npm start
|
||
```
|
||
|
||
### 3️⃣ Teste!
|
||
- Crie uma venda parcelada (3x por exemplo)
|
||
- Visualize a venda (ícone 👁️)
|
||
- Veja as 3 parcelas com valores individuais
|
||
- Gere PIX de cada parcela separadamente
|
||
|
||
## 🎯 O Que Foi Implementado
|
||
|
||
### ✅ Nova Mensagem de WhatsApp Automática
|
||
Quando você registra uma venda, o cliente recebe:
|
||
|
||
**Se for À Vista:**
|
||
```
|
||
Olá João Silva! 👋
|
||
Sua compra foi registrada com sucesso! 💙
|
||
|
||
Confira os detalhes abaixo:
|
||
📅 Data da compra: 18/10/2025
|
||
💰 Valor total: R$ 150,00
|
||
💳 Pagamento: À vista
|
||
|
||
Agradecemos pela sua preferência! 😊
|
||
Conte sempre com a Liberi Kids - Moda Infantil 👕👗
|
||
```
|
||
|
||
**Se for Parcelado:**
|
||
```
|
||
Olá João Silva! 👋
|
||
Sua compra foi registrada com sucesso! 💙
|
||
|
||
Confira os detalhes abaixo:
|
||
📅 Data da compra: 18/10/2025
|
||
💰 Valor total: R$ 150,00
|
||
💳 Pagamento: 3x de R$ 50,00 cada
|
||
|
||
Agradecemos pela sua preferência! 😊
|
||
Conte sempre com a Liberi Kids - Moda Infantil 👕👗
|
||
```
|
||
|
||
### ✅ Visualização de Parcelas Individuais
|
||
|
||
Na tela de detalhes da venda, você verá:
|
||
|
||
```
|
||
┌────────────────────────────────────┐
|
||
│ 💳 Parcelas Individuais │
|
||
├────────────────────────────────────┤
|
||
│ ┌──────────────────────────────┐ │
|
||
│ │ Parcela 1/3 🕐 Pendente│ │
|
||
│ │ 💰 Valor: R$ 50,00 │ │
|
||
│ │ 📅 Vencimento: 18/11/2025 │ │
|
||
│ │ [Gerar PIX] 💳 │ │
|
||
│ └──────────────────────────────┘ │
|
||
│ │
|
||
│ ┌──────────────────────────────┐ │
|
||
│ │ Parcela 2/3 🕐 Pendente│ │
|
||
│ │ 💰 Valor: R$ 50,00 │ │
|
||
│ │ 📅 Vencimento: 18/12/2025 │ │
|
||
│ │ [Gerar PIX] 💳 │ │
|
||
│ └──────────────────────────────┘ │
|
||
│ │
|
||
│ ┌──────────────────────────────┐ │
|
||
│ │ Parcela 3/3 ✅ Pago │ │
|
||
│ │ 💰 Valor: R$ 50,00 │ │
|
||
│ │ 📅 Vencimento: 18/01/2026 │ │
|
||
│ │ ✅ Pago em: 17/01/2026 14:30 │ │
|
||
│ └──────────────────────────────┘ │
|
||
└────────────────────────────────────┘
|
||
```
|
||
|
||
### ✅ PIX Individual por Parcela
|
||
|
||
Quando você clica em "Gerar PIX":
|
||
1. Sistema gera QR Code específico para aquela parcela
|
||
2. Valor exato da parcela (não o total)
|
||
3. Você pode enviar por WhatsApp
|
||
4. Cliente recebe:
|
||
```
|
||
Olá João Silva! 💙
|
||
|
||
Segue o PIX para pagamento da *Parcela 2*:
|
||
|
||
💰 Valor: R$ 50,00
|
||
📅 Vencimento: 18/12/2025
|
||
|
||
👇 Escaneie o QR Code abaixo ou copie o código PIX para pagar:
|
||
[QR CODE IMAGE]
|
||
```
|
||
|
||
## 🎨 Cores dos Status
|
||
|
||
- 🟢 **Verde** = Parcela Paga
|
||
- 🟡 **Amarelo** = Parcela Pendente
|
||
- 🔴 **Vermelho** = Parcela Vencida
|
||
|
||
## 📱 Fluxo de Trabalho Completo
|
||
|
||
```
|
||
1. Cliente faz compra
|
||
↓
|
||
2. Você registra venda parcelada (ex: 3x)
|
||
↓
|
||
3. Cliente recebe WhatsApp automático
|
||
"Compra registrada: 3x de R$ 50,00"
|
||
↓
|
||
4. Quando vencer parcela 1:
|
||
- Você abre a venda
|
||
- Clica "Gerar PIX" na parcela 1
|
||
- Envia PIX por WhatsApp
|
||
↓
|
||
5. Cliente paga via PIX
|
||
↓
|
||
6. Status muda para "Pago" ✅
|
||
↓
|
||
7. Repete para parcelas 2 e 3
|
||
```
|
||
|
||
## 🔥 Recursos Avançados
|
||
|
||
### Mensagem por Parcela
|
||
Cada parcela tem mensagem específica:
|
||
- Valor exato da parcela
|
||
- Número da parcela (1/3, 2/3, etc.)
|
||
- Data de vencimento específica
|
||
|
||
### Rastreamento Individual
|
||
- Cada parcela tem seu ID único
|
||
- PIX vinculado à parcela específica
|
||
- Histórico de pagamento por parcela
|
||
|
||
### Integração com Alertas
|
||
O sistema se integra com alertas WhatsApp:
|
||
- 3 dias antes do vencimento
|
||
- No dia do vencimento
|
||
- 3 dias após vencimento
|
||
|
||
Variáveis disponíveis:
|
||
- `{cliente}` = Nome do cliente
|
||
- `{valor}` = Valor da parcela
|
||
- `{quando}` = Data vencimento
|
||
- `{parcela}` = Número da parcela
|
||
|
||
## 💡 Dicas de Uso
|
||
|
||
### ✅ Boas Práticas
|
||
1. **Gere o PIX próximo ao vencimento** - PIX tem validade
|
||
2. **Envie lembrete 3 dias antes** - Cliente tem tempo de se organizar
|
||
3. **Marque como pago manualmente** - Se receber por outro meio
|
||
4. **Use observações** - Anote detalhes importantes
|
||
|
||
### ⚠️ Evite
|
||
1. ❌ Gerar múltiplos PIX para mesma parcela
|
||
2. ❌ Alterar valor após gerar PIX
|
||
3. ❌ Deletar venda com parcelas pagas
|
||
|
||
## 🆘 Solução de Problemas
|
||
|
||
### "Não vejo as parcelas"
|
||
- ✅ Criou a tabela no Supabase?
|
||
- ✅ Reiniciou o servidor?
|
||
- ✅ A venda é parcelada?
|
||
|
||
### "Erro ao gerar PIX"
|
||
- ✅ MercadoPago configurado?
|
||
- ✅ Cliente tem dados cadastrados?
|
||
- ✅ Parcela já foi paga?
|
||
|
||
### "WhatsApp não envia"
|
||
- ✅ Evolution API configurada?
|
||
- ✅ Cliente tem WhatsApp cadastrado?
|
||
- ✅ Instância está conectada?
|
||
|
||
## 📊 Relatórios Futuros
|
||
|
||
O sistema está preparado para:
|
||
- Dashboard de parcelas a vencer
|
||
- Relatório de inadimplência
|
||
- Histórico de pagamentos
|
||
- Análise de recebimentos
|
||
|
||
## 🎓 Exemplo Prático
|
||
|
||
**Cenário:** Venda de R$ 300,00 em 3x
|
||
|
||
1. **Registro:**
|
||
- Valor Total: R$ 300,00
|
||
- 3 parcelas de R$ 100,00
|
||
- Vencimentos: 18/11, 18/12, 18/01
|
||
|
||
2. **Cliente Recebe:**
|
||
```
|
||
Compra registrada!
|
||
💰 Total: R$ 300,00
|
||
💳 3x de R$ 100,00 cada
|
||
```
|
||
|
||
3. **No vencimento de cada parcela:**
|
||
- Gera PIX de R$ 100,00
|
||
- Envia para cliente
|
||
- Cliente paga
|
||
- Marca como pago ✅
|
||
|
||
4. **Resultado:**
|
||
- Controle total dos recebimentos
|
||
- Cliente recebe apenas o que deve
|
||
- Histórico completo registrado
|
||
|
||
---
|
||
|
||
## ✨ Pronto para Usar!
|
||
|
||
Agora você tem controle completo de vendas parceladas com:
|
||
- ✅ Parcelas individuais
|
||
- ✅ PIX separado por parcela
|
||
- ✅ WhatsApp automático
|
||
- ✅ Rastreamento de status
|
||
- ✅ Interface visual moderna
|
||
|
||
**Comece agora criando sua primeira venda parcelada!** 🚀
|