Telefonía — VoIP Fija y Móvil (MVNO)
El módulo
Telefonía de Quaza gestiona los
servicios de voz que el proveedor ofrece además de internet:
-
Telefonía Fija (VoIP) — números fijos en el estándar SIP que corren sobre la red de datos (Tip, SaperX, Magnus Billing, Summit)
-
Telefonía Móvil (MVNO) — operador virtual que revende chips celulares con su marca (Brazmóvel, Tá Telecom, Bora, DryTelecom, Gertel)
Esta wiki cubre
registros (integradores, planes, números, usuarios, chips),
operación (CDR, grupos) e
facturación (importación periódica de los integradores → mensualidad del cliente).
Visión general — arquitectura del módulo
La telefonía en Quaza tiene tres capas: registro, operación y cobro. Todo gira alrededor del Integrador, que es el puente entre el gateway externo (Tip, Brazmóvel, etc.) y Quaza.
┌──────────────────────────────────────────────────────────────────────┐
│ GATEWAYS EXTERNOS (operadoras) │
│ Tip / SaperX / Magnus (VoIP fija) · Brazmóvel / Tá Telecom (MVNO)│
└──────────────────────────────────────────────────────────────────────┘
↓ (API/FTP/banco) ↑ provisionamiento
┌──────────────────────────────────────────────────────────────────────┐
│ INTEGRADOR (Quaza) │
│ config gateway · día corte · forma importación CDR · empresa fiscal │
└──────────────────────────────────────────────────────────────────────┘
↓ ↓ ↓
PLAN USUARIO NÚMERO
(tarifa, (extensión SIP / (DID — teléfono
franquicia) línea MVNO) público)
↕
TARJETA SIM
(solo MVNO)
↓ ↓ ↓
┌──────────────────────────────────────────────────────────────────────┐
│ CDR (Call Detail Record — una línea por llamada) │
│ origen · destino · duración · tarifa · costo · valor · fecha/hora │
└──────────────────────────────────────────────────────────────────────┘
↓ (consolidación mensual)
┌──────────────────────────────────────────────────────────────────────┐
│ FACTURACIÓN (mensual por usuario/plan) │
│ minutos LC/LDN/LDI/VC + valor minutaje + franquicia + total │
└──────────────────────────────────────────────────────────────────────┘
↓
FINANCIERO (mensualidad del cliente)
→ boleta única con Internet + Telefonía
¿Por qué existen dos "Números"? Quaza tiene telefonia-numero (fijo) y telefonia-numeromvno (móvil) porque las enums de gateway son diferentes: el fijo solo acepta gateways de VoIP (Tip, SaperX, Magnus, Summit) y el MVNO solo acepta operadoras móviles. Misma estructura, pantallas separadas — facilita la operación.
Glosario
Conceptos fundamentales
| Término |
Significado |
Dónde aparece |
| VoIP |
Voice over IP. Llamada de voz que circula por internet usando el protocolo SIP (telefonía fija moderna). |
Integrador (tipo fija), Usuario SIP |
| MVNO |
Mobile Virtual Network Operator. Operadora móvil virtual — revendes chips de una operadora real (Vivo/Claro/Tim/Personal/Tigo) con tu marca. |
Integrador (tipo MVNO), Chip SIM, Número MVNO |
| SIP |
Session Initiation Protocol. Protocolo que crea/cierra llamadas VoIP. Cada Usuario SIP es una "extensión" en el gateway. |
Usuario (Fijo): campos usuario + contraseña |
| DID |
Direct Inward Dialing. Número público que suena directo en la extensión SIP del cliente. En Quaza es el registro "Número". |
Número (Fijo) |
| ICCID |
ID único del chip físico (impreso en la placa del SIM card). No cambia incluso si el número se porta. |
Chip SIM (MVNO) |
| Portabilidade |
Migración del número entre operadoras (cliente cambia de proveedor manteniendo el número). |
Número (Fijo) → flag portado; Chip SIM → situaçãoPortabilidade
|
| CDR |
Call Detail Record. Una línea por llamada — origen, destino, duración, tarifa, costo. Es la materia prima de la facturación. |
Extracto CDR (importado de los gateways) |
| Franquicia |
Paquete de minutos prepagos en el plan (ej: 100min LC incluidos). Lo que exceda se cobra por minuto. |
Plan: minutosLc/LDN/LDI/VC
|
| Cadencia |
Tiempo mínimo cobrado / múltiplo de cobro. Estándar Anatel: 60/6 (mín 60s, después cobra cada 6s). |
Plan: cadenciaLc/LDN/...
|
Tipos de llamada (siglas Anatel)
| Sigla |
Tipo de llamada |
Ejemplo |
| LC |
Local — misma área DDD/característica |
SP→SP (11→11) |
| LDN |
Larga Distancia Nacional |
SP→RJ (11→21) |
| LDI |
Larga Distancia Internacional |
PY→Argentina |
| VC1 |
Móvil local (celular mismo DDD) |
AS fijo → AS celular |
| VC2 |
Móvil regional (misma región) |
AS → CDE celular |
| VC3 |
Móvil nacional fuera de la región |
AS → Encarnación celular |
¿Por qué separar VC1/VC2/VC3? Anatel/Conatel definieron tarifas máximas diferentes para cada tipo. El plan permite franquicia y tarifa específicas, y el CDR se clasifica automáticamente por el gateway de origen.
Gateways soportados
| Gateway |
Tipo |
Forma de integración |
| Summit |
VoIP fija |
API HTTP |
| Tip |
VoIP fija |
WebService + FTP (importación CDR) |
| SaperX |
VoIP fija |
API HTTP |
| Magnus Billing |
VoIP fija |
Acceso directo al banco MySQL |
| Tá Telecom |
MVNO |
API HTTP (provisionamiento + CDR) |
| DryTelecom |
MVNO |
API HTTP |
| Bora |
MVNO |
API HTTP |
| Brazmóvel |
MVNO |
API HTTP (envío en lote) |
| Gertel |
MVNO |
API HTTP |
1. Integrador — configuración del gateway
Camino: Telefonía → Integradores
O Integrador es la configuración técnica que conecta a Quaza con el gateway de telefonía. Sin integrador, nada funciona. Es lo primero a registrar.
Campos principales
| Campo |
Qué es |
Atención |
| Descripción |
Nombre interno del integrador |
Aparece en todos los reportes. Usa nombre claro tipo "VoIP Principal" o "MVNO Personal" |
| Gateway |
Qué operadora/proveedor de telefonía (Tip, Brazmóvel, etc.) |
Define las opciones de número/plan que aparecen después |
| Forma de Importación |
Cómo Quaza va a obtener los CDRs del gateway: API, WebService, FTP |
Depende del gateway. Tip = WebService + FTP, MVNO = API |
| Período Importación CDR |
Frecuencia: Diario / Semanal / Mensual |
Diario es el estándar. Mensual solo para gateways lentos |
| Día de Corte |
Día del mes donde la facturación "cierra" y empieza un nuevo ciclo |
Ej: día 25 — minutaje 26/abr a 25/may genera factura de mayo |
| Día de Facturación |
Día en que el financiero se genera para el cliente |
Generalmente algunos días después del corte |
| Valor Facturación |
Valor fijo cobrado al cliente por mes (independiente del uso) |
Común en MVNO: suscripción mensual del chip |
| Cod País / Cod Área |
Cód. internacional (595) y cód. de área principal del proveedor |
Usado en el parser de números |
| Servidor/Usuario/Contraseña BD |
Acceso al banco del gateway (solo Magnus) |
Credenciales sensibles — usuario solo lectura |
| URL API / Cliente ID / Secret |
Credenciales OAuth de la API del gateway |
Solicitar en el portal de la operadora |
| Generar Financieros |
Si la facturación genera mensualidad automática |
Apaga si quieres revisar antes de generar |
Atención: nunca registres dos integradores del mismo gateway con el mismo día de corte/facturación — Quaza puede confundirse y duplicar CDRs. Si necesitas dos integradores Tip (ej: para empresas diferentes), usa empresas fiscales distintas.
2. Plan de Telefonía
Camino: Telefonía → Planes
El Plan define franquicia + tarifas que se aplican al CDR para generar la facturación. Es como el "plan de internet" del contrato, pero para voz.
Estructura de un plan
| Bloque |
Campos |
Qué hace |
| Identificación |
Descripción, Código Integrador, Integrador |
Nombre interno + código en el gateway (debe coincidir) |
| Valor Predeterminado |
Mensualidad base del plan (Gs.) |
Cobrado todos los meses incluso sin uso. Tipo "línea + 100min" |
| Franquicia (minutos) |
minutosLc, minutosLdn, minutosLdi, minutosVc1/2/3 |
Minutos incluidos por categoría — no se cobran |
| Mínimo (minutos) |
minimoLc, minimoLdn, ... |
Tiempo mínimo cobrado por llamada (ej: 30s = 0.5min) |
| Tarifa (Gs./min) |
tarifaLc, tarifaLdn, ... |
Valor por minuto excedente a la franquicia (hasta 6 decimales) |
| Cadencia |
cadenciaLc = "60/6" |
Mínimo / múltiplo. 60/6 = cobra mín 60s, después cada 6s |
Leyendo la cadencia: formato min/mult. 60/6 significa "cobra al menos 60 segundos, después agrega de 6 en 6". Una llamada de 65s se cobra como 66s (60+6). Estándar Anatel es 60/6 — otras cadencias (30/30, 0/1) son acuerdo comercial específico.
Plan Ilimitado: algunos planes comerciales ofrecen minutos "ilimitados". En Quaza eso se traduce en franquicia muy alta (10.000min) + tarifa cero o en valorPadrao alto + franquicia que cubre uso normal. No hay flag específica "ilimitado".
3. Número (Fijo)
Camino: Telefonía → Números (Fijo)
O Número es el teléfono público (DID) que suena en la extensión SIP del cliente. Es el "número externo" — el que el cliente pone en la tarjeta de visita y que otros marcan para hablar con él.
Campos principales
| Campo |
Qué es |
| Número |
Teléfono completo con cód. internacional+área (ej: 595212110001 = +595 21 211-0001) |
| Integrador |
Por qué gateway se enruta ese número |
| Usuário |
Extensión SIP vinculada (1 número puede sonar en 1 extensión) |
| Cidade |
Ciudad de la numeración (define cód. de área) |
| Reservado |
Sí = bloqueado para nuevas asignaciones (ej: número antiguo de cliente cancelado en cuarentena) |
| Portado |
Sí = vino de otra operadora (cliente trajo el número) |
| Fecha Liberación |
Cuándo el número quedó disponible para uso |
Reservado vs Vinculado: un número puede estar vinculado (campo Usuario lleno — en uso) o libre (campo Usuario vacío — disponible para asignar). El "Reservado=Sí" es una tercera categoría: libre pero no debe asignarse — en cuarentena.
4. Usuario SIP (Fijo)
Camino: Telefonía → Usuarios (Fijo)
El Usuario es la extensión SIP que corre en la PABX/softphone del cliente. Tiene usuario + contraseña SIP que el aparato usa para autenticar en el gateway VoIP.
Campos principales
| Campo |
Qué hace |
| Usuario / Contraseña |
Credenciales SIP — configuradas en el aparato/softphone del cliente |
| Integrador / Plan |
Dónde está registrado y cómo se tarifica |
| Contrato |
Vínculo con contrato del cliente (para cobro) |
| Grupo |
Agrupamiento lógico (departamento, proyecto) |
| Limite |
Límite de crédito mensual — si lo supera, bloquea llamadas |
| Bloquea LC/LDN/LDI/VC1/VC2/VC3 |
Categorías bloqueadas (ej: bloquea LDI para evitar costo internacional) |
| Habilita BINA |
Identificación de chamada (CLID) — caller ID |
| Habilita Cobrar (cobro revertido) |
Permite llamada por cobrar (collect call) |
| Usuario Transferencia |
A dónde redirige si la extensión está ocupada/offline |
Trampa — bloqueo LDI por defecto: la mayoría de los proveedores bloquea LDI (internacional) por defecto para evitar fraude de invasión SIP. El cliente que necesite llamar al exterior debe solicitar liberación explícita y el operador desmarca "Bloquea LDI" + define límite alto.
5. Chip SIM (MVNO)
Camino: Telefonía → Chips (MVNO)
O Chip SIM es la tarjeta física que va en el celular del cliente. Cada chip tiene ICCID único (grabado en el plástico) + un Número MVNO asociado + Plan.
Campos principales
| Campo |
Qué es |
| ICCID |
ID único del chip (19-20 dígitos impresos en la tarjeta) |
| Usuário |
Usuario MVNO asociado (hace contrato con cliente) |
| Número |
Número MVNO activo en el chip (cód. internacional+área+9 dígitos) |
| Número Portado |
Si el cliente portó número de otra operadora, el número anterior queda aquí |
| Plano |
Plan MVNO en vigor (5GB, 10GB, ilimitado, etc.) |
| Situación |
Disponible / Activo / Suspendido / Cancelado |
| Situación Portabilidade |
Sin portabilidad / En curso / Esperando autorización / Concluida / Cancelada / Falla |
| Fecha Cancelación |
Cuándo el chip fue cancelado (si aplica) |
Ciclo de vida del chip: Estoque (Disponível) → Vendido (Ativo, com número e cliente) → eventualmente Cancelado/Suspenso. A integração com a operadora MVNO faz o provisionamiento automático quando o chip muda de estado.
6. Número MVNO
Camino: Telefonía → Números (MVNO)
O Número MVNO es el teléfono celular (cód. internacional+área+9 dígitos) asignado al chip. Pantalla espejo de Número Fijo, pero filtra solo gateways MVNO.
¿Por qué pantalla separada? Conforme o glossário, no Quaza Número (Fijo) e Número MVNO são duas listagens do mesmo cadastro filtradas por tipo de gateway. Vantagem: evita misturar numeração fixa e móvel ao atribuir, e bloqueia ações inválidas (não dá pra colocar número fixo em chip MVNO).
7. Grupo de Telefonía
Camino: Telefonía → Grupos
O Grupo es un agrupamiento lógico de usuarios SIP — útil para reportes ("¿cuánto gastó el equipo comercial?") y para reglas de enrutamiento avanzado.
| Campo |
Qué es |
| Descripción |
Nombre del grupo (Comercial, Atención, Soporte) |
| Código Integrador |
Código correspondiente en el gateway (si el gateway tiene grupos propios) |
| Integrador |
En qué integrador vive el grupo |
Uso típico: empresa con 50 extensiones crea 3 grupos (Comercial 25, Soporte 15, Directoría 10). En el reporte CDR puede ver gasto por grupo. En algunos gateways también permite reglas tipo "grupo X solo puede llamar a LC".
8. Facturación
Camino: Telefonía → Facturación
O Faturamento consolida todos los CDRs de un mes por usuario, aplica franquicia/tarifa del plan y genera el valor a cobrar. Ese valor se convierte en mensualidad en el financiero del cliente.
Columnas del listado
| Columna |
Qué muestra |
| Cliente / Contrato |
Cliente final vía Usuario→Contrato |
| Usuário |
Extensión SIP / línea MVNO |
| Faturado |
Sí/No — si ya generó financiero |
| Mes Referencia |
Mes cerrado (ej: 04/2026) |
| Valor Minutaje |
Total do excedente (chamadas além da franquicia) |
| Valor Total |
Valor minutaje + valor predeterminado del plan |
Flujo de generación
-
1CDR importado: Diariamente Quaza extrae del gateway las llamadas del día anterior
-
2Día de corte: En el día configurado en el Integrador, el cron CierreFacturacion consolida CDRs del ciclo (ej: 26/abr–25/may)
-
3Cálculo: Para cada usuario: suma minutos por categoría (LC/LDN/LDI/VC1-3) → resta franquicia → multiplica por la tarifa → valor minutaje
-
4Facturación creada: Línea en
telefoniaFaturamento con totales
-
5Día de facturación: En el día configurado, genera financiero (mensualidad) y marca Facturado=Sí
-
6Mensualidad del cliente: Aparece en la boleta consolidada junto con la internet
Atención — Facturado=No: se um faturamento ficar
Faturado=Não depois do dia de faturamento, significa que o cron falhou ou que
Generar Financieros=Não no Integrador. Use "Importar Faturamentos" pra reprocessar ou gere manualmente em
Cliente → Financiero
.
Flujos típicos paso a paso
Flujo 1: Habilitar telefonía VoIP para nuevo cliente
| Paso |
Dónde |
Qué hacer |
| 1 |
Telefonía → Números |
Seleccionar un número Libre + No Reservado de la lista. Anotar el ID. |
| 2 |
Telefonía → Usuarios (Fijo) |
Agregar usuario SIP: vincular al Contrato del cliente, elegir Plan, definir límite, dejar BloqueaLDI marcado. |
| 3 |
Telefonía → Números |
Editar el número elegido → vincular al Usuario creado. |
| 4 |
Gateway externo |
Confirmar que Quaza envió las credenciales vía API/WS. Si manual: crear usuario SIP en Tip/SaperX con mismo usuario/contraseña. |
| 5 |
Cliente |
Entregar credenciales (usuario SIP + contraseña + servidor + puerto) para configurar softphone/ATA/IP phone. |
| 6 |
Cliente hace prueba |
Llama desde otro teléfono al número; prueba origen (llamada saliente) — confirma que está autenticado. |
Flujo 2: Vender chip MVNO nuevo
| Paso |
Dónde |
Qué hacer |
| 1 |
Telefonía → Números MVNO |
Verificar si hay números libres del operador (Brazmóvel, etc.) |
| 2 |
Telefonía → Usuarios (MVNO) |
Crear usuario MVNO: contrato cliente, Plan MVNO (5GB), límite |
| 3 |
Telefonía → Chip SIM |
Agregar chip: escanear ICCID, vincular Usuario, Número, Plan, situación=Activo |
| 4 |
API operadora |
Quaza envía activación. Si manual: portal Brazmóvel → activar ICCID |
| 5 |
Cliente |
Entrega física del chip + recibo con número y plan |
Flujo 3: Portabilidad de número (cliente trae número de otra operadora)
| Paso |
Dónde |
Qué hacer |
| 1 |
Cliente |
Solicita portabilidad — proporciona número actual + CI/RUC + copia factura anterior |
| 2 |
Quaza (manual fuera del sistema) |
Solicitar Conatel/ABR — protocolo de portabilidad — informando operadora donadora |
| 3 |
Telefonía → Chip SIM (MVNO) |
Registrar chip con situaciónPortabilidad = "En curso" |
| 4 |
Esperar 1-3 días hábiles |
Cuando ABR/Conatel apruebe, cambiar situaciónPortabilidad = "Concluida" |
| 5 |
Telefonia → Número (Fijo) |
Para portabilidad VoIP: marcar Portado=Sí en el número nuevo |
| 6 |
Cliente recibe SMS/email |
Operadora antigua corta el servicio; nueva operadora activa en < 2h |
Flujo 4: Fin de mes — generar factura de telefonía
| Paso |
Dónde |
Quién hace |
| 1 |
Cron diario |
Importa CDRs del día anterior del gateway (automático) |
| 2 |
Telefonía → Extracto CDR |
Operador verifica si la importación corrió (líneas con fecha de ayer) |
| 3 |
Día de corte llegó |
Cron CierreFacturacion consolida (automático) |
| 4 |
Telefonía → Facturación |
Operador revisa — ¿todos los usuarios activos tienen línea del mes? ¿Alguno con valor cero? |
| 5 |
Día de facturación |
Cron genera financieros (automático) — Facturado=Sí |
| 6 |
Cliente
→ Financeiro |
Verifica que la mensualidad subió con el valor de telefonía |
Trampas frecuentes
1. Llamadas por cobrar se vuelven pérdida si "Habilita Cobrar" está activo por defecto
Si el cliente recibe muchas llamadas por cobrar (vendedores llamando), paga por las recibidas. Default seguro: dejar Habilita Cobrar=No y activar solo bajo pedido con contrato adicional.
2. Fraude SIP — invasión de contraseña débil
Contraseñas SIP cortas/obvias (1234, igual al usuario) son blanco de robots que invaden y hacen miles de llamadas internacionales en horas. Siempre usa contraseña aleatoria 16+ chars. Y mantén BloqueaLDI=Sí por defecto — pedido manual para liberar.
3. ICCID vs Número — no confundas
ICCID es del chip físico (no cambia). Número es el teléfono (puede portarse/cambiar). Busca por el ICCID cuando el cliente traiga el chip para cancelar, no por el número (cliente puede olvidar).
4. Importación CDR atrasada — verifica el cron
Si en la pantalla Extracto CDR solo aparece llamada antigua, el cron de importación está parado. Verifica
Tareas Financieras
y logs del gateway. Importación manual por el botón "Realizar Importación" funciona para recuperar.
5. Facturación cero para usuario activo
Cliente llama reclamando: "¡mi telefonía no se está cobrando hace 2 meses!" — probablemente el usuario SIP se registró sin contrato, entonces no hay cliente para cobrar. Solución: vincular contrato y ejecutar "Importar Facturaciones" en el mes.
6. Portabilidad falló — situaciónPortabilidad=Falla
Causas comunes: CI/RUC no coincide, deuda abierta en la operadora donadora, contrato en vigor (fidelidad), número no pertenece al CI/RUC informado. Cliente debe resolver con operadora antigua antes de intentar de nuevo.
7. Cadencia 60/6 vs 30/30 — confira contrato
Algunas operadoras venden con cadencia más agresiva (30/30 — cobra 30s y después cada 30s, incluso si el cliente cuelga en 35s, cobra 60s). Verifica lo que está en el Plan antes de prometer al cliente — discrepancia genera reclamo.
Galería de pantallas
Telefonia integrador
Telefonia plano
Telefonia numero
Telefonia usuario
Telefonia cartaosim
Telefonia numeromvno
Telefonia grupo
Telefonia faturamento
Documentos relacionados
Profundiza en los temas conexos:
-
Cliente
— contrato del cliente, vinculación del usuario SIP/MVNO
-
Fibra y Red
— telefonía VoIP usa la infraestructura de red del proveedor (SIP sobre PPPoE/IPoE)
-
Inventario
— chips SIM físicos entran como producto de stock antes de ser vendidos
-
Soporte / OS
— atenciones relacionadas a llamada con problema, configuración SIP
-
SVA / NFeSVA
— telefonía puede venderse como SVA (servicio de valor agregado) con NFe específica
-
Paneles / Dashboards
— no tiene alerta específica de telefonía hoy, pero facturaciones no cerradas pueden generar inconsistencia
-
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)
-
Tareas Financieras
— donde corren los crons de importación CDR + cierre facturación
FAQ
¿Quaza tiene PABX propia? ¿Puedo usar sin gateway externo?
Não — Quaza é o billing, não a PABX. A voz trafega pelo gateway externo (Tip, Magnus, etc.). Quaza só configura o provisionamiento e consome os CDRs pra cobrar.
¿Cómo veo el historial de llamadas de un cliente específico?
Telefonía → Extracto CDR → use Filtros → idUsuario = ramal do cliente. Ou abra o usuário SIP → aba CDR.
Cliente cambió de plan a mitad de mes — ¿cómo cobrar prorrateo?
Quaza no hace prorrateo automático de plan de voz. Generalmente el operador edita la Facturación del mes manualmente o usa el Plan nuevo a partir del próximo ciclo. Si es cobro significativo, generar suelta en Ventas
.
¿Chip MVNO desapareció de la operadora — número desactivado sin aviso?
Operadoras móviles cancelan números inactivos > 90 días sin uso. Mantén chips de stock con al menos un "mantenimiento" mensual — o acepta la pérdida y retira del registro.
¿Existe reporte consolidado de minutos por mes?
Telefonía → Facturación → aba Relatórios. Permite agrupar por usuário, grupo, integrador, plano.
¿Puedo tener el mismo gateway con 2 empresas fiscales?
Sí — registra 2 integradores con mismo gateway, cada uno con idEmpresa diferente. Los planes/usuarios quedan aislados por empresa para fines fiscales.
¿Quaza sabe cuándo una llamada está en curso?
No en tiempo real. Quaza recibe el CDR solo después de terminar la llamada. Para monitoreo en tiempo real, usa el portal del propio gateway (Magnus Billing tiene dashboard en vivo).