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, a menos que se indique lo contrario.

‍

Aradial

‍

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

‍

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.

Las tarifas de las pólizas se toman de la tarifa de carga y la tarifa de descarga de los campos de cubo del cliente.

Con la información de grupo de suscriptores habilitada, y si la información está disponible en la base de datos de Azotel, el apodo del padre del CPE del cliente (por ejemplo, un AP) se utilizará como grupo de suscriptores, con el prefijo "L1-". Además, el nombre del sitio donde se encuentra el padre será un grupo de abonados, con el prefijo "L2-". Así pues, habrá dos niveles: un primer nivel formado por grupos de abonados AP (L1) y un segundo con sitios (L2), que pueden contener uno o más AP.

‍

Gaiia

‍

El BQN recupera los límites de velocidad a aplicar de los productos con tipo INTERNET_PLAN. Estos productos tienen los campos downloadSpeedInKbps y uploadSpeedInKbps como parte de su rawSpecificationValue,

Se necesitará una clave API REST en Gaiia. En Gaiia, vaya a Configuración->claves API, haga clic en Nueva clave API y seleccione los permisos de acceso a Cuentas y Productos.

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

Proporcione también el nombre del servidor Gaiia y el número de puerto (443 por defecto).

Las cuentas de Gaiia en estado de tipo INACTIVO o SUSPENDIDO serán bloqueadas. Puede cambiar este comportamiento a no bloqueo desactivando el interruptor Bloquear suscriptores inactivos/no pagadores.

Los siguientes campos de la facturación Gaiia pueden utilizarse como fuente del identificador de abonado:

• Campo Customer-ID:account readableId.
• Nombre: accountprimaryContact firstName +lastName

La tarifa de la póliza se toma del último nombre de producto encontrado en el campo de facturaciónSuscripciones de la cuenta.

 Los grupos de abonados pueden generarse a partir de la cuenta inventoryItem. Si el artículo tiene un upstreamDevice con un asignado, se creará un grupo nombrado con un prefijo "L1-" y el nombre del asignado. La generación de estos grupos está desactivada por defecto; para activarla, seleccione el interruptor Crear subgrupos con el dispositivo ascendente del artículo de inventario.

‍

La integración de Gaiia está preparada para soportar grupos de doble pila IPv4/IPv6, una vez que esa información esté disponible en Gaiia.

‍

Gestfy

‍

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

‍

ISPCube

‍

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

‍

Consulte aquí las instrucciones de configuración en la parte de facturación de ISPCube (vaya a la pestaña Bequant en la parte inferior de la página).

‍

ISPSolution

‍

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

‍

IXC

‍

Existe un plug-in de código abierto disponible en github. Soportado por la comunidad (sin soporte oficial). Utiliza el capítulo REST API de BQN. Siga las instrucciones README en el repositorio.

‍

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
• CategoríaDispositivo

El BQN recupera equipos CPE de una determinada categoría (todas las categorías por defecto). Las categorías se especifican como una lista de números separados por espacios.

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.

Las tarifas de las políticas se toman de la información de Internet del servicio de atención al cliente (MaxIn, MaxOut, BurstIn, BurstOut y BurstBucktTime).

Con la información de grupo de abonados activada, y si la información está disponible en la base de datos Powercode, se utilizará como grupo de abonados el LocationID del equipo del CPE del cliente, prefijado con "L1-".

‍

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 equipo, recuperará la límites de velocidad 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 crearse 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).

No es posible recuperar la información del grupo de abonados, utilice en su lugar la opción basada en SQL.

‍

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 Sónar 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, con Sónar 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 de Sónar pueden utilizarse como fuente del ID de abonado:

• Customer-ID (campo de ID de cuenta en Sonar).
• Nombre (nombre de la cuenta 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

‍

Por defecto, el nombre de la política de tarifas es creado internamente por el BQN. Alternativamente, si se habilita el cambio de nombres de política de los nombres de servicio de Sonar, las políticas serán nombradas usando el nombre de servicio de Sonar más el Id de servicio anexado a él, con el fin de tener un identificador único (los nombres de servicio de Sonar por sí solos no están garantizados para ser únicos).

Con la información de grupo de suscriptores activada, y si la información está disponible en la base de datos Sonar, se creará un grupo de suscriptores, con el prefijo "L1-", basado en la descripción del artículo de inventario padre del artículo de inventario del suscriptor.

Se admite la doble pila: para cada cuenta con una dirección IPv4 e IPv6, se aplicará una política de tarifas conjunta. Esto se implementa creando un grupo de abonados con esas direcciones como miembros. Para activar dualstack, seleccione un nombre de grupo en el campo Nombre de grupo IPv6 dual-stack. Los grupos tendrán un prefijo "DS-". La creación de grupos dual stack está desactivada por defecto ( nombre de grupo IPv6 dual -stack vacío ). Si, además de la dirección del router del abonado, la dirección IP del módulo de abonado también figura en la asignación IP de la cuenta, también se añadirá al grupo.

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, Clientes->Cliente, Clientes->Clientes en línea y Redes->Sitios de red.

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.

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

• customer_id
• inicio de sesión
• nombre_usuario_real

Los límites de velocidad de la política de tarifas se toman de la tarifa de Internet asociada al cliente en línea:

• descarga_semilla
• speed_upload

Se admite la doble pila: para cada cuenta con una dirección IPv4 e IPv6, se aplicará una política de tarifas conjunta. Esto se implementa creando un grupo de abonados con esas direcciones como miembros. Para activar la pila dual, seleccione un nombre de grupo en el campo Nombre de grupo de pila dual IPv6. Los grupos tendrán un prefijo "DS-". La creación de grupos dual stack está desactivada por defecto ( nombre de grupo dual stack IPv6 vacío ).

El BQN puede crear grupos de abonados basados en la información de localización Splynx. La información de ubicación puede ser:

• Grupos basados en el Sitio de Red del Cliente. Los sitios de red deben definirse en Splynx Redes->Sitios de red y asociarse a cada cliente mediante el campo Ubicación de la Información principal del cliente.
• Grupos basados en Etiquetas de Clientes. Las etiquetas se crean en Config->Sistema->Etiquetas y se asocian a cada cliente utilizando el campo Etiquetas de la Información adicional del cliente.

La generación de estos grupos está desactivada por defecto; para activarla, seleccione una opción en Crear subgrupos (Sitios de red, Etiquetas o ambos).

‍

UISP

‍

En primer lugar, debe concederse acceso de lectura con una CLAVE API común a las partes UCRM y UNMS del sistema UISP.

Para activar UISP, vaya a Configuración->RADIUS/REST/Facturación->Sistemas de facturación, seleccione UISP y active el interruptor.

Especifique el nombre del servidor o la dirección IP en el campo Servidor y el número de puerto (443 por defecto).

Las políticas de tarifas se recuperarán de los planes de servicio UCRM cuyo servicePlanType sea "Internet".

Los abonados se obtienen de los clientes de UCRM.

Los identificadores de abonado pueden tener tres fuentes, seleccionables en SubscriberID source:

• ID del cliente: del campo "id" del cliente.
• Nombre: formulario cliente "firstName" y "lastName" (y si ambos son nulos, "companyName").
• Inicio de sesión: desde el nombre de usuario del cliente.

Un abonado se asocia a una política tarifaria a través de los servicios cliente. Los servicios se asocian a direcciones IP a través de los dispositivos de la parte UNMS del sistema UISP.

Un servicio con un estado distinto de "Activo" o "Suspendido" tendrá bloqueado el tráfico de sus direcciones IP asociadas, a menos que Bloquear abonados inactivos/que no pagan esté desactivado.

Los grupos de abonados se extraen del siguiente modo:

• Los dispositivos con un campo "apDevice" se agrupan bajo ese AP (el tipo de grupo de suscriptores será access-point). Esto suele funcionar con los puntos de acceso Ubiquity.
• Los dispositivos con un sitio padre se agruparán bajo ese sitio (el tipo de grupo de abonado será torre).

Por el momento, UISP no soporta IPv6.

 NOTA: esta integración sustituye a los anteriores scripts python de código abierto.

‍

‍

‍

‍

‍

‍

‍

‍

‍

‍

‍

‍

‍

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.

Con el conmutador Bloquear abonados inactivos/que no pagan activado, el BQN bloqueará a los abonados en función de dos criterios posibles:

• Estado de las instancias de servicio y de los paquetes (por defecto). Si ninguno de ellos está en estado "ACTIVO", el abonado se bloqueará.
• Estado de la cuenta de abonado. Si se elige esta opción, se bloquearán los abonados en estado Suspendido, Hibernado e Inactivo (códigos de estado 8, 9 y 10, respectivamente).

Los siguientes campos de la facturación Visp pueden utilizarse como fuente del identificador de abonado:

• Identificación del cliente
• Nombre + Apellido
• Nombre de usuario

Las tasas de política se obtienen de la instancia de servicio up_speed y down_speed del cliente. También se obtienen las tasas de ráfaga up_burst y down_burst.

Con la información de grupo de abonados activada, el identificador del punto de acceso asociado al CPE del abonado, con prefijo "L1-", será el nombre del grupo de abonados, si la información está disponible en la base de datos Visp.

‍

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).

Las velocidades de la política se toman del plan del contrato del cliente. Los parámetros del plan ceil_down_kbps y ceil_up_kbps se utilizan como límites de velocidad.

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.

Con la información de grupos de abonados activada, los nombres de los nodos se utilizarán como grupos de abonados, es decir, un abonado se asociará a un grupo de abonados después del nombre del nodo del contrato, si esa información está disponible en la base de datos de Wispro.

‍

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 (para más detalles, consulte cada sección de facturación).

En el caso de los sistemas de facturación integrados mediante la API REST, el sistema de facturación tiene pleno control 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.

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 de límite de velocidad y puede bloquear a un abonado asignándolo a una política con velocidad 0 límite de velocidad .

‍

Factor de escala de la tasa

Por defecto, el BQN aplicará los límites de velocidad especificados por el sistema de facturación. Es posible aplicar un factor de escalado a esos límites utilizando el campo Escalado de límites 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 de límite de velocidad y puede decidir qué factor, si lo hay, se aplica a los límites enviados al BQN.