Webservices Rakuten France
picto

Documentation

Vieilles versions du webservice GetNewSales supprimées.

15 janvier 2019 by Fred in Blog, Commandes, Documentation, Maintenance

Vieilles versions du webservice : GetNewSales ont été supprimées

    WS GetNewSales

  • Vieilles versions supprimées : 2010 – 2013 versions
  • Dernière version: 2017-08-07
  • Modifications: L’email et le numéro de téléphone de l’acheteur ne sont plus disponibles
  • Vous pouvez récupérer l’email et le numéro de téléphone de l’acheteur dans les webservices GetCurrentSales
  • & GetShippingInformation

Changement d’URL (« endpoint ») des webservices.

15 octobre 2018 by Fred in Blog, Documentation

Vous pouvez dès maintenant changer les URL (« endpoint ») des webservices.


Suite au changement de notre nom de domaine : « priceminister.com » vers « fr.shopping.rakuten.com » les webservices évoluent aussi.

Pensez à modifier votre « endpoint » ou « Base URL » dès maintenant !
Remplacez le « endpoint » actuel « https://ws.priceminister.com/ » par « https://ws.fr.shopping.rakuten.com/ » pour tous les webservices.

Exemple :

    – URL actuel pour un call :

  • https://ws.priceminister.com/stock_ws?action=genericimportfile&login= xxxxxx&pwd=xxxxxx&version=2015-02-02
    – Nouvel URL pour un call :

  • https://ws.fr.shopping.rakuten.com/stock_ws?action=genericimportfile&login= xxxxxx&pwd=xxxxxx&version=2015-02-02

Profitez en également pour mettre à jour vos versions des webservices !

Nouvelles versions de webservices: EXPORT, LISTING.

31 juillet 2018 by Fred in Blog, Documentation

LES NOUVELLES VERSIONS DE WEBSERVICES : EXPORT, LISTING

    WS EXPORT

  • Nouvelle version : 2018-06-29
  • La version précédente est toujours fonctionnelle
  • La nouvelle version comprend « isrefurbished » (true or false) « /isrefurbished » dans les « advert » du PRICING
  • Exemple (extrait) de la nouvelle balise dans le flux :

    WS LISTING

  • Nouvelle version : 2018-06-28
  • La version précédente est toujours fonctionnelle
  • La nouvelle version comprend dans « offercounts » un « refurbishednew » (annonces Reconditionné à Neuf seulement) et un « refurbishedused » (annonces Reconditionné Comme Neuf, Reconditionné Très Bon Etat, etc seulement). Le « new » et « used » excluent désormais le Reconditionné à Neuf et Reconditionné Comme Neuf, Reconditionné Très Bon Etat, etc. Le total d’offercounts est la somme de « new », « used », « refurbishednew » et « refurbishedused »
  • La nouvelle version comprend dans « bestprices » un « refurbishednew » (annonces Reconditionné à Neuf seulement) et un « refurbishedused » (annonces Reconditionné Comme Neuf, Reconditionné Très Bon Etat, etc). Le « new » et « used » excluent désormais le Reconditionné à Neuf et Reconditionné Comme Neuf, Reconditionné Très Bon Etat, etc. Le global bestprice est le meilleur bestprice définit entre le bestprice refurbishedNew, le bestprice refurbishedUsed, le bestprice new et le bestprice used.
  • La nouvelle version comprend dans « adverts » un « refurbishednewadverts » (top 5 annonces Reconditionné à Neuf seulement) et un « refurbishedusedadverts » (top 5 annonces Reconditionné Comme Neuf, Reconditionné Très Bon Etat, etc). Le « newadverts » et « usedadverts » excluent désormais le Reconditionné à Neuf et Reconditionné Comme Neuf, Reconditionné Très Bon Etat, etc
  • Exemple:


Nouveau statut: Reconditionné

31 juillet 2018 by Fred in Blog, Documentation

L’arrivée du nouveau statut Reconditionné s’accompagne des changements ci dessous:

LES DIFFERENTS ETATS ASSOCIES AUX PRODUITS RECONDITIONNES.

Pour la mise en vente de produits reconditionné il existe 5 états différents:

Reconditionné à Neuf
Reconditionné Comme Neuf
Reconditionné Très Bon Etat
Reconditionné Bon Etat
Reconditionné Etat Correct

IMPORTANT: L’état Hors Service n’existe pas pour les produits reconditionné.

LA MISE EN VENTE DE PRODUIT RECONDITIONNE PAR IMPORT CLASSIQUE (.csv)

Le champ Produit reconditionné doit avoir la valeur 1 si le produit est reconditionné.
Si le produit n’est pas reconditionné le vendeur peut laisser la case vide ou ajouter la valeur 0.

Produit Reconditionné ? Valeur du champ
Oui 1
Non Vide ou « 0 »

LA MISE EN VENTE DE PRODUIT RECONDITIONNE PAR IMPORT GENERIQUE (.xml)

La balise « refurbished » dans le noeud « Advert » permet d’activer ou désactiver le Reconditionné avec les valeurs « true » (activer) ou « false » (désactiver).

Les valeurs possibles sont « true » ou « false ».

Arrivée du Click and Collect

5 juillet 2018 by Fred in Blog, Documentation

Ça y est le Click and Collect est arrivé !

Cela s’accompagne, bien entendu, de nouveautés pour plusieurs webservices.

Vous trouverez des informations sur le Click and Collect sur la page dédiée :
Click and Collect

Vous trouverez plus de détails sur les changements pour chaque webservice concerné ci-dessous :

*Structure du fichier XML (producttypetemplate)

Ajout de nouvelles balises « pickupStores / pickupStore / pickupStoreId » dans la structure des fichiers XML dans tous les templates permettant de gérer le stock des points de retrait en magasins.



Indiquer la disponibilité en Point de Retrait en Magasin (Click&Collect)
– Exemple: https://developer.priceminister.com/blog/examples/sample/sample_clickandcollect_2018-01-18.xml

* Rapports d’imports (GenericImportReport)

Ajout d’erreurs et de descriptions d’erreurs liées au Click and Collect

* Récupération des nouvelles ventes (GetNewSales)

Ajout du « ShippingType » Click and Collect ainsi que l’ID du point de retrait en magasin.



– 6. Données en retour – ShippingType + pickupStoreId

* GetCurrentSales

Mêmes informations que pour GetNewSales.



– 6. Données en retour – ShippingType + pickupStoreId

* GetShippingInformation

Mêmes informations que pour GetNewSales.

– 6. Données en retour – ShippingType + pickupStoreId

* GetItemInfos

Mêmes informations que pour GetNewSales.

– 6. Données en retour – ShippingType + pickupStoreId

* ImportItemShippingStatus

Confirmation du retrait de l’article dans votre Magasin vous devez renseigner la valeur « 1 », « oui » ou « yes ».



– 5. Liste des tr. – Numéro de suivi

Profitez-en pour vous assurer d’utiliser les dernières versions (dates) des webservices pour que ces changements soient dans les résultats. Toutes les versions sont ici :

Versions des Webservices

Mise à jour de la liste des transporteurs

31 janvier 2018 by Fred in Blog, Documentation

La liste des transporteurs a été mise à jour pour les webservices ImportItemShippingStatus et SetTrackingPackageInfos, voici la liste des transporteurs ajoutés:

  • Cubyn
  • 4PX
  • WeDo Logistics
  • China Post
  • DPD Germany
  • DPD UK
  • PostNL International
  • Swiss Post
  • China EMS
  • Yun Express
  • B2C Europe
  • TrackYourParcel
  • Royal Mail
  • CNE Express
  • S.F. Express
  • Singapore Post
  • Hong Kong Post
  • Bpost

Nouvelles versions de certains webservices

22 janvier 2018 by Fred in Blog, Commandes, Documentation

Les webservices ci dessous ont été mis à jour pour l’arrivée du Click & Collect (versions 2017):

* Getnewsales

Modifications => 6. Données en retour => ShippingType

* GetCurrentSales

Modifications => 6. Données en retour => ShippingType

* GetShippingInformation

Modifications => 6. Données en retour => pickupStoreId

* GetItemInfos

Modifications => 6. Données en retour => ShippingType

* ImportItemShippingStatus

Modifications => 5. 5. Liste des transporteurs disponibles et consignes => Consignes concernant le Numéro de suivi

Le token sera le seul moyen d’accéder à vos webservices à partir du 28 juin

20 juin 2016 by Daniel in Blog, Documentation

Jusqu’à présent, l’accès à vos webservices pouvait s’effectuer à l’aide de votre mot de passe de votre compte ou avec votre Token d’identification. Pour mieux sécuriser la liaison entre le serveur partenaire et PriceMinister, le Token d’identification sera le seul moyen d’accéder à vos webservices à partir du 28 juin.

Nouvelles fonctionnalités et nouveautés

2 juin 2016 by Daniel in Blog, Commandes, Documentation

Depuis le 26 mai 2016, il est possible de confirmer l’envoi de commandes et d’activer de la compensation accélérée (*) par le biais du nouveau webservice ImportItemShippingStatus et par la nouvelle version du webservice SetTrackingPackageInfos.

 

L’appel au nouveau webservice ImportItemShippingStatus déclenchera un message dans l’interface du client et lui enverra un mail avec le lien du colis. Le mail ne contiendra pas de lien de suivi si l’envoi s’effectue en mode Normal.

 

La confirmation d’envoi d’une commande ajoutera un tag supplémentaire <shipped>1</shipped> dans les nouvelles versions des webservices GetCurrentSales, GetItemsInfos et GetBillingInformation.

 

(*) la compensation accélérée est soumise à éligibilité du compte marchand.

 

Depuis le 26 mai 2016 les statuts associés aux “réclamations en cours”, “les ventes acceptées – en attente de la réception du client” et les “ventes à accepter” ont été unifiés dans les nouvelles versions des webservices GetNewSales, GetCurrentSales et GetBilingInformation. Les statuts affichés par les versions ultérieures restent inchangés. Les nouveaux statuts sont répertoriés dans la liste des statuts des articles commandés.

IMPORTANT: Suppression des anciennes versions du webservice listing

14 septembre 2015 by Cédric in Accueil, Blog, Documentation, Produits

Le webservice listing évolue !
Ce webservice évolue, il devient connecté. Il est maintenant obligatoire de mettre vos identifiants (login + token) dans chacun des appels que vous ferez maintenant en https.
Vous devez effectuer ce changement avant la fin de l’année (Date limite: 31 décembre 2015). Nous ne garantissons pas du tout les anciennes versions du webservice listing en 2016.
Les données retournées entre la dernière version non sécurisée et la nouvelle version sont identiques.