- Informations générales
- Identification par token
- Versions
- Gestion de stock
- Rapport d’intégration de fichier XML (genericimportreport)
- Intégrer son flux XML (genericImportfile)
- Modèle produits (producttypetemplate)
- Types de produits (producttypes)
- Click and Collect
- Produits se déclinant par couleur et taille
- Lister les modes de livraison disponibles (getavailableshippingtypes)
- Construire un fichier en XML pour la création et mise à jour d’annonces
- Export d’inventaire (export)
- Rapport d’intégration de fichier CSV/TXT (importreport)
- Purge d’une campagne (purge_campaign)
- Configurer vos promotions à l’aide de fichiers CSV
- Intégrer son flux CSV/TXT (import)
Nouvelles Ventes
Aprés L'acceptation d'une vente- Confirmer la réception d’une précommande (confirmpreorder)
- Traitement des ventes après leur confirmation (getitemtodolist)
- Annulation post acceptation (cancelitem)
- Envoyer / répondre à un mail du SAV (contactusaboutitem)
- Obtenir les informations de livraison (getshippinginformation)
- Confirmer l’envoi des commandes (importitemshippingstatus)
- Envoyer le numéro de tracking (settrackingpackageinfos)
- Récupérer le détail des éléments liés à un article (getiteminfos)
- Liste des commandes en cours (getcurrentsales)
- Récupérer les éléments comptables d’un panier donné (getbillinginformation)
- Envoi d’un message post vente à l’acheteur (contactuseraboutItem)
Données produits- Comptabilité
Modèle produits (producttypetemplate)
-
1. Utilisation
Ce Webservice sert à lire l’ensemble des attributs produit/annonce/média pour un type de produit. Les types de produits sont fournis grâce au Webservice précédent <a href=”?page_id=1781″>ProductTypes</a>. Ces attributs (et les valeurs associées) servent à créer le flux XML de vos produits.
Afin d’activer les “descriptions d’annonces personnalisées”, et les “campagnes de soldes et de promotions” sur votre compte, merci de contacter notre service commercial à l’adresse <a href=”mailto:infopro@priceminister.com”>infopro@priceminister.com</a>.
Ce Webservice est accessible uniquement aux vendeurs professionnels.
-
2. URL
https://ws.fr.shopping.rakuten.com/stock_ws?action=producttypetemplate&login=xxxxx&pwd=xxxxx&version=xxxx-xx-xx&alias=xxx
-
3. Paramètres
Nom Description Obligatoire action producttypetemplate 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 alias Type de produit Rakuten France fourni par le Webservice «ProductTypes » Oui scope Valeurs disponibles : - « Sans valeur » : on récupère la liste des attributs sans leur valeur
- VALUES : on récupère la liste des attributs et leurs valeurs obligatoires (pour les attributs ayant des valeurs – visibles par la balise <havalues>)
Non -
4. XSD
<a href=”https://www.fr.shopping.rakuten.com/res/schema/producttypetemplate/producttypetemplate.2017-10-04.xsd” target=”_blank”>https://www.fr.shopping.rakuten.com/res/schema/producttypetemplate/producttypetemplate.2017-10-04.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 Could not find the model corresponding to the form alias -
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 Alias Alias du type de produit recherché Version Version du webservice appelé Response Prdtypelabel Libellé du type de produit Updatedate Date de dernière modification du modèle Attributes Liste des attributs product / advert / media / campaigns Indique les attributs produits / annonces / images ou campagne Label Libellé de l’attribut Key Clé de l’attribut Mandatory Indique si l’attribut est obligatoire pour la création Valuetype Type de l’attribut Multivalued Indique si l’attribut peut recevoir plusieurs valeurs Hasvalues Indique si l’attribut a une liste fermée de valeurs Valueslist Liste des valeurs de cet attribut Units Liste des unités pour certains attributs Unit Unité de valeur shipping Données concernant vos frais de port.
La structure décrite ici est la structure exacte que vous pouvez avoir dans votre flux XMLshipped_by_rsl Item envoyé par le service Rakuten Super Logistic (nécessite une activation de votre chargé de compte commercial) package_weight Poids du colis configuration / zone … Frais de port personnalisé par annonce (nécessite une activation de votre chargé de compte commercial) pickupStores Données concernant le retrait en magasin. Cette structure s’affiche uniquement si votre compte est éligible. Si vous souhaitez en bénéficier, vous devez contacter votre chargé de compte.
La structure décrite ici est la structure exacte que vous pouvez avoir dans votre flux XMLpickupStore Indique les attributs associés à la fonctionnalité “retrait en magasin” (Click and Collect) pickupStoreId ID alphanumérique de votre magasin physique qty Disponibilité du produit dans votre magasin physique. Cette disponibilité peut différer de celle spécifié pour l’envoi du colis par transporteur -
7. Exemple de sortie
<?xml version=”1.0″ encoding=”ISO-8859-1″?>
<producttypetemplateresult xmlns=”https://pmcdn.staticpmrk.com/res/schema/producttypetemplate”
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
xsi:schemaLocation=”https://pmcdn.staticpmrk.com/res/schema/producttypetemplate https://pmcdn.staticpmrk.com/res/schema/producttypetemplate/producttypetemplate.2017-10-04.xsd”>
<request>
<user>xxxxxxx</user>
<alias>vetement</alias><version>2017-10-04</version>
</request>
<response>
<prdtypelabel>Vêtements</prdtypelabel><updatedate>2014-08-06T00:00:00</updatedate>
<attributes>
<product>
<attribute>
<label>Identification produit</label>
<key>pid</key>
<mandatory>0</mandatory>
<valuetype>Number</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Référence privée</label>
<key>submitterreference</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Public</label>
<key>varpublic</key>
<mandatory>1</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Type de vêtement</label>
<key>garmentType</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Coupe</label>
<key>garmentCut</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Motif</label>
<key>garmentPattern</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>1</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Coupe</label>
<key>modele</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Marque</label>
<key>manufacturer</key>
<mandatory>1</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Utilisation</label>
<key>prdUseDomain</key>
<mandatory>1</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Type de sport</label>
<key>sportType</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Modèle</label>
<key>design</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Matière</label>
<key>fabricclothes</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Fait main</label>
<key>faitmain</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>1</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Vintage</label>
<key>vintage</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>1</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Descriptif détaillé de votre produit</label>
<key>prdEdito</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Titre de votre annonce</label>
<key>title</key>
<mandatory>1</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Prix d'origine</label>
<key>originalPrice</key>
<mandatory>0</mandatory>
<valuetype>Number</valuetype><units>
<unit>&euro;</unit>
</units>
<multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
</product>
<advert>
<attribute>
<label>Identification annonce</label>
<key>aid</key>
<mandatory>0</mandatory>
<valuetype>Number</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Taille</label>
<key>size</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Couleur</label>
<key>color</key>
<mandatory>1</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Etat du produit</label>
<key>state</key>
<mandatory>1</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Ajoutez un commentaire sur cet article pour augmenter vos chances de le vendre</label>
<key>comment</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Prix de vente</label>
<key>sellingPrice</key>
<mandatory>1</mandatory>
<valuetype>Number</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Stock illimité</label>
<key>qtyUnlimited</key>
<mandatory>0</mandatory>
<valuetype>Boolean</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Quantité</label>
<key>qty</key>
<mandatory>1</mandatory>
<valuetype>Number</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Référence fabricant</label>
<key>mpnVariant</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>EAN (code barre)</label>
<key>eanVariant</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Modes de livraison</label>
<key>shipping</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>1</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Code Postal</label>
<key>zipcode</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>1</hasvalues></attribute>
<attribute>
<label>Téléphone</label>
<key>phoneNumber</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Votre référence cachée</label>
<key>sellerReference</key>
<mandatory>1</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Votre commentaire caché</label>
<key>privateComment</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
<attribute>
<label>Description personnalisée</label>
<key>customizedAdvertDetail</key>
<mandatory>0</mandatory>
<valuetype>Text</valuetype><multivalued>0</multivalued>
<hasvalues>0</hasvalues></attribute>
</advert>
<media>
<attribute>
<label>url image</label>
<key>image_url</key>
<mandatory>1</mandatory>
<valuetype>Text</valuetype>
<multivalued>0</multivalued>
<hasvalues>0</hasvalues>
</attribute>
</media><campaigns>
<campaign><attribute>
<label>Identifiant de la campagne</label>
<key>productsCampaignId</key>
<mandatory>0</mandatory>
<valuetype>Number</valuetype>
<multivalued>0</multivalued>
<hasvalues>0</hasvalues>
</attribute><attribute>
<label>Prix de référence</label>
<key>productsCampaignRefPrice</key>
<mandatory>0</mandatory>
<valuetype>Number</valuetype>
<multivalued>0</multivalued>
<hasvalues>0</hasvalues>
</attribute><attribute>
<label>Pourcentage de réduction</label>
<key>productsCampaignPct</key>
<mandatory>0</mandatory>
<valuetype>Number</valuetype>
<multivalued>0</multivalued>
<hasvalues>0</hasvalues>
</attribute><attribute>
<label>Prix “promo”</label>
<key>productsCampaignPrice</key>
<mandatory>0</mandatory>
<valuetype>Number</valuetype>
<multivalued>0</multivalued>
<hasvalues>0</hasvalues>
</attribute></campaign>
</campaigns>
<shipping>
<shipped_by_rsl>1</shipped_by_rsl>
<package_weight>30</package_weight>
<configuration>
<zone>
<name>WORLD</name>
<type>
<name>NORMAL</name>
<authorization>1</authorization>
<leader_price>44.44</leader_price>
<follower_price>33.33</follower_price>
</type>
<type>
<name>RECOMMANDE</name>
<authorization>1</authorization>
<leader_price>22.22</leader_price>
<follower_price>11.11</follower_price>
</type>
</zone>
<zone>
<name>EUROPE</name>
<type>
<name>NORMAL</name>
<authorization>1</authorization>
<leader_price>88.88</leader_price>
<follower_price>77.77</follower_price>
</type>
<type>
<name>RECOMMANDE</name>
<authorization>1</authorization>
<leader_price>66.66</leader_price>
<follower_price>55.55</follower_price>
</type>
</zone>
<zone>
<name>FRANCE_DROM_COM</name>
<type>
<name>NORMAL</name>
<authorization>1</authorization>
<leader_price>22.22</leader_price>
<follower_price>14.44</follower_price>
</type>
<type>
<name>RECOMMANDE</name>
<authorization>1</authorization>
<leader_price>10.40</leader_price>
<follower_price>99.99</follower_price>
</type>
</zone>
<zone>
<name>FRANCE</name>
<type>
<name>NORMAL</name>
<authorization>1</authorization>
<leader_price>33.33</leader_price>
<follower_price>44.44</follower_price>
</type>
<type>
<name>SUIVI</name>
<authorization>0</authorization>
</type>
<type>
<name>RECOMMANDE</name>
<authorization>1</authorization>
<leader_price>55.55</leader_price>
<follower_price>11.11</follower_price>
</type>
<type>
<name>EXPRESS_DELIVERY</name>
<authorization>1</authorization>
<leader_price>66.66</leader_price>
<follower_price>22.22</follower_price>
</type>
</zone>
</configuration>
</shipping><pickupStores>
<pickupStore>
<pickupStoreId>A1</pickupStoreId>
<qty>3</qty>
</pickupStore>
<pickupStore>
<pickupStoreId>B2</pickupStoreId>
<qty>7</qty>
</pickupStore>
<pickupStore>
<pickupStoreId>K6</pickupStoreId>
<qty>2</qty>
</pickupStore>
</pickupStores></attributes>
</response>
</producttypetemplateresult>