Endpoint de cambio de estado

Actualizado hoy

Establece en el movimiento identificado por native_system_load_leg_id el estado correspondiente al código de native_system_load_leg_status. Enviamos un cambio de estado cuando un rastreador cambia el estado de la carga en TrackFlo y cuando un evento de parada cambia la carga a un nuevo estado, por ejemplo, cuando llega al punto de recogida.

Ruta sugerida: POST /trackflo/status-changes. Encontrará información sobre la autenticación, los campos compartidos, las respuestas y los reintentos en Crear endpoints de escritura de datos para TrackFlo.

Campos

Cada solicitud incluye los campos compartidos y los siguientes. event_type es status_change.

Campo	Tipo	Descripción
`native_system_load_leg_status`	string	El nuevo estado, indicado mediante uno de los códigos de estado propios de su TMS.
`status_date_time_utc`	string	Cuándo entró en vigor el estado.
`status_date_time_local`	string or null	La misma hora, según la hora local de la parada o ubicación a la que corresponde el estado.
`status_iana_timezone`	string or null	La zona horaria de `status_date_time_local`.
`trigger`	string	`manual` cuando un rastreador establece el estado, `stop_event` cuando lo cambia un evento de parada.
`native_system_stop_id`	string or null	La parada a la que corresponde el estado, si la hay (por ejemplo, el punto de recogida para un estado de llegada al punto de recogida).
`comment`	string or null	El comentario del rastreador, con un máximo de 600 caracteres.

Ejemplo

{
  "event_id": "c7d4b1a9-52e0-4c33-8f17-6a2e90d5b4f8",
  "event_type": "status_change",
  "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:45Z",
  "trackflo_load_url": "https://app.trackflo.tech/public_load_details/4b6e…",
  "native_system_load_leg_status": "ATDEL",
  "status_date_time_utc": "2026-10-25T12:10:00Z",
  "status_date_time_local": "2026-10-25T07:10:00",
  "status_iana_timezone": "America/Chicago",
  "trigger": "stop_event",
  "native_system_stop_id": "88214",
  "comment": null
}

Responda con { "id": "<your record id>" } o con { "id": null } si su TMS no conserva ningún registro de los cambios de estado.

Sus códigos de estado

Solo enviamos códigos de su propia lista. Durante la incorporación, acordamos con usted dos cosas:

Qué estados puede establecer un rastreador desde TrackFlo. La mayoría de los equipos eligen una lista breve, como enviado, en el punto de recogida, en tránsito, en el punto de entrega y entregado.
Qué estado corresponde a cada evento de parada. Por ejemplo, una llegada al primer punto de recogida se convierte en su código de estado en el punto de recogida, y una salida del punto de entrega final se convierte en su código de estado entregado.

Responda con 422 y un message que indique el código desconocido. El rastreador verá el mensaje y nosotros corregiremos la asignación.

Aspectos que debe tener en cuenta

Ordene por status_date_time_utc. Un cambio de estado que se reintente puede llegar después de uno más reciente. Omita los cambios de estado cuya hora sea anterior a la del estado que ya tenga para ese tramo.
Aplíquelo al tramo, no al pedido. En un pedido dividido, cada tramo pasa por sus propios estados: el primer transportista puede haber entregado la carga en el centro de transferencia mientras el segundo aún está en el punto de recogida.

¿Te fue útil?