Wispro (AR) - es
Esta documentación trata del servicio externo Wispro. El servicio externo se accede a través de API. Las funcionalidades descritas aquí indican las capacidades y los requisitos de la integración, así como el cuestionario y las funcionalidades relacionadas.
Tipo de Integración
La integración OZmap-Wispro es del tipo Activa.
Descripción
Wispro es un software desarrollado para centralizar la administración y la gestión de Proveedores de Servicio de Internet(ISP/WISP).
Las funcionalidades de la integración entre OZmap y Wispro se basan en la sincronización de clientes y cajas entre los sistemas. La integración encuentra a los clientes de Wispro en OZmap a través de su ID de contrato.
Observación: El ID del contrato Wispro, representado en la API por el atributo “public_id”, debe ser igual al código del cliente en OZmap para que el cliente sea localizado correctamente. Este ID de contrato corresponde a un número secuencial del contrato exhibido en la interfaz de Wispro. A continuación, se incluye una imagen destacando en rojo la información referente a este ID de contrato:
Resumen de las funcionalidades
Funcionalidad | Descripción | Dirección de la integración |
---|---|---|
Actualización de Datos de Clientes en OZmap | Actualización de los datos de los clientes registrados en OZmap, pudiendo incluir nombre, dirección, usuario pppoe, dirección mac y observaciones. | Wispro => OZmap |
Actualización de las Coordenadas de Clientes | Al actualizar las coordenadas de un cliente en el sistema elegido como fuente, replica esa alteración en el sistema opuesto. | OZmap => Wispro ou Wispro => OZmap |
Actualización de la Caja del Cliente | Al cambiar un cliente de caja en el sistema elegido como fuente, replica esa alteración en el sistema opuesto. | OZmap => Wispro ou Wispro => OZmap |
Creación de Clientes en OZmap | Creación en OZmap de clientes que poseen contrato en Wispro. | Wispro => OZmap |
Cancelación de Clientes en OZmap | Remoción en OZmap de clientes que no poseen contrato en Wispro. | Wispro => OZmap |
Sincronización de Cajas | Creación, eliminación y actualización de cajas en Wispro, basándose en los datos de cajas OZmap. | OZmap => Wispro |
Funcionalidades
A continuación se describirán las funcionalidades presentadas en el resumen para entender cómo funciona el flujo de sincronización.
Actualización de datos de los Clientes en OZmap
Después de cada intervalo entre las sincronizaciones, la integración busca los contratos y clientes en Wispro.
Identifica a los clientes en OZmap que posean un código similar al ID del contrato existente en Wispro, y actualiza los campos basándote en las siguientes reglas:
Nombre
Si hay una alteración del nombre en Wispro y está diferente en OZmap, se considerará el nombre que está en Wispro. (Cualquier alteración de nombre en OZmap será descartada).
Dirección
La actualización del campo dirección del cliente en OZmap se basa en la lectura informada por Wispro. La actualización se realiza si la dirección de Wispro es diferente de la dirección existente en OZmap actualmente.
Usuário pppoe y dirección Mac
Actualización del valor del campo de usuario pppoe y dirección mac en el OZmap se basa en la lectura informada por Wispro. La actualización se realiza si el usuario pppoe o la dirección mac del contrato en Wispro es diferente de la existente en OZmap actualmente.
Observaciones
La actualización del campo "observaciones" del cliente en OZmap se realiza con base en la información proporcionada por Wispro. Este proceso utiliza los datos disponibles en los detalles del contrato del cliente en Wispro para garantizar que la información esté alineada entre los sistemas.
Actualización de las Coordenadas del Cliente
La funcionalidad de actualización de coordenadas permite mantener los datos de latitud y longitud del cliente sincronizados entre dos sistemas. Essa actualización puede configurarse para tener como fuente principal el OZmap o el Wispro.
El proceso de actualización ocurre de la siguiente manera:
Se realiza la lectura de todos los contratos de clientes de Wispro.
La integración busca clientes en OZmap que posean un código similar al ID del contrato en Wispro.
La integración compara los valores de latitud y longitud entre los dos sistemas, utilizando como fuente el sistema determinado por el cliente.
Caso se identifique una divergencia entre las coordenadas de los sistemas y:
El sistema fuente para las coordenadas sea el OZmap:
Las coordenadas de latitud y longitud del contrato del cliente en Wispro se actualizan con los valores presentes en OZmap.El sistema fuente para las coordenadas sea el Wispro:
Las coordenadas de latitud y longitud de la propiedad del cliente en OZmap se actualizan con los valores presentes en Wispro.
Observación: En caso de que la configuración "Considerar fecha de última actualización para actualización de coordenadas" esté activa y utilizando el sistema fuente OZmap, la integración buscará actualizar solamente los clientes o contratos que hayan sufrido alteraciones desde la última sincronización, garantizando mayor eficiencia en el proceso y evitando operaciones innecesarias.
Actualización de la Caja del Cliente
La actualización de la caja del cliente consiste en identificar que un cliente ha sido cambiado de caja en el sistema elegido como fuente, y replicar esa actualización en el otro sistema, y ocurre de la siguiente manera:
Se realiza la búsqueda de todos los contratos existentes en Wispro.
La integración busca clientes en OZmap con código igual al ID de contrato del cliente Wispro.
En caso de que el sistema elegido como fuente sea OZmap:
En caso de que el cliente en Wispro esté en una caja diferente en OZmap, se actualiza la caja del contrato del cliente en Wispro, replicando los datos de OZmap.
En caso el cliente no tiene información de caja en OZmap y la configuración ‘Desconexión de clientes en cambios de caja si no tienen información de conexión en el sistema fuente’ está activa, también desconecta al cliente en Wispro.
IMPORTANTE:
La actualización de caja se realizará solo si hay una caja en Wispro vinculada a la caja correspondiente en el OZmap del cliente. Además, es importante destacar que la caja vinculada en Wispro debe estar asociada a una OLT para que la actualización se realice correctamente.
En caso el sistema elegido como fuente sea el Wispro:
En caso de que el cliente en OZmap esté en una caja diferente en Wispro, se actualiza la caja del cliente en OZmap conectándolo en el primer puerto libre del primer splitter.
En caso de que el cliente no tenga información de caja en Wispro y la configuración ‘Desconexión de clientes en cambios de caja si no tienen información de conexión en el sistema fuente’ esté activa, también desconecta la fibra del cliente en el splitter OZmap manteniendo el drop en la caja.
IMPORTANTE:
La actualización de caja solo se realizará si hay una caja en OZmap vinculada con la caja Wispro del cliente.
Creación de Clientes en OZmap
La creación de clientes consiste en buscar todos los contratos de clientes que existen en Wispro y que no existen en OZmap, y crearlos en OZmap, siguiendo el siguiente orden:
Se realiza la lectura de todos los contratos de clientes en Wispro;
Para cada contrato de cliente en Wispro, se verifica si existe un cliente OZmap, buscando el código del cliente OZmap similar al ID del contrato Wispro.
La integración intentará crear los clientes que existen en Wispro pero no existen en OZmap;
Para cada contrato de cliente en Wispro que se cree en OZmap, se buscará, por el id de la caja OZmap, si la caja del cliente en Wispro está vinculada a una Caja en OZmap;
En caso la caja del cliente en Wispro no esté vinculada a ninguna caja en OZmap, el cliente no será creado.
Si se encuentra una caja correspondiente en OZmap, creamos el inmueble en OZmap conectado a esa caja y el cliente con el código OZmap siendo el ID de contrato del cliente Wispro.
En caso la caja exista en el OZmap y tenga splitter, creamos el cliente en el primer puerto libre del primer splitter (el splitter debe permitir conexión de cliente).
El cliente será creado con nombre, usuario pppoe, dirección mac, dirección, coordenadas y observaciones provenientes del contrato del cliente Wispro.
Cancelación de Clientes en OZmap
La cancelación de clientes Wispro en OZmap ocurre con base en las lecturas realizadas en Wispro y se da en las siguientes situaciones:
Se realiza la lectura de todos los contratos de clientes en Wispro.
A partir de entonces, los clientes existentes en OZmap, la integración busca un contrato de cliente en Wispro que tenga el ID igual al código del cliente OZmap.
En caso de que no se encuentre ningún contrato Wispro referente a este cliente, el cliente será cancelado del OZmap, teniendo por defecto la propiedad y el drop mantenidos en el OZmap, con el drop siendo mantenido conectado al puerto del splitter, pero esto puede ser alterado a través de las Configuraciones Específicas OZmap - Clientes, donde es posible:
Mantener inmueble y drop en el OZmap, desconectado el drop conectado al puerto del splitter (para esto, basta con que el parámetro “Desconectar Drop de Clientes cancelados en el OZmap“ esté activo).
Sincronización de Cajas
La Sincronización de Cajas OZmap se basa en la creación, actualización y eliminación de cajas en Wispro con base en los datos de cajas OZmap, y ocurre de la siguiente manera:
A cada ciclo de ejecución de las funcionalidades de la integración, se buscan todas las cajas Wispro, y las cajas OZmap que hayan tenido algún tipo de actualización desde la última sincronización de la integración y las que pertenezcan a un proyecto nuevo, y, además, la caja OZmap debe poseer un splitter de atendimiento.
La integración verifica si hay nuevas cajas OZmap aún no vinculadas con cajas Wispro y si alguna caja vinculada anteriormente entre los sistemas ha sido actualizada o eliminada del OZmap, para realizar los debidos tratamientos en Wispro:
En caso de que haya nuevas cajas OZmap, que no estén con estado "En proyecto", y aún no vinculadas con cajas Wispro, se realizará la siguiente verificación:
Se verificará si hay en Wispro alguna caja correspondiente con nombre de cajas OZmap, y en caso de que se encuentren cajas con nombres similares, estas cajas serán vinculadas entre los dos sistemas en la integración.
En caso no se encuentre ninguna caja Wispro con el mismo nombre de las cajas OZmap, las cajas OZmap serán creadas en Wispro y vinculadas entre los dos sistemas en la integración.
En caso se este utilizando la configuración "Considerar OLT", se buscará una OLT en Wispro con IP correspondiente a la OLT OZmap. En caso de que no esté conectado a una OLT en OZmap o no se encuentre una OLT correspondiente en Wispro, la caja será creada en Wispro sin información de OLT.
En caso alguna de las cajas vinculadas anteriormente ha tenido alguna alteración en OZmap, esas modificaciones se transferirán a sus cajas correspondientes en Wispro.
En caso alguna de las cajas vinculadas anteriormente ha sido eliminada del OZmap, la integración eliminará las cajas correspondientes de Wispro.
Configuración Base
Parámetro | Descripción | Patrón |
---|---|---|
Tiempo entre Sincronizaciones | Tiempo esperado entre las sincronizaciones realizadas por la integración. | 15 minutos
|
Configuraciones Específicas - Clientes
Parámetro | Descripción | Patrón |
---|---|---|
Creación de Clientes | Clientes que existen en Wispro pero no existen en OZmap serán creados en OZmap si la caja del cliente en Wispro está vinculada a una caja en OZmap. | Desactivado |
Actualización de Caja del Cliente | Al cambiar un cliente de caja en el sistema elegido como fuente, replica esa alteración en el sistema opuesto. | Desactivado |
Cancelación de Clientes | Clientes que existen en el OZmap y no poseen un código referente a un contrato de cliente en Wispro serán removidos del OZmap. | Desactivado |
Fuente de información de cajas para la sincronización de cajas entre los sistemas OZmap y Wispro | El sistema fuente que contiene los datos de caja correctos y que serán propagados al sistema opuesto. | ozmap |
Actualizar Coordenadas de Clientes | Actualización de los atributos de latitud y longitud de los clientes, basada en la lectura del sistema elegido como fuente. | Desactivado |
Fuente de coordenadas para sincronización de coordenadas entre los sistemas | El sistema fuente que contiene los datos de coordenadas correctos y que serán propagados al sistema opuesto. | ozmap |
Desconexión de clientes en intercambios de caja en caso de que no tengan información de conexión en el sistema fuente. | Decide si la desconexión de clientes y también la falta de conexión de clientes en el sistema fuente será propagada al sistema opuesto. | Desactivado |
Desconectar Drop de Clientes cancelados en OZmap | Cuando un cliente sea removido del OZmap por no existir un contrato referente a ese cliente en Wispro, el drop de la propiedad será desconectado del puerto del splitter OZmap. | Desactivado |
Considerar la fecha de última actualización para la actualización de coordenadas (solo puede ser utilizado si el sistema fuente para la actualización de coordenadas es el OZmap). | En el proceso de actualización de coordenadas, la integración buscará actualizar las coordenadas solamente de los clientes o contratos que hayan sufrido alteraciones desde la última sincronización. | Desactivado |
Configuraciones Específicas - Cajas
Parámetro | Descripción | Patrón |
---|---|---|
Considerar OLT | Busca una OLT Wispro con IP correspondiente a la OLT OZmap. Caso no esté conectado a una OLT en OZmap o no se encuentre una OLT correspondiente en Wispro, la caja será creada sin OLT en Wispro. | Desactivado |
Datos de Acceso
Wispro
Datos de acceso necesarios para buscar información a través de la API en el sistema Wispro (estos datos deben ser proporcionados en el cuestionario inicial).
Parámetro | Descripción | Ejemplo |
---|---|---|
URL | Dirección del servidor Wispro. | https://wispro.co/api/v1 |
Token | Token proporcionado por el cliente para acceder al servicio. | 59123456-2e1d-479a-9b49-5513b2aac54f |
OZmap
Parámetro | Descripción | Ejemplo |
---|---|---|
Token | Token asociado a la cuenta del usuario de integración registrado en ozmap. (El usuario debe tener acceso a los proyectos en los que la integración trabajará (elección del usuario). Tutorial sobre como generar usuario/clave.) | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE |
Liberación de IPs
Para la validación y ejecución de la integración en el entorno de producción, es necesario que se liberen en el servidor Wispro del cliente las IPs utilizadas por el OZmap:
Servidor OZmap del cliente (ping cliente.ozmap.com.br)
54.207.162.199
Cuestionario
Pregunta | Respuesta | Funcionalidad |
---|---|---|
|
|
|