Envíe una actualización de ubicación, ETA o comentario

Solo admite adiciones. Una actualización por cada check call, ping de GPS o comentario de estado; un permalink ya almacenado se informa como duplicate y no se modifica. TrackFlo obtiene la ubicación, ETA y comentario más recientes del leg a partir de estas actualizaciones.

POST /api/v1/loadupdates/upsert

Clave de API en la cabecera X-API-Key

curl 'https://integration-api.trackflo.tech/api/v1/loadupdates/upsert' \
  --request POST \
  --header 'Trackflo-Ingest-Source: pull' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "native_system_load_update_id": "zz1k1rlu15t0dlo1fuevi0",
  "native_system_load_id": "1087189",
  "native_system_load_leg_id": "2326805",
  "native_system_load_permalink": "1087189-acme",
  "native_system_load_leg_permalink": "2326805-acme",
  "native_system_load_update_permalink": "zz1k1rlu15t0dlo1fuevi0-acme",
  "comment": "MacroPoint location update:\nHighway 531 Minden, LA 71055 at 09/06/2026 10:37 AM",
  "load_update_entered_by": "tms-system",
  "latitude": 32.58185,
  "longitude": -93.250547,
  "city": "MINDEN",
  "state": "LA",
  "load_update_utc_timestamp": "2026-09-06T15:37:00",
  "enter_time_utc_timestamp": "2026-09-06T15:38:00",
  "eta_utc": "2026-09-07T04:13:00",
  "eta_local": "2026-09-06T23:13:00",
  "eta_source": "PowerBroker",
  "company_permalink": "acme"
}'

{
  "status": "processed",
  "message": "example",
  "permalink": "example"
}

Almacenado, omitido o duplicado: consulte status.

Cabeceras

· 1

Trackflo-Ingest-Source string · enumeración

pull para consultas programadas, webhook para envíos activados por eventos. Permite que TrackFlo supervise por separado el estado de cada ruta de ingestión; se recomienda incluirlo en cada solicitud.

valores

pull
webhook

Cuerpo

· LoadUpdateUpsert

obligatorio application/json

native_system_load_update_id string · max length: 100· anulable

Obligatorio. El id de su TMS para el check call o evento de ubicación.

native_system_load_id string · max length: 100· anulable

Obligatorio. El id de su TMS para el load principal.

native_system_load_leg_id string · max length: 100· anulable

Obligatorio. El id de su TMS para el leg principal.

native_system_load_permalink string · max length: 100· anulable

Obligatorio. Clave única del load principal: -.

native_system_load_leg_permalink string · max length: 100· anulable

Obligatorio. Clave única del leg principal: -. La actualización se aplica a este leg.

native_system_load_update_permalink string · max length: 100 obligatorio

Obligatorio. Clave única: -. Un permalink ya almacenado es un duplicado y se omite.

comment string · max length: 1000· anulable

Obligatorio. Texto de la actualización (nota del check call, comentario de estado).

load_update_type string · max length: 100· anulable

Recomendado. Tipo de actualización según la denominación de su TMS (por ejemplo, check call, ping de GPS, cambio de estado).

Cabeceras

Cuerpo

Respuestas