Non usare quest'API per nuove implementazioni. E' stata sostituita dall'API Import documenti
L’API aggiornamento spedizione consente ad un sistema esterno di aggiornare bindCommerce sulla spedizione degli ordini.
I campi che è possibile trasmettere sono i seguenti:
- Id ordine bindCommerce (es. "OrderID":"3470")
- Corriere: (es. "TrackingCarrier":"SanMarinoMail")
- Codice di tracciabilità della spedizione (es. "TrackingNumber":"00B2NMH8")
- Data ed ora di spedizione (es. "ShippedTime":"2018:01:10 12:36:19")
Chiamata ed autenticazione
La chiamata viene effettuata all’URL generato da bindCommerce per lo specifico connettore (da configurare preventivamente attraverso l’interfaccia di bindCommerce).
L’autenticazione avviene attraverso token assegnato per il nodo API. Il parametro viene trasmesso nell'header della richiesta.
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://HABCDE.bindcommerce.cloud/integrator-tool/logistic/request_logistic.php?connector=5258",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "[\r\n\t{\r\n \r\n\t \"OrderID\": 191252,\r\n\t \"TrackingCarrier\": \"UPS\",\r\n\t \"TrackingNumber\": \"1ZA103756899507566\",\r\n\t \"ShippedTime\": \"2017:12:13 09:00:00\"\r\n\t},\r\n\t{\r\n\t \r\n\t \"OrderID\": 191252,\r\n\t \"TransactionID\": \"ORDER2365\",\r\n\t \"CarrierID\": 50,\r\n\t \"TrackingCarrier\": \"UPS\",\r\n\t \"TrackingNumber\": \"1ZA103756899507566\",\r\n\t \"ShippedTime\": \"2017:12:13 09:00:00\"\r\n\t}\r\n]",
CURLOPT_HTTPHEADER => array(
"cache-control: no-cache",
"content-type: application/json",
"token: 84b670ea63539f5bc0572a260f1f4dfb"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
File Json
[ { "OrderID": "3470", "TrackingCarrier": "SanMarinoMail", "TrackingNumber": "00B2NMH8", "ShippedTime": "2018:01:10 12:36:19" } ]
Risposta
Codice HTTP
|
Descrizione |
200 | OK richiesta accettata |
412 | Contenuto richiesta mancante o non valido |
401 | Token mancante o autenticazione fallita |
500 | Errore interno |