Saltar al contenido

SmartOLT (FTTH)

Conecta la API de SmartOLT, sincroniza ONUs y opera tu red FTTH.

12 min de lectura

Esta guía configura SmartOLT de punta a punta: credenciales API, catálogos (VLAN / Zona / Perfil / ODB), listado de ONUs, vinculación a clientes y autorización FTTH.

Antes de empezar:

  • Cuenta SmartOLT con dominio tipo https://miempresa.smartolt.com y una API KEY con permisos de lectura/escritura.
  • Al menos un OLT y perfiles de velocidad ya creados en SmartOLT (o los crearás desde este módulo).
  • Permiso olt_access (Acceso OLT) o smartolt_access.

IMPORTANTE: No puedes usar la misma cuenta SmartOLT en varios sistemas a la vez: el ID de servicio no puede duplicarse.

1. Abrir el módulo

Menú Ajustes → Infraestructura → OLT (SmartOLT) (también Ajustes → OLT → SmartOLT) → /smartolt.

Vista: SmartOLT

Layout común en todas las secciones:

  • Título SmartOLT - {sección} y breadcrumb Ajustes > SmartOLT > …
  • KPIs globales: Esperando autorización, Online, Offline, Señal baja
  • Menú lateral Secciones del módulo:
Sección UI Subtítulo URL
ONUs registrados Gestión de ONUs /smartolt
VLANs Redes virtuales /smartolt/vlans
Zonas Áreas geográficas /smartolt/zonas
Perfiles Perfiles de velocidad /smartolt/profiles
ODB Cajas de distribución /smartolt/odb
API Configurar conexión /smartolt/api

2. Configurar la API (obligatorio primero)

Abre la sección API → /smartolt/api.

Vista: configuración API SmartOLT

Verás el aviso de cuenta única y los botones Probar conexión y Limpiar caché.

Campos del formulario Configuración API

Campo UI Obligatorio Detalle
Dominio SmartOLT Sí Placeholder https://tuservicio.smartolt.com
API KEY Sí Token de SmartOLT
Desactivar ONUs Sí NO (0) o SI (1)

La ayuda de Desactivar ONUs: al suspender/activar el cliente en el sistema, también se desactiva/activa la ONU en SmartOLT.

  1. Completa dominio + API KEY.
  2. Elige Desactivar ONUs según tu política de mora.
  3. Pulsa Guardar → Configuración guardada correctamente.
  4. Pulsa Probar conexión → Conexión SmartOLT correcta.
    Si falla: SmartOLT no configurado. Verifica dominio y API Key.

Caché y “sincronización” de catálogos

No hay un botón llamado “Sincronizar catálogos”. Los catálogos (VLAN, zonas, perfiles, ODB) se cachean ~6 h desde la API. Para forzar datos frescos:

  1. Pulsa Limpiar caché.
  2. Confirma ¿Está seguro de eliminar el caché de SmartOLT?… (título ¿Eliminar Caché?, botón Sí, continuar).
  3. Mensaje: Caché limpiado correctamente.
  4. Vuelve a abrir VLANs / Zonas / Perfiles / ODB o autoriza una ONU; el sistema vuelve a consultar SmartOLT.

Los formularios de catálogo muestran: ATENCION!! Debe indicar los datos tal cual están dado de alta en la plataforma de SMAROLT.

Vista: catálogos SmartOLT

3. Catálogos operativos

3.1 VLANs — /smartolt/vlans

  • Título VLANs / Redes virtuales configuradas en SmartOLT.
  • Botón Nueva VLAN.
  • Columnas: ID, VLAN ID, Descripción, OLT, Acciones.
Campo Obligatorio
OLT Sí
VLAN-ID (1 a 4094) Sí
Descripción No
For IPTV No (switch)
Management / VoIP No
DHCP snooping No
LAN to LAN No

Eliminar pide confirmación irreversible.

3.2 Zonas — /smartolt/zonas

  • Botón Nueva Zona.
  • Columnas: ID, Nombre, Acciones.
  • Formulario: solo Nombre (obligatorio).

3.3 Perfiles — /smartolt/profiles

  • Botón Nuevo Perfil.
  • Columnas: ID, Nombre, Tipo (UPLOAD / DOWNLOAD).
  • Campos: Nombre + Tipo (UPLOAD o DOWNLOAD), ambos obligatorios.

Crea al menos un perfil de bajada y uno de subida con los mismos nombres que en SmartOLT antes de autorizar ONUs.

3.4 ODB — /smartolt/odb

  • Botón Nuevo ODB.
  • Columnas: ID, Nombre, Zona, Acciones.
  • Campos: Nombre y Zona (ambos obligatorios). El ODB es el splitter que verás al autorizar.

4. Listado de ONUs

Sección ONUs registrados → /smartolt.

Vista: listado de ONUs

Si la API no está configurada aparece el banner SmartOLT sin configurar con botón Ir a API.

Con API OK verás:

  • Sección Listado de ONUs — Equipos reportados por SmartOLT y su vínculo con clientes.
  • Columnas: Cliente, ID cliente, SN, OLT, Estado, Board, Port, Signal, RX signal, Acciones.
  • Estados: ONLINE / OFFLINE; cliente sin vínculo: Sin cliente vinculado.
  • Tooltips de señal: Señal buena, Señal baja, Señal crítica, Sin dato.
  • Filtro (por defecto Todos): Clientes Online, Clientes Offline, Clientes Señal baja, Clientes Señal mala.
  • Exportación: Imprimir, Exportar CSV, Exportar Excel, Exportar PDF.

Acciones de fila

Situación Acciones
ONU vinculada Gestionar FTTH, Ver detalles
ONU sin cliente Vincular al cliente en el sistema

Ver detalles abre Resumen Datos (General, Señal, Historial, WAN, LAN Ports, VoIP, MAC Address).

Vincular SN al sistema (sin autorizar en SmartOLT)

  1. Acción Vincular al cliente en el sistema.
  2. Busca en Buscar por nombre, email o documento...
  3. Confirma en Confirmar vinculación / Vincular ONU.
  4. Aviso clave: Solo vinculación interna — guarda el SN en el servicio; no autoriza en SmartOLT.
  5. Éxito: ONU vinculada al cliente… Para autorizar o configurar en SmartOLT, usa Gestionar FTTH.

Gestionar FTTH

Modal Gestionar FTTH con pestañas Información ONU, WAN, WiFi, TR069, Puertos, Servicios.

Herramientas:

  • Reiniciar ONU
  • Resincronizar ONU
  • Mover ONU
  • Disable ONU (escribe DISABLE)
  • Delete ONU (escribe ELIMINAR)

5. Autorizar ONU desde el cliente

Flujo diario típico (Cliente → servicio Internet → SmartOLT):

  1. Abre el cliente y el servicio de internet FTTH.
  2. El sistema carga catálogos con GET /smartolt/catalogs.
  3. Completa la autorización:
Bloque UI Campos clave
Información detectada por SmartOLT OLT, Board, Puerto, Serial ONU / SN, Modelo…
Datos tomados de WispSmart Cliente, Plan, Router, Usuario/Contraseña PPPoE, IP
Parámetros de autorización SmartOLT Obligatorios: VLAN de Datos, Zona, Perfil de Descarga, Perfil de Subida. Opcionales: Modo ONU, ODB / Splitter, Nombre, Dirección / Comentario
TR069 / Administración Perfil TR069, Modo IP Gestión (Inactivo / DHCP / IP Estática), VLAN gestión, Acceso remoto
  1. Lee el pie: Primero se autoriza la ONU con catálogos SmartOLT. Luego se gestiona la WAN PPPoE/TR069 desde FTTH.
  2. Pulsa Guardar y Autorizar ONU.

También puedes registrar desde el listado (Registrar ONU / Editar ONU) con campos: Servicio cliente, Modo Operación (INTERNET + CATV / INTERNET), ONU Type, Use custom profile, ONU mode (Routing / Bridging), User VLAN-ID, PROFILE DOWN/UP, Zone, ODB (Splitter).

6. Tips

  • Configura API y limpia caché antes de autorizar masivamente.
  • Los nombres de Perfiles y VLANs deben coincidir exactamente con SmartOLT.
  • Usa Desactivar ONUs = SI solo si quieres que la suspensión del cliente apague la ONU automáticamente.
  • Señal baja/crítica: filtra el listado y abre Gestionar FTTH antes de mandar técnico.

7. Checklist rápido

  1. Ajustes → OLT (SmartOLT) → API → Dominio + API KEY + Desactivar ONUs → Guardar
  2. Probar conexión OK
  3. (Opcional) Limpiar caché y revisar VLANs / Zonas / Perfiles / ODB
  4. Abrir ONUs registrados y filtrar Offline / señal baja
  5. Vincular SN al servicio o autorizar desde el cliente con Guardar y Autorizar ONU
  6. Verificar ONU ONLINE con perfil correcto