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
- transmettre une première fois (action=CREATE).
- retransmettre (action=REPLACE).
- annuler (action=CANCEL).
Vous devriez mettre en place deux modes de fonctionnement dans votre ERP :
- La transmission automatique d'une commande fournisseur. Exemple : transmission de la commande lors du passage en statut "En attente de réception".
- 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 |