Endpoint de actualización de carga

Actualizado hoy

Almacene cada actualización de carga como una llamada de seguimiento, una llamada entrante o una nota de seguimiento en el movimiento indicado en native_system_load_leg_id. Enviamos una por cada llamada de seguimiento que registra un rastreador, cada actualización aprobada a partir de un mensaje del conductor o del transportista y cada nota que TrackFlo escribe para registrar una acción en la carga, como la respuesta por mensaje de texto de un conductor.

Ruta sugerida: POST /trackflo/load-updates. Encontrará 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 estos otros. event_type es load_update.

Campo	Tipo	Descripción
`load_update_utc_timestamp`	string	Cuándo ocurrió la actualización. Es anterior a `entered_at_utc` cuando un rastreador registra una llamada después de que ocurrió. Siempre está presente.
`load_update_local_timestamp`	string or null	La misma hora, según la hora local del lugar de la actualización.
`load_update_iana_timezone`	string or null	La zona horaria de `load_update_local_timestamp`, por ejemplo, `America/Chicago`.
`load_update_type`	string	El tipo de actualización. Consulte Tipos de actualización más abajo.
`load_update_information_source`	string	De dónde provino la información. Consulte Fuentes de información más abajo.
`comment`	string	Lo que escribió el rastreador o la nota que registró TrackFlo. Texto sin formato, de hasta 1,000 caracteres. Siempre está presente.
`comment_formatted`	string	Una línea que combina el comentario, la ubicación, la hora estimada de llegada, la temperatura y las horas, y termina en `(via TrackFlo)`. Úsela si su TMS guarda las llamadas de seguimiento en un único campo de notas. Hasta 2,000 caracteres.
`city`	string or null	La ciudad en la que se encontraba el camión en `load_update_utc_timestamp`.
`state`	string or null	Código de dos letras del estado o la provincia.
`latitude`	number or null	Grados decimales.
`longitude`	number or null	Grados decimales.
`eta_utc`	string or null	La hora estimada de llegada a la parada indicada en `eta_native_system_stop_id`.
`eta_local`	string or null	La misma hora estimada de llegada, según la hora local de esa parada.
`eta_native_system_stop_id`	string or null	Su identificador de la parada a la que corresponde la hora estimada de llegada. Es null si no hay una hora estimada de llegada.
`miles_to_next_stop`	number or null	Millas de conducción desde la ubicación hasta la siguiente parada.
`temperature_fahrenheit`	number or null	La temperatura del refrigerador que informó el conductor o el transportista.
`load_empty`	boolean	`true` cuando el conductor informó que el camión estaba vacío y listo antes de la recogida.

Una actualización de carga sin ubicación sigue siendo válida: la nota de un rastreador que indica que el transportista no respondió incluye un comentario y nada más. Almacénela de la misma manera.

Ejemplo

{
  "event_id": "6f1d2c0e-8a43-4f0b-9a57-2b8d3e1c4f90",
  "event_type": "load_update",
  "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-24T15:42:10Z",
  "trackflo_load_url": "https://app.trackflo.tech/public_load_details/4b6e…",
  "load_update_utc_timestamp": "2026-10-24T15:37:00Z",
  "load_update_local_timestamp": "2026-10-24T10:37:00",
  "load_update_iana_timezone": "America/Chicago",
  "load_update_type": "Check Call with Location",
  "load_update_information_source": "Phone Call with Driver",
  "comment": "Driver rolling, no issues. Fuel stop in Joplin.",
  "comment_formatted": "Check Call with Location - Driver rolling, no issues. Fuel stop in Joplin., Data Source: Phone Call with Driver, Location: Springfield, MO, Miles to stop: 412, ETA to next stop: 10/25/2026 06:30 CDT (via TrackFlo)",
  "city": "Springfield",
  "state": "MO",
  "latitude": 37.2089,
  "longitude": -93.2923,
  "eta_utc": "2026-10-25T11:30:00Z",
  "eta_local": "2026-10-25T06:30:00",
  "eta_native_system_stop_id": "88214",
  "miles_to_next_stop": 412,
  "temperature_fahrenheit": null,
  "load_empty": false
}

Responda con el identificador de su registro:

{ "id": "callin-99812" }

Tipos de actualización

Acordamos la lista con usted durante la incorporación, así que load_update_type usa los nombres que su equipo ya conoce. Si no tiene una lista, enviamos estos valores:

Check Call with Location
Check Call without Location
ETA Confirmation
Load is Late Update
Problem
Detention Warning
No Response
Note, para una nota que TrackFlo registra sobre una acción en la carga, en lugar de una llamada de seguimiento de un rastreador

Fuentes de información

load_update_information_source es uno de estos valores:

Phone Call with Driver, Text Message with Driver, WhatsApp with Driver, Phone Call with Carrier, Email with Carrier, Carrier Tracking Website, Tracking Portal, FourKites, MacroPoint, Trucker Tools, P44, No Contact, Other.

Información importante

La hora estimada de llegada indica la parada correspondiente. Guárdela asociada a eta_native_system_stop_id, no a la parada que su TMS considere siguiente. No coinciden cuando se omite o se cambia el orden de una parada.
Las actualizaciones solo se agregan. Nunca editamos ni eliminamos una actualización de carga que hayamos enviado. Una corrección se envía como una actualización nueva.
comment no tiene prefijo ni sufijo. Si guarda comment en lugar de comment_formatted, use entered_by_name y load_update_information_source para mostrar quién lo escribió y de dónde provino.

¿Te fue útil?