Reglas de Cobro
Define cuándo y cómo Quaza ejecuta acciones de cobranza automáticas
Las Reglas de Cobro automatizan el ciclo de cobranza — geram fatura, envian email, bloquean cliente inadimplente, geran NF, todo conforme dias antes/después del vencimiento. 15 tipos de acción disponibles.
En esta wiki:
Preguntas frecuentes
¿Puedo tener varias reglas para el mismo cliente?
Es posible — pero evite acciones conflictivas. Mantenga 1 regla por contrato.
¿Cómo simulo una regla antes de activar?
Active solo en clientes test (use grupo separado).
¿Las reglas funcionan retroactivamente?
No — solo aplican a vencimientos a partir de la activación.
Glosario
| Término |
Qué es |
| Regla |
Conjunto de acciones que ejecutan en relación al vencimiento |
| Día de referencia |
Cuándo ejecutar — negativo = antes del vencimiento; positivo = después |
| Acción |
Lo que se ejecuta: gerar fatura, enviar email, bloquear, etc. |
Flujo de una regla
1. Tarea diaria
Cron lee todas las reglas activas y verifica vencimientos próximos.
↓
2. Match de día
Para cada contrato/débito, calcula días até vencimento. Se bate con día_referencia → ejecuta.
↓
3. Acción ejecutada
Generar fatura, enviar email, bloquear, etc.
↓
4. Log + próxima regla
Sistema registra ejecución; passa para próxima regla del calendario.
Pantalla Reglas de Cobro
Contrato › Regra de Cobrança
1 botão Adicionar regra. Cada regla tem descrição + dia de referencia + lista de acciones.
15 tipos de acción
| Acción |
Qué hace |
Día típico |
| GERAR_FATURA |
Genera la factura del contrato |
-5 (5 dias antes) |
| ENVIAR_FATURA |
Envia fatura por email |
-3 |
| ENVIAR_FINANCEIROS |
Resumo financeiro mensal |
-1 |
| ENVIAR_NOTAS |
Envia notas fiscales |
-1 |
| SMS |
Envia SMS lembrete |
-1, 0, +3 |
| WHATSAPP |
Envia mensaje WhatsApp |
-1, 0, +3 |
| EMAIL |
Envia email lembrete |
-1, 0, +5 |
| BLOQUEIO |
Bloquea servicio del cliente |
-N (NEGATIVO obligatorio) |
| BLOQUEADO |
Acción cuando ya está bloqueado |
+N (POSITIVO obligatorio) |
| REGULARIZADO |
Acción após pagamento |
+N (POSITIVO obligatorio) |
| TOLERANCIA |
Tempo de tolerância antes de bloquear |
+N |
| REDUCAO |
Reduz velocidade do plano |
+N |
| PERIODO_REFERENCIA |
Define janela de referência |
— |
| RENOVACAO |
Renova contrato |
— |
| OUTROS |
Tarefas custom |
— |
Día de referencia
📌 El día se cuenta a partir del vencimiento del débito.
Negativo (-5, -3, -1) = ANTES del vencimiento — pra preparar (gerar fatura, lembrete).
Positivo (0, +3, +5, +30) = NO MISMO DIA ou DEPOIS — pra cobrar (lembrete, bloqueio, ação).
Templates por acción
Cada acción puede usar template — ex: SMS usa template de mensagem com variáveis ({cliente.nome}, {vencimento}). Configure templates antes de criar a regla.
Validações automáticas
-
Día 1-31 — fora desse range, rejeita.
-
BLOQUEIO ⇒ día negativo obrigatório.
-
BLOQUEADO/REGULARIZADO ⇒ día positivo obrigatório.
-
Acción única por regra — não permite duplicatas.
-
ENVIAR_FATURA ⇒ requer GERAR_FATURA prévia com día menor.
-
Cron busca regras com GERAR_FATURA em
ContratoFaturaGerarCommand.
-
Não pode deletar regla com contratos vinculados.
Trampas
🛑 1. Día errado bloqueia cliente sem aviso. BLOQUEIO no día -5 = cliente bloqueado 5 dias ANTES do vencimento. Use día positivo.
⚠️ 2. Múltiplas reglas no mesmo cliente podem ejecutar acciones conflictivas. Mantenha 1 regla por contrato.
⚠️ 3. Templates ausentes = email/SMS vai com texto genérico ou falha. Confirme antes de ativar.