Webservices Rakuten-PriceMinister

pictoConfirmer la réception d’une précommande (ConfirmPreorder)

1. Utilisation

Ce webservice sert à confirmer une précommande sur un article, une fois le stock reçu.

 

Cela enclenche :

  • La capture des cartes bleues
  • Un changement de statut sur les commandes sélectionnées
  • Un envoi d’email à tous les clients concernés

 

Cas d’utilisation :

  • Je suis un vendeur, j’ai 4 précommandes en attente. J’appelle le ws avec le stock à 3.
    Le WS répond « OK : 1 remaining item(s) »
  • Je suis un vendeur, j’ai 4 précommandes en attente dont 3 en cours de traitement (un stock a déjà été entré mais les précommandes attendent le passage du batch de confirmation).
    Le WS répond « KO : Items are being processed »

2. Url

https://ws.fr.shopping.rakuten.com/sales_ws?action=confirmpreorder&login=xxxxx&pwd=xxxxx&version=xxxx-xx-xx&advertid=xxxx&stock=xxxx

3. Paramètres

Nom Description Obligatoire
action confirmpreorder 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
Cliquer ici pour voir le dernier numéro de version
Oui
advertid Identifiant de l’annonce.
L’advertID est disponible dans l’export d’inventaire.
Oui
stock nombre de précommandes reçues Oui

4. XSD

https://www.fr.shopping.rakuten.com/res/schema/confirmpreorder/confirmpreorder.2013-01-09.xsd

5. Erreurs possibles

Type Code Message Détail
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 InvalidUserRights Problem with user rights The user nickname is not allowed to use web services.
Sender InvalidUserConnection User is from another country The user ‘XXX’ is not from this platform
Sender Parameters Error Problem with parameters The parameter advertid is mandatory
Sender Parameters Error Problem with parameters The parameter advertid is invalid
Sender Parameters Error Problem with parameters The advertid does not exist

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
statut Message de retour de la confirmation, commençant par

  • OK, si tout s’est bien passé
  • KO, s’il y a une erreur

7. Exemple de sortie

Ouvrir

8. Tester le Webservice

Paramètres Valeur
Destination
Login
Token
Version
advertid
stock

9. FAQ

ConfirmPreorder

Comment retrouver l’advertid de mes annonces ?

L’advertid est l’identifiant unique de nos annonces sur Rakuten France.
Cet identifiant est disponible

Que se passe t il après l’appel du webservice « ConfirmPreorder » ?

Après l’appel du webservice « confirmpreorder », les commandes vont changer de statuts :

  • Les commandes restent en statut PENDING quelques minutes. Pendant ce temps là, Rakuten France va essayer de prélever les cartes de crédit des clients.
  • Les commandes dont les cartes de crédit ont été débitées avec succès passeront en statut ACCEPTED. Le workflow passe ensuite dans un chemin normal.
  • Les commandes dont les cartes de crédit n’ont pas été débitées passeront en statut CANCELLED.

Pour suivre l’évolution des statuts des commandes, utiliser le webservice GetCurrentSales.
Pour suivre vérifier qu’une commande est annulée, voir le webservice GetItemInfos.
Pour plus d’informations concernant les statuts de commandes, consulter cette page.