Como podemos ajudar?

Central de Ajuda Quaza Provedores — encontre por tema, ou busque direto.

Busca instantânea · resultados enquanto digita Populares: Sicredi · Desprovisionar ONU · Unificar cobrança

Telefonía (ES-PY)

La Telefonía de Quaza concentra la gestión de los servicios de voz que usted vende a sus clientes: la conexión con la operadora (gateway), los planes de voz con minutos y tarifas, los números de teléfono (DID), los usuarios de telefonía fija/VoIP, las tarjetas SIM y usuarios móviles (MVNO), y la facturación de las llamadas. Esta página es la guía operativa del módulo para el operador y el técnico del proveedor.

En esta wiki:

Cuándo usar la Telefonía (y cuándo NO)

Use la Telefonía cuando...	NO es el lugar cuando...
El proveedor revende voz fija/VoIP (extensiones, números DID) o línea móvil (chip MVNO) y necesita cobrar las llamadas por Quaza.	Solo quiere consultar saldo y llamadas de una plataforma VoIP externa (MOR) sin operar la tarifación en Quaza — vea VoIP.Mor .
Necesita registrar planes de voz, importar números y usuarios de la operadora y generar el cobro mensual de las llamadas.	Quiere configurar bloques de IP, perfiles de acceso o los detalles técnicos de red — vea Red .
Gestiona el ciclo de un chip móvil: activar, cambiar plan/número, bloquear, cancelar y portabilidad.	El cliente no tiene servicio de voz contratado — entonces nada de aquí se le aplica.

Telefonía fija/VoIP vs. móvil (MVNO). El módulo atiende dos mundos. En la telefonía fija/VoIP usted trabaja con números (DID), usuarios y el detalle de llamadas (CDR). En la telefonía móvil (MVNO) trabaja con tarjetas SIM, usuarios móviles y números móviles. Cuál aparece depende del gateway que elija en el Integrador.

Paso a paso — del gateway al primer número activo

Secuencia mínima para poner la telefonía fija/VoIP en funcionamiento. Cada paso abre una pantalla del menú Telefonía.

1	Registre el Integrador. Elija la operadora (gateway), informe los datos de conexión (dirección, usuario y contraseña) y los parámetros de cobro. Es el puente entre Quaza y la operadora.
2	Importe los planes. En la pantalla Plan, haga clic en Importar Planes y seleccione el integrador. Los planes vienen listos de la operadora; usted solo ajusta valor y servicio.
3	Importe los grupos (cuando la operadora usa grupos). En la pantalla Grupo, haga clic en Importar Grupos.
4	Importe los números. En la pantalla Número, haga clic en Importar Números. Son los números (DID) disponibles en la operadora para distribuir a los clientes.
5	Registre el usuario. En la pantalla Usuario, haga clic en Agregar usuario, elija el integrador, vincule el cliente/contrato y defina usuario, contraseña, plan y grupo.
6	Vincule un número al usuario. Dentro del propio usuario, agregue un número disponible de la ciudad. El número pasa a pertenecer a ese usuario.
7	Las llamadas entran solas. El sistema importa el detalle de llamadas (CDR) de la operadora periódicamente. Usted lo consulta en Detalle CDR.
8	Facture. Al cierre del ciclo (día de corte/facturación del integrador) el sistema genera la Facturación por usuario; usted revisa y genera la venta para el contrato.

Para telefonía móvil (MVNO) el camino cambia a partir del paso 4: en lugar de Número/Usuario fijos, usted importa Tarjeta SIM, registra Usuario (MVNO) y activa el chip. Detalles en la sección Tarjeta SIM, Usuario y Número (MVNO) .

Flujo general — de la llamada a la facturación

De la puesta a disposición en la operadora hasta el cobro en el contrato. Los pasos 5 y 6 ocurren manualmente (botón Importar) o por tarea automática.

Glosario

Término	Qué significa
Gateway	La operadora/plataforma de voz con la que Quaza se integra (por ejemplo Tip, Magnus Billing, SaperX, Summit en voz fija; Bora, Brazmóvel, Gertel, Tá Telecom, DryTelecom en telefonía móvil). Cada Integrador usa un gateway.
Integrador	El registro en Quaza que guarda los datos de conexión con un gateway y las reglas de cobro de esa operadora.
DID / Número	El número de teléfono que el proveedor distribuye al cliente. Viene de la operadora y se vincula a un usuario.
Usuario (telefonía)	La extensión/cuenta de voz de un cliente. Une el número, el plan y el contrato. En voz fija tiene usuario y contraseña; en MVNO está ligado al chip.
Plan de telefonía	La franquicia de minutos y las tarifas por tipo de llamada que rigen cuánto paga el cliente.
CDR (Detalle de llamadas)	El registro detallado de cada llamada (origen, destino, duración, valor). Es la base de la facturación.
MVNO	Operadora móvil virtual. Es la telefonía móvil (chip/SIM) que el proveedor revende usando la red de una operadora real.
Tarjeta SIM	El chip móvil. Tiene un ICCID y recorre estados como Disponible, Activo, Bloqueado y Cancelado.
ICCID	El número único impreso en el chip que lo identifica en la operadora.
Portabilidad	Traer un número de otra operadora al chip activado aquí, manteniendo el número del cliente.
Grupo de telefonía	Una agrupación de usuarios en la operadora (por ejemplo equipo comercial, soporte). Se importa de la operadora.
DDI / DDD	Código de país (DDI) y código de área (DDD) usados en la numeración. Están en el Integrador.
LC, LDN, LDI, VC1, VC2, VC3	Tipos de llamada usados en las franquicias y tarifas: LC = local, LDN = larga distancia nacional, LDI = internacional, VC1/VC2/VC3 = llamadas a móvil (local, regional, nacional).
Cadencia	Cómo se cobra la llamada por tiempo, en el formato inicio/intervalo (ej. 3/30/6). Viene de la operadora.

Configuración y requisitos previos

Antes de registrar usuarios y números, prepare la base. Cada ítem de abajo es un requisito del paso a paso.

Acceso a la operadoraTelefonía → Integrador

Necesita los datos de conexión que la operadora provee (dirección, usuario y contraseña de integración). Sin ellos Quaza no puede importar planes, números ni llamadas.

Servicio en el contratoRegistro del servicio cobrado en el contrato

El Integrador pide un Servicio predeterminado y cada plan puede apuntar a un Servicio. Es el ítem que aparece en el cobro del cliente. Defínalo antes de generar ventas.

Contrato del clienteCliente → Contrato

El usuario de telefonía se vincula a un cliente y a un contrato. El cliente debe tener contrato activo para recibir el cobro de las llamadas.

Forma de pago y tipo de ventaFinanciero

Para generar la venta de la facturación, el sistema pide un tipo de venta y una forma de pago ya registrados y activos.

Integrador — la conexión con la operadora

Es el primer registro del módulo. Define con qué operadora habla Quaza y cómo cobra. Todo (planes, números, usuarios, llamadas) pertenece a un integrador.

Telefonía → Integrador

Listado de integradores: cada linea es una operadora con su gateway (aqui, Tip para voz fija y Brazmovel para movil) y la licencia predeterminada.

Campos principales

Campo	Para qué sirve
Descripción	Un nombre amigable para identificar la integración (ej. "VoIP Principal", "MVNO Brazmóvel").
Gateway	La operadora/plataforma. La elección aquí decide si esta integración es de voz fija o móvil y qué campos de conexión aparecen.
Situación	Activa o desactiva la integración.
Código de País (DDI) / Código de Área (DDD)	Numeración usada por la operadora. El DDI ya viene completado como 55.
Licencia Predeterminada	El tipo de licencia de voz aplicado por defecto (definido por la operadora).
Servicio predeterminado	El servicio del contrato usado en el cobro cuando el plan no indica otro.
Día de corte / Día de Facturación	Cuándo cierra el ciclo y cuándo se genera el cobro.
Valor de Facturación / Generar cobros	Valor base y si la facturación debe generar cobro automático en el financiero.
Datos de conexión (dirección, usuario, contraseña)	Las credenciales de la operadora. Varían según el gateway elegido — el formulario muestra solo lo que ese gateway usa. Las contraseñas quedan ocultas.

Probar conexión. Al editar un integrador que usa conexión por API o por transferencia de archivos, aparecen botones para Probar conexión. Úselos para confirmar que las credenciales están correctas antes de importar cualquier cosa.

Plan de telefonía — minutos y tarifas

El plan define la franquicia de minutos y la tarifa por tipo de llamada. Los planes vienen de la operadora: usted los importa y luego ajusta valor y servicio — no se crea un plan desde cero.

Telefonía → Plan

Listado de planes importados, con la operadora (Integrador) de origen y si el plan es ilimitado.

Qué edita usted en el plan

Campo	Significado
Descripción	Nombre del plan (viene de la operadora; en algunos gateways puede ajustarse).
Ilimitado	Indica si el plan no tiene límite de minutos.
Valor predeterminado	El valor base del plan usado en el cobro.
Servicio	El ítem del contrato que va a aparecer en el cobro del cliente.
Minutos Franquicia (LC, LDN, LDI, VC1, VC2, VC3)	Cuántos minutos de cada tipo de llamada están incluidos en el plan.
Tarifa (LC, LDN, LDI, VC1, VC2, VC3)	Cuánto cuesta el minuto excedente de cada tipo.
Cadencia (LC, LDN, ...)	Cómo se cobra el tiempo (ej. 3/30/6). Viene de la operadora.
Llamadas a cobrar	Define si las llamadas generan cobro.

Para importar planes: en el listado haga clic en Importar Planes, elija el integrador y confirme. Los planes aparecen en la lista; luego abra cada uno para ajustar valor y servicio.

Número (DID) y Usuario — telefonía fija/VoIP

Para gateways de voz fija/VoIP usted trabaja con dos registros que van juntos: el Número (el teléfono) y el Usuario (la cuenta de voz del cliente). Importe los números, registre el usuario y vincule un número a él.

Número

Telefonía → Número

Listado de numeros (DID): cada numero pertenece a un integrador y queda libre hasta vincularse a un usuario/cliente.

Los números se importan de la operadora (botón Importar Números). Para cada número usted ve el integrador, el número en sí, la ciudad, si está portado o reservado y la fecha de liberación. El número solo pasa a cobrarse cuando se vincula a un usuario.

Usuario

Telefonía → Usuario

Listado de usuarios de voz fija: cada uno une el cliente/contrato, el/los numero(s) y el plan.

Al agregar un usuario usted elige el integrador, vincula el cliente y el contrato, define usuario y contraseña (hay un botón para generar contraseña aleatoria) y elige el plan y el grupo. La pestaña Información trae opciones de tarificación y bloqueos por tipo de llamada (cobrar, identificación de llamadas, bloquear LC/LDN/LDI/VC1/VC2/VC3). Después de guardar, dentro del usuario usted vincula un número disponible de la ciudad del cliente.

Importar usuarios existentes. Si los usuarios ya existen en la operadora, use Importar Usuarios en el listado en vez de registrar uno por uno.

Tarjeta SIM, Usuario y Número (MVNO) — telefonía móvil

Para gateways móviles (MVNO) el flujo cambia: en lugar de número fijo + usuario, usted gestiona tarjetas SIM, usuarios móviles y números móviles. El corazón de la operación es la Tarjeta SIM y sus estados.

Tarjeta SIM

Telefonía → Tarjeta Sim

Listado de tarjetas SIM (MVNO): cada chip tiene ICCID, numero activo y situacion (aqui, Disponible).

Los chips se importan de la operadora (botón Importar SimCards). Al abrir un chip, los botones disponibles dependen de su situación y de lo que la operadora permite:

#	Botón	Cuándo aparece	Qué hace
1	Activar SimCard	Chip Inactivo	Activa el chip en la operadora, vinculando contrato, plan, DDD y (opcional) número portado.
2	Actualizar datos	Chip activo/disponible o con portabilidad en curso	Sincroniza la información del chip con la plataforma de la operadora.
3	Cambio de usuario	Chip activo/disponible	Transfiere el chip a otro usuario móvil.
4	Cambio de número	Chip activo/disponible	Cambia el número activo del chip.
5	Cambio de plan	Chip activo/disponible	Cambia el plan del chip.
6	Bloqueo parcial	Chip activo/disponible	Bloquea llamadas de voz, SMS y datos, pero el usuario aún recibe llamadas y SMS.
7	Bloqueo total	Chip activo/disponible	Bloquea todos los servicios del chip.
8	Desbloquear SimCard	Chip bloqueado (parcial o total)	Libera los servicios del chip. No funciona en chip cancelado.
9	Cancelar SimCard / Cancelar plan	Chip activo/disponible	Cancela el chip (o el plan, en algunas operadoras).

Estados de la tarjeta SIM: Inactivo, Disponible, Activo, Bloqueado, Bloqueado parcialmente, Cancelado, Suspendido y Pendiente financiero. En el listado los chips bloqueados aparecen en rojo, los inactivos en amarillo y los cancelados en gris. La pestaña Pagos solo aparece cuando la operadora soporta captura de pago.

Usuario (MVNO)

Telefonía → Usuario (MVNO)

El usuario móvil une el contrato del cliente a los chips. Cada contrato tiene un único usuario por integrador. En algunas operadoras (ej. Brazmóvel) el usuario nace Pre Activo y debe activarse: usted envía un código al número del cliente y confirma la activación con el código recibido. Dentro del usuario usted ve los chips (SIM) vinculados a él.

Número (MVNO)

Telefonía → Número (MVNO)

Listado de numeros moviles (MVNO): numeros importados de la operadora, listos para vincular a un chip/usuario.

Los números móviles también se importan (botón Importar Números) y quedan disponibles para vincular a un chip/usuario durante la activación o por el cambio de número.

Grupo de telefonía

Los grupos organizan a los usuarios en la operadora (por ejemplo "Equipo Comercial", "Soporte Técnico"). Vienen de la operadora — usted los importa (botón Importar Grupos) y luego asocia un grupo a cada usuario de voz fija. Aplica a los gateways de voz fija.

Telefonía → Grupo

Listado de grupos de telefonia importados de la operadora.

Facturación y Detalle de llamadas

La Facturación es el cierre del ciclo: para cada usuario, el sistema suma minutos y valores por tipo de llamada (a partir del detalle CDR), aplica la franquicia del plan y llega a un valor total. Usted revisa y lo convierte en cobro.

Telefonía → Facturación

Listado de facturaciones por usuario, con la columna Facturado (Si/No), el mes de referencia y los valores de minutos y total.

Qué hace usted en una facturación

Al abrir una facturación (que es de solo lectura) usted ve los minutos y valores por tipo de llamada y el detalle de las llamadas. Los botones disponibles:

#	Botón	Qué hace
1	Ver usuario / Ver cliente / Ver contrato / Ver débito	Abre los registros relacionados con la facturación.
2	Generar venta	Aparece cuando la facturación aún no fue facturada y tiene contrato. Crea la venta en el contrato del cliente (eligiendo tipo de venta, forma de pago y vencimiento) y marca como facturado.
3	Marcar como facturado	Marca manualmente como facturado sin generar venta (cuando el cobro se trató por otro camino).

La facturación no se crea a mano. Los registros surgen del procesamiento de las llamadas (importación del CDR + cálculo). La pantalla solo permite revisar, generar la venta y marcar como facturado.

Detalle de llamadas (CDR)

El detalle lista cada llamada individual (inicio, origen, destino, duración, tipo y valor). Usted puede importar el detalle manualmente, filtrar por período y usuario y generar reporte. Los tipos de llamada siguen el glosario (Local, Nacional, Internacional, Móvil Local/Regional/Nacional, 0800 y Otros).

Tareas automáticas

Buena parte del trabajo corre solo mediante tareas programadas. Cada una hace una parte del ciclo. Quien las activa, desactiva y programa es el administrador del servidor — el equipo de operación no controla eso por una pantalla.

Tarea	Qué hace
Importa CDR	Busca en la operadora el detalle de llamadas (CDR) y lo trae a Quaza. Es lo que alimenta la facturación.
Crea los financieros del CDR	A partir del detalle, genera las facturaciones/cobros de las llamadas.
Activación del chip Bora MVNO	Concluye en segundo plano la activación de chips en la operadora Bora (que puede tardar algunos minutos).
Captura de pago	Procesa los pagos programados de los chips, en las operadoras que soportan captura de pago.

Manual o automático. Importar CDR y generar la facturación también pueden hacerse al instante con los botones Importar de las pantallas. Las tareas solo automatizan lo que usted haría a mano.

Errores frecuentes

Importar antes de registrar. Planes, grupos, números y chips vienen de la operadora. Si intenta registrar un usuario sin antes importar planes/números, no tendrá qué seleccionar. Empiece siempre por el Integrador y por las importaciones.

El número solo cobra cuando se vincula. Un número importado queda libre. Solo entra en la cuenta del cliente después de vincularse a un usuario con contrato.

¿Probó la conexión? Si la importación "no trae nada", casi siempre es credencial errada en el Integrador. Use el botón Probar conexión antes de abrir un ticket.

Bloqueo parcial no es bloqueo total. En el parcial el cliente aún recibe llamadas y SMS; solo corta voz de salida, SMS de envío y datos. Para cortar todo, use bloqueo total.

Chip cancelado no se desbloquea. Una vez cancelado (o con fecha de cancelación alcanzada) el chip no puede desbloquearse — hay que activar/importar de nuevo según la operadora.

Usuario MVNO pre activo. En algunas operadoras el usuario móvil nace Pre Activo y solo funciona después de la activación por código enviado al número del cliente. Sin esa etapa el chip no opera.

Un usuario por contrato en el móvil. Cada contrato solo puede tener un usuario móvil por integrador. El sistema impide crear un segundo.

Facturación ya facturada. Después de generar la venta o marcar como facturado, el registro no genera nuevo cobro. Revise antes de marcar.

Cada operadora habilita funciones distintas. No todo gateway soporta cambio de número, portabilidad o captura de pago. Los botones no disponibles para esa operadora aparecen desactivados.

Día de corte vs. día de facturación. Son cosas distintas en el Integrador: el corte cierra el ciclo de llamadas; la facturación es cuando se genera el cobro. Configure ambos.

Preguntas frecuentes

¿Cuál es la diferencia entre esta pantalla y VoIP.Mor?

Aquí usted opera la telefonía (planes, números, chips, tarifación y cobro) dentro de Quaza. VoIP.Mor es una integración solo para consultar saldo y llamadas de una plataforma VoIP externa (MOR), sin operar la tarifación por aquí.

¿Dónde está la telefonía en el menú?

En el grupo Telefonía, con las pantallas Integrador, Plan, Número, Usuario, Grupo, Facturación, Tarjeta Sim, Usuario (MVNO) y Número (MVNO).

¿Por dónde empiezo?

Siempre por el Integrador: elija la operadora e informe la conexión. Luego importe planes, grupos y números y solo entonces registre usuarios.

¿Tengo que escribir los planes a mano?

No. Los planes vienen de la operadora con el botón Importar Planes. Usted solo ajusta valor y servicio de cada uno.

¿Cómo se le cobra al cliente las llamadas?

Las llamadas entran por el detalle (CDR), el sistema calcula la facturación por usuario y usted genera la venta en el contrato. El cobro sigue el flujo financiero normal.

Importé el número pero el cliente no puede usarlo. ¿Por qué?

Un número importado queda libre. Debe ser vinculado a un usuario (con cliente y contrato) para funcionar y cobrarse.

¿Cómo activo un chip móvil?

En Tarjeta Sim, abra el chip Inactivo y haga clic en Activar SimCard: elija contrato, plan y DDD. En algunas operadoras la activación se concluye en segundo plano por una tarea.

¿Cuál es la diferencia entre bloqueo parcial y total?

En el parcial el cliente aún recibe llamadas y SMS (corta voz de salida, SMS de envío y datos). En el total todo queda bloqueado.

¿Cómo hago portabilidad de número?

La portabilidad entra en la activación del chip: informe que el número es portado y el número a traer. Acompañe la situación de portabilidad del chip (en curso, esperando autorización, concluida).

La importación no trajo nada. ¿Qué reviso?

Casi siempre es credencial errada en el Integrador. Use el botón Probar conexión. Confirme también si el integrador está con la situación activa.

¿Puedo tener más de una operadora al mismo tiempo?

Sí. Registre un Integrador para cada operadora — por ejemplo uno para voz fija y otro para móvil. Planes, números y usuarios quedan separados por integrador.

¿Las llamadas se importan solas?

Sí, por una tarea automática (Importa CDR), programada por el administrador del servidor. También puede importar al instante con el botón Importar de las pantallas.

Marqué como facturado por error. ¿Cobrará de nuevo?

No. Una facturación ya facturada no genera nuevo cobro. Verifique siempre antes de marcar o generar la venta.

Un botón del chip está desactivado. ¿Por qué?

Esa función no es soportada por la operadora del chip (cada gateway habilita funciones distintas), o el chip está en un estado que no permite la acción.

Documentos relacionados

VoIP.Mor — consulta de solo lectura de saldo y llamadas de una plataforma VoIP externa (MOR).
Red — registros de red (bloques de IP, configuraciones de acceso) del proveedor.

Este artigo foi útil?