- Informations générales
- Identification par token
- Versions
- Gestion de stock
- Rapport d’intégration de fichier XML (genericimportreport)
- Intégrer son flux XML (genericImportfile)
- Modèle produits (producttypetemplate)
- Types de produits (producttypes)
- Click and Collect
- Produits se déclinant par couleur et taille
- Lister les modes de livraison disponibles (getavailableshippingtypes)
- Construire un fichier en XML pour la création et mise à jour d’annonces
- Export d’inventaire (export)
- Rapport d’intégration de fichier CSV/TXT (importreport)
- Purge d’une campagne (purge_campaign)
- Configurer vos promotions à l’aide de fichiers CSV
- Intégrer son flux CSV/TXT (import)
- Nouvelles Ventes
- Aprés L'acceptation d'une vente
- Confirmer la réception d’une précommande (confirmpreorder)
- Traitement des ventes après leur confirmation (getitemtodolist)
- Annulation post acceptation (cancelitem)
- Envoyer / répondre à un mail du SAV (contactusaboutitem)
- Obtenir les informations de livraison (getshippinginformation)
- Confirmer l’envoi des commandes (importitemshippingstatus)
- Envoyer le numéro de tracking (settrackingpackageinfos)
- Récupérer le détail des éléments liés à un article (getiteminfos)
- Liste des commandes en cours (getcurrentsales)
- Récupérer les éléments comptables d’un panier donné (getbillinginformation)
- Envoi d’un message post vente à l’acheteur (contactuseraboutItem)
- Données produits
- Comptabilité
Traitement des ventes après leur confirmation (getitemtodolist)
-
1. Utilisation
Ce webservice permet de traiter les ventes après leur confirmation.
Le webservice retourne la liste des articles vendus pour lesquels il peut y avoir une action à faire de la part du vendeur :
- les articles possédant une réclamation en cours
- les articles possédant un message de l’acheteur non lu par le vendeur
- les articles possédant un message de Rakuten France non lu par le vendeur
Chaque article possédant un ou plusieurs « todo » est listé dans la réponse du webservice avec une précision sur la ou les natures du « todo ».
Les détails du todo (détail sur la réclamation, message de Rakuten France ou de l’acheteur …etc…) seront récupérés via un autre webservice à partir de l’id de l’article fourni dans ce webservice.
Ce WS est accessible à la fois aux vendeurs particuliers et aux marchands ainsi qu’aux acheteurs.
-
2. Url
https://ws.fr.shopping.rakuten.com/sales_ws?action=getitemtodolist&login=xxxxxx&pwd=xxxxxx&version=xxxx-xx-xx
-
3. Paramètres
Nom Description Obligatoire action getitemtodolist Oui login login du vendeur Oui pwd Vous avez besoin de votre Token. Plus d’informations ICI. Et vous trouverez votre Token ICI. Oui version Version du webservice à utiliser
Cliquer ici pour voir le dernier numéro de versionOui -
4. XSD
-
5. Erreurs possibles
Type Code Message Detail Sender ParameterError Problem with parameters The parameter login is mandatory Sender ParameterError Problem with parameters The parameter pwd is mandatory Sender ParameterError Problem with parameters The parameter version is mandatory Sender ParameterError Problem with parameters The version XXX is not supported Sender InvalidUserConnection Unknown user or password Incorrect login or password -
6. Données en retour
Voici une vue générale des données disponibles. Se référer au XSD pour les détails.
Valeur Description lastversion Dernière version du WS (à utiliser en priorité) itemid Identifiant de l’article cause Type de todo sur l’article : - CLAIM (une réclamation est à traiter)
- UNREAD_MESSAGE_FROM_CUSTOMER_SERVICE (message non lu du site vers le vendeur)
- UNREAD_MESSAGE_FROM_BUYER (message non lu de l’acheteur vers le vendeur)
-
7. Exemple de sortie
<getitemtodolistresult xsi:schemaLocation="http://www.fr.shopping.rakuten.com/res/schema/getitemtodolist http://pmcdn.priceminister.com/res/schema/getitemtodolist/getitemtodolist.2011-09-01.xsd" xmlns="http://www.fr.shopping.rakuten.com/res/schema/getitemtodolist" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <request> <version>xxxx-xx-xx</version> <user>xxxx</user> </request> <response> <lastversion>xxxx-xx-xx</lastversion> <sellerid>18352654</sellerid> <items> <item> <itemid>159177464</itemid> <causes> <cause>CLAIM</cause> <cause>UNREAD_MESSAGE_FROM_CUSTOMER_SERVICE</cause> <cause>UNREAD_MESSAGE_FROM_BUYER</cause> </causes> </item> </item> </items> </response> </getitemtodolistresult>