Kazam WMS · plateforme d'entrepôt
Cette page s'adresse à qui doit placer Sun Tech WCS sous un WMS existant : ce que les deux systèmes échangent, ce que le WMS doit servir et dans quel ordre travailler. Le guide complet, en anglais, est Writing a WMS adapter.
Trois contrats
- Du WCS vers le WMS. Le WCS pose des questions au WMS et lui communique les faits par 43 routes HTTP, que le WMS sert directement ou via un adaptateur placé devant lui.
- De vos systèmes vers le WCS. ERP, MES et écrans utilisent l'API du WCS et son canal d'événements. Le WMS aussi, quand il veut que le WCS fasse quelque chose, utilise les commandes de cette API : le contrat ne prévoit pas de rappels du WMS vers le WCS.
- Du WCS vers les machines. Par un driver, sur un contrat public. Sun Tech fournit son propre driver ; vous pouvez aussi en écrire un.
Le WMS ne pousse pas, le WCS demande
Quand le moteur tourne, une fois par seconde le WCS demande au WMS le travail en attente. Le WMS reste la source de vérité sur la marchandise et les commandes, et c'est lui qui choisit l'emplacement : le WCS sait comment y arriver. Aucun des deux n'écrit jamais dans la base de données de l'autre.
Ce que le WMS doit servir
- Les 43 routes du contrat, sous un chemin commun, en JSON, avec une clé dans l'en-tête
X-Api-Key. - Des réponses qui distinguent un refus d'une panne : un 4xx est un refus définitif et la demande est mise de côté, un 5xx, 408 ou 429 est retenté.
- Des accusés pour chaque fait, liés à son identifiant d'opération : le même fait envoyé deux fois n'est pas enregistré deux fois.
La liste des routes, une par ligne, est dans WMS routes ; le contrat complet, avec les règles sur les identifiants, les énumérations et les nouvelles tentatives, dans WMS contract. Les deux existent aussi comme document OpenAPI 3.1, généré à partir du code.
Les étapes du guide
- On part du WMS d'exemple, qui répond aux 43 routes sur un entrepôt en mémoire : on garde la partie qui expose les routes et le contrôle de la clé, et on remplace les données fictives par des requêtes sur votre base de données.
- On prépare les données que le WMS tient pour le WCS : les codes de porte des emplacements, les profondeurs, les équipements depuis lesquels chaque emplacement est accessible, les réservations avec échéance et les accusés.
- On implémente dans l'ordre : d'abord le stockage, puis l'extraction, puis le reste. Une route pas encore prête répond 503, pas par un refus.
- On teste avec le client du WCS lui-même, en prenant pour modèle les tests du WMS d'exemple.
Dans quel langage
Depuis .NET, on utilise la bibliothèque des contrats par une référence de projet, à partir d'un clone du dépôt : il n'y a pas encore de paquets NuGet. Dans un autre langage, il suffit de servir les mêmes chemins avec le même JSON.
Vous voulez que Sun Tech écrive l'adaptateur, ou vous connectez Kazam WMS ? Parlez-nous de votre WMS et de l'installation : un ingénieur vous répond. Parler à un ingénieur