API : Purchase Order

Usage de la commande Puchase Order

La commande Purchase Order permet la transmission des données d'une commande fournisseur ou commande d'achat à PMS. Cette commande apparaîtra dans PMS en tant qu'attendu de réception.

La commande Purchase Order permet de

  1. transmettre une première fois (action=CREATE).
  2. retransmettre (action=REPLACE).
  3. annuler (action=CANCEL).

 

Vous devriez mettre en place deux modes de fonctionnement dans votre ERP :

  1. La transmission automatique d'une commande fournisseur. Exemple : transmission de la commande lors du passage en statut "En attente de réception".
  2. La transmission à la demande de l'utilisateur via l'interface utilisateur.

Exemple de requête


<purchase_order>
	<AccountName>beautyshop</AccountName>
    <Action>Create</Action>
	<PurchaseOrderId>451566</PurchaseOrderId>
	<PurchaseOrderSupplierRef>999789</PurchaseOrderSupplierRef>
	<PurchaseOrderDate>2013-06-04</PurchaseOrderDate>
	<ExpectedDate>2013-06-04</ExpectedDate>
	<SupplierId>154</SupplierId>
	<SupplierName>Distribution du Sud SAS</SupplierName>
	<WarehouseId>1</WarehouseId>
	<status>1</status>
	<PurchaseOrderTitle>999789</PurchaseOrderTitle>
	<products>
  		<product>
			<Sku>125452</Sku>
			<Quantity>1</Quantity>
			<UnitPurchasePrice>19.99</UnitPurchasePrice>
		</product>
		<product>
			<Sku>9458454</Sku>
			<Quantity>2</Quantity>
			<UnitPurchasePrice>19.99</UnitPurchasePrice>
		</product>
	</products>
</purchase_order>

Champs de données

Champs <purchase_order>

Champ Obligatoire Description
AccountName Oui Votre identifiant de compte PMS
Action Oui « Create » (par défaut si vide). Attention : si la commande existe déjà, l'action est ignorée. « Replace » : annule et remplace. Attention : si la commande est déjà expédiée, cette action est ignorée. « Test » : pour tester la requête, équivalent à Create mais n'affecte pas la base de données « Cancel » : désactive la commande (pour recréer la commande avec le même OrderId, utilisez « Replace »)
PurchaseOrderId Oui Id / référence de la commande dans votre ERP
PurchaseOrderSupplierRef Non Référence attribuée par le fournisseur à la commande.
PurchaseOrderDate Non Date de commande (YYYY-MM-DD)
ExpectedDate Non Date de livraison prévisionnelle (YYYY-MM-DD)
SupplierId Oui Id / référence du fournisseur dans votre ERP
SupplierName Non Nom du fournisseur
WarehouseId Non Id / référence de l'entrepôt destinataire
status Non id du statut PMS (1 = En attente, 90 = Terminée, même si non réceptionnée complètement, 99 = Annulée)
PurchaseOrderTitle Non Intitulé de la commande.

Champs <purchase_order> <products> <product>

Champ Obligatoire Description
Sku Oui Identifiant unique pour chaque article
Quantity Oui Quantité
UnitPurchasePrice Non Prix d'achat unitaire (ex : 29.99)

Réponse


<response>error:duplicate</response>
Réponse Description
ok Opération réussie
error:duplicate Création non réalisée : la commande existe déjà
error:locked Action Replace ou Cancel non réalisée : le statut de la commande d'origine ne permet pas de l'annuler (commande déjà expédiée par exemple)
error:unvailable Service non disponible, essayez ultérieurement
error:missing sku Sku manquant sur l'un des articles