Rapport d’intégration de fichier XML (genericimportreport)

  • 1. Utilisation

    Ce Webservice permet de visualiser l’état de soumission de votre stock à partir du numéro « importid » fourni dans le Webservice précédent (ou visible dans : « Mon compte > Envoyer mes fichiers de stock »)
    Le fichier de stock peut être :<ul>
    <li>Reçu : Reçu</li>
    <li>Traité : Traité</li>
    <li>En attente : En attente</li>
    <li>M.à.j. en cours: Import en cours</li>
    <li>Annulé : Annulé</li>
    <li>Aucune ligne n’a été chargée : Fichier XML corrompu</li>
    </ul>
    Ce Webservice est accessible aux vendeurs professionnels uniquement.

    
    																																															
    
    																																															
  • 2. Url

    https://ws.fr.shopping.rakuten.com/stock_ws?action=genericimportreport&login=xxxxx&pwd=xxxxx&version=xxxx-xx-xx&fileid=xxxxx

    
    																																															
    
    																																															
  • 3. Paramètres

    Nom Description Obligatoire
    action genericimportreport 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
    fileid Numéro du fichier dans la file d’attente (répondu par le précédent Webservice) ou visible dans : « mon compte > Envoyer mes fichiers de stock » Oui
    nexttoken permet de paginer les résultats Non
    
    																																															
    
    																																															
  • 4. XSD

    <a href=”https://www.fr.shopping.rakuten.com/res/schema/genericimportreport/genericimportreport.2017-02-10.xsd” target=”_blank”>https://www.fr.shopping.rakuten.com/res/schema/genericimportreport/genericimportreport.2017-02-10.xsd</a>

    
    																																															
    
    																																															
  • 5. Erreurs possibles

    Type Code Message Detail
    Sender InvalidUserConnection Unknown user or password. Incorrect login or password
    Sender Parameters Error Problem with parameters The version xxx is not supported
    Sender Parameters Error Problem with parameters Could not find the following fileId : xxx

    Ci-dessous les différents codes d’erreur :

    Valeur Description
    10 Fichier XML mal formé
    20 Id Annonce/Produit n’est pas un nombre
    30 Balise <key> ou <value> manquante
    40 Annonce / Produit non trouvé
    50 Plusieurs annonces/produits correspondent
    60 Valeur manquante / non acceptée
    70 Droits insuffisants
    
    																																															
    
    																																															
  • 6. Données de retour

    Valeur Description
    user Login du vendeur
    version Version du webservice utilisé
    fileid Identifiant du fichier envoyé
    successrate Taux de réussite de l’import de stock
    totallines Nombre de lignes dans le fichier
    processedlines Nombre de lignes traitées
    errorlines Nombre de lignes en erreur
    successrate Taux de succès
    Product
    sku Référence privée du vendeur
    status Statut de l’import
    pid Identifiant du produit crée ou modifié
    aid Identifiant de l’annonce crée ou modifié
    errors Liste des erreurs
    Error Erreurs
    error_key Clé de l’attribut en erreur
    error_code Code d’erreur (voir ci-dessus)
    error_text Texte explicatif de l’erreur
    fatal_error Apparait si l’erreur est fatale.

    • Dans le cas d’une création, cela bloque la création
    • Dans le cas d’une modification, les autres modifications seront bloquées
    Images
    imageprocessstatus L’état de l’avancement de l’intégration des images de vos annonces: NONE, IN_PROCESS ou PROCESSED
    imageerrorlist / error La liste des images avec erreur
    urlimg L’URL de l’image avec erreur
    advertid L’id de l’annonce ayant une l’image avec erreur
    detail Le motif pour lequel l’image n’a pas pu être intégrée
    nextoken Nettoken de la page suivante
    
    																																															
    
    																																															
  • 7. Exemple de sortie

    En cas de succès

    <genericimportreportresult xmlns=”http://pmcdn.priceminister.com/res/schema/genericimportreport xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance xsi:schemaLocation=”http://pmcdn.priceminister.com/res/schema/genericimportreport http://pmcdn.priceminister.com/res/schema/genericimportreport/genericimportreport.2011-11-29.xsd>
    <request>
    <user>xxxxxx</user>
    <version>2011-11-29</version>
    <fileid>xxxxxx</fileid>
    </request>
    <response>
    <file>
    <filename>file.xml</filename>
    <status>Traité</status>
    <uploaddate>2012-04-04T11:19:33</uploaddate>
    <processdate>2012-04-04T11:30:56</processdate>
    <totallines>1</totallines>
    <processedlines>1</processedlines>
    <errorlines>0</errorlines>
    <successrate>100%</successrate>
    </file>
    <product>
    <status>Traité</status>
    <sku>mon SKU</sku>
    <pid>1375729</pid>
    <aid>551313383</aid>
    <errors/>
    </product>
    </response>
    </genericimportreportresult>

    En cas d’erreur bloquante

    <genericimportreportresult xmlns=”http://pmcdn.priceminister.com/res/schema/genericimportreport xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance xsi:schemaLocation=”http://pmcdn.priceminister.com/res/schema/genericimportreport http://pmcdn.priceminister.com/res/schema/genericimportreport/genericimportreport.2011-11-29.xsd>
    <request>
    <user>xxxxx</user>
    <version>2011-11-29</version>
    <fileid>xxxxx</fileid>
    </request>
    <response>
    <file>
    <filename>file.xml</filename>
    <status>Traité</status>
    <uploaddate>2012-04-04T11:27:14</uploaddate>
    <processdate>2012-04-04T11:31:02</processdate>
    <totallines>1</totallines>
    <processedlines>0</processedlines>
    <errorlines>1</errorlines>
    <successrate>0%</successrate>
    </file>
    <product>
    <sku>mon SKU</sku>
    <status>Erreur</status>
    <errors>
    <error>
    <error_key>qty</error_key>
    <error_code>60</error_code>
    <error_text>
    <![CDATA[ Saisissez une quantité ]]>
    </error_text>
    <fatal_error/>
    </error>
    </errors>
    </product>
    </response>
    </genericimportreportresult>

    En cas d’erreur non bloquante

    <genericimportreportresult xmlns=”http://pmcdn.priceminister.com/res/schema/genericimportreport xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance xsi:schemaLocation=”http://pmcdn.priceminister.com/res/schema/genericimportreport http://pmcdn.priceminister.com/res/schema/genericimportreport/genericimportreport.2011-11-29.xsd>
    <request>
    <user>xxxxx</user>
    <version>2011-11-29</version>
    <fileid>xxxxx</fileid>
    </request>
    <response>
    <file>
    <filename>file.xml</filename>
    <status>Traité</status>
    <uploaddate>2012-04-04T11:27:14</uploaddate>
    <processdate>2012-04-04T11:31:02</processdate>
    <totallines>1</totallines>
    <processedlines>0</processedlines>
    <errorlines>1</errorlines>
    <successrate>0%</successrate>
    </file>
    <product>
    <sku>mon SKU</sku>
    <status>Erreur</status>
    <errors>
    <error>
    <error_key>qty</error_key>
    <error_code>60</error_code>
    <error_text>
    <![CDATA[ Saisissez un nombre entre 0 et 999 pour le Stock. ]]>
    </error_text>
    </error>
    </errors>
    </product>
    </response>
    </genericimportreportresult>

    En cas d’erreur d’image

    <genericimportreportresult xmlns=”https://pmcdn.staticpmrk.com/res/schema/genericimportreport xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance xsi:schemaLocation=”https://pmcdn.staticpmrk.com/res/schema/genericimportreport https://pmcdn.staticpmrk.com/res/schema/genericimportreport/genericimportreport.2017-02-10.xsd>
    <request>
    <user>mylogin</user>
    <version>2017-02-10</version>
    <fileid>573556693</fileid>
    </request>
    <response>
    <file>
    <filename>mystockfile20170322T120205.xml</filename>
    <status>Traité</status>
    <uploaddate>2017-03-22T12:02:05</uploaddate>
    <processdate>2017-03-22T12:03:35</processdate>
    <totallines>1</totallines>
    <processedlines>1</processedlines>
    <errorlines>0</errorlines>
    <successrate>100%</successrate>
    <imageprocessstatus> PROCESSED </imageprocessstatus>
    <imageerrorlist>
    <error>
    <urlimg>http://www.mywebsite.com/1295-large_default/store-bateau-tamisant-suedine.jpg</urlimg>
    <advertid>2682901683</advertid>
    <detail>Images à retraiter : http://www.mywebsite.com/1295-large_default/store-bateau-tamisant-suedine.jpg: L’URL indiquée ne pointe pas vers une image: com.priceminister.tools.images.exceptions.ImageUtilityBadResponseCodeException – Nombre dessais maximum atteint pour cette ligne.</detail>
    </error>
    </imageerrorlist>
    </file>
    <product>
    <sku>
    <![CDATA[ TShiuu8fNoir ]]>
    </sku>
    <status>Traité</status>
    <pid>1924665240</pid>
    <aid>2682901683</aid>
    <errors> </errors>
    </product>
    </response>
    </genericimportreportresult>
    
    																																															
    
    																																															

Privacy Preference Center