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

    IMPORTANT : 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)

    Vous pouvez également envoyer votre fichier en « écrasement » en rajoutant le paramétrage « &purgeandreplace=true » à la fin de l’URL ce qui remplace tout votre inventaire par le contenu du fichier envoyé.

    Cette option d’écrasement n’est possible qu’une seule fois par 24 heures.

    Exemple:

    IMPORTANT: Pour le mode « purgeandreplace » veuillez faire une requête GET pour les variables action=genericimportfile & purgeandreplace=true = > [formulaire de test]

    
																								
    <errorresponse xmlns=”https://static.fr.shopping.rakuten.com/res/schema/error“ xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance“ xsi:schemaLocation=”https://static.fr.shopping.rakuten.com/res/schema/error https://static.fr.shopping.rakuten.com/res/schema/error/error.xsd“>
    

    

    

    <error>
    

    

    <type>ServerError</type>
    

    <code>ServerError</code>
    

    <message>Server not able to fullfill request.</message>
    

    

    <details>
    

    

    

    <detail>
    

    

    <![CDATA[ An error occurred while submitting the file ]]>
    

    

    </detail>
    

    

    

    </details>
    

    

    

    </error>
    

    

    

    </errorresponse>
    
																							
    
																								
    <errorresponse xmlns=”https://static.fr.shopping.rakuten.com/res/schema/error“ xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance“ xsi:schemaLocation=”https://static.fr.shopping.rakuten.com/res/schema/error https://static.fr.shopping.rakuten.com/res/schema/error/error.xsd“>
    

    

    

    <error>
    

    

    <type>ServerError</type>
    

    <code>ServerError</code>
    

    <message>Server not able to fullfill request.</message>
    

    

    <details>
    

    

    

    <detail>
    

    

    <![CDATA[ An error occurred while submitting the file ]]>
    

    

    </detail>
    

    

    

    </details>
    

    

    

    </error>
    

    

    

    </errorresponse>

  • 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 à utiliser
    Oui
    Cliquer ici pour voir le dernier numéro de version
    file
    		 Le fichier en tant que tel
    Oui
    Voir la page Comment construire son fichier XML ?

  • 4. XSD

    https://www.fr.shopping.rakuten.com/res/schema/genericimportfile/genericimportfile.2015-02-02.xsd

    
																								
    <xs:schema xmlns:xs=”http://www.w3.org/2001/XMLSchema“ xmlns:ns=”https://static.fr.shopping.rakuten.com/res/schema/genericimportfile“ elementFormDefault=”qualified“ targetNamespace=”https://static.fr.shopping.rakuten.com/res/schema/genericimportfile“>
    

    

    

    <xs:element name=”importresult“>
    

    

    

    <xs:annotation>
    

    

    

    <xs:documentation>
    

    

    <![CDATA[ This service allows you to import a stock file. If the call succeeds, you will get an element ‘request’ that lists the parameters you have passed in your call, as well as an element ‘response’, containing the data requested. If the call fails, you will get an error message that uses a standard XML structure common to all priceminister webservices. You can get the schema for the error response here: https://static.fr.shopping.rakuten.com/res/schema/error/error.xsd ]]>
    

    

    </xs:documentation>
    

    

    

    </xs:annotation>
    

    

    

    <xs:complexType>
    

    

    

    <xs:sequence>
    

    

    <xs:element name=”request“ type=”ns:RequestType“/>
    

    <xs:element name=”response“ type=”ns:ResponseType“/>
    

    

    </xs:sequence>
    

    

    

    </xs:complexType>
    

    

    

    </xs:element>
    

    

    

    <xs:complexType name=”RequestType“>
    

    

    

    <xs:sequence>
    

    

    

    <xs:element name=”user“ type=”xs:string“>
    

    

    

    <xs:annotation>
    

    

    

    <xs:documentation>
    

    

    <![CDATA[ The login used to request the webservice. ]]>
    

    

    </xs:documentation>
    

    

    

    </xs:annotation>
    

    

    

    </xs:element>
    

    

    

    <xs:element name=”scope“ type=”ns:ScopeType“ minOccurs=”0“ maxOccurs=”1“>
    

    

    

    <xs:annotation>
    

    

    

    <xs:documentation>
    

    

    <![CDATA[ Use scope “CREATION” to create adverts or products. Use scope “UPDATE” to update adverts or products. ]]>
    

    

    </xs:documentation>
    

    

    

    </xs:annotation>
    

    

    

    </xs:element>
    

    

    

    <xs:element name=”version“ type=”xs:string“>
    

    

    

    <xs:annotation>
    

    

    

    <xs:documentation>
    

    

    <![CDATA[ The webservice version: YYYY-MM-DD. ]]>
    

    

    </xs:documentation>
    

    

    

    </xs:annotation>
    

    

    

    </xs:element>
    

    

    

    </xs:sequence>
    

    

    

    </xs:complexType>
    

    

    

    <xs:complexType name=”ResponseType“>
    

    

    

    <xs:sequence>
    

    

    

    <xs:element name=”importid“ type=”xs:long“>
    

    

    

    <xs:annotation>
    

    

    

    <xs:documentation>
    

    

    <![CDATA[ The id of the imported file, which can be used to access to the import report. ]]>
    

    

    </xs:documentation>
    

    

    

    </xs:annotation>
    

    

    

    </xs:element>
    

    

    

    <xs:element name=”status“ type=”xs:string“>
    

    

    

    <xs:annotation>
    

    

    

    <xs:documentation>
    

    

    <![CDATA[ The status of the import. “OK” means the file has been correctly uploaded. ]]>
    

    

    </xs:documentation>
    

    

    

    </xs:annotation>
    

    

    

    </xs:element>
    

    

    

    </xs:sequence>
    

    

    

    </xs:complexType>
    

    

    

    <xs:simpleType name=”ScopeType“>
    

    

    

    <xs:restriction base=”xs:string“>
    

    

    <xs:enumeration value=”CREATION“/>
    

    <xs:enumeration value=”UPDATE“/>
    

    

    </xs:restriction>
    

    

    

    </xs:simpleType>
    

    

    

    </xs:schema>

  • 5. Erreurs possible

    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

Privacy Preference Center

Privacy Preferences