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!** 🚀
|