Intégrer son flux XML (genericImportfile)

  • 1. Utilisation

    Ce Webservice permet d’envoyer des fichiers de stock (Produits / Annonces / Médias) sur la plateforme Rakuten France. Ce fichier doit être au format XML.
    Vous devez créer ce fichier à partir des 2 Webservices précédents.
    Ce Webservice est accessible uniquement aux vendeurs professionnels.

  • 2. URL

    https://ws.fr.shopping.rakuten.com/stock_ws?action=genericimportfile&login=xxxxxx&pwd=xxxxxx&version=xxxx-xx-xx
    <p>&nbsp;</p>
    <strong>IMPORTANT</strong> : Il faut transmettre le fichier d’import de stock en POST / multiPart.
    (Par exemple, en simulant l’envoi d’un formulaire HTML en POST, ou en utilisant des fonctions java, PHP, Curl … d’upload en MultiPart de fichiers)<h2></h2>Vous pouvez également envoyer votre fichier en “écrasement” en rajoutant le paramétrage “<strong>&purgeandreplace=true</strong>” à la fin de l’URL ce qui remplace tout votre inventaire par le contenu du fichier envoyé.<br />Cette option d’écrasement <strong>n’est possible qu’une seule fois par 24 heures</strong>.<h3></h3>

    Exemple:<br />

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

    <p><span style=”background-color: #ffff99;”><strong>IMPORTANT: Pour le mode “purgeandreplace” veuillez faire une requête GET pour les variables action=genericimportfile & purgeandreplace=true</strong></span> = > <a target=”_blank” href=”https://developer.fr.shopping.rakuten.com/blog/wp-content/uploads/2020/04/imports_generiques_PurgeAndReplace_sample.htm”><strong>[formulaire de test]</strong></a></p>

  • 3. Paramètres

    Nom Description Obligatoire
    action genericimportfile 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 à utiliserCliquer ici pour voir le dernier numéro de version Oui
    file Le fichier en tant que tel
    Voir la page Comment construire son fichier XML ?    		 Oui

  • 4. XSD

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

  • 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 request must contain a file to be accepted
    Sender InvalidUserRights Problem with user rights The user xxxxx is not allowed to use this web service.

  • 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
    User Login du marchand
    version Version du webservice appelé
    importid Id du « fichier d’import » dans la file d’attente d’import de stock Rakuten France
    status Status du fichier reçu

  • 7. Exemples de sortie

    En cas de succès

    <importresult xmlns=”http://pmcdn.priceminister.com/res/schema/genericimportfile“ xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance“ xsi:schemaLocation=”http://pmcdn.priceminister.com/res/schema/genericimportfile http://pmcdn.priceminister.com/res/schema/genericimportfile/genericimportfile.2012-09-11.xsd“>
    <request>
    <user>xxxxx</user>
    <version>2012-09-11</version>
    </request>
    <response>
    <importid>35826776</importid>
    <status>OK</status>
    </response>
    </importresult>

     

    En cas d’erreur

    <errorresponse xmlns=”http://pmcdn.priceminister.com/res/schema/error“ xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance“ xsi:schemaLocation=”http://pmcdn.priceminister.com/res/schema/error http://pmcdn.priceminister.com/res/schema/error/error.xsd“>
    <error>
    <type>Sender</type>
    <code>ParameterError</code>
    <message>Problem with parameters.</message>
    <details>
    <detail>
    <![CDATA[ The request must contain a file to be accepted ]]>
    </detail>
    </details>
    </error>
    </errorresponse>

     

Privacy Preference Center

Privacy Preferences