Central de Ajuda Quaza Provedores

Cliente (ES-PY)

Cliente — Quaza

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
Bloqueado automático Bloqueado por morosidad vía cron No
Bloqueado manual Bloqueado por el operador (motivo libre) No
Reducido automático Velocidad reducida (cron de morosidad) 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
Listagem
Tipoatividade
Tipoatividade
Analise
Analise
Qualificacao
Qualificacao
Historico
Historico
Listagem
Listagem
Estado
Estado
Fidelidade
Fidelidade
Servico
Servico
Template
Template
Aceite
Aceite
Condicao
Condicao
Acao
Acao
Documento
Documento
Listagem
Listagem
Consumo
Consumo
Degustacao
Degustacao
Equipamento
Equipamento
Historico
Historico
Reply
Reply

Documentos relacionados

Profundiza en los temas relacionados:

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.