Récupérer le détail des éléments liés à un article (getiteminfos)

  • 1. Utilisation

    Le WS GetItemInfos permet de récupérer le détail des éléments liés à un article:

    • Etat de l’article en cours
    • L’historique de l’article
    • L’ensemble des messages liés à cet article (à la fois les messages envoyés et reçus)
    • les actions possibles sur cet article

    Important: L’appel de ce webservice passera tous les messages en “lu”. Ils n’apparaîtront donc plus lors d’un second appel du webservice précédent “getitemtodolist”.

    Ce WS est accessible à la fois aux vendeurs (particuliers et marchands) et aux acheteurs.

  • 2. Url

    https://ws.fr.shopping.rakuten.com/sales_ws?action=getiteminfos&login=xxxxxx&pwd=xxxxxx&version=xxxx-xx-xx&itemid=xxxxx

  • 3. Paramètres

    Nom Description Obligatoire
    action getiteminfos 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
    itemid identifiant de l’article dont on veut récupérer les infos Oui

  • 4. XSD

    https://fr.shopping.rakuten.com/res/schema/getiteminfos/getiteminfos.2017-08-07.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
    Sender ParameterError Problem with parameters The parameter ‘itemid’ is invalid

  • 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é)
    sellerid Identifiant Rakuten France du compte vendeur
    item  
    itemid Identifiant Rakuten France de l’article
    date Date de vente de l’article
    itemstatus Statut de l’article

    Valeurs possibles :

    • REQUESTED
    • REMINDED
    • COMMITTED
    • CANCELLED
    • ON_HOLD
    • CLOSED

    Voir le détail des statuts
    shippingtype Mode d’expédition
    Valeurs possibles FR :

    • Normal
    • Suivi
    • Recommandé
    • So Colissimo
    • Chronopost
    • Express
    • Point relais Mondial Relay
    • Relai Kiala
    • Retrait chez le vendeur
    • Retrait gratuit en magasin
    pickupStoreId Seul pour le mode d’expédition “Retrait gratuit en magasin”
    shipped Indique si l’article a été expédié (“1” ou “0”)
    itemstate Etat de l’article (détail sur itemstatus)
    Voir les différentes valeurs
    itemstatelabel Explication sur état de l’article
    paymentstatus Statut du paiement

    Valeurs possibles :

    • Forthcoming
    • Paid on DD/MM/YYYY
    • Nous afficherons un tiret dans le cas où aucun paiement n’est attendu
    sellerscore Note de l’acheteur
    availableactions  
    action  
    title Titre de l’action
    description Description de l’action
    actioncode Action code de l’action disponible pour l’article (permettra d’invoquer les WS d’actions post vente).

    Valeurs possibles :

    • contactuseraboutitem
    • contactusaboutitem
    • cancelitem
    itemlog  
    creationdate Date de création du log article
    itemlogcode Code du log article
    description Description fonctionnelle du log article
    complement Complément d’information dans le cas des réclamations et annulation post vente.
    mail  
    mailid Id du mail reçu par le vendeur ou Rakuten France
    senddate Date d’envoi du mail
    sender Expéditeur du mail
    recipient Destinataire du mail
    object Sujet du mail
    content Contenu du mail
    status Statut du mail

    Valeurs possibles :

    • UNREAD
    • READ
    • SENT
    message  
    sender Expéditeur du message
    recipient Destinataire du message
    senddate Date d’envoi du message
    content Contenu du message
    status Statut du message

    Valeurs possibles :

    • UNREAD
    • READ
    • SENT

  • 7. Exemple de sortie 

    <getiteminfosresult xsi:schemaLocation="http://fr.shopping.rakuten.com/res/schema/getiteminfos   http://fr.shopping.rakuten.com/res/schema/getiteminfos/getiteminfos.2017-08-07.xsd" xmlns="http://fr.shopping.rakuten.com/res/schema/getiteminfos"   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<request>
<version>2011-02-02</version>
<user>vendeur</user>
<itemid>1510836652</itemid>
</request>
<response>
<lastversion>2011-02-02</lastversion>
<sellerid>109698070</sellerid>
<item>
<itemid>1518036652</itemid>
<date>10/02/2011-14:34</date>
<itemstatus>ON_HOLD</itemstatus>
<shipped>0</shipped>
<itemstate>CLAIMED_AMICABLE</itemstate>
<itemstatelabel><![CDATA[Réclamation   en cours. Traitement amiable avec l'acheteur]]></itemstatelabel>
<paymentstatus>Forthcoming</paymentstatus>
<sellerscore/>
<claim>
<creationdate>15/02/2011-11:46</creationdate>
<type>DAMAGED</type>
<state>NEW</state>
<amicable>Y</amicable>
<claimcomment><![CDATA[article   abimé, pouvez vous me renvoyer un nouvel exemplaire   ?]]></claimcomment>
</claim>
<availableactions>
<action>
<title>Contacter   acheteur1</title>
<description><![CDATA[Pour   contacter acheteur1 à propos de cet article (expédition, fonctionnement,   accessoires...)]]></description>
<actioncode>contactuseraboutitem</actioncode>
</action>
<action>
<title>Contacter Rakuten France</title>
<description><![CDATA[Pour   apporter un complément d'information concernant la réclamation de   acheteur1]]></description>
<actioncode>contactusaboutitem</actioncode>
</action>
<action>
<title>Annuler la vente   de cet article</title>
<description><![CDATA[Pour   annuler la transaction et demander à Rakuten France de rembourser   acheteur1]]></description>
<actioncode>cancelitem</actioncode>
</action>
</availableactions>
<mail>
<mailid>
2906818102
</mailid>
<senddate>
15/02/2011-11:58
</senddate>
<sender>
vendeur
</sender>
<recipient>
Rakuten France
</recipient>
<object>
<![CDATA[Concernant   la réclamation en cours (943746258/1510436652)]]>
</object>
<content>
<![CDATA[Bonjour,   pouvez vous m'expliquer la démarche à suivre pour   retourner un nouvel article à l'acheteur ? serais je   remboursé ?]]>
</content>
<status>
SENT
</status>
</mail>
<message>
<sender>
vendeur
</sender>
<recipient>
Acheteur1
</recipient>
<senddate>
15/02/2011-11:50
</senddate>
<content>
<![CDATA[Pouvez   vous nous retourner l'article à l'adresse précisé sur la facture ?   Cordialement,]]>
</content>
<status>
SENT
</status>
</message>
<message>
<sender>
acheteur
</sender>
<recipient>
vendeur
</recipient>
<senddate>
15/02/2011-11:47
</senddate>
<content>
<![CDATA[Merci   d'avance pour votre aide !]]>
</content>
<status>
UNREAD
</status>
</message>
<mail>
<mailid>2906185099</mailid>
<senddate>15/02/2011-11:46</senddate>
<sender>Rakuten France</sender>
<recipient>vendeur</recipient>
<object><![CDATA[Réclamation   sur votre vente (1551036652) - Service Clients Rakuten France]]></object>
<content><![CDATA[Bonjour   vendeur,
L'acheteur   acheteur19 vient de faire une réclamation concernant votre vente :
Commande :   943796258/9151036652 <   http://fr.shopping.rakuten.com/purchase?action=itemmonitoring&itemid=1510346652   >
Article : Harry   Potter Et Le Prince De Sang-Mêlé - Édition Spéciale 2 Dvd (DVD Zone 2)
Réclamation :   Abimé
Commentaire :   article abimé, pouvez vous me renvoyer un nouvel exemplaire ?
A partir   d'aujourd'hui, 15/02/2011, vous avez 3 jours ouvrés pour trouver un   arrangement amiable directement avec acheteur1. (Notez que pendant cette   période, il est inutile de contacter le Service Clients de Rakuten France.)
Pour répondre à la   réclamation de ACHETEUR1, envoyez-lui un message depuis la page "Suivi   de commande pour cet article <   http://www.pminteg.fr/purchase?action=itemmonitoring&itemid=151036652#item_state_action_block   >".
Pour y accéder à   tout moment, rendez-vous dans la rubrique "Tous mes achats" de   votre compte, puis sur l'article concerné.
Sur cette page,   vous retrouverez également toutes les informations importantes (messages   envoyés et reçus, événements...) concernant cet article.
ACHETEUR1 indique   avoir reçu un article qui n'est pas conforme à votre annonce.
Si vous estimez ne   pas être en mesure de résoudre le problème de l'acheteur (ex. : par un   échange de l'article non conforme, un rabais...), vous aurez la possibilité   d'annuler la vente, toujours depuis la page "Suivi de commande pour cet   article < http://fr.shopping.rakuten.com/purchase?action=itemmonitoring&itemid=1510346652#item_state_action_block   >".
Si vous et votre   acheteur ne trouvez aucune solution au problème après 3 jours ouvrés, le   Service Clients de Rakuten France reprendra en main le traitement de cette   réclamation, et vous contactera directement par e-mail.
Merci de votre   confiance et à bientôt,
Rakuten France <   http://fr.shopping.rakuten.com >
L'Achat-Vente   Garanti]]></content>
<status>UNREAD</status>
</mail>
<itemlog>
<creationdate>15/02/2011-11:46</creationdate>
<itemlogcode>AMICABLE_CLAIM_CREATION</itemlogcode>
<description><![CDATA[ACHETEUR1   a ouvert une réclamation.]]></description>
<complement><![CDATA[Commentaire   :  article abimé, pouvez vous me   renvoyer un nouvel exemplaire ?]]></complement>
</itemlog>
<itemlog>
<creationdate>15/02/2011-11:08</creationdate>
<itemlogcode>ITEM_COMMITTED</itemlogcode>
<description><![CDATA[Vous   avez confirmé la commande et vous êtes engagé(e) à livrer cet article.]]></description>
<complement><![CDATA[]]></complement>
</itemlog>
<itemlog>
<creationdate>15/02/2011-00:08</creationdate>
<itemlogcode>PM_REMIND</itemlogcode>
<description><![CDATA[Un   rappel vous a été envoyé par e-mail pour confirmer la commande.]]></description>
<complement><![CDATA[]]></complement>
</itemlog>
<itemlog>
<creationdate>10/02/2011-14:34</creationdate>
<itemlogcode>ITEM_REQUESTED</itemlogcode>
<description><![CDATA[ACHETEUR1   vous a passé commande pour cet article.]]></description>
<complement><![CDATA[]]></complement>
</itemlog>
</item>
</response>
</getiteminfosresult>

Privacy Preference Center

Privacy Preferences