- Documentation technique BackMarket : https://doc.backmarket.fr/?#update-orderline
- Article HelpCenter Backmarket : https://merchant-support.backmarket.com/hc/en-gb/articles/360014986540-How-to-fill-in-the-IMEI-Serial-Number-
Côté Shoppingfeed, lorsque vous expédiez une commande en utilisant l’API de Shoppingfeed, nous pouvons ajouter l’information d’IMEI par produit de la commande. Notre API a été mise à jour pour permettre d’expédier une commande avec une donnée additionnelle au niveau du produit (item).
Vous trouverez ici la documentation technique de Shoppingfeed "Order API > Order > Ship an order", qui donne le modèle API d’une commande expédiée avec un champ additionnel (additionalFields). Ce champ additionnel de l’item (items>additionalFields) sera utilisé pour transmettre l’IMEI à la place de marché Backmarket lors de l’expédition d’une commande.
Au même titre que le sont actuellement le transporteur, le numéro et l’url de tracking que vous précisez lors d’une expédition de commande, l’IMEI est à intégrer dans les appels d’expédition de commande.
L’IMEI est une donnée propre au produit. Aussi, si une commande contient plusieurs produits concernés par l’obligation d’en fournir, il faudra bien expédier la commande avec un IMEI par produit.
Par exemple, pour une commande de 2 smartphones (référence "abc" et "bcd"), vous pourrez expédier la commande avec :
- référence "abc", imei “12345”
- référence "bcd", imei “56789”
Le modèle api est comme suit :
|
"items": [ { "channelReference": "string", "additionalFields": {} } ] |
Plus précisément, le modèle pour Backmarket est décrit sur cette documentation.
Voici un cas concret :
Étape 1/ Récupération de la commande
GET View an order (documentation API SF)
Il s’agit de l’appel pour récupérer une commande. Dans ce dernier, nous aurons besoin de récupérer le channelReference, car cette donnée nous permettra ensuite de mettre à jour l’IMEI.
Voici un extrait de ce qui est récupéré au niveau de l’item :
|
"items": [ { "reference": "786374", "status": "", "quantity": 1, "price": 48.89, "taxAmount": 0, "channelReference": "20106896", |
où reference 786374 est égale à la référence vendeur et channelReference est égal à la référence transmise par le channel (ici Backmarket).
Etape 2/ Expédier la commande avec l’IMEI
POST Ship an order (documentation API SF)
Cet appel est celui utilisé pour expédier la commande. Dans ce dernier, nous pourrons préciser une donnée additionnelle pour chaque item de la commande, avec un IMEI, en précisant son channelReference récupéré précédemment.
Voici un exemple :
|
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 } } ] } ] } |
Dans cet appel d’expédition, nous attribuons à la fois les données habituelles de la commande (transporteur, numéro et lien de tracking), mais aussi l’IMEI par ligne.