Sistema VOS3000 CDR Tiempo Real Powerful: Reenvio, Consultas, Modos y Direccion Fin
El sistema VOS3000 CDR tiempo real permite la transmision, consulta y analisis avanzado de los registros de llamadas mas alla del modelo estatico basico. Segun el manual oficial VOS3000 V2.1.9.07 seccion 4.3.5.1, los parametros como REAL_TIME_REPORT_SERVER, QUERY_CDR_DENY_TIME, QUERY_CDR_MAX_DAY_INTERVAL, los codigos de modo de facturacion CDR y la direccion fin de llamada proporcionan un control granular sobre como los datos de llamadas fluyen a traves del sistema. Si necesita asistencia con la configuracion de CDR avanzado, contactenos por WhatsApp al +8801911119966.
Los registros CDR (Call Detail Records) son la base de la facturacion y la auditoria en cualquier operacion VoIP. Cada llamada genera un registro con informacion detallada incluyendo numeros de origen y destino, duracion, tarifas aplicadas y codigos de finalizacion. Sin embargo, el modelo estandar donde los CDR se almacenan localmente y se consultan posteriormente no es suficiente para operaciones que necesitan informacion en tiempo real, control de acceso a consultas durante periodos de facturacion, o interpretacion avanzada de codigos de modo y direccion.
En esta guia cubriremos cinco areas criticas del manejo avanzado de registros de llamadas: el reenvio de CDR en tiempo real a servidores externos, el bloqueo de consultas durante periodos criticos, el limite de rango de fechas para consultas, los codigos de modo de facturacion CDR y la direccion fin de llamada. Cada area resuelve un problema operacional especifico que los operadores encuentran en produccion. (Sistema VOS3000 CDR Tiempo)
Table of Contents
================================================================
๐ SISTEMA VOS3000 CDR TIEMPO REAL โ 5 AREAS
================================================================
[1] ๐ก REENVIO CDR TIEMPO REAL
|-> REAL_TIME_REPORT_SERVER config
|-> IP/puerto destino, protocolo TCP/UDP
|-> Integracion con billing/fraude externo
v
[2] ๐ BLOQUEO CONSULTAS CDR
|-> QUERY_CDR_DENY_TIME horas blackout
|-> Por que carriers restringen acceso
|-> Configuracion hora inicio/fin
v
[3] ๐
LIMITE RANGO FECHAS CDR
|-> QUERY_CDR_MAX_DAY_INTERVAL (31 dias)
|-> Prevenir sobrecarga base de datos
|-> Workaround: exportaciones incrementales
v
[4] ๐ข CODIGOS MODO FACTURACION CDR
|-> -1, 0, 1, 3 significado
|-> Normal / prepago / postpago / gratuita
|-> Interpretacion en analisis CDR
v
[5] ๐ DIRECCION FIN CDR
|-> Quien colgo: llamante, llamado, sistema
|-> Importancia en disputas facturacion
|-> Analisis calidad: hangup cliente vs fallo red
================================================================
๐ Introduccion al CDR en Sistema VOS3000 CDR Tiempo
Los registros CDR tradicionales se almacenan en la base de datos local del servidor VOS3000 y se consultan a traves de la interfaz web o exportaciones periodicas. Este modelo funciona bien para operaciones pequenas y medianas, pero tiene limitaciones significativas para operaciones grandes que necesitan integracion con sistemas de facturacion externos, deteccion de fraude en tiempo real, o analisis de calidad de servicio inmediato. (Sistema VOS3000 CDR Tiempo)
El reenvio de CDR en tiempo real resuelve estas limitaciones transmitiendo cada registro de llamada a un servidor externo inmediatamente despues de que la llamada termina, sin necesidad de esperar a procesamientos por lotes o consultas manuales periodicas. Esto permite que los sistemas externos procesen los datos de llamadas en tiempo real, detecten patrones de fraude a medida que ocurren, actualicen los saldos de los clientes sin demora y generen alertas automaticas cuando se detectan anomalias en el trafico. (Sistema VOS3000 CDR Tiempo)
Ademas del reenvio en tiempo real, el sistema VOS3000 CDR tiempo real proporciona controles de acceso para las consultas de CDR. El bloqueo de consultas durante periodos especificos protege la base de datos durante procesos de facturacion criticos, y el limite de rango de fechas previene consultas excesivamente amplias que pueden degradar el rendimiento del servidor. Estos controles son esenciales para mantener la estabilidad del sistema en operaciones con grandes volumenes de datos. (Sistema VOS3000 CDR Tiempo)
๐ก Reenvio de CDR en Tiempo Real (REAL_TIME_REPORT_SERVER)
El parametro SERVER_CDR_REAL_TIME_REPORT_SERVER configura la direccion del servidor externo que recibira los registros CDR en tiempo real. Cada vez que una llamada termina y se genera un CDR, el sistema envia una copia del registro al servidor configurado, permitiendo que los sistemas externos procesen los datos inmediatamente sin esperar a consultas periodicas o exportaciones manuales. (Sistema VOS3000 CDR Tiempo)
La configuracion incluye la direccion IP del servidor destino, el puerto de escucha y opcionalmente el protocolo de transporte (TCP o UDP). El servidor externo debe implementar un listener que acepte las conexiones entrantes de VOS3000 y procese los registros CDR recibidos. El formato de los datos transmitidos es el mismo que se utiliza en la base de datos local, facilitando la integracion con sistemas existentes. (Sistema VOS3000 CDR Tiempo)
Las aplicaciones mas comunes del reenvio de CDR en tiempo real incluyen la integracion con sistemas de facturacion propios del operador, la alimentacion de sistemas de deteccion de fraude que analizan patrones de llamadas en tiempo real, la sincronizacion con plataformas de gestion de clientes que actualizan saldos y consumos inmediatamente, y la replicacion de datos a servidores de respaldo para redundancia y disaster recovery. (Sistema VOS3000 CDR Tiempo)
Es importante considerar el impacto en el rendimiento del servidor VOS3000 cuando se habilita el reenvio de CDR en tiempo real. Cada CDR genera una transmision de red adicional, y en operaciones con alto volumen de llamadas, esto puede representar un trafico significativo. Se recomienda utilizar una conexion de red dedicada entre el servidor VOS3000 y el servidor de CDR externo para evitar que el trafico de CDR afecte la calidad de las llamadas. (Sistema VOS3000 CDR Tiempo)
| ๐ Parametro | ๐ Descripcion | ๐ Ejemplo | ๐ฏ Notas |
|---|---|---|---|
| IP destino | Direccion del servidor CDR externo | 192.168.1.200 | Debe ser alcanzable desde VOS3000 |
| Puerto | Puerto de escucha del servidor | 5065 | No conflicto con puertos SIP/RTP |
| Protocolo | TCP o UDP para transmision | TCP (recomendado) | TCP garantiza entrega; UDP es mas rapido |
| Formato | Formato de datos CDR | Mismo que BD local | Facilita integracion |
| ๐ Aplicacion | ๐ Descripcion | ๐ฏ Beneficio | ๐ Latencia Requerida |
|---|---|---|---|
| Facturacion externa | Enviar CDR a sistema de billing propio | Facturacion inmediata | Segundos |
| Deteccion fraude | Alimentar sistema anti-fraude | Alertas en tiempo real | Segundos |
| Gestion clientes | Actualizar saldos automaticamente | Cliente ve consumo al instante | Minutos |
| Backup redundancia | Replicar CDR a servidor secundario | Disaster recovery | Minutos |
| Analisis calidad | Monitorear ASR/ACD en tiempo real | Detectar problemas de calidad | Minutos |
๐ Bloqueo de Consultas CDR (QUERY_CDR_DENY_TIME)
El parametro SERVER_QUERY_CDR_DENY_TIME permite definir un periodo de tiempo durante el cual las consultas de CDR estan bloqueadas. Este mecanismo protege la base de datos durante periodos criticos como los procesos de facturacion mensual, cuando el acceso concurrente a los datos puede causar inconsistencias o degradacion del rendimiento. Los operadores pueden configurar una ventana de blackout donde solo el proceso de facturacion tiene acceso exclusivo a los datos.
La configuracion especifica la hora de inicio y la hora de fin del periodo de bloqueo en formato de 24 horas. Por ejemplo, una configuracion de inicio 02:00 y fin 06:00 bloquearia las consultas de CDR entre las 2:00 AM y las 6:00 AM, un periodo tipico para procesos de facturacion nocturnos. Durante este periodo, cualquier intento de consulta de CDR desde la interfaz web o la API sera rechazado con un mensaje indicando que el sistema esta en mantenimiento. (Sistema VOS3000 CDR Tiempo)
El bloqueo de consultas es especialmente importante para operaciones grandes donde la base de datos de CDR contiene millones de registros y los procesos de facturacion requieren acceso exclusivo para calcular correctamente los montos. Sin el bloqueo, una consulta simultanea de un usuario podria bloquear registros que el proceso de facturacion necesita actualizar, causando errores de calculo o tiempos de procesamiento excesivamente largos. (Sistema VOS3000 CDR Tiempo)
๐ Limite de Rango de Fechas CDR (QUERY_CDR_MAX_DAY_INTERVAL)
El parametro SERVER_QUERY_CDR_MAX_DAY_INTERVAL establece el numero maximo de dias que se pueden consultar en una sola consulta de CDR. El valor por defecto es 31 dias, lo que significa que los usuarios no pueden realizar consultas que abarquen mas de un mes de datos. Esta limitacion previene que consultas excesivamente amplias sobrecarguen la base de datos y degraduen el rendimiento del sistema para todos los usuarios. (Sistema VOS3000 CDR Tiempo)
Las consultas de CDR que abarcan grandes periodos de tiempo son resource-intensive porque requieren escanear millones de registros en la base de datos. En una operacion con 10 millones de CDR mensuales, una consulta de 6 meses necesitaria procesar 60 millones de registros, lo que podria tomar minutos y consumir recursos significativos del servidor. El limite de rango previene este tipo de consultas sin restringir las consultas normales que tipicamente abarcan dias o semanas. (Sistema VOS3000 CDR Tiempo)
Para los usuarios que necesitan analizar datos de periodos mas largos, el workaround recomendado es utilizar exportaciones incrementales. En lugar de consultar 6 meses de datos de una vez, se pueden exportar los CDR mensualmente en archivos de texto y procesarlos offline con herramientas de analisis externas. Esto descarga el procesamiento del servidor VOS3000 y permite analisis de grandes volumenes de datos sin afectar el rendimiento del sistema en produccion. (Sistema VOS3000 CDR Tiempo)
| ๐ Rango Consulta | ๐ Registros (10M/mes) | โฑ๏ธ Tiempo Estimado | ๐ฏ Recomendacion |
|---|---|---|---|
| 1 dia | ~333,000 | Segundos | Siempre permitido |
| 7 dias | ~2.3M | Segundos-minutos | Permitido |
| 31 dias | ~10M | Minutos | Maximo por defecto |
| 90 dias | ~30M | Minutos-largo | Usar exportacion |
| 180 dias | ~60M | Largo | Usar exportacion |
๐ข Codigos de Modo de Facturacion CDR (-1, 0, 1, 3)
Los codigos de modo de facturacion en los registros CDR indican como fue facturada la llamada y que tipo de cuenta fue utilizada. Estos codigos son esenciales para el analisis de CDR porque permiten distinguir entre llamadas normales, llamadas prepagas, llamadas postpagas y llamadas gratuitas. Comprender cada codigo es fundamental para la conciliacion de ingresos y la deteccion de anomalias en la facturacion. (Sistema VOS3000 CDR Tiempo)
El codigo -1 indica una llamada gratuita que no genera cargo. Esto incluye llamadas a numeros en la lista FREE_E164S, llamadas a numeros de emergencia y llamadas cubiertas por promociones. El CDR se genera con todos los datos de la llamada pero el monto facturado es cero. Estos registros son importantes para la auditoria porque documentan que la llamada ocurrio incluso si no genero ingresos.
El codigo 0 indica una llamada con facturacion normal, tipicamente asociada con cuentas postpago. La llamada se tarifica con la tarifa estandar y el monto se acumula para ser facturado al final del periodo de facturacion. Este es el modo mas comun en operaciones empresariales y mayoristas donde los clientes pagan mensualmente por sus consumos. (Sistema VOS3000 CDR Tiempo)
El codigo 1 indica una llamada prepago donde el monto se deduce del saldo del usuario en tiempo real. A diferencia del modo postpago donde el cobro es diferido, en el modo prepago el saldo se decrementa inmediatamente despues de cada llamada. Si el saldo es insuficiente, la llamada es rechazada antes de establecerse (gracias a PREVENT_OVERDRAFT_ADVANCE_TIME).
El codigo 3 indica una llamada facturada con tarifa especial, como llamadas con tarifas de seccion, tarifas promocionales o tarifas de tarjeta de llamada. Estas llamadas tienen un modelo de facturacion diferente al estandar por minuto y se contabilizan separadamente para analisis de ingresos por tipo de servicio. Los operadores que utilizan tarifas escalonadas o promociones de tiempo deben monitorear estos registros para verificar que las tarifas especiales se aplican correctamente y que los ingresos por tipo de servicio coinciden con las proyecciones financieras.
La distribucion de codigos de modo en los CDR de una operacion proporciona informacion valiosa sobre el mix de negocio. Una operacion predominantemente prepago tendra la mayoria de CDR con codigo 1, mientras que una operacion empresarial tendra mas CDR con codigo 0. Cambios significativos en la distribucion de codigos pueden indicar problemas como errores de configuracion de cuentas o migracion de clientes entre tipos de servicio que no fue documentada adecuadamente.
| ๐ Codigo | ๐ Modo | ๐ Ejemplo | ๐ฐ Cobro | ๐ฏ Uso Tipico |
|---|---|---|---|---|
| -1 | Gratuita | Llamada a 911 | $0.00 | Emergencias, numeros free |
| 0 | Normal / Postpago | Llamada empresarial | Tarifa estandar | Cuentas postpago |
| 1 | Prepago | Llamada con tarjeta | Deducido del saldo | Cuentas prepago |
| 3 | Tarifa especial | Llamada con seccion rate | Tarifa promocional | Promociones, section rate |
๐ Direccion Fin de CDR (End Direction)
La direccion fin de CDR indica quien termino la llamada: el llamante (caller), el llamado (callee) o el sistema (server). Este campo es crucial para la resolucion de disputas de facturacion y el analisis de calidad de servicio, porque permite distinguir entre llamadas que terminaron normalmente y llamadas que fueron interrumpidas por problemas de red o por el servidor.
Cuando el llamante cuelga, la direccion fin indica “caller”, lo que sugiere que la llamada termino normalmente con el usuario que inicio la llamada decidiendo finalizarla. Cuando el llamado cuelga, la direccion indica “callee”, lo que tambien es una terminacion normal pero desde el extremo receptor. Estas dos situaciones representan el comportamiento esperado y generalmente no generan disputas.
Cuando el sistema cuelga la llamada, la direccion fin indica “server”, lo que puede tener multiples razones: saldo prepago agotado, violacion de seguridad detectada, tiempo maximo de llamada excedido, o fallo tecnico en el gateway. Las terminaciones por el servidor son las que mas frecuentemente generan disputas porque el cliente puede sentir que la llamada fue interrumpida injustamente. Los CDR con direccion “server” deben ser monitoreados regularmente para identificar problemas sistematicos.
| ๐ Direccion | ๐ Quien Colgo | ๐ Implicacion Facturacion | ๐ฏ Accion Recomendada |
|---|---|---|---|
| Caller | El llamante | Terminacion normal | Sin accion |
| Callee | El llamado | Terminacion normal | Sin accion |
| Server | El sistema | Posible problema | Investigar razon |
| ๐ Escenario | ๐ % Server Hangup | ๐ Diagnostico | ๐ ๏ธ Solucion |
|---|---|---|---|
| Operacion normal | < 5% | Sin problemas | Mantener monitoreo |
| Saldos bajos | 10-20% | Usuarios sin saldo | Ajustar tiempo avance |
| Problemas gateway | 20-40% | Gateways fallando | Verificar conectividad |
| Ataque en curso | > 50% | Ataque DDoS/flood | Bloquear atacante |
๐ Tabla de Referencia de Parametros CDR
La siguiente tabla resume todos los parametros de CDR avanzado con sus valores por defecto y recomendaciones para diferentes tipos de operaciones. Use esta referencia como guia rapida al configurar el sistema. (Sistema VOS3000 CDR Tiempo)
| ๐ Parametro | ๐ Funcion | ๐ Default | ๐ฏ Recomendacion |
|---|---|---|---|
| REAL_TIME_REPORT_SERVER | Reenvio CDR tiempo real | Deshabilitado | Habilitar para fraude/billing externo |
| QUERY_CDR_DENY_TIME | Bloqueo consultas | Sin bloqueo | Bloquear durante facturacion mensual |
| QUERY_CDR_MAX_DAY_INTERVAL | Limite rango dias | 31 dias | 31 dias (equilibrar acceso y rendimiento) |
| CDR Billing Mode | Codigo modo facturacion | Automatico | No modificar, es campo calculado |
| CDR End Direction | Direccion fin llamada | Automatico | No modificar, es campo calculado |
| ๐ Tipo Operacion | ๐ก Reenvio TR | ๐ Bloqueo | ๐ Max Dias |
|---|---|---|---|
| Mayorista grande | Si (fraude) | 02:00-06:00 | 31 |
| Prepago minorista | Si (saldo) | 01:00-05:00 | 31 |
| Operador pequeno | No | Sin bloqueo | 31 |
| Empresarial | Si (billing) | 03:00-07:00 | 90 |
โ Preguntas Frecuentes – (Sistema VOS3000 CDR Tiempo)
โ Como configurar el reenvio de CDR en tiempo real?
Para configurar el reenvio de CDR en tiempo real, acceda a los parametros del servidor y configure SERVER_CDR_REAL_TIME_REPORT_SERVER con la direccion IP y puerto del servidor externo que recibira los datos. El servidor externo debe tener un listener activo en el puerto configurado que acepte conexiones desde la direccion IP del servidor VOS3000. Se recomienda utilizar TCP como protocolo de transporte para garantizar la entrega de todos los registros, aunque UDP puede utilizarse si la latencia es critica y se tolera la perdida ocasional de registros. (Sistema VOS3000 CDR Tiempo)
โ Cuando bloquear las consultas de CDR?
Se recomienda bloquear las consultas de CDR durante los procesos de facturacion mensual cuando el sistema necesita acceso exclusivo a la base de datos para calcular los montos correctamente. Un periodo tipico es entre las 2:00 AM y las 6:00 AM en el dia de cierre de facturacion. Tambien es util bloquear durante tareas de mantenimiento de la base de datos como reindexacion o purga de registros antiguos, que requieren acceso exclusivo para completarse eficientemente. (Sistema VOS3000 CDR Tiempo)
โ Que significa un codigo de modo -1 en un CDR?
El codigo de modo -1 indica una llamada gratuita que no genera cargo para el usuario. Esto incluye llamadas a numeros de emergencia (911, 112), numeros en la lista FREE_E164S y llamadas cubiertas por promociones de tiempo libre. El CDR se genera con todos los datos de la llamada pero el monto facturado es cero. Estos registros son importantes para la auditoria porque documentan la actividad del sistema y permiten verificar que las llamadas gratuitas estan funcionando correctamente. (Sistema VOS3000 CDR Tiempo)
โ Como analizar la proporcion de hangups del servidor?
Para analizar la proporcion de hangups del servidor, genere un reporte de CDR filtrado por direccion fin igual a “server” y calcule el porcentaje sobre el total de llamadas. Una proporcion menor al 5% es normal y generalmente corresponde a usuarios prepago que agotan su saldo. Una proporcion entre 10-20% puede indicar problemas de saldo o configuracion de tiempos de avance. Una proporcion superior al 20% requiere investigacion inmediata porque puede indicar problemas de gateway, ataques o errores de configuracion sistematicos. (Sistema VOS3000 CDR Tiempo)
โ Se puede consultar mas de 31 dias de CDR?
El parametro QUERY_CDR_MAX_DAY_INTERVAL puede modificarse para permitir consultas de mas de 31 dias, pero esto no es recomendable para operaciones en produccion porque las consultas amplias degradan el rendimiento del servidor. En lugar de aumentar el limite, se recomienda utilizar exportaciones periodicas de CDR en formato de texto y procesar los datos offline con herramientas externas. Esto permite analizar cualquier periodo de tiempo sin afectar el rendimiento del sistema en produccion. (Sistema VOS3000 CDR Tiempo)
โ Como integrar el reenvio de CDR con un sistema de fraude?
Para integrar el reenvio de CDR con un sistema de deteccion de fraude, configure el servidor de CDR en tiempo real para enviar los registros al servidor de fraude, que debe implementar un listener compatible con el formato de datos de VOS3000. El sistema de fraude recibe cada CDR inmediatamente despues de que la llamada termina y puede analizar patrones como volumenes anormales de llamadas, destinos inusuales, duraciones atipicas y frecuencias de llamada sospechosas. Las alertas generadas por el sistema de fraude pueden entonces disparar acciones automaticas como bloqueo de cuentas o notificaciones al equipo de seguridad. (Sistema VOS3000 CDR Tiempo)
El sistema VOS3000 CDR tiempo real extiende las capacidades de gestion de registros de llamadas mas alla del modelo basico, proporcionando herramientas esenciales para operaciones profesionales. Para asistencia profesional, contactenos por WhatsApp al +8801911119966 o visite vos3000.com.
Relacionado: registros CDR avanzados | gestion CDR | casos facturacion especial
๐ Need Professional VOS3000 Setup Support?
For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:
๐ฑ WhatsApp: +8801911119966
๐ Website: www.vos3000.com
๐ Blog: multahost.com/blog
![]() | ![]() | ![]() |


