Come posso passare un client Cargoes Flow a Dockflow?

Domande e risposte pratiche
1

Il mio cliente chiama l’API di tracciamento Cargoes Flow. Cosa devo cambiare per eseguirla su Dockflow?

Due valori:

  1. Cambia l’host. Un client che mantiene il proprio percorso può usare https://api.dockflow.com/compat/cargoes-flow/flow/api/public_tracking/v1
  2. Inserisci una chiave API di Dockflow in X-DPW-ApiKey. Crea la chiave nella Console API con lo scope Downstream. X-DPW-Org-Token viene accettato e ignorato.

Non esiste una specifica pubblica su cui fare test, quindi il primo passaggio a questa superficie va eseguito insieme a Dockflow, come convalida. Contatta l’assistenza per pianificarlo.

Un esempio pratico, con una chiave fittizia:

POST /compat/cargoes-flow/createShipments
X-DPW-ApiKey: prod_acme_FAKE-TOKEN

{"uploadType":"FORM_BY_MBL_NUMBER","formData":[{"mblNumber":"MB-4471","oceanLine":"MAEU"}]}

Risposta:

{"result":"SUCCESS","errorDetail":[],
 "shipments":[{"shipmentNumber":"DF74123","mblNumber":"MB-4471","created":true}]}

Le righe sono tutto o niente: una sola riga errata in formData significa che non viene creato nulla, e la risposta è FAILED con errorDetail su HTTP 200.

Leggila con GET /shipments e shipmentNumber=DF74123. Aggiungi includeUniqueContainers=true per una riga per collo. Le emissioni e le tratte stradali restano vuote. Ogni consegna webhook include un header X-Dockflow-Signature.

Mappatura completa dei campi e verifica della firma: