Contrato — Núcleo y Configuraciones — La relación comercial entre cliente y empresa
El contrato es el vínculo entre el cliente y la empresa — define lo que está siendo prestado, por cuánto, con qué reglas de cobranza, fidelidad, y en qué condiciones.
Glosario
| Término |
Qué es |
| Contrato |
Vínculo comercial entre cliente y empresa. Tiene ciclo de vida (Pre-contrato → Activo → Bloqueado/Suspendido → Cancelado). |
| Pre-contrato |
Contrato en borrador — todavía no generó factura, no se bloquea/desbloquea automáticamente, puede ajustarse. |
| Activo |
Contrato en producción — genera mensualidad, sufre crontabs, puede ser bloqueado/suspendido. |
| Plan de ventas |
Catálogo de productos/servicios vendibles (planes de internet, SVAs, tasas). Define precio base y reglas tributarias. |
| Fidelidad |
Período mínimo del contrato. Romper antes = multa proporcional al tiempo restante × valor mensual. |
| Aceptación digital |
Mecanismo de firma electrónica del contrato — link/SMS/email genera token, cliente confirma identidad, contrato pasa a "Activo". |
| Bloqueo automático |
Crontab que cambia contrato a Bloqueado cuando factura pasa N días vencida (configurable). |
| Renegociación |
Flujo de acuerdo entre cliente y empresa sobre débitos abiertos. Crea nuevo título, mantiene histórico. |
| Migración de plan |
Cambio de plan en contrato activo. Puede preservar o recalcular débitos abiertos. |
| Templates |
Modelos estandarizados de contrato — texto, reglas, SVAs default. Aplicados en masa. |
| Comisión del vendedor |
% sobre instalación/mensualidad pagado al vendedor que cerró el contrato. |
| Cancelación |
Cierre del contrato. Cobra multa de fidelidad si aplicable, marca fecha fin, genera última factura. |
Diagrama — ciclo de vida del contrato
CONTRATO — CICLO DE VIDA
────────────────────────
┌─────────────────┐
│ PRE-CONTRATO │ (borrador, sin mensualidad aún)
└────────┬────────┘
│ Aceptación digital OR clic manual "Activar"
▼
┌─────────────────┐
│ ACTIVO │ ◄────────┐
│ - genera fact. │ │ Reactivación tras pago
│ - sufre crons │ │
│ - cobra mens. │ │
└────┬────────┬───┘ │
│ │ │
morosidad │ │ Cliente pide │
N días │ │ suspensión │
▼ ▼ │
┌──────────────┐ ┌───────────────┐│
│ BLOQUEADO │ │ SUSPENDIDO ││
│ (cron auto) │ │ (manual) ├┘
└──────┬───────┘ └─────┬─────────┘
│ │
│ Cliente paga │ Cliente reactiva
└──────┬────────┘
│
│ O
│
│ Cancela contrato
▼
┌─────────────────┐
│ CANCELADO │ - cobra multa fidelidad
│ (fecha fin) │ - última factura
└─────────────────┘
CRONTABS QUE TOCAN:
─ verifica_factura_atrasada → marca BLOQUEADO
─ desbloqueo_pago → reactiva a ACTIVO
─ genera_mensualidad → crea factura próximo ciclo
─ cobra_multa_cancelacion → calcula al cierre
📸 Pantallas del sistema
Las pantallas a continuación muestran cómo el sistema se presenta en cada parte del flujo descrito.
Listado de Contratos — todos los contratos del cliente, con situación, plan de venta vigente y fechas.
Edición de contrato — donde se cambia plan, vencimiento, fidelidad, situación y datos generales. Los cambios generan registro en el historial.
Logins del contrato — credenciales vinculadas al contrato. Cada login puede ser controlado por el Radius.
Configuración de Aceptación — define qué textos contractuales el cliente debe aceptar antes de la activación.
Plantillas de contrato — modelos predefinidos que aceleran la creación de nuevos contratos.
Servicios del contrato — ítems que componen el valor mensual. Cada servicio puede tener valor fijo o porcentaje.
Listado de Planes de Venta — catálogo de paquetes (velocidad, precio, fidelidad, día predeterminado) ofrecidos al cliente.
1 Listado de Contratos
Cliente → Contrato
2 Estados de Contrato
Cliente → Estado de contrato
| Estado |
Significado |
| Activo |
Contrato vigente. |
| Suspenso |
Temporariamente sin cobranza/servicio. |
| Bloqueado |
Inadimplencia o solicitud cliente. |
| Cancelado |
Encerrado definitivamente. |
| En degustación |
Trial gratuito. |
3 Fidelidad
Cliente → Fidelidad
Configuración de períodos de fidelidad. Fidelidad prevé multa por cancelación antes del plazo.
4 Servicios del Contrato
Cliente → Servicio de contrato
5 Templates de Contrato
Cliente → Template de contrato
6 Configuración de Aceptación
Cliente → Configuración de aceptación
7 Condiciones de Contrato
Cliente → Condición de contrato
8 Acciones de Contrato
Cliente → Acción de contrato
9 Documentos del Contrato
Contrato → Documento
Documentos relacionados
📌 Qué pasa cuando usted guarda el contrato
Cuando el contrato es guardado (creado o alterado), el Quaza ejecuta operaciones automáticas conforme lo que fue modificado:
Cambió el estado del contrato (Activo/Bloqueado/Cancelado)
- El sistema tira la conexión del cliente inmediatamente cuando el estado vuelve Bloqueado, Cancelado o Desativado.
- Cuando vuelve a Activo, la conexión es restablecida automáticamente.
- Estados finales (Cancelado) también remueven todas las Órdenes de Servicio asociadas; estados temporales (Bloqueado) solo pausan.
Cambió el valor mensual del contrato
- Los boletos abiertos sin factura emitida son recalculados automáticamente para el nuevo valor.
- Boletos que ya tienen factura emitida no son alterados — para corregir, es necesario emitir Nota de Crédito o Débito.
- Boletos pagados nunca son alterados.
Cambió la forma de pago (cartera)
Importante: cambiar la forma de pago no re-emite los boletos abiertos automáticamente. Los boletos abiertos continúan con la cartera anterior. Si el cliente quiere pagar por la nueva forma, es necesario cancelar los boletos abiertos y generar nuevos.
Cambió la regla de cobranza o la empresa fiscal
- La nueva regla/empresa solo vale para boletos y facturas nuevos.
- Boletos ya en abierto continúan con la regla antigua.
- Facturas ya emitidas mantienen la empresa antigua — para cambiar, hay que cancelar y re-emitir.
🎯 Las 12 Acciones de Contrato
| Acción |
Qué hace |
Side-effects |
¿Reversible? |
| INSTALACAO |
Inicia nuevo contrato. |
OS instalación + débito instalación + login Radius. |
❌ No |
| DEGUSTACAO |
Trial gratuito. |
Login Radius modo "degustación". |
✅ Sí |
| ATUALIZACAO_PLANO |
Cambia plan. |
Recalcula débitos abiertos sin NF. |
✅ Sí (REVERTER) |
| MIGRACAO_TECNOLOGIA |
Fibra↔ADSL. |
OS visita técnica. |
✅ Sí |
| TROCA_ENDERECO |
Nueva dirección. |
Débito proporcional + OS visita. |
✅ Sí |
| TROCA_TITULARIDADE |
Cambio CPF/CNPJ. |
Débitos van junto al contrato. |
❌ No |
| CANCELAMENTO |
Encerra definitivamente. |
Multa fidelidad + fecha OS + financeiro final. |
❌ No |
| DESATIVACAO_TEMPORARIA |
Pausa. |
No genera débito durante pausa. |
✅ Sí |
| DESVINCULAR |
Quita vínculo cliente. |
Contrato órfano. |
❌ No |
| TRANSFERIR |
Pasa a otro cliente. |
Mantiene deuda anterior. |
❌ No |
| REVERTER |
Deshace última acción. |
Restaura snapshot anterior. |
— |
| DESATIVACAO |
Permanente. |
Como cancelamento sin multa. |
❌ No |
⏰ Tareas crontab del contrato
| ID |
Tarea |
Función |
| 310 |
tarefa de Resincronização de Contratos |
Resync con Radius. |
| 311 |
tarefa de Aviso de Bloqueio |
Aviso pre-bloqueo (canal configurable). |
| 312 |
tarefa de Avisos de Contrato |
Avisos generales (vencimiento, fidelidad). |
| 1301 |
tarefa de Geração de Fatura |
Genera factura mensual. |
| 1302 |
tarefa de Envio de Fatura |
Envía factura. |
🔐 Bloqueo automático
Acontece a la noche cuando: configuração "Bloqueio automático ativo" + contrato permite + atraso ≥ intervalo de bloqueio días + no es feriado/fin de semana. Sistema cambia estado, derrumba Radius y dispara tarea 311 (aviso).
💰 Cuándo débitos abiertos son modificados (vs preservados)
Modificables: ABERTO/ATRASADO sin NF emitida. Inmutables: con NF, PAGO, sin servicios, valor ≤ 0.
Para forzar actualización con NF: emitir Nota de Crédito → cancelar débito → re-generar.
✍️ Aceptación Digital — modos y flujo
La aceptación digital sustituye la firma física del contrato. Modos disponibles:
| Envío del enlace |
Cómo funciona |
| Portal |
Cliente accede al portal y acepta. |
| E-mail |
Sistema envía link único. |
| WhatsApp |
Mismo link vía WhatsApp Business. |
| Código 2FA |
Cuándo usar |
| E-mail |
Predeterminado. |
| WhatsApp |
Cliente prefiere WhatsApp. |
| SMS |
Para clientes sin e-mail/WhatsApp. |
Documentos opcionales: CPF/CNPJ, RG/CNH, Selfie, firma digital.
📅 Fidelidad — multa
Modos de cálculo: Valor fijo / Proporcional (decrece mes a mes) / % del valor mensual × meses restantes.
Multa cero cuando: cumplió el plazo, exención manual, fuerza mayor.
💼 Comisión del Vendedor
Vendedor configurado en CRM → Vendedor Comisión. Comisión generada automáticamente al activar contrato. Más en Comisiones
.
❌ Cancelación — flujo completo
- Validación + cálculo de multa fidelidad.
- Cobranza del financiero final + multa.
- OS de "desinstalación" para retirar equipo.
- Notificación al cliente.
- Estado → Cancelado, Radius derrumbado.
- Histórico registra acción CANCELAMENTO.
📋 Templates de Contrato — uso avanzado
Plantillas con: plan padrón, fidelidad, regla de cobranza, estado inicial, configuración de aceptación, múltiples facturas. Recomendado: templates separados para residencial vs empresarial, con/sin fidelidad, promociones, empresas fiscales distintas.
🔐 Bloqueo — manual y automático
Manual: operador bloquea por solicitud cliente, fraude, pendencia.
Automático: ocurre durante la noche cuando atraso ≥ X días + empresa permite + contrato permite + no es feriado/finde. Sistema cambia estado, derrumba Radius, pausa OS, envía notificación.
Aviso preventivo: N días antes del bloqueo (configurable).
Reducción de velocidad: alternativa al bloqueo — cliente sigue online con banda muy limitada.
⚙️ Configuraciones que afectan al Contrato
Aceptación y Validación
| Configuración |
Qué hace |
| Template padrón de contrato |
Template seleccionado automáticamente. |
| Fidelidad padrón |
Período sugerido por default. |
| Estado padrón |
Estado inicial. |
| Validar situación de documento |
Valida CPF/CNPJ en Receita. |
| Permitir un solo usuario por contrato |
Restringe a 1 cliente. |
| Bloquear selección de template |
Operador no cambia template después de creado. |
Bloqueo
| Configuración |
Qué hace |
| Bloqueo automático activo |
Habilita/deshabilita bloqueo por morosidad. |
| Tipo de bloqueo |
Por todos los débitos, solo mensualidad, o débito específico. |
| Días de intervalo hasta bloqueo |
Cuántos días después del vencimiento. |
| Días de intervalo hasta reducción |
Para reducción de velocidad. |
| Aviso de bloqueo |
Avisar al cliente N días antes. |
| Bloquear pagos parciales |
Mantiene bloqueo si paga parcial. |
Comunicación
| Configuración |
Qué hace |
| Envío padrón de factura |
Canal padrón (Email/WhatsApp/ambos/deshabilitado). |
| Envío padrón de comprobante |
Canal padrón para comprobante de pago. |
| Habilitar email de factura |
Cuándo enviar email: en generación, en vencimiento, ambos, nunca. |
| Habilitar recado de vencimiento |
Aviso SMS/Email/WhatsApp. |
Cobranza
| Configuración |
Qué hace |
| Permitir unificar contratos |
Habilita agrupamiento de cobranza. Ver Contrato Unificado
. |
| Habilitar múltiples facturas por contrato |
Permite generar más de una factura. |
| Permitir débitos para pre-cadastros |
Crea boletos para clientes en pre-cadastro. |
Tributación
| Configuración |
Qué hace |
| Modo de tributación padrón |
Recibimiento (caja) o Acréscimo (competencia). |
| Tipo de débito tributable |
Cuáles débitos generan factura. |
Módulo Facturas
| Configuración |
Qué hace |
| Tipo padrón de factura |
Cuáles débitos consolidan. |
| Período padrón |
Mensual/trimestral/anual. |
| Considerar juros |
Si incluye juros y multa. |
| Template de factura |
Layout PDF. |
| Enviar facturas pagadas |
Si envía facturas ya pagadas. |
| Módulo Facturas habilitado |
Liga/apaga el módulo. |
Configuraciones huérfanas (en revisión): algunas configuraciones existen en el formulario pero no tienen uso activo: tipo de bloqueio por contrato, estado padrón de contrato, días/estado de quebra, tolerancia para aceptación. No impactan operación — simplemente no hacen nada.
📝 Cómo crear un contrato (paso a paso)
-
Cadastrar el cliente. Confirme nombre, RUC, dirección, contactos.
-
Abrir nuevo contrato en la pantalla del cliente.
-
Elegir template (residencial, empresarial, promocional).
-
Seleccionar plan de venta — define servicio y valor base.
-
Agregar servicios extras (opcional) — IP fijo, manutención premium, etc.
-
Configurar fidelidad — 12, 24, 36 meses o ninguna.
- Definir día de vencimiento.
- Elegir cartera y forma de pago.
- Definir dirección de instalación.
-
Designar técnico o agendar visita.
-
Recoger aceptación — enviar link o capturar firma presencial.
-
Activar contrato — empieza a generar mensualidades.
💰 Cómo se compone el valor mensual
Valor final = (plan base) + (extras) − (descuentos)
| Componente |
Origen |
| Valor base del plan |
Plan de venta elegido |
| Servicios extras |
IP fijo, manutención premium, etc. |
| Descuento por fidelidad |
Algunos contratos dan descuento progresivo |
| Descuento promocional |
Por período |
🔄 Cambio de plan a mitad de mes — proporcional
Cuando el cliente cambia plan a medio mes, el sistema genera:
-
Crédito del plan antiguo — días antes del cambio.
-
Cobranza del plan nuevo — días desde el cambio.
Atención: el cambio solo recalcula boletos no emitidos. Boletos abiertos en el banco mantienen valor antiguo.
🏢 Tipo de cliente y de contrato
-
Tipo de cliente (PF/PJ/MEI) — afecta tributación fiscal.
-
Tipo de contrato (residencial/empresarial/promocional) — controla reglas comerciales.
🏠 Dirección de instalación
Puede ser diferente del cobro. Importante para: equipo técnico, área de cobertura, empresa fiscal regional, documento contrato.
Para mudar use la ACCIÓN TROCA DE ENDEREÇO — verifica cobertura, genera tasa, crea OS, actualiza documento.
📤 Envío del contrato al cliente
| Canal |
Cuándo usar |
| E-mail |
Padrón — anexa PDF + link aceptación. |
| WhatsApp |
Cliente prefiere WhatsApp. |
| Portal del cliente |
Cliente baja del portal. |
| Impresión |
Cliente prefiere papel — firma presencial. |
🔁 Renovación automática
| Modo |
Comportamiento |
| Renovación automática (default) |
Contrato sigue activo, sin fidelidad activa. Cliente puede cancelar sin multa. |
| Renovación con nueva fidelidad |
Sistema renueva con período igual al anterior. Cliente recibe notificación. |
| Renovación manual |
Sistema avisa al operador, que negocia con cliente. |
Aviso de renovación dispara en tarea automática (típicamente 30 días antes).
📋 Documentos relacionados a este contrato
- Contrato firmado (PDF)
- Término de aceptación (registro digital)
- Documentos del cliente (RG, CNH, CPF/CNPJ/RUC)
- Comprobante de dirección
- Foto de instalación
- Adendos contractuales
📦 Servicios del contrato — qué está siendo prestado
Cada contrato tiene uno o más servicios vinculados. El servicio es el "producto" que el cliente está pagando.
Los 6 tipos de servicio disponibles
| Tipo |
Cuándo usar |
¿Crea login Radius? |
| PPPoE |
Internet con autenticación usuario/contraseña. |
✅ Sí |
| IPOE |
Internet vía DHCP (sin autenticación). |
✅ Sí — por MAC/IP |
| SVA |
Streaming, TV, aplicativos. |
❌ No |
| Telefonía |
VoIP, fijo, móvil. |
❌ No |
| IP Fijo |
IP estático adicional. |
❌ No |
| Otros |
Manutención, soporte 24h, etc. |
❌ No |
Cómo configurar el catálogo de servicios
En Cliente → Servicio de contrato, cadastre los servicios. Cada uno tiene: descripción, tipo, valor padrón, gerar usuario (Radius), producto fiscal, grupo padrón.
Cómo agregar servicios a un contrato
- En la pantalla del contrato, pestaña "Servicios".
- "Agregar servicio".
- Elija del catálogo.
- Defina desconto (fijo o percentual) y data final del desconto.
- Guardar — sistema registra y ajusta valor mensual.
Estados de un servicio
| Estado |
Significado |
| Activo |
Cobrado normalmente. |
| Inactivo |
Pausado temporalmente. |
| Removido |
Cancelado definitivamente. |
Tipos de valor
-
Valor fijo — congelado en reales hasta alterar.
-
Percentual — fracción del valor base del plan.
Servicios adicionales (combos)
Un servicio puede tener servicios vinculados que entran automáticamente cuando el cliente contrata el principal — útil para combos.
Qué pasa al remover un servicio
- Boletos abiertos sin factura emitida son recalculados.
- Boletos con factura no cambian.
- Login Radius vinculado es desactivado.
- Histórico es preservado.
💸 Tipos de cobranza en el contrato
Mensualidad — cobranza recurrente
Cobranza automática mensual. Suma servicios activos + descuentos + adicionales. Ver Generación de Mensualidad
.
Venta — cobranza esporádica
Cobranza única o cuotada, no recurrente. Ejemplos: tasa de instalación, equipo, multa, visita técnica, renegociación. Ver Ventas
.
Diferencia práctica
| Aspecto |
Mensualidad |
Venta |
| Frecuencia |
Recurrente |
Eventual |
| Origen |
Plan + servicios del contrato |
Operación avulsa |
| Valor |
Fijo |
Por venta |
| Cancelación |
Para de generar al cancelar contrato |
Sigue válida |
| Factura |
NFe 55 o NFCom |
NFe 55 o NFSe |
Otros ítems de cobranza
| Ítem |
Origen |
| Acréscimo proporcional |
Días usados al iniciar/encerrar. |
| Juros y multa |
Atraso anterior — agregado conforme regla. |
| Descuento fidelidad |
Reducción para clientes con fidelidad activa. |
| Bonus comercial |
Crédito concedido — abate de cobranzas futuras. |
| Renegociación |
Acuerdo que sustituye débitos antiguos. Ver Renegociación de Deuda
. |
Resumen: Mensualidad = recurrencia. Servicios = qué se cobra y cuánto. Venta = avulsa. Todo se consolida en la factura mensual.
🔢 Cómo el valor del contrato se divide entre tipos de factura
Cuando un contrato tiene productos/servicios que van a diferentes tipos de factura (algunos NFe, otros NFCom, otros NFSe), el valor mensual se distribuye:
Tipos de valor del servicio
| Tipo |
Cómo funciona |
| Valor Fijo |
Definido en reales. Constante. |
| Percentual |
Recibe fracción del valor restante (después de los fijos). Suma 100% entre los percentuales. |
Ejemplo práctico — contrato R$ 100,00
| Servicio |
Categoría |
Tipo |
Valor |
| Internet 500MB |
Telecom (NFCom) |
Percentual 100% |
R$ 60,00 |
| Telefonía VoIP |
Servicios (NFSe) |
Fijo |
R$ 20,00 |
| Manutención |
Servicios (NFSe) |
Fijo |
R$ 20,00 |
Distribución: NFCom R$ 60,00 + NFSe R$ 40,00.
Si el operador altera valor a R$ 150
Fijos quedan iguales (R$ 40 total). Percentual absorbe diferencia → Internet R$ 110,00. NFCom: R$ 110, NFSe: R$ 40.
Múltiples servicios percentuales
Valor restante dividido proporcionalmente. Ejemplo: SVA1 60% + SVA2 40% del restante después de fijos.
Regla de oro: servicios Percentuales deben sumar 100%.
Más detalles en Configuraciones Fiscales
.
🔗 Veja também
Trampas frecuentes
1. Cambiar plan de contrato activo sin entender débitos abiertos. Al migrar plan, débitos de las mensualidades ya generadas pueden ser preservados O recalculados — depende de la configuración. Verifique antes de hacer en masa.
2. Cancelar contrato olvidando la fidelidad. Cancelación dentro del período de fidelidad DEBE generar multa proporcional. Si la config no está correcta, la multa no se cobra y queda perjuicio silencioso.
3. Pre-contrato olvidado vuelto "fantasma". Pre-contratos no generan factura pero ocupan datos de cliente. Cron de limpieza ayuda — pero si está desactivado, decenas de pre-contratos abiertos se vuelven basura en el CRM.
4. Aceptación digital expirada. Token de aceptación tiene TTL. Si cliente demora demasiado en clicar, link expira y contrato queda en pre-contrato esperando renovación manual.
5. Bloqueo automático tocando en contrato manual. Si usted marcó contrato como "no bloquear automáticamente" pero el cron ignora esa flag, contrato manual se vuelve bloqueado por error. Siempre revise las flags de excepción.
6. Comisión del vendedor calculada sobre valor equivocado. La base de cálculo de la comisión (instalación? mensualidad? primera factura pagada?) debe estar definida en el plan de ventas. Sin eso, comisión queda inconsistente entre vendedores.
7. Templates de contrato desactualizados. Template con cláusula antigua aplicado a contrato nuevo puede contradecir normas actuales (LGPD, regulación, Marco Civil). Revise periódicamente.
8. Factura única consolidando múltiples contratos. Cliente con 2 contratos puede tener factura única. Si un contrato cancela, el otro continúa — pero la próxima factura ya no consolida. Confirmar con cliente.
FAQ
¿Puedo tener más de un contrato activo para el mismo cliente?
Sí. Cliente puede tener múltiples contratos (residencial + empresarial, por ej.). Cada uno tiene ciclo de vida propio. Factura puede ser unificada o separada — configurable en el cliente.
¿Diferencia entre Bloqueado y Suspendido?
Bloqueado = automático por morosidad (cron). Suspendido = manual (cliente pidió pausa, viaje, etc). Bloqueado reactiva al pagar; Suspendido reactiva manualmente.
¿Qué pasa cuando aplico un Template en contrato existente?
Sustituye texto/cláusulas. No cambia valores ni fechas. Cuidado: aceptación anterior puede necesitar ser renovada si los cambios son materiales.
¿Crontab puede tocar contrato con flag "manual"?
Depende de la config del crontab. La mayoría respeta la flag — pero verifique en Tareas Financieras
.
¿Cómo funciona la comisión recurrente?
Configurable en el plan de ventas. Puede ser % sobre instalación (1×), % sobre primera factura, o recurrente sobre mensualidad. Ver Comisiones
.
¿Cancelar contrato borra el historial?
No. Cancelación marca fecha fin pero preserva todas las facturas, asientos e historial. Cliente continúa existiendo en el sistema.
¿La fidelidad cuenta a partir de qué fecha?
De la fecha de inicio efectivo del contrato (no pre-contrato). Generalmente coincide con primera factura emitida.
¿Puedo editar contrato después de la aceptación digital?
Sí, pero si el cambio es material (valor, plazo, plan), se recomienda solicitar nueva aceptación para evitar disputa.