1. Prérequis à connaitre pour intéger Rakuten

a. Types & période de publication

Rakuten France dispose de différents types de publication, BeezUP utilisait auparavant les flux CSV transmis en HTTP, et depuis fin 2021 la publication par API au format XML.

Cette publication par API est structurée autour:

des offres - "advert" & "campaigns" chez Rakuten - transmises de manière différentielle (seules les offres mises à jour sont transmises), complète & mise à jour, complète & écrasement (dans la limite de 30 M par export) toutes les 2h.
des produits - "product" & "media" chez Rakuten - transmis de manière complète une fois par jour.

b. Maching, EAN et référence privée

Rakuten France impose l'EAN pour la majorité des catégories ("alias").

Si vos produits appartiennent à l'une des catégories "privées" exemptées suivantes : vêtements, chaussures, mobilier, décoration et bijoux, le champ EAN ne sera pas requis, mais une référence privée "submitterreference" le sera.

⏩ Conséquence: le matching d'offres par EAN n'est également pas possible pour ces catégories, mais est possible pour toutes les autres.

c. Transition depuis la publication HTTP

Si vous utilisiez précédemment la publication vers Rakuten France (ex priceminister) par HTTP depuis BeezUP, quelques points d'attention:

vous devez prévenir le support Rakuten de votre changement de mode de publication
activez la gestion de commandes uniquement sur l'un des 2 Rakuten (HTTP ou API).

Idéalement, pour éviter d'éventuels doublons de commande, assurez-vous de réaliser cette migration lorsque toutes vos commandes liées à Rakuten HTTP sont expédiées.

2. Procédure d’intégration

Créer votre compte PRO ici
Au sein de l’onglet « Réseaux » de BeezUP, ajoutez "Rakuten FRA API".
Procéder à la catégorisation de manière classique, en veillant bien à ne catégoriser que les catégories que vous souhaitez transmettre.
Au sein de l’onglet « Mapping », 2 possibilités:
1. Offres uniquement
  Si vos produits sont déjà connus de Rakuten et n'appartiennent pas aux catégories "privées" (voir pré-requis plus haut), la publication d'offres suffit, et il vous suffit de mapper les champs obligatoires suivants :
  - SKU
  - codebarres
  - state
  - sellingPrice
  - qty
  
  ✖️ Recommandé : le champ "comment" afin d'apporter des précisions publiques sur votre offre.
  ✖️ Optionnel : les champs liés à l'animation commerciale débutant par "productsCampaig" et ceux liés aux modes de livraison (voir plus bas).
2. Création Produits
  Si par contre, vos produits sont inconnus de Rakuten ou appartenant à une catégorie privée, il vous est nécessaire de les créer en renseignant d'une part les attributs offres (voir ci-dessus) et d'autre part à minima l'ensemble des attributs requis pour la ou les catégories cibles.
  Afin de connaître les attributs attendus et leurs éventuelles valeurs associées, rendez-vos sur notre outil dédié et choisissez "Rakuten FR".
  Il est probable dans ce cas, que vous ne disposiez pas de tous les attributs au bon format dans votre flux source, nous vous recommandons donc l'usage des champs personnalisés.
Une fois vos mappings réalisés, rendez-vous sur la page "Paramètres API", renseignez-y :
- vos identifiants API "login" et "Token" que vous pouvez retrouver dans votre espace marchand Rakuten au sein de la section "Paramètres du compte" > "Token" pour le token. Le login est lui le même que celui utilisé pour vos connecter sur Rakuten.
- vos choix de synchronisation : offres / produits / commandes.
- vos paramètres d'auto-acceptation de commandes, si vous activez l'auto-acceptation, afin que BeezUP puisse transmettre automatiquement vos pays d'expédition et d'importation. (voir plus de détail ci-dessous).

✅ Note : Vous pouvez vérifier si vos accès API Rakuten sont bien correctes sur le site webservice Rakuten (point 8) dans le cas où ces derniers ne sont pas accepté sur votre compte BeezUP
Paramétrez vos modes de livraison

Rakuten dispose de 3 options de calcul des frais de port pour vos annonces :

Application de la grille standard Rakuten. (par défaut)
Application d'une grille personnalisée par rapport au poids du produit. (pour configurer la grille, veuillez contacter votre chargé de compte).
Au sein de BeezUP, veuillez simplement veillez à renseigner le poids de vos produits en grammes via le champ "package_weight".
Personnalisation au niveau de chaque annonce par zone géographique et mode de livraison.
Au sein de BeezUP, différents champs sont à votre disposition pour les paramétrer :

FR_NORMAL, FR_SUIVI, FR_RECOMMANDE, FR_EXPRESS_DELIVERY, FR_MONDIAL_RELAY, FR_KIALA, FR_DROM_COM_FR_NORMAL, FR_DROM_COM_FR_RECOMMANDE, EUR_NORMAL, EUR_RECOMMANDE, WORLD_NORMAL, WORLD_RECOMMANDE

⏩ Quelques indications importantes à leur sujet :

- XX_YYYY : permet d'indiquer le montant de frais de port "leader" pour la zone géographique (XX) et le mode de livraison (YYYY) concernés. ex: FR pour France, SUIVI pour Courrier Suivi.
Les frais de port « leader » correspondent aux frais de port appliqués si la commande ne comporte qu’un seul produit ou aux frais de port les plus élevés en cas de commande multi-produits.
Ne peut pas être égal à 0
- XX-YYYY-fw : permet d'indiquer le montant de frais de port "follower" en utilisant la même nomenclature que pour les frais de port "leader".
Les frais de port « follower » correspondent à des frais de port dégressifs s’ajoutant pour chaque produit supplémentaire de la commande.
Peut être égal à 0 (valeur par défaut transmise par BeezUP)
- Les frais de port « leader » doivent être supérieurs ou égaux aux frais de port « follower ».
- Si l’autorisation est activée, un des 3 modes suivant est obligatoire: Recommandé / Express / un mode personnalisé
- Les modes de livraison : Kiala, Express et Mondial Relay nécessitent l’activation de votre chargé de compte commercial et la valeur "false" doit être transmise afin de les désactiver.
- Les modes personnalisés ne sont pas gérés par BeezUP
- Contacter votre chargé de compte Rakuten, si vous souhaitez mettre en place une livraison gratuite.

👉Plus de détails sur le sujet ici

7. Activez le réseau Rakuten FRA API, en fonction de vos options "Paramètres API", vos publications commencent, et vos commandes sont synchronisées. 💪

Bonnes ventes sur Rakuten via BeezUP !

3. Cas particulier des produits avec déclinaisons

Si vos produits possèdent des déclinaisons telles que tailles et/ou couleurs, veillez à bien posséder un flux entrant fidèle aux spécifications indiquées ici.

Si votre flux entrant est fidèle à cette structure, il vous faut :

Mapper le champ "parentage" avec la valeur "child", pour tous vos produits enfant.
Mapper le champ "ParentSKU" à votre champ "ParentID", ou tout autre champ renseignant une valeur en commun à tous les produits d'une même famille.

NB : Les déclinaisons sont réservées aux catégories Vêtements, Maison et jardin et Bijoux.

4. Gestion de commandes

Rakuten, afin de se conformer à la nouvelle réglementation TVA, a décidé d'exiger le pays d'expédition lors de la phase d'acceptation de la commande.

Si vous utilisez la fonctionnalité "Auto accept" pour vos commandes, pensez à vous rendre sur la page "Paramètres API" et à choisir votre pays de livraison par défaut sur le champ "Shipping From Country". Si vous activez la fonctionnalité "Auto accept" et ne sélectionnez pas le pays de livraison par défaut (champ Shipping From Country), des erreurs se produiront lors de la phase d'acceptation de la commande.

Si vous n'utilisez pas l'acceptation automatique des commandes, vous devrez sélectionner le pays d'expédition lors de la phase d'acceptation.