Seguimiento del Uso del Servicio y del Saldo

El sistema de Uso del Servicio proporciona monitoreo en tiempo real del consumo de los clientes para datos, voz, SMS y saldos monetarios. Esta función se integra con el OCS (Sistema de Carga en Línea) para mostrar el uso actual, las asignaciones restantes y la información de expiración del saldo tanto a los clientes (a través del Portal de Autocuidado) como al personal.

Descripción General

El seguimiento del uso permite:

• Visualización de Saldo en Tiempo Real - Ver el uso actual y las asignaciones restantes
• Múltiples Tipos de Saldo - Rastrear datos, voz, SMS y saldos monetarios simultáneamente
• Monitoreo de Expiración - Ver cuándo expiran los saldos
• Desglose del Saldo - Vista detallada de los buckets de saldo individuales
• Actualización Automática - Actualizaciones de uso cada 3 segundos automáticamente

Accediendo al Uso del Servicio

Desde la Lista de Servicios:

1. Navega a Servicios → Lista de Servicios
2. Haz clic en el menú de acciones (⋮) al lado de un servicio
3. Selecciona "Uso"

Desde los Detalles del Servicio:

1. Abre la página de detalles de un servicio
2. Haz clic en la pestaña "Uso"

Desde la Página del Cliente:

1. Abre la vista general del cliente
2. Navega a la pestaña Servicios
3. Haz clic en "Ver Uso" al lado de cualquier servicio

Se abre el modal o la página de uso mostrando datos de consumo en tiempo real.

Visualización del Uso

La interfaz de uso muestra tarjetas resumen y barras de progreso detalladas para cada tipo de saldo.

{.align-center width="800px"}

Tarjetas Resumen

La fila superior muestra tarjetas de vista rápida para cada tipo de saldo:

Información de la Tarjeta:

• Tipo de Saldo - Icono y etiqueta (Datos, Voz, SMS, Monetario)
• Cantidad Restante - Saldo actual en las unidades apropiadas
• Tiempo de Expiración - Días/horas hasta que el saldo expire
• Botón de Más Información - Haz clic para expandir el desglose detallado

Barras de Progreso

Debajo de las tarjetas, las barras de progreso muestran el consumo visualmente con porciones llenas que indican el saldo restante.

Caracter��sticas de la Barra de Progreso:

• Indicador Visual - La porción llena muestra el saldo restante
• Porcentaje - Porcentaje numérico del saldo restante
• Valores Absolutos - Muestra usado vs. total (por ejemplo, "12.5GB / 20GB")
• Codificación de Color:
  • Verde: >50% restante
  • Amarillo: 20-50% restante
  • Rojo: <20% restante
• Hacible - Haz clic para expandir el desglose detallado

Tipos de Saldo

Saldo de Datos

Rastrea el consumo de datos de internet.

Unidades: Gigabytes (GB) o Megabytes (MB)

Formato de Visualización:

Progreso: 12.5GB / 20GB (62%)

Escenarios Comunes:

• Planes de datos móviles - 5GB, 10GB, 20GB de asignaciones mensuales
• Inalámbrico fijo - Ilimitado o limitado a altas cantidades (500GB, 1TB)
• Recargas - Datos adicionales comprados a mitad de ciclo
• Servicios de dongle - Datos prepagados para dispositivos hotspot

Múltiples Buckets:

Los servicios a menudo tienen múltiples saldos de datos:

• Asignación mensual (expira mensualmente)
• Datos de bonificación (expira después del período de campaña)
• Datos de recarga (expiración más corta, consumidos primero)

Saldo de Voz

Rastrea minutos de llamadas telefónicas.

Unidades: Minutos (min)

Formato de Visualización:

Progreso: 125 min / 500 min (25%)

Seguimiento de la Duración de la Llamada:

• Llamadas entrantes (si se cobran)
• Llamadas salientes
• Llamadas internacionales (bucket separado si corresponde)
• Números premium

Cálculo:

El uso de voz se calcula por la duración de la llamada en nanosegundos internamente, convertido a minutos para la visualización.

Saldo de SMS

Rastrea el uso de mensajes de texto.

Unidades: Mensajes (msgs)

Formato de Visualización:

Progreso: 45 / 250 (18%)

Tipos de Mensajes:

• SMS estándar (160 caracteres)
• SMS largo (múltiples segmentos)
• MMS (si se rastrea por separado)

Saldo Monetario

Rastrea el crédito prepago o el saldo de la cuenta.

Unidades: Moneda (£, $, €, etc.)

Formato de Visualización:

Progreso: £15.50 / £20.00 (77%)

Uso:

• Las cuentas prepagas utilizan el saldo monetario para pagar por el uso
• El crédito se decrementa a medida que el cliente utiliza servicios
• Puede recargarse a través de pago o vale
• Puede expirar si no se utiliza dentro del período de validez

Desglose Detallado del Saldo

Haz clic en "Más Información" en cualquier tarjeta o haz clic en una barra de progreso para expandir el desglose detallado.

Vista Expandida:

📦 Asignación Mensual 20GB

: Restante: 12.5 GB Usado: 7.5 GB Expira: 25 Ene 2025 (15 días) Peso: 10

📦 Datos de Bonificación 5GB

: Restante: 5.0 GB Usado: 0 GB Expira: 31 Ene 2025 (21 días) Peso: 20

📦 Datos de Recarga 3GB

: Restante: 0 GB Usado: 3.0 GB Expira: 18 Ene 2025 (EXPIRED) Peso: 30

Total Restante: 17.5 GB

Campos del Bucket de Saldo:

• ID/Nombre - Identificador para el bucket de saldo
• Restante - Cantidad restante en este bucket específico
• Usado - Cantidad consumida de este bucket
• Fecha de Expiración - Cuándo expira este saldo
• Peso - Orden de prioridad (peso más alto consumido primero)

Sistema de Peso

Los saldos tienen un valor de peso que determina el orden de consumo:

• Peso más alto = consumido primero
• Peso más bajo = consumido al final

Ejemplo de Pesos:

• Datos de recarga: Peso 30 (consumido primero, expiración más corta)
• Datos de bonificación: Peso 20 (consumido segundo)
• Asignación mensual: Peso 10 (consumido al final, expiración más larga)

Esto asegura que los saldos que expiran se utilicen antes que los que duran más.

Actualizaciones en Tiempo Real

Los datos de uso se actualizan automáticamente cada 3 segundos a través de polling.

Qué se Actualiza:

• Cantidades actuales de saldo
• Barras de progreso de uso
• Temporizadores de expiración
• Detalles de cada bucket

Experiencia del Usuario:

• No se requiere recarga de página
• Actualizaciones suaves sin parpadeo
• Superposición de carga durante la actualización
• Insignia de estado muestra el estado actual del servicio

Casos de Uso:

• Monitorear el uso del cliente durante la llamada
• Ver el decremento del saldo en tiempo real a medida que el cliente utiliza el servicio
• Verificar la recarga inmediatamente después de la compra

Uso en Diferentes Tipos de Servicio

Servicios Móviles

Muestra los cuatro tipos de saldo:

• Datos (GB)
• Voz (minutos)
• SMS (mensajes)
• Monetario (moneda)

Ejemplo:

DATOS: 12.5GB restantes VOZ: 125 min restantes SMS: 45 msgs restantes MONETARIO: £15.50 restantes

Inalámbrico Fijo / Internet

Normalmente muestra solo:

• Datos (GB o TB)
• Monetario (si es prepago)

Ejemplo:

DATOS: 450GB / 500GB restantes MONETARIO: £45.00 (crédito prepago)

Servicios de Hotspot / Dongle

Muestra el seguimiento de datos específico del dongle:

• Datos (consumido vs. prepago)
• Monetario (saldo prepago)

Modo de Visualización:

Cuando dongle=true, el componente oculta voz y SMS, mostrando solo datos relevantes y saldos monetarios.

Solución de Problemas

Uso mostrando como 0 / 0

• Causa: Servicio no integrado con OCS o CGRateS
• Solución:
  • Verifica que el servicio esté provisionado en OCS
  • Verifica la conectividad de la API de OCS
  • Revisa el mapeo de UUID del servicio

Uso no actualizándose

• Causa: Polling detenido o OCS inalcanzable
• Solución:
  • Actualiza la página
  • Verifica la consola del navegador en busca de errores
  • Verifica que la API de OCS esté en línea

Los saldos muestran cantidades incorrectas

• Causa: Desajuste de datos de OCS o problema de caché
• Solución:
  • Fuerza la actualización del saldo de OCS
  • Verifica si hay transacciones pendientes
  • Verifica la configuración de OCS

Fechas de expiración faltantes

• Causa: El saldo no tiene fecha de expiración establecida
• Solución:
  • Algunos saldos están configurados para nunca expirar (validez ilimitada)
  • Verifica la configuración del saldo en OCS

Múltiples saldos confusos

• Causa: Se han agregado múltiples recargas o datos de bonificación
• Solución:
  • Usa la vista de desglose detallado para ver todos los buckets
  • Ordena por peso para ver el orden de consumo
  • Revisa las fechas de expiración individuales

Integración con OCS/CGRateS

Los datos de uso provienen del OCS (Sistema de Carga en Línea), típicamente CGRateS.

Flujo de Datos:

1. El usuario abre la vista de uso
2. OmniCRM llama a GET /crm/service/{service_id}
3. La API consulta a OCS a través del UUID del servicio
4. OCS devuelve el mapa de saldo:

{
  "BalanceMap": {
    "*data": [
      {
        "ID": "monthly_data_20GB",
        "Value": 13421772800,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*voice": [
      {
        "ID": "monthly_voice_500min",
        "Value": 7500000000000,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*sms": [
      {
        "ID": "monthly_sms_250",
        "Value": 250,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*monetary": [
      {
        "ID": "prepaid_credit",
        "Value": 1550,
        "ExpiryTime": "2025-02-25T23:59:59Z",
        "Weight": 10
      }
    ]
  }
}

5. La UI convierte los valores a unidades de visualización (bytes → GB, nanosegundos → minutos)
6. Se renderizan las barras de progreso y las tarjetas
7. El polling continúa cada 3 segundos

Mapeo de Tipos de Saldo de OCS:

El OCS devuelve datos de saldo con prefijos de tipo que se mapean a la visualización de la UI:

• *data → TARJETA DE DATOS (uso de internet)
• *voice → TARJETA DE VOZ (minutos de llamada)
• *sms → TARJETA DE SMS (mensajes de texto)
• *monetary → TARJETA MONETARIA (crédito prepago)

Cada tipo de saldo puede tener múltiples buckets (por ejemplo, asignación mensual + datos de bonificación + datos de recarga), todos mostrados en la vista de desglose detallado.

Conversiones de Valores de Saldo:

• Datos: Bytes → GB (dividir por 1024³)
• Voz: Nanosegundos → Minutos (dividir por 60×10⁹)
• SMS: Conteo (sin conversión)
• Monetario: Céntimos → Moneda (dividir por 100)

Auto-Renovación y Planes de Acción

Los servicios con auto-renovación habilitada tienen Planes de Acción programados en el OCS.

¿Qué son los Planes de Acción?

Los Planes de Acción son tareas programadas en CGRateS que se ejecutan automáticamente en momentos específicos para:

• Agregar saldo a una cuenta (recarga automática)
• Renovar asignaciones mensuales
• Aplicar cargos recurrentes
• Expirar saldos antiguos

Cómo Funciona la Auto-Renovación:

1. Provisionamiento del Servicio:

   • Cuando se crea el servicio con auto_renew = true
   • El libro de provisión crea un Plan de Acción en OCS
   • El Plan de Acción está configurado para ejecutarse mensualmente (o por ciclo de facturación)

2. Configuración del Plan de Acción:

   El Plan de Acción contiene:

   • ID de Cuenta - UUID del servicio
   • Acciones - Qué hacer (agregar datos, voz, SMS, saldo monetario)
   • Horario - Cuándo ejecutar (por ejemplo, mensualmente el 1 a las 00:00 UTC)
   • Cantidad - Cuánto saldo agregar

3. Ejecución Automática:

   • OCS ejecuta el Plan de Acción en el momento programado
   • Agrega saldo a la cuenta (por ejemplo, 20GB de datos, 500 minutos de voz)
   • Establece la fecha de expiración para el nuevo saldo (por ejemplo, 30 días)
   • Se carga al cliente a través del método de pago registrado

4. Visualización de Planes de Acción:

   • Navega a los detalles del servicio en la vista de OCS
   • Los Planes de Acción se enumeran con el próximo tiempo de ejecución
   • Muestra: Nombre del plan, fecha del próximo ejecución, detalles de la acción

Ejemplo de Plan de Acción:

{
  "ActionPlanId": "ProductID_MonthlyPlan__ProductName_20GB_Mobile__ActionPlan_Monthly_Renew",
  "NextExecTime": "2025-02-01T00:00:00+00:00",
  "ActionName_hr": "Renovación Mensual",
  "PlanName": "20GB Móvil",
  "ActionFrequency_hr": "Cada Plan Mensual",
  "custom_NextExecTime_hr": "en 22 días"
}

Gestión de Auto-Renovación:

• Habilitar - Establecer durante la creación o modificación del servicio
• Deshabilitar - Eliminar el Plan de Acción de OCS (el servicio mantiene el saldo existente pero no se auto-renueva)
• Modificar - Cambiar la cantidad de renovación o la frecuencia a través de la modificación del servicio

Renovación Manual:

Si la auto-renovación está deshabilitada, el cliente debe manualmente:

• Recargar antes de que el saldo expire
• O el servicio se suspende cuando se agota el saldo

Visualización en la UI:

La pestaña de servicios muestra el estado de auto-renovación:

Próxima Renovación: 1 Feb 2025 (en 22 días) Monto de Renovación: £15.00

Mejores Prácticas

Para el Personal de Soporte:

• Verifica el uso antes de responder llamadas de "¿Por qué mi servicio es lento?"
• Verifica el saldo después de las recargas para confirmar el éxito
• Usa el desglose detallado para identificar buckets expirados
• Monitorea a los clientes de alto uso para prevenir sobrecargos

Para los Clientes (Autocuidado):

• Verifica el uso regularmente para evitar quedarte sin saldo
• Recarga antes de que el saldo expire
• Entiende el sistema de peso para saber qué saldo se consume primero
• Contacta al soporte si el uso parece incorrecto

Para los Administradores:

• Configura las expiraciones de saldo apropiadas
• Establece valores de peso para priorizar los saldos que expiran
• Monitorea la conectividad de OCS para informes precisos
• Revisa que las configuraciones de saldo coincidan con las ofertas de productos

Documentación Relacionada

• features_topup_recharge - Sistema de recarga para agregar saldo
• csa_service_management - Gestión de servicios
• csa_modify - Agregar complementos para aumentar asignaciones
• concepts_products_and_services - Configuración de productos