Crear o actualizar un tramo de carga

Un tramo por ruta o movimiento. Los tramos contienen las asignaciones de transportista, conductor y representante que TrackFlo supervisa y gestiona.

POST /api/v1/loadlegs/upsert

Clave de API en la cabecera X-API-Key

curl 'https://integration-api.trackflo.tech/api/v1/loadlegs/upsert?sync_run_time=2026-01-01T12%3A00%3A00Z' \
  --request POST \
  --header 'Trackflo-Ingest-Source: pull' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "native_system_load_leg_id": "2329167",
  "native_system_load_id": "1089521",
  "native_system_load_leg_permalink": "2329167-acme",
  "native_system_load_permalink": "1089521-acme",
  "native_system_load_leg_status": "OPEN",
  "load_mode": "T",
  "origin_stop_id": "zz1k1rlpe4o0dis1m9cjnt",
  "origin_stop_id_permalink": "zz1k1rlpe4o0dis1m9cjnt-acme",
  "destination_stop_id": "zz1k1rlpe550dis1m9cjnt",
  "destination_stop_id_permalink": "zz1k1rlpe550dis1m9cjnt-acme",
  "company_permalink": "acme"
}'

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

Almacenado, omitido o duplicado; consulte status.

Parámetros de consulta

· 1

sync_run_time string · date-time

Hora UTC en formato ISO-8601 en que comenzó su ejecución de sincronización (por ejemplo, 2026-09-06T12:00:00Z). Envíela en cada lote o upsert de polling: si el registro cambió en TrackFlo después de esta hora (una edición de usuario o un webhook más reciente), el upsert responde skipped en lugar de sobrescribirlo. No es necesaria para publicaciones impulsadas por eventos (webhooks).

Cabeceras

· 1

Trackflo-Ingest-Source string · enumeración

Use pull para el polling programado y webhook para los envíos impulsados por eventos. Permite que TrackFlo supervise por separado el estado de cada ruta de ingesta; se recomienda incluirlo en cada solicitud.

valores

pull
webhook

Cuerpo

· LoadLegUpsert

obligatorio application/json

native_system_load_leg_id string · max length: 100· anulable

Obligatorio. Identificador de su TMS para el tramo (ruta o movimiento).

load_leg_sequence integer · anulable

Obligatorio. Posición basada en 1 de este tramo dentro de la carga.

native_system_load_id string · max length: 100· anulable

Obligatorio. Identificador de su TMS para la carga principal.

native_system_load_unique_key string · max length: 100· anulable

Recomendado. Clave que TrackFlo usa para crear el enlace “View in TMS” de esta carga.

native_system_reference_number string · max length: 100· anulable

Recomendado. Número de referencia del tramo. Se muestra como número de referencia y permite búsquedas.

pickup_reference_number string · max length: 1000· anulable

Recomendado. Número de recogida de la primera parada. Se muestra como número de referencia y permite búsquedas.

native_system_load_leg_permalink string · max length: 100 obligatorio

Obligatorio. Clave única: -. Identifica el tramo en cada upsert.

native_system_load_permalink string · max length: 100· anulable

Obligatorio. Clave única de la carga principal: -.

Parámetros de consulta

Cabeceras

Cuerpo

Respuestas