Endpoint de eventos de parada
Actualizado hoy
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 sistema de seguimiento 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 del retraso.
Ruta sugerida: POST /trackflo/stop-events. Encontrará información sobre la autenticación, los campos compartidos, las respuestas y los reintentos en Crear endpoints de escritura para TrackFlo.
Campos
Cada solicitud incluye los campos compartidos y estos campos. event_type es stop_event.
Campo | Tipo | Descripción |
|---|---|---|
| string | El ID de la parada tal como se lo envió a TrackFlo. |
| integer | La posición de la parada en el tramo, empezando por 1. |
| string | El tipo de parada tal como se lo envió a TrackFlo. |
| string or null | La hora a la que llegó el camión. |
| string or null | La misma hora, en la hora local de la parada. |
| string or null | La hora a la que salió el camión. |
| string or null | La misma hora, en la hora local de la parada. |
| string | 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 retraso a continuación. |
| string or null | La explicación del retraso proporcionada por el sistema de seguimiento, de hasta 500 caracteres. |
| string | El origen de las horas. Los mismos valores que |
| string or null | Cualquier otro dato escrito por el sistema de seguimiento, de hasta 600 caracteres. |
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 ID de la parada o con el ID del registro que creó:
{ "id": "88214" }Cómo aplicar un evento de parada
Un evento puede incluir una llegada, una salida o ambas. Una hora nula significa que esa hora no forma parte de esta actualización. Mantenga el valor que ya tiene; nunca significa que deba borrarlo.
Una corrección es un evento nuevo. Cuando un sistema de seguimiento corrige una hora incorrecta, enviamos la hora corregida en un evento de parada nuevo. Reemplace con ella la hora almacenada.
Puede producirse un cambio de estado a continuación. Cuando un evento de parada cambia el estado de la carga, por ejemplo, al registrar una llegada al punto de recogida, también enviamos un cambio de estado con el código de estado que usted haya asignado. Su equipo define esa asignación con nosotros durante la incorporación.
Códigos de retraso
De forma predeterminada, delay_code es un código de motivo de estado EDI 214. Si su TMS mantiene su propia lista, acordamos los códigos con usted durante la incorporación y enviamos esos códigos en su lugar.
Código | Significado |
|---|---|
| Accidente |
| Relacionado con el consignatario |
| 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 un desastre natural |
| Cliente, otro |
| Error interno |
Un delay_code siempre se envía junto con un delay_comment.