Rapport d’intégration de fichier CSV/TXT (importreport)

  • 1. Utilisation

    Ce webservice permet de visualiser l’état de soumission de votre stock et de vos images à partir du numéro « importid » fourni dans le précédent Webservice (ou visible dans : « mon compte > Envoyer mes fichiers de stock »)

     

    Le fichier de stock peut être :

    Statut Signification Cas d’utilisation ok ? Statut Final ?
    ABORTED Annulé Le traitement a été annulé Non Oui
    CLOSING_ADVERTS Fermeture d’annonces Ecrasement ou fermeture de stock Oui Non
    DELETED Supprimé Rakuten France (ou le marchand dans son interface) a supprimé son fichier Non Oui
    FAILURE Le fichier n’est pas chargé totalement Echec partiel du chargement de données Non Oui
    FATAL_ERROR Erreur Erreur applicatif Non Oui
    LOAD_FAILED Aucune ligne n’a été chargée Echec total du chargement de données Non Oui
    LOADED En attente Ok, étape 2 Oui Non
    LOADING Chargement de données Ok, étape 1 Oui Non
    ON_HOLD Import interrompu En pause Non Non
    PROCESS_FAILED Trop d’erreurs Non Oui
    PROCESSED Traité ok, étape 4 Oui Oui
    PROCESSING Mise à jour en cours ok, étape 3 Oui Non
    RE_LOADED En attente de retraitement Non Non
    RESET A retraiter – Le fichier doit être retraité Rakuten France a lancé le retraitement du fichier Non Non
    UNDO A défaire – Défaire l’import En cours de rollback Non Non
    UNDONE Défait Rollback terminé Non Oui

    Ce Webservice est accessible aux vendeurs professionnels.

  • 2. URL

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

  • 3. Paramètres

    Nom Description Obligatoire
    action importreport Oui
    login login du vendeur Oui
    pwd Token d’identification 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 le rapport Non

  • 4. XSD

    https://www.fr.shopping.rakuten.com/res/schema/importreport/importreport.2017-02-10.xsd

  • 5. Erreurs Possibles

    Type Code Message Detail
    Sender Parameters Error Problem with parameters The parameter login is mandatory
    Sender Parameters Error Problem with parameters The parameter pwd is mandatory
    Sender Parameters Error Problem with parameters The parameter version is mandatory
    Sender Parameters Error Problem with parameters The parameter fileid is mandatory

  • 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
    importtype Type d’import
    filename Nom du fichier uploadé
    uploaddate
    processdate
    processstatus
    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
    skippedlines Nombre de lignes non traitées
    defautprice Paramètre de votre import – valeur de prix par défaut si le prix n’est pas renseigné (paramètre disponible dans “mon compte > Envoyer mes fichiers de stock”)
    defaultquality Paramètre de votre import – valeur de l’état par défaut si l’état n’est pas renseigné (paramètre disponible dans “mon compte > Envoyer mes fichiers de stock”)
    referencetype Type de référence pour le matching des produits / annonces
    separator Séparateur utilisé dans le fichier d’import
    errorlist Une liste de balises “error” contenant chacune une ligne en erreur de votre fichier
    errorreport Le type d’erreur
    data Un rappel du contenu de la ligne en erreur
    imageprocessstatus L’état de l’avancement de l’intégration des images de vos annonces: NONE, IN_PROCESS ou PROCESSED
    imageerrorlist 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

  • 7. Exemple de sortie 

    <?xml version="1.0" encoding="ISO-8859-1"?>
<importreportresult xmlns="http://www.fr.shopping.rakuten.com/res/schema/importreport" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.fr.shopping.rakuten.com/res/schema/importreport http://www.fr.shopping.rakuten.com/res/schema/importreport/importreport.2010-11-02.xsd">
<request>
<user> vendeur </user>
<version>2010-11-02</version>
<fileid>116519595</fileid>
</request>
<response>
<nexttoken>51699609599</nexttoken>
<importtype>M.à.j./création annonces</importtype>
<filename>ADD_xxx_01022011_113956.txt.pm</filename>
<uploaddate>2011-02-01T12:18:24</uploaddate>
<processdate>2011-02-01T12:22:57</processdate>
<processstatus>PROCESSED</processstatus>
<successrate>99 %</successrate>
<totallines>5155</totallines>
<processedlines>5153</processedlines>
<errorlines>2</errorlines>
<skippedlines>0</skippedlines>
<defaultprice/>
<defaultquality/>
<adjusttobestprice/>
<referencetype>STANDARD</referencetype>
<separator><![CDATA[;]]></separator>
<errorlist>
<error>
<errorreport><![CDATA[Aucune annonce dans votre inventaire ne correspond aux critères de recherche.]]></errorreport>
<data><![CDATA[*;9780744011999;]]></data>
</error>
<error>
<errorreport><![CDATA[Aucune annonce dans votre inventaire ne correspond aux critères de recherche.]]></errorreport>
<data><![CDATA[*;9782874424809;]]></data>
</error>
</errorlist>
<imageprocessstatus>PROCESSED</imageprocessstatus>
<imageerrorlist>
<error>
<urlimg>
http://www.mywebsite.com/1295-large_default/store-bateau-tamisant-suedine.jpg
</urlimg>
<advertid>2681327160</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>
<error>
<urlimg>
http://www.mywebsite.com/1295-large_default/store-bateau-tamisant-suedine.jpg
</urlimg>
<advertid>2681327159</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>
</response>
</importreportresult>

Privacy Preference Center

Privacy Preferences