Crear o actualizar un transportista

Datos maestros del transportista y contactos de seguimiento. Un transportista cuyos contactos se gestionan dentro de TrackFlo se informa como skipped y se deja sin cambios.

POST /api/v1/carriers/upsert

Clave de API en la cabecera X-API-Key

curl 'https://integration-api.trackflo.tech/api/v1/carriers/upsert' \
  --request POST \
  --header 'Trackflo-Ingest-Source: pull' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "native_system_carrier_id": "SINBDEGA",
  "carrier_name": "EXAMPLE TRUCKING LLC",
  "native_system_carrier_permalink": "SINBDEGA-acme",
  "primary_after_hours_tracking_contact_name": "Jane Dispatcher",
  "primary_after_hours_tracking_contact_email": "[email protected]",
  "primary_after_hours_tracking_contact_phone_number": "(555) 010-0100",
  "primary_pod_contact_name": "Jane Dispatcher",
  "primary_pod_contact_email": "[email protected]",
  "primary_pod_contact_phone_number": "(555) 010-0100",
  "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 ingesta; se recomienda incluirlo en cada solicitud.

valores

pull
webhook

Cuerpo

· CarrierUpsert

obligatorio application/json

native_system_carrier_id string · max length: 100· anulable

Obligatorio. El identificador de su TMS para el transportista.

carrier_name string · max length: 100· anulable

Obligatorio. Nombre del transportista.

mc_number string · max length: 100· anulable

Recomendado. Número de Motor carrier (MC).

dot_number string · max length: 100· anulable

Recomendado. Número de US DOT.

native_system_carrier_permalink string · max length: 100 obligatorio

Obligatorio. Clave única: -. Identifica al transportista en cada upsert.

primary_tracking_contact_name string · max length: 100· anulable

Recomendado. Contacto principal de seguimiento del transportista. Se utiliza para comunicaciones.

primary_tracking_contact_email string · max length: 100· anulable

Recomendado. Correo electrónico del contacto principal de seguimiento. Se utiliza para comunicaciones.

primary_tracking_contact_phone_number string · max length: 100· anulable

Recomendado. Teléfono del contacto principal de seguimiento. Se utiliza para comunicaciones.

Cabeceras

Cuerpo

Respuestas