TrackFlo
Loads

Crear o actualizar un load

Un load por pedido en su TMS (el registro a nivel de BOL). Cree el load antes que sus legs y stops.

POST /api/v1/loads/upsert
Clave de API en la cabecera X-API-Key

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 batch / polling upsert: si el registro cambió en TrackFlo después de esta hora (por 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 (webhook).

Cabeceras

· 1
Trackflo-Ingest-Source string · enumeración

pull para polling programado, webhook para envíos impulsados 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

· LoadUpsert
obligatorio application/json
native_system_load_id string · max length: 100· anulable

Obligatorio. El id de su TMS para el pedido / load (el registro a nivel de BOL).

native_system_customer_reference_number string · max length: 100· anulable

Recomendado. El número de referencia del cliente para el pedido. Se muestra como número de referencia y permite búsquedas.

order_type string · max length: 100· anulable

Recomendado. Tipo de pedido tal como lo denomina su TMS. Se muestra como número de referencia.

load_mode string · max length: 100· anulable

Opcional. Modo de transporte del pedido tal como lo denomina su TMS (por ejemplo, Truckload, LTL, Intermodal).

bol_number string · max length: 250· anulable

Recomendado. Número de Bill of lading. Se muestra como número de referencia y permite búsquedas.

po_number string · max length: 1000· anulable

Recomendado. Número de Purchase order. Se muestra como número de referencia y permite búsquedas.

native_system_load_permalink string · max length: 100 obligatorio

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

native_system_load_status string · max length: 100· anulable

Obligatorio. Estado del load exactamente como lo denomina su TMS. TrackFlo lo asigna a sus fases mediante el status mapping acordado durante la incorporación.

Respuestas