Documentos BQN

Además de RADIUS y REST, los datos de los abonados pueden recuperarse de varios sistemas de facturación compatibles.

Las integraciones de facturación sólo admiten direcciones IPv4.

‍

Azotel

El BQN recupera los datos del cliente y obtiene de ellos los límites de velocidad que debe aplicar(velocidad de subida y de bajada).

Para activar Azotel, en la GUI de BQN vaya a Configuración->RADIUS/REST/Facturación->Sistemas de facturación, seleccione Azotel y active el conmutador.

También se necesitará un usuario y contraseña para el acceso REST/JSON a Azotel.Ese usuario/contraseña debe crearse en el sistema Azotel con acceso permitido desde la dirección IP de BQN. Consulte la documentación de Azotel aquí.

La BQN utilizará su dirección de gestión para las consultas de Azotel, pero tenga en cuenta que si la BQN llega a Azotel a través de Internet, Azotel verá una dirección IP pública y ésta es la que necesitará autorización por parte del sistema de Azotel.

En la interfaz gráfica de usuario de BQN, configure también la dirección IP del sistema Azotel o el nombre del servidor y el número de puerto (443 por defecto).

Los clientes de Azotel que se encuentren en un estado distinto a "actual" serán bloqueados (se considerará que carecen de una suscripción válida). Puede cambiar este comportamiento a no bloqueo desactivando el interruptor Bloquear abonados inactivos/que no pagan.

‍

Gestfy

Gestfy utiliza la API REST de BQN. Consulte el capítulo sobre la API REST.

‍

ISPSolution

ISPSolution utiliza la API REST de BQN. Consulte el capítulo API REST .

‍

Microwisp

Microwip utiliza RADIUS. Consulte el capítulo Interfaz RADIUS.

‍

Powercode

Para activar Powercode en la interfaz gráfica de usuario de BQN, vaya a Configuración->RADIUS/REST/Facturación->Sistemas de facturación, seleccione Powercode y active el interruptor.

Proporcione la dirección IP del sistema Powercode o el nombre del servidor y su número de puerto SSH (22 por defecto).

El servidor BQN necesita acceso SSH al servidor Powercode utilizando un usuario/contraseña Unix.

En el sistema Powercode, necesitaremos un usuario y contraseña MySQL. Si el usuario/contraseña MySQL es diferente al usuario/contraseña Unix, deberá especificarse en Credenciales MySQL en la GUI BQN. El usuario MySQL debe tener acceso de lectura a las siguientes tablas de la base de datos MySQL de Powercode:

• Servicios
• InternetInfo
• Equipamiento
• Cliente
• Atención al cliente
• DirecciónRango

Los clientes de Powercode en un estado que no sea "Activo" serán bloqueados (se considera que carecen de una suscripción válida). Puede cambiar este comportamiento a no bloqueo desactivando el interruptor Bloquear suscriptores inactivos/que no pagan.

‍

REST-API Powercode

La facturación de Powercode restringe la API REST a tres peticiones por segundo. Por esta razón, la integración preferida es utilizar el acceso MySQL descrito en la sección anterior. REST-API se puede utilizar cuando MySQL no se puede utilizar y el número de suscriptores es bajo (mil o menos).

El BQN recupera los equipos CPE de una determinada categoría (1 por defecto). Para los abonados con esa categoría de equipos, recuperará los límites de tarifa de su servicio de Internet ("internetInfo").

Para activar Powercode, vaya a Configuration->External Subscriber Data->Billing Systems, seleccione Powercode y active el interruptor.

También se necesitará una clave API. La clave API debe ser creada en el sistema Powercode, con acceso permitido desde la dirección IP de la BQN (la BQN utilizará su dirección de gestión para las consultas de Powercode).

Indique también la dirección IP del sistema Powercode o el nombre del servidor y el número de puerto (444 por defecto).

Si la categoría del equipo CPE en la base de datos Powercode es distinta de 1, cámbiela. Se puede especificar más de una categoría escribiendo los números de categoría separados por espacios (por ejemplo, "10 11 12" para las categorías 10, 11 y 12).

‍

Sónar

Se admite Sonar v2 (el que tiene GraphQL API).

El BQN recupera las tarifas de los clientes y los límites de velocidad a aplicar.

Para activar la integración de Sónar, vaya a Configuración->RADIUS/REST/Facturación ->Sistemas de facturación en la interfaz gráfica de usuario de BQN, seleccione Sónar y active el interruptor.

Se necesitará una clave API. Deben crearse en el sistema Sonar. Consulte la documentación de Sonar para más detalles aquí.

Por último, en la interfaz gráfica de usuario de BQN, configure la dirección IP del sistema Sonar o el nombre del servidor y el número de puerto (443 por defecto) en Configuración->RADIUS/REST/Facturación ->Sistemas de facturación, icon Sonar seleccionado y activado.

Por defecto, los clientes de Sónar con el campo account_status->name con un valor distinto de "Activo" serán bloqueados (se considera que carecen de una suscripción válida). Puede añadir más estados además de "Activo", para que tampoco se bloqueen (vea el ejemplo anterior, donde se ha añadido el estado Empleado ). Puede cambiar el comportamiento de BQN a no bloquear con respecto al estado de la cuenta desactivando el interruptor Bloquear suscriptores inactivos/que no pagan.

Los siguientes campos de la facturación Sonar pueden utilizarse como fuente del ID de abonado:

• Customer-ID (campo de ID de cuenta en Sonar).
• Nombre (accountname en Sonar).

Los límites de velocidad se toman de los campos detallados del servicio de datos:

• velocidad_descarga_kilobits_por_segundo
• velocidad_carga_kilobits_por_segundo

‍

Splynx

El BQN recupera las tarifas de los clientes, los límites de velocidad a aplicar y las tarifas de ráfaga, junto con los umbrales de ráfaga y la duración de las ráfagas.

Para activar Splynx en la GUI de BQN, vaya a Configuración->RADIUS/REST/Facturación->Sistemas de facturación, seleccione Splynx y active el conmutador.

Se necesitará una clave API y un secreto. Deben crearse en el sistema Splynx con la siguiente configuración:

• Habilitar la autorización básica para esta llave.
• Deje vacía la lista de IPs permitidas o incluya la dirección IP de la BQN. El BQN utilizará su dirección de gestión para las consultas de Splynx, pero tenga en cuenta que si el BQN llega a Splynx a través de Internet, Splynx verá una dirección IP pública y ésta es la que necesitará autorización por parte del sistema Splynx.
• Añadir permisos de visualización para los elementos de la base de datos Planes de tarifas ->Internet y Clientes->Clientes en línea.

Las siguientes capturas de pantalla muestran la API KEY y los permisos de acceso:

En la GUI de BQN, configure también la dirección IP del sistema Splynx o el nombre del servidor y el número de puerto (443 por defecto).

Los clientes Splynx con "1" en su campo bloqueado , serán bloqueados (se considera que carecen de una suscripción válida). Puede cambiar este comportamiento a no bloqueo desactivando el interruptor Bloquear abonados inactivos/que no pagan.

‍

UISP

Existe un plug-in de código abierto disponible en github. Apoyado por la comunidad (sin soporte oficial). Utiliza la API REST de BQN.

‍

Visp.net

El BQN recupera la tarifa del cliente y obtiene de ella los límites de velocidad a aplicar y las tasas de ráfagas, umbrales y duración.

Para activar Visp, vaya a Configuración->RADIUS/RESTO/Facturación ->Sistemas de facturación, seleccione Visp y active el conmutador.

Para solicitar los tokens temporales de la API es necesario proporcionar al BQN un identificador de cliente y un secreto, así como un nombre de usuario y una contraseña válidos. Un id de cliente es único por instalación de Visp. Un usuario es cualquiera de las cuentas de usuario válidas en ese cliente para acceder al sistema.

The provided IP address or server name will be used, along with the port (443 by default), to requests API tokens (https://<server>:<port>/token) and also to send API queries (https://<server>:<port>/graphql).  

La siguiente pantalla muestra un ejemplo de configuración de Visp:

Los clientes Visp con un estado de paquete y de instancia de servicio distinto de ACTIVO, serán bloqueados. Puede cambiar este comportamiento a no bloqueo desactivando el interruptor Bloquear suscriptores inactivos/no pagadores.

‍

WISPControl

WISPControl utiliza RADIUS. Consulte el capítulo Interfaz RADIUS.

‍

Wisphub

Wisphub ha desarrollado una integración con BQN utilizando la API REST de BQN. Consulte la documentación del producto Wisphub aquí.

‍

Wispro

El BQN recupera clientes, contratos y planes para conseguir que se apliquen los límites de velocidad.

Para activar Visp, vaya a Configuración->RADIUS/RESTO/Facturación->Sistemas de facturación, seleccione Wispro y active el conmutador.

Debe proporcionarse una clave API válida. La clave API debe generarse en el sistema Wispro. Consulte las instrucciones aquí.

The provided IP address or server name will be used, along with the port (443 by default), to send API queries to Wispro (https://<server>:<port>/api/v1).  

La siguiente pantalla muestra un ejemplo de configuración de Wispro:

Sólo se bloquearán los clientes Wispro con contratos en estado desactivado . Puede cambiar este comportamiento a no bloqueo desactivando el interruptor Bloquear suscriptores inactivos/que no pagan.

Los siguientes campos de la facturación Wispro pueden utilizarse como fuente del ID de abonado:

• SubscriberID ("public_id" en el cliente Wispro).
• Nombre.
• Dirección MAC.
• Login (campo "email" en el cliente Wispro).

Si un cliente Wispro tiene más de un contrato, a cada dirección IP se le asignarán los límites de velocidad de su contrato. Si una dirección IP se repite en dos contratos de cliente (se trata de una incoherencia en la base de datos de facturación que no debería ocurrir), se seleccionarán los límites del contacto obtenido el último.

‍

Consideraciones generales sobre la facturación

‍

Fuente de ID de abonado

El sistema de facturación puede ser la fuente de ID de abonado BQN. Las opciones de fuentes de ID dependen del sistema de facturación (consulte cada sección de facturación para obtener más detalles).

Para los sistemas de facturación integrados mediante la API REST, el sistema de facturación tiene el control total del identificador del abonado, que puede definirse explícitamente al crear o editar el abonado.

‍

Bloquear abonados inactivos / que no pagan

Por defecto, BQN bloqueará a los abonados que no paguen. Qué es un suscriptor que no paga depende del sistema de facturación (ver cada sección específica de facturación para más detalles). Para evitar que BQN bloquee a los abonados que no pagan, desactive el interruptor Bloquear abonados inactivos/que no pagan.

Para los sistemas de facturación integrados mediante REST API, el sistema de facturación tiene el control total de la definición del límite de tarifa y puede bloquear a un abonado asignándolo a una política con velocidad de límite de tarifa 0.

‍

Factor de escala de la tasa

Por defecto, el BQN aplicará los límites de tarifa especificados por el sistema de facturación. Es posible aplicar un factor de escala a esos límites utilizando el campo Escala de límite de tarifa.

Para aplicar un límite de velocidad inferior al de la facturación, utiliza un factor inferior al 100%. Por ejemplo, un límite en la facturación de 200 Mbps con un factor del 90% será de 180 Mbps.

Para imponer una velocidad superior a la de la facturación, utiliza un factor mayor del 100% y hasta el 200% (máximo factor posible). Por ejemplo, una velocidad de 200 Mbps en la facturación con un factor del 150% será de 300 Mbps.

En el caso de los sistemas de facturación integrados mediante la API REST, el sistema de facturación tiene el control total de la definición del límite de tarifa y puede decidir qué factor, si lo hay, se aplica a los límites enviados al BQN.