Endpoint de eventos de parada
Actualizado la semana pasada
Registre las horas de llegada y salida de la parada indicada en native_system_stop_id. Enviamos un evento de parada cada vez que un rastreador registra una llegada o una salida, o cuando se aprueba una a partir de un mensaje del conductor o del transportista, junto con cualquier motivo de demora.
Ruta sugerida: POST /trackflo/stop-events. Encontrará información sobre la autenticación, los campos compartidos, las respuestas y los reintentos en Build Write-Back Endpoints for TrackFlo.
Campos
Cada solicitud incluye los campos compartidos y los siguientes. event_type es stop_event.
Campo | Tipo | Descripción |
|---|---|---|
| string | El identificador de su parada, tal como lo envió a TrackFlo. |
| integer | La posición de la parada en el tramo, comenzando por 1. |
| string | El tipo de parada, tal como lo envió a TrackFlo. |
| string or null | La hora a la que llegó el camión. |
| string or null | La misma hora, en la zona horaria local de la parada. |
| string or null | La hora a la que se fue el camión. |
| string or null | La misma hora, en la zona horaria local de la parada. |
| string or null | La zona horaria de la parada, por ejemplo, |
| string or null | El motivo por el que se retrasó el camión. Consulte Códigos de demora más abajo. |
| string or null | La explicación del rastreador sobre la demora, de hasta 500 caracteres. |
| string | El origen de las horas. Los valores son los mismos que los de |
| string or null | El comentario del rastreador sobre la actualización de la parada, de hasta 600 caracteres. También se envía como una actualización de carga; consulte más abajo. |
Ejemplo
{
"event_id": "0c9a7e52-3b1f-4d8e-a6c2-91f04e7d2b13",
"event_type": "stop_event",
"native_system_load_id": "1089520",
"native_system_load_leg_id": "2330158",
"entered_by_name": "Jordan Ellis",
"entered_by_email": "[email protected]",
"entered_by_tms_user_id": "JELLIS",
"entered_at_utc": "2026-10-25T13:05:44Z",
"trackflo_load_url": "https://app.trackflo.tech/public_load_details/4b6e…",
"native_system_stop_id": "88214",
"stop_sequence": 2,
"stop_type": "Delivery",
"arrived_date_time_utc": "2026-10-25T12:10:00Z",
"arrived_date_time_local": "2026-10-25T07:10:00",
"departed_date_time_utc": null,
"departed_date_time_local": null,
"stop_local_iana_timezone": "America/Chicago",
"delay_code": "AH",
"delay_comment": "Driver ran out of hours overnight, restarted at 05:00.",
"stop_update_data_source": "Phone Call with Driver",
"comment": null
}Responda con el identificador de su parada o con el identificador del registro que creó:
{ "id": "88214" }Aplicar un evento de parada
Un evento incluye una llegada, o bien una llegada y una salida. Una salida siempre viene acompañada de la hora de llegada a la parada, incluso si ya la tiene. Una hora nula significa que esa hora no forma parte de esta actualización. Mantenga el valor que tiene; nunca significa que deba borrarlo.
Una corrección es un evento nuevo. Cuando un rastreador corrige una hora incorrecta, enviamos la hora corregida en un nuevo evento de parada. Guarde la hora corregida incluso si es anterior a la que ya tiene: la corrección siempre reemplaza la hora guardada, así que no la descarte porque la hora del evento sea anterior a la del evento que contenía el valor incorrecto. Ordene las actualizaciones por la hora de su evento, incluida
arrived_date_time_utc, para gestionar los reintentos y la entrega fuera de orden, tal como se describe en Reintentos y duplicados en Build Write-Back Endpoints for TrackFlo.Después puede producirse un cambio de estado. Cuando una llegada o una salida en la primera recogida o la entrega final del tramo cambia el estado de la carga, también enviamos un cambio de estado usando el código de estado que usted haya definido. Una parada a mitad del tramo nunca cambia el estado. Su equipo define esta correspondencia con nosotros durante la incorporación.
También se envía una actualización de carga. Enviamos además una actualización de carga que registra el evento de parada: el
commentdel rastreador o, si no hay ninguno, una nota comoStop Update: Arrived: …, Stop: Dallas, TX.
Códigos de demora
De forma predeterminada, delay_code es un código de motivo de estado EDI 214. Si su TMS utiliza su propia lista, acordaremos los códigos con usted durante la incorporación y enviaremos esos códigos en su lugar.
Código | Significado |
|---|---|
| Accidente |
| Relacionado con el destinatario |
| Relacionado con el conductor |
| Avería mecánica |
| Relacionado con otro transportista |
| Parada anterior (solo para cargas con varias paradas) |
| Relacionado con el remitente |
| Relacionado con el clima o con un desastre natural |
| Cliente, otros |
| Error interno |
Por lo general, un delay_code viene acompañado de un delay_comment. Una demora indicada en un mensaje del conductor o del transportista puede llegar sin comentario, y su código quizá no figure en esta lista; guárdelo tal como se envió.