URL Push : Receipt

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.

 

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.