Horizon
Administración

Empresas

Nodos del árbol de tenancy y visibilidad por nivel

En Horizon, empresa significa un nodo del árbol comercial: no es solo un nombre fiscal, sino la unidad de aislamiento de datos, facturación y permisos.

Tipos de nodo

Cada empresa tiene un node_type:

TipoEjemploQué representa
distributorLutrilloPartner de más alto nivel; puede crear integradores y clientes finales debajo
integratorOozMSP que opera para varios transportistas
end_clientCapricornio, QuantumCliente final con flotillas y unidades reales (hoja del árbol)

Debajo de un end_client viven las flotillas y unidades — no son nodos del árbol comercial, sino agrupaciones operativas.

Jerarquía y visibilidad

Distribuidor (Lutrillo)
  └── Integrador (Ooz)
        ├── Cliente final (Capricornio)
        └── Cliente final (Quantum)

Reglas clave:

  • Subtree: un nodo ve a todos sus descendientes. Lutrillo ve a Ooz, Capricornio y Quantum. Ooz ve a Capricornio y Quantum.
  • Hermanos aislados: Ooz no ve a otro integrador creado por el mismo distribuidor.
  • Altura del árbol: las hojas (end_client) tienen vista operacional completa (mapa, alertas, bitácora). Niveles superiores ven dashboards agregados — conteo de unidades, viajes activos, alertas abiertas, uso del agente — sin ubicación GPS individual de unidades ajenas a su propio nodo operativo.

Qué ve cada nivel en el dashboard

NivelPantallas típicasLimitaciones
distributorKPIs por hijo, clientes creados, uso agregado del subtreeSin drill-down a mapa de unidades de descendientes
integratorLista de Clientes, métricas por cliente, integraciones GPS, soporte a descendientesOpera en detalle solo al entrar al contexto de un end_client
end_clientFlota, dispositivos, viajes, geocercas, alertas, bitácoraSolo su subtree operativo (flotillas propias)

Dónde administrar empresas

Depende de tu rol:

Integrador o distribuidor — alta de clientes

Dashboard → Clientes

  • Lista de empresas descendientes con tipo, unidades activas, viajes y alertas abiertas.
  • Botón Nuevo cliente para crear un end_client (o nodo hijo permitido).
  • Detalle de cliente con resumen operativo y pestaña de dueños de carga cuando aplica.

Datos fiscales de tu propia organización

Dashboard → Configuración → Organización

  • Razón social, RFC y domicilio fiscal del nodo activo.
  • Resumen de uso e historial de facturas cuando tu nodo es responsable comercial (billing_owner).

Facturación en el árbol

Solo un nodo raíz por subtree mantiene contrato directo con Horizon (billing_owner). Los descendientes reportan uso pero no facturan por separado a Horizon; el distribuidor o integrador raíz concilia internamente con sus clientes.

Si necesitas entender consumo y overage, ve a Planes y cuotas y la pantalla Uso del dashboard.

Buenas prácticas

  1. Un end_client por transportista operativo — evita mezclar flotillas de clientes distintos en el mismo nodo.
  2. Nombres reconocibles — el equipo de soporte identifica empresas en alertas y bitácora por ese nombre.
  3. Delega soporte al integrador directo — el distribuidor no hace soporte operativo al cliente final; escala a integrator_admin o a Horizon solo por incidentes de plataforma.

On this page