Guía funcional para registrar clientes, crear solicitudes, administrar segmentos IP, cargar líneas, asignar IPs, realizar bajas y consultar reportes.
Objetivo del manual. Este documento explica el uso operativo del sistema con lenguaje claro, capturas de pantalla, reglas de validación y estructura de archivos de carga.
Este manual explica cómo usar la plataforma Gestión M2M para registrar clientes, crear solicitudes, administrar segmentos IP, cargar líneas, asignar IPs, dar de baja líneas y consultar reportes.
El documento está orientado al usuario operativo. Por eso, cada sección indica qué opción usar, qué archivo corresponde, qué campos son obligatorios y qué validaciones realiza el sistema antes de guardar la información.
El sistema tiene 5 menús principales, visibles en la barra superior:
Nota: las capturas de este manual corresponden a un entorno de desarrollo/pruebas. Los clientes, usuarios, líneas, segmentos e IPs mostrados son datos de prueba.
Acceso al sistema: https://190-119-63-153.sslip.io/SGM2M/
El usuario debe ingresar a la plataforma utilizando como usuario y contraseña su código de trabajador “C”.
Ejemplo: si el código de trabajador “C” es
C13013, el usuario seráC13013y la contraseña inicial también seráC13013.
Se recomienda cambiar la contraseña después del primer ingreso (ver sección Usuarios → Editar).
Pasos para ingresar al sistema:
C + código de trabajador), por
ejemplo C13013.Si el usuario o la contraseña son incorrectos, el sistema muestra un aviso en la esquina superior derecha (una notificación roja tipo toast) indicando el problema, sin necesidad de recargar la página.
El Dashboard es la primera pantalla que se muestra al ingresar al sistema. También puede consultarse en cualquier momento desde la opción Dashboard, ubicada en la barra superior. Es un panel de análisis que resume, mediante indicadores y gráficos, el comportamiento del negocio M2M en un periodo determinado: líneas activas, IPs disponibles, clientes con mayor concentración de líneas y movimientos recientes. Permite consultar la situación general del sistema sin ingresar a cada solicitud de manera individual.
La pantalla se organiza en 3 bloques: primero los filtros, luego 5 tarjetas de indicadores (KPIs) y, debajo, 7 gráficos/tablas con el detalle. A continuación se explica cada uno.
Los indicadores y gráficos del Dashboard se recalculan según estos filtros:
| Filtro | Para qué sirve |
|---|---|
| Periodo (fecha inicial — fecha final) | Delimita el rango de fechas que se analiza. Por defecto trae el año en curso. |
| Cliente | Filtra el panel por un cliente específico. |
| APN | Filtra el panel por un APN específico. |
| Segmento | Filtra el panel por un segmento IP específico. |
Botón ↻ (refrescar) |
Recalcula los indicadores y gráficos con los filtros actuales. |
Cuenta cuántas direcciones IP quedan libres para asignar, sumando la capacidad de todos los segmentos IP registrados (en todas las solicitudes) menos las que ya están en uso por una línea. Este indicador permite anticipar si la capacidad IP disponible será suficiente para atender nuevas líneas.
Es el porcentaje de líneas que fueron dadas de baja
frente al total de líneas que tuvo el sistema en el periodo filtrado. Un
valor alto indica que muchos clientes están desactivando líneas; en
0.0% significa que, en el periodo consultado, no hubo
bajas.
Total de líneas en estado Activa (con IP asignada y habilitadas) en todo el sistema — o dentro del cliente/APN/segmento, si se usó algún filtro. Ver la sección [Los estados de una línea (Sin IP / Activa / Inactiva)] para el significado exacto de este estado.
Total de líneas que ya fueron cargadas pero todavía no tienen IP asignada. Un número alto aquí es una señal de que hace falta usar “Asignación de IPs” sobre esas solicitudes (ver [Pestaña “Asignación de IPs”]).
Total de líneas en estado Inactiva dentro del periodo filtrado — las que se desactivaron con “Baja masiva de líneas” y ya liberaron su IP.
Un gráfico de burbujas que compara, para los 5 clientes con más líneas activas: en el eje X cuántas líneas activas tiene, en el eje Y su tasa de abandono, y en el tamaño de la burbuja — de nuevo — la cantidad de líneas activas (mientras más grande la burbuja, más líneas activas tiene ese cliente). Permite identificar si los clientes con mayor cantidad de líneas también presentan mayor tasa de baja o si mantienen un comportamiento estable.
Una tabla con los clientes que más líneas dieron de baja, mostrando por cada uno: cuántas líneas Activas tiene, cuántas Bajas y su Tasa de abandono (Bajas ÷ Total). Cuando no hay bajas en el periodo, la tabla muestra “No hay información para mostrar”.
Un mapa de bloques (treemap) donde cada rectángulo representa un cliente y su tamaño es proporcional a la cantidad de líneas pendientes de asignación de IP. Los bloques de mayor tamaño permiten identificar a los clientes con mayor volumen de líneas sin IP.
Un gráfico de líneas en el tiempo que compara tres tipos de movimiento a lo largo del periodo filtrado:
Los picos marcan los días en que se hizo una carga masiva grande o una asignación de IPs masiva — es la misma información que aparece, más detallada, en la pestaña [Pestaña “Movimientos”] de cada solicitud, pero aquí sumada de todo el sistema.
Ranking de los APN (identificadores técnicos de las solicitudes) con más líneas activas, con una barra de progreso que muestra qué porcentaje del total de líneas activas del sistema concentra cada uno. Ayuda a ver si el tráfico está muy concentrado en un solo APN.
Un historial en tiempo real de los movimientos más recientes de todo el sistema (cargas masivas, asignaciones de IP, bajas), con el cliente al que pertenece cada uno y la fecha/hora exacta. Permite verificar rápidamente los últimos movimientos registrados en el sistema.
Un histograma que agrupa todos los segmentos IP registrados según su
capacidad (cuántas direcciones tiene cada uno — el
mismo dato de “Cant. IPs” que se explicó en la sección [¿Qué es un
“segmento IP” y cómo se registra?]) y cuenta cuántos segmentos hay de
cada tamaño. En el ejemplo, la mayoría de los segmentos configurados
tienen capacidad para 254 IPs (equivalente a una máscara
/24).
Antes de revisar cada menú, es importante conocer un patrón que se repite en todas las tablas del sistema (usuarios, canales, clientes, sectores, rubros, solicitudes, etc.): la columna Opciones, al final de cada fila.
Al seleccionar el botón ☰ de una fila, se despliega un
menú con las acciones disponibles para ese registro — normalmente
Editar y Eliminar.
Este mismo patrón aplica en las secciones siguientes. Cuando se mencione Opciones → Editar u Opciones → Eliminar, se hace referencia a este botón.
Este menú administra las cuentas de acceso al sistema (Usuarios) y los canales de venta (Canales) a los que pertenece cada cliente o solicitud.
Lista todas las cuentas de acceso al sistema.
Columnas de la tabla:
| Columna | Descripción |
|---|---|
| Código | El código de trabajador (sin la C). |
| Nombre | Nombre completo del usuario. |
| Celular | Número de contacto. |
| Coordinador / Administrador | Marca de qué perfil(es) tiene el usuario. |
| Canal | Canal/distribuidora al que pertenece. |
| Estado | Activo / Inactivo. |
| Opciones | Editar / Eliminar. |
Botón “Nuevo usuario”, arriba a la derecha de la tabla.
Campos del formulario:
| Campo | Obligatorio | Descripción |
|---|---|---|
| Código | Sí | Código de trabajador. Con este código se arma el usuario
(C + código). |
| Nombre | Sí | Nombre completo, tal como debe aparecer en el sistema. |
| Activo | — | Casilla marcada = la cuenta puede iniciar sesión. |
| Celular | No | Número de contacto del usuario. |
| Canal | Sí | Canal/distribuidora al que se asocia (ver sección Canales). |
| Perfil | Sí | Marca Coordinador y/o Administrador, según el rol que deba tener. |
| Usuario | Sí | Se sugiere automáticamente como C + Código; puede
editarse. |
| Contraseña | Sí | Contraseña inicial de la cuenta. Tiene un ícono de ojo para mostrar u ocultar el texto durante el registro. |
Perfiles: un Coordinador gestiona solicitudes y cargas masivas del día a día. Un Administrador además administra clientes, usuarios y canales. Un usuario puede tener ambos perfiles marcados a la vez.
Desde Opciones → Editar se abre el mismo formulario con los datos actuales, incluyendo la contraseña (oculta, con el ícono de ojo para revelarla). Desde esta opción, cada usuario puede cambiar su propia contraseña después del primer ingreso. Para ello, se reemplaza el valor del campo Contraseña y se presiona Guardar.
Desde Opciones → Eliminar (o el botón Eliminar dentro del propio formulario de edición), el sistema pide confirmación antes de borrar la cuenta:
Lista los canales de venta/distribuidoras (por ejemplo: Directo, Indirecto) a los que se asocian clientes y usuarios.
Botón “Nuevo canal”.
Campos:
| Campo | Obligatorio | Descripción |
|---|---|---|
| Código | Sí | Código corto del canal, por ejemplo 001. |
| Nombre | Sí | Nombre del canal, por ejemplo DIRECTO. |
| Activo | — | Casilla marcada = el canal está disponible para asignar a usuarios/clientes. |
Igual que en Usuarios, Opciones → Editar abre el formulario con los datos ya cargados (Código, Nombre, Activo):
Y Opciones → Eliminar pide confirmación antes de borrar:
Administra los clientes finales (empresas/personas dueñas de las líneas M2M) y sus dos catálogos de clasificación: Sectores y Rubros.
Lista de todos los clientes registrados, con su dirección, distrito, tipo de cliente, rubro y si tiene datos de georreferencia.
Columnas de la tabla:
| Columna | Descripción |
|---|---|
| Código | Código interno del cliente. |
| Nombre | Razón social / nombre. |
| Dirección | Dirección registrada. |
| Distrito | Distrito de la dirección. |
| Tipo de cliente | Sector asignado (ver Sectores). |
| Rubro | Rubro asignado (ver Rubros). |
| Geo. | Indica si el cliente tiene coordenadas (latitud/longitud) registradas. |
| Estado | Activo / Inactivo. |
| Opciones | Editar / Eliminar. |
Para registrar un cliente, seleccionar el botón “Nuevo cliente”, ubicado en la parte superior derecha. El formulario tiene dos pestañas.
| Campo | Obligatorio | Descripción |
|---|---|---|
| RUC | Sí | RUC del cliente. El sistema valida que sea un RUC con dígito verificador correcto (formato SUNAT); si no lo es, no deja guardar y marca el campo en rojo. |
| Nombre | Sí | Razón social. |
| Activo | — | Casilla marcada = cliente habilitado. |
| Dirección | No | Dirección en texto libre. |
| Departamento / Provincia / Distrito | No | Ubigeo del cliente, en cascada (al elegir Departamento se filtra Provincia, y al elegir Provincia se filtra Distrito). |
| Tipo de sector | No | Sector del cliente (ver Sectores). |
| Rubro | No | Rubro del cliente (ver Rubros). |
Permite ubicar al cliente en un mapa, mediante búsqueda de dirección
o selección directa sobre el mapa, para registrar
Latitud y Longitud. Estos dos campos
son los mismos que aparecen como columnas
Latitud/Longitud en la carga masiva (ver más
abajo).
Opciones → Editar abre el mismo formulario de dos pestañas con los datos ya cargados:
Opciones → Eliminar pide confirmación:
En la parte superior de la pantalla de Clientes hay un panel para subir un archivo Excel con muchos clientes/direcciones a la vez, en lugar de registrarlos uno por uno con “Nuevo cliente”.
Junto al título del panel hay un botón de ayuda “?”, marcado con un círculo rojo en la imagen:
Al seleccionarlo, se abre una ventana con la explicación del archivo, sus columnas y un ejemplo:
Resumen de columnas de este archivo:
| Columna | Obligatorio | Descripción |
|---|---|---|
ruc |
Sí | RUC del cliente (11 dígitos). Si ya existe, se utiliza el cliente existente. |
nombre |
Sí | Razón social. Se ignora si el RUC ya existe. |
direccion |
Recomendado | Dirección del cliente. |
codsector |
No | Código de sector, debe existir en Sectores. |
codrubro |
No | Código de rubro, debe existir en Rubros. |
ubigeo |
No | Código Ubigeo (6 dígitos) del distrito. |
Latitud / Longitud |
No | Coordenadas de georreferencia — mismos valores que la pestaña “Ubicación geográfica”. |
Importante: este archivo crea/actualiza clientes y direcciones solamente. No crea solicitudes ni segmentos IP — para ello se utiliza el archivo
Clientes_Segmentos_M2M.xlsx(ver sección [Carga de clientes y segmentos]) dentro de Gestión M2M.
Después de seleccionar el archivo, el sistema no lo guarda de inmediato: primero muestra una vista previa con un resumen (Cargados / Válidos / Con error) y la tabla completa, fila por fila, con una columna Error que explica exactamente qué está mal en las filas que no pasaron la validación.
Hay una casilla “Ver sólo errores” que filtra la tabla para mostrar únicamente las filas con problemas — muy útil cuando se cargan archivos grandes:
En el ejemplo de arriba se ven los 3 tipos de error más comunes de este archivo:
| Error mostrado | Causa |
|---|---|
| “Ingrese un RUC válido” | El RUC no tiene 11 dígitos o no pasa la validación de RUC de SUNAT. |
| “Ingrese el nombre del cliente” | La columna nombre está vacía y el RUC todavía no existe
en el sistema (por lo tanto no hay un nombre ya registrado que se pueda
reutilizar). |
Al final de la vista previa hay un botón “Guardar válidas”: permite confirmar la carga de solo las filas sin error, dejando las filas con error fuera (no se pierden — hay que corregirlas en el Excel y volver a cargar solo esas).
Catálogo de sectores/tipos de negocio (Energía, Retail, Transporte, Seguridad, etc.) que se usan para clasificar a los clientes.
Botón “Nuevo sector”.
| Campo | Obligatorio | Descripción |
|---|---|---|
| Código | Sí | Código corto, por ejemplo ENE. Este es el valor
utilizado en la columna codsector de la carga masiva de
clientes. |
| Nombre | Sí | Nombre completo, por ejemplo Energía. |
| Activo | — | Casilla marcada = disponible para asignar a clientes. |
Opciones → Editar:
Opciones → Eliminar, con confirmación:
Catálogo de rubros/tipos de establecimiento (Telemetría, POS, GPS, Alarmas, etc.).
Botón “Nuevo rubro”. El formulario tiene la misma estructura que “Nuevo sector”:
| Campo | Obligatorio | Descripción |
|---|---|---|
| Código | Sí | Código corto, por ejemplo TEL. Este es el valor
utilizado en la columna codrubro de la carga masiva de
clientes. |
| Nombre | Sí | Nombre completo, por ejemplo
Telemetría / Medición remota. |
| Activo | — | Casilla marcada = disponible para asignar a clientes. |
Opciones → Editar:
Opciones → Eliminar, con confirmación:
Este es el módulo principal del sistema. Desde aquí se administran las solicitudes M2M, los clientes/APN, los segmentos IP, las líneas móviles, la asignación de IPs y la baja de líneas.
Una solicitud M2M agrupa la información operativa de un cliente para la gestión de sus líneas e IPs. En términos prácticos, una solicitud reúne:
El flujo normal de trabajo es:
Una solicitud puede quedar sin APN o sin segmento al momento de su creación. En esos casos, la información se completa posteriormente desde la edición de la solicitud o mediante la carga de clientes y segmentos.
La pantalla de Solicitudes tiene tres bloques principales:
Para crear una solicitud, seleccionar el botón “Nueva solicitud”.
| Campo | Obligatorio | Descripción |
|---|---|---|
| RUC | Sí | RUC del cliente. El botón de búsqueda valida el RUC y trae el nombre del cliente. El cliente debe existir previamente en el sistema. |
| Nombre del cliente | Se completa solo | Se muestra automáticamente al encontrar el RUC. |
| Tiene APN / APN | No | Se marca cuando la solicitud trabaja con APN. Si no aplica, la solicitud queda sin APN. |
| Fecha solicitud / Fecha atención | No | Fechas referenciales del proceso. |
| Tiene IP / IP base + Máscara | No | Permite agregar uno o más segmentos IP a la solicitud. |
Un segmento IP es el bloque de direcciones IP disponible para una solicitud. Cada línea puede recibir una IP dentro de alguno de los segmentos registrados para el mismo cliente/APN.
Un segmento se define con:
10.10.10.0.24.También puede representarse en formato CIDR, por ejemplo:
10.10.10.0/24
Para agregar un segmento manualmente:
+.El archivo
Clientes_Segmentos_M2M.xlsxutiliza el mismo concepto; el segmento se registra directamente en formato CIDR.
Clientes_Segmentos_M2M.xlsx)Esta opción registra masivamente clientes, solicitudes/APN y segmentos IP. Reemplaza al archivo de solicitudes end-to-end anterior, porque el usuario ya no necesita colocar el segmento de cada línea.
Estructura del archivo:
| Columna | Obligatorio | Descripción |
|---|---|---|
ruc |
Sí | RUC del cliente. Se utiliza para identificar o crear el cliente. |
razon_social |
Sí | Nombre o razón social del cliente. |
apn |
No | APN asociado al cliente. Si queda vacío, la solicitud se registra sin APN. |
segmento |
No | Segmento IP en formato CIDR, por ejemplo 10.10.11.0/24.
Si queda vacío, se registra o valida el cliente/APN sin agregar
segmento. |
fec_solicitud |
No | Fecha de solicitud del segmento, si se cuenta con esta información. |
fec_atencion |
No | Fecha de atención del segmento, si se cuenta con esta información. |
Si un cliente/APN tiene varios segmentos, se repiten el RUC, la razón social y el APN por cada segmento.
Antes de guardar, el sistema valida:
Si el cliente no existe, el sistema lo crea. Si ya existe, utiliza el cliente registrado. La solicitud se identifica por cliente y APN; si el APN queda vacío, la solicitud queda sin APN.
La vista previa agrupa la información por cliente + APN y muestra los segmentos asociados, los registros válidos, las observaciones y los errores antes de guardar.
El ícono de la columna Ver segmentos abre el detalle de los segmentos de cada grupo:
Error típico — “El segmento se cruza con un segmento ya registrado”: aparece cuando el rango de IPs del archivo se superpone con un segmento existente. Un mismo rango de IPs no puede pertenecer a dos solicitudes distintas al mismo tiempo.
Lineas_M2M.xlsx)El archivo Lineas_M2M.xlsx se mantiene como la plantilla
única para la gestión de líneas. Se utiliza en tres escenarios:
Estructura del archivo:
| Columna | Obligatorio | Descripción |
|---|---|---|
ruc |
Sí | RUC del cliente asociado a la línea. |
apn |
No / según escenario | APN usado para ubicar o validar la solicitud. Si la solicitud no tiene APN, puede quedar vacío. |
linea |
Sí | Número de línea móvil M2M. |
iccid |
Sí | Código ICCID de la SIM. |
ip |
No | IP asociada a la línea, si ya existe. Si queda vacía, la línea queda pendiente de asignación. |
| Caso | Resultado |
|---|---|
| La línea viene sin IP | Se registra la línea sin IP y queda pendiente de asignación. |
| La línea viene con IP y pertenece a un segmento del cliente/APN | Se registra la línea con IP, segmento y estado activo. |
| La línea viene con IP y no pertenece a ningún segmento del cliente/APN | La línea no se registra. La vista previa muestra el error “IP no pertenece al APN”. |
Antes de guardar, el sistema muestra la vista previa fila por fila con RUC, APN, línea, ICCID, IP, segmento encontrado y observaciones.
Errores comunes:
| Error mostrado | Causa |
|---|---|
La solicitud/APN no existe |
No existe una solicitud creada para el RUC + APN del archivo. |
IP no pertenece al APN |
La IP tiene valor, pero no cae dentro de ningún segmento registrado para ese cliente/APN. |
Línea duplicada |
La línea ya existe activa o se repite dentro del archivo. |
ICCID duplicado |
El ICCID ya existe activo o se repite dentro del archivo. |
IP duplicada |
La IP ya está activa o se repite dentro del archivo. |
| Estado | Qué significa |
|---|---|
| Sin IP | La línea está registrada, pero todavía no tiene IP asignada. |
| Activa | La línea tiene IP asignada y está habilitada. |
| Inactiva | La línea fue dada de baja y su IP quedó disponible para reutilización. |
Estos estados aparecen en el Dashboard, en la tabla de Solicitudes y dentro de Gestión de líneas e IPs.
Cada fila de la tabla de Solicitudes muestra los datos principales de la solicitud: RUC, razón social, APN, segmentos, IPs totales, IPs disponibles, líneas sin IP, líneas activas, líneas inactivas y fechas.
Accesos disponibles:
Al seleccionar el ícono Líneas de una solicitud, se abre la pantalla de detalle. Esta pantalla contiene tres pestañas.
Muestra las líneas de la solicitud: línea, ICCID, IP asignada, estado y fecha de activación.
Desde esta pestaña se puede:
Lineas_M2M.xlsx para esa
solicitud;Si el archivo trae APN, el sistema lo valida contra la solicitud seleccionada. Si trae IP, intenta ubicar el segmento dentro de los segmentos de esa solicitud.
Permite asignar IPs a líneas que están en estado Sin IP.
Pasos generales del proceso:
Muestra el historial de cargas, asignaciones y bajas realizadas sobre la solicitud. Se puede filtrar por tipo de movimiento y descargar a Excel.
Al seleccionar el ícono Baja de una solicitud, se
abre la pantalla para cargar el archivo Lineas_M2M.xlsx con
las líneas que serán desactivadas.
En este proceso se usan principalmente:
ruclineaiccidEl APN puede utilizarse como validación adicional si tiene valor. La IP no se utiliza para asignación durante la baja.
Advertencia: las líneas dadas de baja liberan su IP automáticamente. Esta acción no se puede deshacer.
Historial de todas las cargas, asignaciones de IP y bajas de líneas realizadas en el sistema — útil para auditar quién hizo qué y cuándo.
Se puede filtrar por Cliente (RUC o nombre), APN, Segmento, tipo de Acción y rango de fechas. El botón verde con ícono de Excel, junto a “Consultar”, exporta el resultado filtrado a un archivo Excel.
La tabla de resultados muestra, por cada solicitud: RUC, Razón social, APN, Segmento, Acción realizada, líneas cargadas/asignadas/deshabilitadas y la fecha de registro de la solicitud.
| Necesito… | Uso este archivo | Dónde |
|---|---|---|
| Registrar clientes y direcciones, sin solicitudes ni segmentos IP | Carga masiva de clientes y direcciones | Gestión de Clientes → Clientes |
| Crear clientes, solicitudes/APN y segmentos IP | Clientes_Segmentos_M2M.xlsx |
Gestión M2M → Solicitudes → Carga de clientes y segmentos |
| Cargar líneas sobre solicitudes existentes | Lineas_M2M.xlsx |
Gestión M2M → Solicitudes → Carga de líneas |
| Cargar líneas dentro de una solicitud específica | Lineas_M2M.xlsx |
Ícono Líneas → pestaña Líneas → Subir archivo |
| Dar de baja líneas | Lineas_M2M.xlsx |
Ícono Baja de la solicitud |
| Asignar IPs a líneas pendientes | No requiere archivo | Ícono Líneas → pestaña Asignación de IPs |
Clientes_Segmentos_M2M.xlsx registra clientes,
solicitudes/APN y segmentos.Lineas_M2M.xlsx registra líneas y también se utiliza
para baja.Ante cualquier duda durante la carga, se puede utilizar el botón ? de la pantalla correspondiente. Este botón muestra la plantilla esperada y las reglas de validación del archivo.