- Documentación técnica BackMarket : https://doc.backmarket.fr/?#update-orderline
- Artículo del HelpCenter de Backmarket : https://merchant-support.backmarket.com/hc/en-gb/articles/360014986540-How-to-fill-in-the-IMEI-Serial-Number-
Por el lado de Shoppingfeed, cuando envías un pedido usando la API de Shoppingfeed, podemos añadir la información de IMEI por producto del pedido. Nuestra API se ha actualizado para permitir enviar un pedido con un dato adicional a nivel de producto (item).
Encontrarás aquí la documentación técnica de Shoppingfeed "Order API > Order > Ship an order", que muestra el modelo API de un pedido enviado con un campo adicional (additionalFields). Este campo adicional del item (items>additionalFields) se usará para transmitir el IMEI al marketplace Backmarket durante el envío de un pedido.
Al igual que actualmente ocurre con el transportista, el número y la url de tracking que indicas al enviar un pedido, el IMEI debe integrarse en las llamadas de envío de pedidos.
El IMEI es un dato propio del producto. Por tanto, si un pedido contiene varios productos afectados por la obligación de proporcionarlo, tendrás que enviar el pedido con un IMEI por producto.
Por ejemplo, para un pedido de 2 smartphones (referencia "abc" y "bcd"), podrás enviar el pedido con :
- referencia "abc", imei “12345”
- referencia "bcd", imei “56789”
El modelo api es el siguiente :
|
"items": [ { "channelReference": "string", "additionalFields": {} } ] |
Más concretamente, el modelo para Backmarket se describe en esta documentación.
Aquí tienes un caso concreto :
Paso 1/ Recuperación del pedido
GET View an order (documentación API SF)
Se trata de la llamada para recuperar un pedido. En esta, necesitaremos recuperar el channelReference, ya que este dato nos permitirá después actualizar el IMEI.
Aquí tienes un extracto de lo que se recupera a nivel del item :
|
"items": [ { "reference": "786374", "status": "", "quantity": 1, "price": 48.89, "taxAmount": 0, "channelReference": "20106896", |
donde reference 786374 es igual a la referencia del vendedor y channelReference es igual a la referencia transmitida por el channel (aquí Backmarket).
Paso 2/ Enviar el pedido con el IMEI
POST Ship an order (documentación API SF)
Esta llamada es la que se usa para enviar el pedido. En esta, podremos indicar un dato adicional para cada item del pedido, con un IMEI, indicando su channelReference recuperado previamente.
Aquí tienes un ejemplo :
|
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 } } ] } ] } |
En esta llamada de envío, asignamos tanto los datos habituales del pedido (transportista, número y enlace de tracking), como también el IMEI por línea.