Cliente — Registro, Contratos y Conexiones — El corazón de Quaza: cómo organizar quién contrata, qué contrata y la conexión técnica que entrega
Esta guía explica desde cero el módulo Cliente — pensada para quien nunca usó Quaza (o ningún sistema de proveedor de internet). Cada concepto se define antes de aparecer en una pantalla, y cada pantalla tiene captura real de ejemplo.
¿Qué es el módulo Cliente?
Es donde está quién es tu cliente (persona, empresa, datos de contacto), qué contrató (planes, servicios, fidelidad) y cómo se conecta (login PPPoE, IP, equipo). Toda facturación, factura electrónica, orden de servicio y atención parte de aquí.
Visión general — la cadena completa
Antes de profundizar en las pantallas, comprende la relación entre los 4 conceptos centrales. Cada caja del diagrama es una entidad en la base de datos, con su propia pantalla:
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ CLIENTE │ 1→N│ CONTRATO │ 1→N│ LOGIN │ 1→N│ EQUIPO │
│ (PF o PJ) │────│ (1 servicio)│────│ (PPPoE/IP) │────│ (ONU/router)│
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
│
┌──────┼─────────────────────┐
↓ ↓ ↓
[Cobro] [Doc. Electr.] [Plan de Venta]
[Carnet] [Factura] [Comisión]
[Ventas] [Renegociación] [Fidelidad]
Un cliente puede tener varios contratos (ej: internet residencial + IP fijo empresarial + TV). Cada contrato tiene 1 o más logins (credenciales técnicas que autentican el equipo en la red). Cada login puede tener uno o más equipos vinculados.
Glosario — conceptos antes de las pantallas
Tipos de Cliente
| Tipo |
Cuándo se usa |
Ejemplo |
| Persona Física |
Cliente residencial — suscripción personal |
"Juan Pérez", CI/RUC, casa de Juan |
| Persona Jurídica |
Cliente empresarial — emite Factura Electrónica |
"Panadería Central S.A.", RUC |
| Bonificado |
Cliente exento (cortesía, socio, empleado) |
Internet de cortesía para escuela local |
| Preinscripción |
Registro iniciado pero sin contrato activo aún |
Lead que pidió visita técnica |
Atención — Cliente ≠ Empresa
En Quaza, "Cliente" es quien contrata tu servicio (suscriptor). Ya "Empresa" (en Admin → Empresa) es tu proveedor — la razón social que emite los documentos electrónicos. No confundas al configurar.
Estados del Cliente vs Estados del Contrato
El cliente en sí no tiene "estado" técnico — quien lo tiene es el contrato. Cuando dices "el cliente está bloqueado", en realidad el contrato está bloqueado. Por eso un mismo cliente puede tener un contrato Activo (internet) y otro Cancelado (TV vieja).
| Estado del contrato |
Significa |
¿Cobra mensualidad? |
¿Conecta? |
| Preinscripción |
Aceptado, esperando instalación |
No |
No |
| Activo |
Funcionando normalmente |
Sí |
Sí |
| Bloqueado automático |
Bloqueado por morosidad vía cron |
Sí |
No |
| Bloqueado manual |
Bloqueado por el operador (motivo libre) |
Sí |
No |
| Reducido automático |
Velocidad reducida (cron de morosidad) |
Sí |
Sí (lento) |
| Cancelado |
Cerrado (definitivo) |
No |
No |
| Desactivado |
Soft-delete (oculto del listado) |
No |
No |
| Retirada abierta |
Equipo agendado para retirada |
Sí (hasta retirar) |
Sí/No |
Login técnico ≠ Usuario del sistema
Dos conceptos que se llaman parecido pero son completamente diferentes:
|
Login técnico (del contrato) |
Usuario del sistema (operador) |
| ¿Qué es? |
Credencial PPPoE/IPoE/Hotspot que el equipo del cliente usa para autenticar en la red |
Login del operador (atendente, técnico, gestor) que accede al panel de Quaza |
| Dónde |
Cliente → Contrato → Login |
Admin → Usuario (o ACL → Usuario) |
| Ejemplo |
user_12345 / contraseña generada |
maria.silva / login del atendente |
| Quién lo usa |
Router/ONU del cliente final |
Empleado del proveedor |
1 Registro de Cliente
Cliente → Cliente
La pantalla principal del módulo lista todos los clientes registrados. Es la puerta de entrada del sistema — toda facturación, contrato, atención parte de un cliente registrado aquí.
Listado de clientes — note las pestañas (Estándar, En mora), filtros pre-creados y el botón verde "Añadir cliente" arriba a la derecha
Botones superiores
| Botón |
Función |
|
+ Añadir cliente
|
Registra un nuevo cliente desde cero (PF o PJ) |
| Edición múltiple |
Selecciona varios y altera campos en lote |
| Acciones |
Operaciones masivas: bloqueo, envío de e-mail, generación de boletos |
Tipo de Actividad
Cliente → Tipo de Actividad
Categorización libre — define listas como Residencial, Empresarial, Condominio, Cortesía, Empleado. Útil para informes, filtros masivos y reglas de cobro distintas por tipo.
Tipos de actividad — cada proveedor define los suyos
Análisis de Registros
Cliente → Análisis de Registros
Herramienta de auditoría automática. En lugar de abrir 1.000 clientes para revisar, recorre todo y dice: "47 clientes sin RUC válido", "12 sin dirección", etc.
Análisis de Registros — selecciona qué validar y haz clic en "Analizar Registros"
| Validación |
Qué chequea |
Cuándo ejecutar |
| Validar datos para creación de boletos |
RUC/CI, dirección, código postal |
Antes de migrar de gateway |
| Validar datos para emisión de NFe / DE |
Régimen tributario, código de municipio — campos fiscales |
Antes de habilitar emisión automática |
| Validar datos de registro |
Nombre, contacto — auditoría general |
Mensualmente |
| Validar datos de contacto |
E-mail válido, celular para SMS, WhatsApp |
Antes de campañas masivas |
| Verificar problemas en contratos |
Contratos sin login, sin plan, sin cartera |
Auditoría técnica |
| Validar datos para gateway |
Específico del gateway (Sicredi, MP, etc.) |
Antes de activar cobro automático |
Calificación de Direcciones
Cliente → Calificación de dirección
Calificación de direcciones — geocoding masivo y validación de cobertura
Cliente Histórico
Cliente → Cliente histórico
Registro inmutable de toda alteración en el registro: quién cambió, cuándo, y cuál era el valor antes/después.
Historial de alteraciones — trazabilidad completa para LGPD/auditoría
2 Contrato — el vínculo cliente ↔ servicio
Cliente → Contrato
El contrato es el vínculo entre el cliente y un servicio prestado. Es la pieza central — toda facturación, login, instalación y cancelación gira en torno al contrato.
Cliente puede tener varios contratos. Ejemplo: Juan tiene 1 contrato de internet residencial, 1 de IP fijo (empresa), 1 de TV. Son 3 contratos, 3 cobros (o 1 factura agregadora — ver
Factura
), pero 1 solo cliente.
Listado de contratos con columnas de cliente, número, plan de venta, valor mensual, regla de cobro y estado
Estados del Contrato
Cliente → Estado del contrato
Configuración de estados — cuántos contratos hay en cada estado
Condiciones del Contrato
Cliente → Condición del contrato
Condiciones del contrato — perfil de motivos de cancelación y situaciones intermedias
Servicios
Cliente → Servicio del contrato
Catálogo de tipos de servicio que pueden entrar en un contrato:
| Tipo de servicio |
Qué es |
¿Genera login? |
| PPPoE |
Internet con autenticación por usuario/contraseña |
Sí — usuario y contraseña PPPoE |
| IP Fijo |
Conexión por IP estático (sin login) |
Sí — login con IP fijado |
| SVA |
Streaming/TV/Telefonía (Servicio de Valor Adicionado) |
Depende |
| Otros |
Mensualidad fija sin componente técnico |
No |
Listado de servicios — note el tipo, si genera usuario y el valor predeterminado
Plantillas de Contrato
Cliente → Plantilla del contrato
Plantillas de contrato — modelos registrados, con conteo de contratos usando cada uno
Configuración de Aceptación
Cliente → Aceptación del contrato
Configuraciones de aceptación — Aceptación con foto (presencial) y Aceptación portal (digital)
| Tipo |
Cómo funciona |
Cuándo usar |
| Aceptación con foto |
Técnico en sitio fotografía al cliente con CI + firma del término |
Instalación presencial |
| Aceptación portal |
Sistema envía link vía WhatsApp/SMS con código. Cliente entra al portal, lee, acepta. |
Ventas online, renovaciones |
Acciones del Contrato
Cliente → Acción del contrato
Acciones del contrato — note los valores antes/después y el estado (Pendiente/Concluida)
Documentos del Contrato
Cliente → Documentos del contrato
Documentos del contrato — gestión de anexos con aceptación digital
3 Login (camada técnica de conexión)
Cliente → Contrato → Logins
El login es lo que de hecho autentica el equipo del cliente en la red. Cada login tiene usuario/contraseña, MAC esperado, IP fijo (opcional), grupo de velocidad, prioridad, equipo.
Listado de logins — columnas Cliente, Estado, Plan (grupo), Medio (Fibra/TV), IPv4, CTO/Puerto
Consumo
Cliente → Contrato → Consumo
Consumo por login — útil para auditoría de uso e identificación de usuarios sobre la media
Degustación
Cliente → Contrato → Degustación
Degustaciones — período de prueba de plan superior, con fecha inicio y fin
Equipos
Cliente → Contrato → Equipo
Equipos — fabricante, comunidad SNMP usada para gestión remota
Historial del Login
Cliente → Contrato → Historial
Historial de alteraciones del login — útil para investigar problemas técnicos
Reply (atributos RADIUS personalizados)
Cliente → Contrato → Reply
Reply RADIUS — uso avanzado para clientes con necesidades fuera del estándar
Flujos típicos paso a paso
Flujo 1: Registrar cliente nuevo
| Paso |
Dónde |
Qué hacer |
| 1 |
Cliente → Cliente |
Click en Añadir cliente
|
| 2 |
Pestaña Principal |
Nombre/Razón, RUC/CI, Tipo de Actividad |
| 3 |
Pestaña Dirección |
Código postal, calle, número, barrio, ciudad, geolocalización |
| 4 |
Pestaña Contactos |
E-mail, teléfono, WhatsApp |
| 5 |
Guardar |
Cliente queda en Preinscripción (sin contrato aún) |
Flujo 2: Crear primer contrato
| Paso |
Dónde |
Qué hacer |
| 1 |
Editar cliente → Contratos |
Añadir contrato |
| 2 |
Wizard - Configuraciones |
Plan de venta, regla de cobro, cartera, plantilla, estado inicial |
| 3 |
Wizard - Servicios |
Añadir PPPoE/IP/SVA. Sistema genera login automático. |
| 4 |
Wizard - Cadastro de usuarios |
Contraseña del PPPoE |
| 5 |
Wizard - Orden de servicio |
Agenda instalación técnica |
| 6 |
Wizard - Resumen |
Confirma |
| 7 |
Aceptación |
Cliente firma presencial o vía portal |
| 8 |
Técnico finaliza OS |
Contrato → Activo, login PPPoE entra en RADIUS |
Flujo 3: Cliente moroso — bloqueo automático
| Paso |
Qué pasa |
| D+0 (vencimiento) |
Cobro generado, enviado (ver Cobro
) |
| D+5 |
Cron de aviso — SMS/e-mail/WhatsApp |
| D+15 |
Cron de reducción automática — contrato → Reducido automático
|
| D+30 |
Cron de bloqueo automático — contrato → Bloqueado automático, login no autentica |
| Cliente paga |
Cron de retorno — contrato → Activo
|
Flujo 4: Cancelación
| Paso |
Dónde |
Qué hacer |
| 1 |
Editar contrato → Acciones |
Añadir acción Cancelación
|
| 2 |
Seleccionar Condición |
"Cancelación - Mudó de ciudad", "Insatisfacción", etc. |
| 3 |
Sistema verifica fidelidad |
Si tiene fidelidad activa, calcula multa |
| 4 |
Generar orden de retirada |
Equipo agendado (estado Retirada abierta) |
| 5 |
Técnico retira |
Contrato → Cancelado
|
Trampas frecuentes
1. Preinscripción no cobra. Si el cliente está registrado pero el contrato no fue a "Activo" (está en Preinscripción), la mensualidad no se genera.
2. Reducido automático cancela en N días. Si el contrato queda en
Reducido automático más allá del límite, el cron lo pasa a
Cancelado. Configura el plazo en
Reglas de Cobro
.
3. Fidelidad pendiente bloquea cancelación sin multa. El sistema calcula multa automáticamente.
4. MAC vinculado es restrictivo. Si el login tiene MAC fijado y el cliente cambia de router, autenticación falla.
5. Cliente con varios contratos: cobros separados por defecto. Cada contrato genera su propio cobro. Para agrupar, activa
Factura
.
Galería de pantallas
Listagem
Tipoatividade
Analise
Qualificacao
Historico
Listagem
Estado
Fidelidade
Servico
Template
Aceite
Condicao
Acao
Documento
Listagem
Consumo
Degustacao
Equipamento
Historico
Reply
Documentos relacionados
Profundiza en los temas relacionados:
-
Inventario
— equipos vinculados al contrato (ONU, router, decoder)
-
Soporte / OS
— atenciones y órdenes de servicio sobre el cliente
-
Fibra y Red
— login técnico (PPPoE/IPoE), conexión, ONU, señal óptica
-
SVA / NFeSVA
— servicios de valor agregado (Netflix, Skeelo, telefonía) y la factura específica
-
Paneles / Dashboards
— visión ejecutiva, indicadores diarios y alertas operacionales
-
Telefonía (VoIP + MVNO)
— servicios de voz fija y móvil que pueden ser vendidos junto con internet
-
Administración
— configuraciones, usuarios, permisos (ACL), tareas (crons) y logs de auditoría
-
Comunicación
— Email, SMS, WhatsApp y campañas masivas para clientes
-
Chat
— atención omnicanal en vivo (WhatsApp, bot, respuestas rápidas)
-
Portal / Área del Cliente
— autoatención del cliente final (2da vía, OS, dependientes, recomendaciones)
-
Mapa
— visualización geográfica de clientes, CTOs, postes, cables FO (georreferencia)
-
Generación de Cobro
— boleto/PIX/carnet
-
Mensualidad
— generación recurrente
-
Ventas
— ventas puntuales (instalación, equipo)
-
Plan de Ventas
— catálogo de planes
-
Factura / Contrato Factura
— agrupación de cobros
-
Reglas de Cobro
— vencimiento, multa, intereses
-
Carnet
— generación de carnet impreso
-
Renegociación
— acuerdo de deudas
-
Historial Financiero
— visión financiera del cliente
-
SLA
— perfiles de SLA
-
Comisiones
— comisión del vendedor
-
Configuración FacturaSend
— para Paraguay (DE)
-
Documento Electrónico Paraguay
— emisión de DE
-
Verificaciones
— auditorías de adimplencia
Preguntas frecuentes
¿Por qué mi cliente está cancelado pero aún recibe boleto?
Probablemente
el boleto fue generado antes de la cancelación. Cancela las deudas abiertas manualmente, o ejecuta
Verificar Adimplentes en
Verificaciones
.
¿Dónde altero el plan (velocidad) del cliente?
Editar contrato → pestaña Login → cambiar el campo Grupo. Para registrar comercialmente, usa también Añadir acción → Actualización de plan.
¿Puedo tener dos logins en el mismo contrato?
Sí. Cada servicio genera un login; un contrato con PPPoE + SVA-TV tendrá 2 logins.
¿Diferencia entre cancelar y bloquear?
Bloquear es temporal (cliente atrasó) — login para de autenticar pero el contrato sigue. Cancelar es definitivo — cierra el vínculo, retira equipo, genera multa de fidelidad.
¿Cómo saber todo lo que pasó con un cliente?
Combina: (a)
Cliente histórico; (b)
Contrato → Acciones; (c)
Login → Historial; (d)
Historial Financiero
.
¿Cómo medir el éxito operacional?
Defina 3 KPIs y acompañe semanalmente. Tendencia importa más que valor absoluto.
¿Hay entrenamiento oficial Quaza?
Sí — equipo de soporte ofrece sesiones de onboarding.
¿Cómo reportar bug o pedir nueva feature?
Por el canal de soporte. Incluya contexto: lo que esperaba, lo que pasó, frecuencia.
¿Cómo empezar a usar este módulo?
Configure los pre-requisitos, haga teste con pocos registros, valide con equipo, después active producción.
¿Necesito permiso especial?
Sí. Cada rol tiene permisos distintos.