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
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.
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
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 velocidad ->Internety 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.
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
No es posible recuperar la información del grupo de abonados, ya que no existe un campo estándar en el sistema de facturación con esa información.
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 ).
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.
Instalación
Requisitos previos
- BQN con los paquetes linux-R3.0.13-2-20231130 o posterior y bqn-R4.18.8 o posterior.
- BQN con la API REST activada (consulte https://www.bequant.com/docs/rest#rest-configuration).
- UISP con API REST habilitada con acceso tanto aNMS como a CRM. Debe crearse una CLAVE API común para ambos tipos de acceso.
Pasos
1. Vaya al repositorio de código y obtenga el archivo zip del código (en la página principal del repositorio, vaya a Código->Descargar ZIP).
2. Descomprima el archivo zip del código. Por ejemplo con el comando unzip:
Esto creará un subdirectorio llamado uisp-main.
3. Cree un directorio uisp en la cuenta raíz del servidor BQN:
Where <BQN-OAM-IP> is the management IP address of the BQN server.
4. Edite el archivo sync-uisp-bqn.sh para ajustar los parámetros a los valores de su entorno. Ejemplo:
5. Transfiera los siguientes archivos desde el PC al servidor BQN utilizando scp:
6. Asegúrese de que los siguientes archivos son ejecutables en BQN:
7. En el BQN, copie sync-uisp-bqn.sh en el directorio crontab para que se ejecute cada 5 minutos:
8. Si se necesita DNS (el servidor BQN o el UISP utilizan nombres de dominio), compruebe que el BQN tiene configurado el DNS (véase Configuración->Interfaces->Gestión).
Y eso es todo, el script accederá al UISP cada 5 minutos y actualizará el BQN en consecuencia. Puedes comprobar el registro del script en el BQN:
Para ver las políticas y los suscriptores creados en el servidor BQN, consulte la sección "Comprobar la API REST" en https://www.bequant.com/docs/rest#rest-configuration.
Actualizaciones
Para actualizar el script de sincronización, haga lo siguiente:
1. Vaya al repositorio de código y obtenga el archivo zip del código (en la página principal del repositorio, vaya a Código->Descargar ZIP).
2. Descomprima el archivo zip del código. Por ejemplo con el comando unzip:
Esto creará un subdirectorio llamado uisp-main.
3. Transfiera los siguientes archivos desde el PC al servidor BQN utilizando scp:
Where <BQN-OAM-IP> is the management IP address of the BQN server. NOTE that the sync-uisp-bqn.sh MUST NOT be updated.
4. Asegúrese de que el siguiente archivo actualizado sigue siendo ejecutable:
Limitaciones conocidas
- La primera vez puede tardar minutos en ejecutarse. Las siguientes ejecuciones enviarán a BQN sólo los cambios del cliente y serán más rápidas.
- Si la sincronización falla, no se vuelve a intentar hasta la siguiente tarea programada.
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.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.