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 version
    Oui
    
    																																															
    
    																																															
  • 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>
    
    
    																																															
    
    																																															

Privacy Preference Center