chore: sincroniza projeto para gitea
This commit is contained in:
Tiago
261
GUIA-RAPIDO-PARCELAS.md
Normal file
261
GUIA-RAPIDO-PARCELAS.md
Normal file
@@ -0,0 +1,261 @@
|
||||
# 🚀 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!** 🚀
|
||||
Reference in New Issue
Block a user