Skip to main content

Compañías

Una compañía es la unidad organizativa de Airbag Sync: agrupa conductores, vehículos, administradores y toda la información operativa. Algunas organizaciones operan bajo un esquema de grupo empresarial, donde una compañía padre concentra la relación comercial y varias sub-compañías (filiales, unidades de negocio, regiones o razones sociales distintas) operan de forma independiente bajo ella.

Información que gestionamos​

  • Compañía padre: la que agrupa al resto. Es la titular de la API key con la que consultas la jerarquía.
  • Sub-compañías (hijas): las compañías que cuelgan de ese padre. Cada una mantiene sus propios conductores, vehículos y administradores.
  • Resumen operativo: país, estado y número de conductores y administradores registrados en cada sub-compañía.

La jerarquía es de un solo nivel: una sub-compañía no puede tener sub-compañías propias. No existen "nietas" ni relaciones circulares.

Autenticación​

Todas las consultas sobre la jerarquía requieren una API key válida en el encabezado Authorization: apikey {API_KEY}. Las llaves se solicitan a un agente de soporte de Airbag Tech y se entregan únicamente a contactos autorizados.

La compañía padre se deduce siempre de la API key con la que se firma la solicitud. Los endpoints de esta sección no aceptan un identificador de compañía como parámetro, por lo que no es posible consultar la jerarquía de una organización ajena.

Alcance de la consulta​

Consultar la lista de sub-compañías no da acceso a sus datos operativos. Para leer los conductores, vehículos o viajes de una sub-compañía necesitas la API key de esa sub-compañía; los identificadores devueltos sirven para correlacionar información entre tus sistemas y Airbag, no como credencial.

La API expone la estructura en modo lectura. Para dar de alta o modificar la jerarquía de tu grupo, contacta al equipo de soporte de Airbag Tech.

Buenas prácticas​

  • Cachea la lista de sub-compañías: la jerarquía cambia con poca frecuencia y consultarla en cada sincronización desperdicia cuota.
  • Usa el id de cada sub-compañía como llave de correlación estable en tus sistemas; el name puede cambiar.
  • Si tu grupo supera el tamaño de una página, recorre la paginación hasta que pagination.hasNext sea false en lugar de asumir un tamaño fijo.