- Documentazione tecnica BackMarket : https://doc.backmarket.fr/?#update-orderline
- Articolo dell’HelpCenter di Backmarket : https://merchant-support.backmarket.com/hc/en-gb/articles/360014986540-How-to-fill-in-the-IMEI-Serial-Number-
Dal lato Shoppingfeed, quando spedisci un ordine usando l’API di Shoppingfeed, possiamo aggiungere l’informazione IMEI per prodotto dell’ordine. La nostra API è stata aggiornata per consentire di spedire un ordine con un dato aggiuntivo a livello di prodotto (item).
Troverai qui la documentazione tecnica di Shoppingfeed "Order API > Order > Ship an order", che mostra il modello API di un ordine spedito con un campo aggiuntivo (additionalFields). Questo campo aggiuntivo dell’item (items>additionalFields) verrà utilizzato per trasmettere l’IMEI al marketplace Backmarket durante la spedizione di un ordine.
Così come avviene attualmente con il corriere, il numero e la url di tracking che indichi quando spedisci un ordine, l’IMEI deve essere integrato nelle chiamate di spedizione degli ordini.
L’IMEI è un dato specifico del prodotto. Pertanto, se un ordine contiene più prodotti soggetti all’obbligo di fornirlo, dovrai spedire l’ordine con un IMEI per prodotto.
Per esempio, per un ordine di 2 smartphones (riferimento "abc" e "bcd"), potrai spedire l’ordine con :
- riferimento "abc", imei “12345”
- riferimento "bcd", imei “56789”
Il modello api è il seguente :
|
"items": [ { "channelReference": "string", "additionalFields": {} } ] |
Più precisamente, il modello per Backmarket è descritto in questa documentazione.
Ecco un caso concreto :
Step 1/ Recupero dell’ordine
GET View an order (documentazione API SF)
Si tratta della chiamata per recuperare un ordine. In questa, dovremo recuperare il channelReference, poiché questo dato ci permetterà poi di aggiornare l’IMEI.
Ecco un estratto di ciò che viene recuperato a livello di item :
|
"items": [ { "reference": "786374", "status": "", "quantity": 1, "price": 48.89, "taxAmount": 0, "channelReference": "20106896", |
dove reference 786374 corrisponde al riferimento del venditore e channelReference corrisponde al riferimento trasmesso dal channel (qui Backmarket).
Step 2/ Spedire l’ordine con l’IMEI
POST Ship an order (documentazione API SF)
Questa chiamata è quella che si usa per spedire l’ordine. In questa, potremo indicare un dato aggiuntivo per ogni item dell’ordine, con un IMEI, indicando il suo channelReference recuperato in precedenza.
Ecco un esempio :
|
curl --request POST \ --url https://api.shopping-feed.com/v1/store/storeId/order/ship \ --header 'Authorization: ' \ --header 'Content-Type: application/json' \ --data '{ "order": [ { "id": 1234, "carrier": "ups", "trackingLink": "https://ups.com/tracking/FP4321", "items": [ { "channelReference": "20106896", "additionalFields": { "imei": 12345678907 } } ] } ] } |
In questa chiamata di spedizione, assegniamo sia i dati abituali dell’ordine (corriere, numero e link di tracking), sia anche l’IMEI per riga.