TrackFlo
Paradas

Crear o actualizar una parada

Una parada por cada recogida o entrega en un tramo, con su ventana de cita y la llegada o salida reales.

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

Parámetros de consulta

· 1
sync_run_time string · date-time

Hora UTC de inicio de su ejecución de sincronización en formato ISO-8601 (por ejemplo, 2026-09-06T12:00:00Z). Envíela en cada upsert por lotes o sondeo: 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 solicitudes impulsadas por eventos (webhooks).

Cabeceras

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

pull para sondeos programados, webhook para 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

· StopUpsert
obligatorio application/json
native_system_stop_id string · max length: 100· anulable

Obligatorio. El id de la parada en su TMS.

native_system_load_id string · max length: 100· anulable

Obligatorio. El id de la carga principal en su TMS.

native_system_load_leg_id string · max length: 100· anulable

Obligatorio. El id del tramo principal en su TMS.

native_system_load_permalink string · max length: 100· anulable

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

native_system_load_leg_permalink string · max length: 100· anulable

Obligatorio. Clave única del tramo principal: -.

native_system_stop_permalink string · max length: 100 obligatorio

Obligatorio. Clave única: -. Identifica la parada en cada upsert.

native_system_stop_reference_number string · max length: 100· anulable

Recomendado. Referencia de la parada (número de recogida o entrega). Se muestra y permite búsquedas.

native_system_stop_status string · max length: 100· anulable

Recomendado. Estado de la parada tal como lo denomina su TMS (por ejemplo, planned, arrived, departed).

Respuestas