Saltar a contenido

Explotación

Prestar el servicio exige asignar medios a las expediciones y, después, constatar lo que se ha hecho realmente. La API expone ambas cosas, y es su confrontación lo que aporta valor.

Prever y después constatar

Dos objetos se parecen y responden a preguntas distintas.

planning duties
Responde a Quién debía realizar qué Quién realizó efectivamente el servicio
Naturaleza Previsión Constatación
Producido por La planificación del operador La toma de servicio del conductor en su dispositivo

Comparar ambos revela las discrepancias de explotación: expedición no cubierta, cambio de conductor, vehículo sustituido. Ningún endpoint calcula esta comparación: le corresponde a la integración hacerla, cruzando ambas lecturas sobre la misma fecha.

Endpoint Función
GET /api/v4/groups/<group_id>/planning Da la asignación prevista en un periodo
GET /api/v4/groups/<group_id>/duties Lista los servicios realmente realizados
GET /api/v4/groups/<group_id>/duties/<duty_id> Describe un servicio y las expediciones que cubre

El servicio de conducción lo une todo

El servicio de conducción es el eje de la explotación: es el que asocia, para una franja horaria dada, un conductor, un vehículo, un dispositivo y una lista de expediciones realizadas. También incluye los kilómetros recorridos fuera de expedición comercial y la información de toma y fin de servicio.

Es, por tanto, el punto de entrada para cualquier pregunta del tipo «quién conducía este vehículo a tal hora», que ni la expedición ni el dispositivo responden por sí solos.

Los medios

Tres entidades describen los medios empleados, definidas en el glosario: los conductores, los vehículos y los dispositivos.

Dos aspectos importan para una integración:

  • Un conductor no es un usuario. No se conecta a la interfaz de explotación; se identifica en la aplicación Pysae Driver. Las cuentas de usuario, por su parte, pertenecen a la organización.
  • Archivar no es eliminar. Un conductor o un vehículo que deja la red se archiva: desaparece de la explotación corriente, pero sigue vinculado al historial que ha generado. Una integración que filtra sin tener en cuenta el archivado pierde los datos pasados.
Endpoint Función
GET /api/v4/groups/<group_id>/drivers Lista los conductores
GET /api/v4/groups/<group_id>/vehicles Lista los vehículos

La compartimentación por equipo

Un grupo puede subdividirse en equipos: una cochera, un sector, un subcontratista. Los conductores y los vehículos están vinculados a ellos, y los derechos de un usuario pueden limitarse a algunos de ellos.

Una integración cuya clave de API está restringida a ciertos equipos solo ve una parte de la red. Por eso, una diferencia de volumen inexplicada se comprueba primero por ese lado.

Y después

Para analizar todo esto en periodos largos, la vía es la exportación masiva: consulte la página Estadísticas y exportaciones.