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.