Votre ERP peut être notifié par PMS des réceptions de marchandises.
Fonctionnement
- Les messages sont envoyés à votre serveur par une requête HTTP POST sur une URL que vous aurez définie.
- Vous devez créer sur votre serveur le script qui traitera la requête envoyée à cette URL.
- Le contenu des messages et de la réponse est structuré en XML, encodage UTF8.
- La chaîne XML est placée dans la variable POST nommée
xml_feed
.
- Renseignez l'URL dans PMS dans
Réglages
, paramètre URL destinataire des avis de réception
.
CSV : si vous préférez obtenir un fichier CSV mis à disposition dans le dossier /outbox de votre espace FTP PMS, renseignez l'url https://votredomainepms/edi/api_to_flat.php
dans le paramètre URL destinataire des avis de réception
dans Réglages
Exemple de script en PHP
Lire le message XML avec la classe SimpleXMLElement:
$xml = new SimpleXMLElement($_POST['xml_feed']);
if ($xml->getName() == "receipt")
{
if ($xml->receipt_id > 0)
{
/* action à effectuer */
}
}
Exemple de message
<receipt>
<receipt_id>5</receipt_id>
<receipt_ref>459885</receipt_ref>
<receipt_supplier_ref>BL45744</receipt_supplier_ref>
<inhouse_date>2020-10-01</inhouse_date>
<close_date>2020-10-01</close_date>
<WarehouseId>1</WarehouseId>
<purchase_order>
<PurchaseOrderId>451566</PurchaseOrderId>
<products>
<product>
<Sku>125452</Sku>
<quantity>1</quantity>
<Ean>3350033974302</Ean>
</product>
<product>
<Sku>9458454</Sku>
<quantity>2</quantity>
<Ean>3350033974303</Ean>
</product>
</products>
</purchase_order>
<purchase_order>
<PurchaseOrderId>45156</PurchaseOrderId>
<products>
<product>
<Sku>125453</Sku>
<quantity>4</quantity>
<Ean>3350033974304</Ean>
</product>
<product>
<Sku>9458455</Sku>
<quantity>4</quantity>
<Ean>3350033974305</Ean>
</product>
</products>
</purchase_order>
</receipt>
Champs
Champ |
Description |
receipt_id |
Id PMS de la réception
|
receipt_ref |
Votre référence de réception saisie dans PMS
|
receipt_supplier_ref |
Référence fournisseur (généralement n° de BL fournisseur) saisie dans PMS
|
inhouse_date |
Date d'entrée dans l'entrepôt ou de début de réception saisie dans PMS
|
close_date |
Date de fin de réception saisie dans PMS
|
WarehouseId |
Votre référence d'entrepôt
|
Champs <purchase_order>
Une réception peut concerner plusieurs commandes d'achat.
Champ |
Description |
PurchaseOrderId |
Votre référence de commande d'achat
|
Champs <purchase_order><products><product>
Champ |
Description |
Sku |
Votre identifiant unique pour chaque article
|
quantity |
Quantité réceptionnée dans PMS
|
Ean |
EAN
|
Réponse
Voici les réponses possibles à retourner :
<response>ok</response>
<response>error: message d'erreur</response>
<response>disabled</response>
<response>ignored</response>
Réponse |
Description |
ok |
Succès
|
error: texte |
Votre message d'erreur pour affichage à l'utilisateur dans PMS.
|
disabled |
L'application ne traite plus ces messages.
|
ignored |
Notification prise en compte mais n'ayant entrainé aucune action ou modification.
|