Confirmer la réception d’une précommande (confirmpreorder)

PHP/JSON

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

Rechercher