7.5 KiB
7.5 KiB
🚀 Guia Rápido - Sistema de Parcelas com PIX
⚡ Início Rápido (3 Passos)
1️⃣ Execute no Supabase SQL Editor
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
# 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":
- Sistema gera QR Code específico para aquela parcela
- Valor exato da parcela (não o total)
- Você pode enviar por WhatsApp
- 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
- Gere o PIX próximo ao vencimento - PIX tem validade
- Envie lembrete 3 dias antes - Cliente tem tempo de se organizar
- Marque como pago manualmente - Se receber por outro meio
- Use observações - Anote detalhes importantes
⚠️ Evite
- ❌ Gerar múltiplos PIX para mesma parcela
- ❌ Alterar valor após gerar PIX
- ❌ 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
-
Registro:
- Valor Total: R$ 300,00
- 3 parcelas de R$ 100,00
- Vencimentos: 18/11, 18/12, 18/01
-
Cliente Recebe:
Compra registrada! 💰 Total: R$ 300,00 💳 3x de R$ 100,00 cada -
No vencimento de cada parcela:
- Gera PIX de R$ 100,00
- Envia para cliente
- Cliente paga
- Marca como pago ✅
-
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! 🚀