Central de Ajuda Quaza Provedores

Cliente (PT)

Cliente — Quaza

Cliente — Cadastro, Contratos e Conexões — El corazón de Quaza: como organizar quién contrata, que contrata y la conexión técnica que entrega

Esta guía explica desde cero o módulo Cliente — pensada para quien nunca usó Quaza (o ningún sistema de provedor de internet). Cada concepto se define antes de aparecer en uma tela, y cada tela tem captura real de ejemplo.

O que es o módulo Cliente? Es donde está quién es tu cliente (persona, empresa, datos de contacto), que contrató (planes, serviços, fidelidad) y como se conecta (login PPPoE, IP, equipo). Toda faturación, fatura electrónica, orden de servicio y atención parte de aquí.

Nesta wiki:

Visão geral — a cadeia completa
Glossário — conceitos antes das telas
Fluxos típicos passo-a-passo
Pegadinhas frequentes
Documentos relacionados
Perguntas frequentes

Visão geral — a cadeia completa

Antes de profundizar en as telas, comprende la relación entre os 4 conceitos centrales. Cada caixa do diagrama es uma entidad en la base de datos, con seu propia tela:

┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ CLIENTE │ 1→N│ CONTRATO │ 1→N│ LOGIN │ 1→N│ EQUIPO │ │ (PF o PJ) │────│ (1 servicio)│────│ (PPPoE/IP) │────│ (ONU/router)│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │ ┌──────┼─────────────────────┐ ↓ ↓ ↓ [Cobrança] [Doc. Electr.] [Plan de Venta] [Carnê] [Fatura] [Comisión] [Vendas] [Renegociação] [Fidelidad]

Un cliente pode tener varios contratos (ej: internet residencial + IP fijo empresarial + TV). Cada contrato tem 1 o más logins (credenciales técnicas que autentican el equipo en la red). Cada login pode tener uno o más equipos vinculados.

Glossário — conceitos antes das telas

Tipos de Cliente

Tipo	Quando se usa	Exemplo
Persona Física	Cliente residencial — suscripción personal	"Juan Pérez", CI/RUC, casa de Juan
Persona Jurídica	Cliente empresarial — emite Fatura 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

Atendimento — Cliente ≠ Empresa
En Quaza, "Cliente" es quien contrata tu servicio (suscriptor). Ya "Empresa" (en Admin → Empresa) es tu provedor — la razón social que emite os documentos electrónicos. No confundas al configurar.

Estados do Cliente vs Estados do Contrato

El cliente en sí não tem "estado" técnico — quien lo tem es el contrato. Cuando dices "el cliente está bloqueado", en realidad el contrato está bloqueado. Por eso un mismo cliente pode tener un contrato Activo (internet) y otro Cancelado (TV vieja).

Estado do contrato	Significa	Cobra mensalidade?	Conecta?
Preinscripción	Aceptado, esperando instalação	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 do listado)	No	No
Retirada abierta	Equipe agendado para retirada	Sí (hasta retirar)	Sim/Não

Login técnico ≠ Usuário do sistema

Dos conceitos que se llaman parecido pero son completamente diferentes:

	Login técnico (do contrato)	Usuário do sistema (operador)
O que es?	Credencial PPPoE/IPoE/Hotspot que el equipo do cliente usa para autenticar en la red	Login do operador (atendente, técnico, gestor) que accede al panel de Quaza
Onde	Cliente → Contrato → Login	Admin → Usuário (o ACL → Usuário)
Ejemplo	`user_12345` / senha gerada	`maria.silva` / login do atendente
Quién lo usa	Router/ONU do cliente final	Empleado do provedor

1 Registro de Cliente

Cliente → Cliente

La tela principal do módulo lista todos os clientes registrados. Es la puerta de entrada do sistema — toda faturación, contrato, atención parte de un cliente registrado aquí.

Listagem de clientes — note as pestañas (Estándar, En mora), filtros pre-creados y el botón verde "Adicionar cliente" arriba a la derecha

Botones superiores

Botão	Função
+ Adicionar cliente	Registra un nuevo cliente desde cero (PF o PJ)
Edição múltiple	Selecione varios y altera campos en lote
Acciones	Operaciones masivas: bloqueo, envío de e-mail, geración de boletos

Tipo de Atividade

Cliente → Tipo de Atividade

Categorización libre — define listas como Residencial, Empresarial, Condominio, Cortesía, Empleado. Útil para informes, filtros masivos y reglas de cobrança distintas por tipo.

Tipos de atividade — cada provedor define os suyos

Análisis de Registros

Cliente → Análisis de Registros

Herramienta de auditoria 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 que validar y haz clic en "Analizar Registros"

Validación	O que chequea	Quando 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	Nome, contacto — auditoria geral	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 carteira	Auditoria técnica
Validar datos para gateway	Específico do gateway (Sicredi, MP, etc.)	Antes de activar cobrança 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ó, quando, y qual era el valor antes/depois.

Historial de alteraciones — trazabilidad completa para LGPD/auditoria

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 faturación, login, instalação y cancelación gira en torno al contrato.

Cliente pode tener varios contratos. Ejemplo: Juan tem 1 contrato de internet residencial, 1 de IP fijo (empresa), 1 de TV. Son 3 contratos, 3 cobranças (o 1 fatura agregadora — ver Fatura ), pero 1 solo cliente.

Listagem de contratos con columnas de cliente, número, plan de venda, valor mensual, regla de cobrança y estado

Estados do Contrato

Cliente → Estado do contrato

Configuração de estados — cuántos contratos há en cada estado

Condiciones do Contrato

Cliente → Condición do contrato

Condiciones do contrato — perfil de motivos de cancelación y situaciones intermedias

Serviços

Cliente → Serviço do contrato

Catálogo de tipos de servicio que poden entrar en un contrato:

Tipo de servicio	O que é	Gera login?
PPPoE	Internet con autenticación por usuário/senha	Sim — usuário y senha PPPoE
IP Fijo	Conexión por IP estático (sin login)	Sim — login con IP fijado
SVA	Streaming/TV/Telefonia (Serviço de Valor Adicionado)	Depende
Otros	Mensalidade fija sin componente técnico	No

Listagem de serviços — note el tipo, si gera usuário y el valor predeterminado

Templates de Contrato

Cliente → Template do contrato

Templates de contrato — modelos registrados, con conteo de contratos usando cada uno

Configuração de Aceptación

Cliente → Aceptación do contrato

Configurações de aceptación — Aceptación con foto (presencial) y Aceptación portal (digital)

Tipo	Como funciona	Quando usar
Aceptación con foto	Técnico en sitio fotografía al cliente con CI + firma do 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.	Vendas online, renovaciones

Acciones do Contrato

Cliente → Acción do contrato

Acciones do contrato — note os valores antes/depois y el estado (Pendiente/Concluida)

Documentos do Contrato

Cliente → Documentos do contrato

Documentos do contrato — gestión de anexos con aceptación digital

Cliente → Contrato → Logins

El login es lo que de hecho autentica el equipo do cliente en la red. Cada login tem usuário/senha, MAC esperado, IP fijo (opcional), grupo de velocidad, prioridad, equipo.

Listagem de logins — columnas Cliente, Estado, Plan (grupo), Medio (Fibra/TV), IPv4, CTO/Puerto

Consumo

Cliente → Contrato → Consumo

Consumo por login — útil para auditoria de uso e identificación de usuários sobre la media

Degustación

Cliente → Contrato → Degustación

Degustaciones — período de prueba de plan superior, con fecha inicio y fin

Equipamentos

Cliente → Contrato → Equipe

Equipamentos — fabricante, comunidad SNMP usada para gestión remota

Historial do Login

Cliente → Contrato → Historial

Historial de alteraciones do login — útil para investigar problemas técnicos

Reply (atributos RADIUS personalizados)

Cliente → Contrato → Reply

Reply RADIUS — uso avanzado para clientes con necessidadees fuera do estándar

Fluxos típicos passo-a-passo

Fluxo 1: Registrar cliente nuevo

Passo	Onde	O que fazer
1	Cliente → Cliente	Click en Adicionar cliente
2	Aba Principal	Nome/Razón, RUC/CI, Tipo de Atividade
3	Aba Dirección	Código postal, calle, número, barrio, ciudad, geolocalización
4	Aba Contactos	E-mail, teléfono, WhatsApp
5	Salvar	Cliente queda en Preinscripción (sin contrato aún)

Fluxo 2: Criar primer contrato

Passo	Onde	O que fazer
1	Editar cliente → Contratos	Adicionar contrato
2	Wizard - Configurações	Plan de venda, regla de cobrança, carteira, template, estado inicial
3	Wizard - Serviços	Adicionar PPPoE/IP/SVA. Sistema gera login automático.
4	Wizard - Cadastro de usuários	Senha do PPPoE
5	Wizard - Orden de servicio	Agenda instalação 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

Fluxo 3: Cliente moroso — bloqueo automático

Passo	O que pasa
D+0 (vencimiento)	Cobrança gerado, enviado (ver Cobrança )
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

Fluxo 4: Cancelamento

Passo	Onde	O que fazer
1	Editar contrato → Acciones	Adicionar acción Cancelamento
2	Selecioner Condición	"Cancelamento - Mudó de ciudad", "Insatisfacción", etc.
3	Sistema verifica fidelidad	Si tem fidelidad activa, calcula multa
4	Gerar orden de retirada	Equipe agendado (estado Retirada abierta)
5	Técnico retira	Contrato → Cancelado

Pegadinhas frequentes

1. Preinscripción no cobra. Si el cliente está registrado pero el contrato no fue a "Activo" (está en Preinscripción), la mensalidade no se gera.

2. Reducido automático cancela en N días. Si el contrato queda en Reducido automático más allá do límite, el cron lo pasa a Cancelado. Configura el plazo en Regras de Cobrança .

3. Fidelidad pendiente bloquea cancelación sin multa. El sistema calcula multa automáticamente.

4. MAC vinculado es restrictivo. Si el login tem MAC fijado y el cliente cambia de router, autenticación falla.

5. Cliente con varios contratos: cobranças separados por defecto. Cada contrato gera seu propio cobrança. Para agrupar, activa Fatura .

Galeria de telas

Documentos relacionados

Aprofunde-se nos temas relacionados:

Estoque — equipos vinculados al contrato (ONU, router, decoder)
Suporte / OS — atenciones y órdenes de servicio sobre el cliente
Fibra e Rede — login técnico (PPPoE/IPoE), conexión, ONU, señal óptica
SVA / NFeSVA — serviços de valor agregado (Netflix, Skeelo, telefonia) y la fatura específica
Painéis / Dashboards — visión ejecutiva, indicadores diarios y alertas operacionales
Telefonia (VoIP + MVNO) — serviços de voz fija y móvil que poden ser vendidos junto con internet
Administração — configuraciones, usuários, permisos (ACL), tarefas (crons) y logs de auditoria
Comunicação — Email, SMS, WhatsApp y campañas masivas para clientes
Chat — atención omnicanal en vivo (WhatsApp, bot, respuestas rápidas)
Portal / Área do Cliente — autoatendimento do cliente final (2da vía, OS, dependientes, recomendaciones)
Mapa — visualización geográfica de clientes, CTOs, postes, cables FO (georreferencia)
Geración de Cobrança — boleto/PIX/carnê
Mensalidade — geración recurrente
Vendas — ventas puntuales (instalação, equipo)
Plan de Vendas — catálogo de planes
Fatura / Contrato Fatura — agrupación de cobranças
Regras de Cobrança — vencimiento, multa, intereses
Carnê — geración de carnê impreso
Renegociação — acuerdo de deudas
Histórico Financeiro — visión financiera do cliente
SLA — perfiles de SLA
Comissões — comisión do vendedor
Configuração FaturaSend — para Paraguai (DE)
Documento Eletrônico Paraguai — emisión de DE
Verificações — auditorias de adimplencia

Perguntas frequentes

Por que mi cliente está cancelado pero aún recibe boleto?
Probablemente el boleto fue gerado antes da cancelación. Cancela as deudas abiertas manualmente, o ejecuta Verificar Adimplentes en Verificações .

Onde altero el plan (velocidad) do cliente?
Editar contrato → pestaña Login → cambiar el campo Grupo. Para registrar comercialmente, usa también Adicionar acción → Actualización de plan.

Puedo tener dos logins en el mismo contrato?
Sí. Cada servicio gera 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, gera multa de fidelidad.

Como saber todo lo que pasó con un cliente?
Combina: (a) Cliente histórico; (b) Contrato → Acciones; (c) Login → Historial; (d) Histórico Financeiro .

Como medir o sucesso operacional?

Defina 3 KPIs e acompanhe semanalmente. Tendência importa mais que valor absoluto.

Há treinamento oficial Quaza?

Sim — equipe de suporte oferece sessões de onboarding. Documentação rica também ajuda.

Como reportar bug ou pedir nova feature?

Pelo canal de suporte. Inclua contexto: o que esperava, o que aconteceu, frequência do problema.

Como começar a usar este módulo?

Configure os pré-requisitos, faça um teste com poucos registros, valide com a equipe, e só então ative em produção.

Preciso de permissão especial?

Sim. Cada papel (operador/supervisor/admin) tem permissões distintas. Confirme com administrador.