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:
| Tipo | Ejemplo | Qué representa |
|---|---|---|
distributor | Lutrillo | Partner de más alto nivel; puede crear integradores y clientes finales debajo |
integrator | Ooz | MSP que opera para varios transportistas |
end_client | Capricornio, Quantum | Cliente 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
| Nivel | Pantallas típicas | Limitaciones |
|---|---|---|
distributor | KPIs por hijo, clientes creados, uso agregado del subtree | Sin drill-down a mapa de unidades de descendientes |
integrator | Lista de Clientes, métricas por cliente, integraciones GPS, soporte a descendientes | Opera en detalle solo al entrar al contexto de un end_client |
end_client | Flota, dispositivos, viajes, geocercas, alertas, bitácora | Solo 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
- Un
end_clientpor transportista operativo — evita mezclar flotillas de clientes distintos en el mismo nodo. - Nombres reconocibles — el equipo de soporte identifica empresas en alertas y bitácora por ese nombre.
- Delega soporte al integrador directo — el distribuidor no hace soporte operativo al cliente final; escala a
integrator_admino a Horizon solo por incidentes de plataforma.