# Integración con Splynx

## Resumen

Use esta integración cuando Splynx sea su fuente de verdad CRM/NMS.

## Configuración básica

1. Configure Splynx en `/etc/lqos.conf`.
2. Seleccione estrategia de topología (`flat`, `ap_only`, `ap_site`, `full`).
3. Habilite sincronización automática y reinicie scheduler.

## Inicio rápido para nuevos operadores

Base recomendada:

- `strategy = "ap_only"` (menos confusión inicial)
- `enable_splynx = true`
- `network.json` queda reservado para despliegues DIY o manuales

Después, ejecute una sincronización manual y valide salidas antes de aumentar frecuencia de refresh.

## Notas operativas

- La sincronización actualiza automáticamente los datos importados y de shaping que LibreQoS usa con Splynx.
- `network.json` queda para despliegues DIY o manuales.
- Use la WebUI para confirmar que la importación y la profundidad del árbol son las esperadas.
- Use WebUI para ajustes operativos diarios.
- Cuando Splynx no puede inferir el padre de un circuito desde `access_device` o los metadatos del router, LibreQoS deja ese circuito sin padre para shaping en lugar de adjuntarlo a un sitio o AP sintético. Corrija el padre en Splynx o Topology Manager si debe aparecer bajo un sitio o AP real.
- En modo `ap_site`, LibreQoS trata los Network Sites de Splynx como contenedores de sitio y las filas de monitoreo con `access_device = 1` como AP o nodos de acceso. Las ramas grandes de sitios y APs, incluidas ramas de uplink o agregación representadas como nodos `Site` o `AP`, pueden virtualizarse automáticamente cuando superan `queue_auto_virtualize_threshold_mbps`, tienen ramas de cola hijas y no tienen circuitos conectados directamente al ID del nodo. Defina una anulación virtual del nodo en `false` cuando un nodo específico deba permanecer como cola física.

## Validación en 5 minutos después de cambios Splynx

1. Ejecute prueba de integración:
```bash
python3 integrationSplynx.py
```
2. Confirme archivos actualizados:
```bash
ls -lh /opt/libreqos/src/topology_import.json /opt/libreqos/src/shaping_inputs.json
```
3. Confirme salud de servicios:
```bash
sudo systemctl status lqosd lqos_scheduler
journalctl -u lqos_scheduler --since "30 minutes ago"
```
4. Verifique en WebUI que Scheduler Status y profundidad de árbol coincidan con la estrategia elegida.

## Referencia completa

- [Referencia detallada de Splynx](integrations-reference-es.md#integración-con-splynx)
- [Modos de operación y fuente de verdad](operating-modes-es.md)

Las versiones actuales también exponen una política compartida de margen para puertos Ethernet en `Configuration -> Integrations -> Integration Defaults`. Las integraciones que pueden aportar la velocidad Ethernet negociada hacia el suscriptor usan un multiplicador conservador por defecto de `0.94`, salvo que el operador lo cambie.