Kazam WMS · Lagerplattform
Diese Seite richtet sich an alle, die Sun Tech WCS unter ein bestehendes WMS setzen: was die beiden Systeme austauschen, was das WMS bereitstellen muss und in welcher Reihenfolge man am besten vorgeht. Der vollständige Leitfaden auf Englisch ist Writing a WMS adapter.
Drei Verträge
- Vom WCS zum WMS. Das WCS stellt dem WMS Fragen und meldet ihm Fakten über 43 HTTP-Routen, die das WMS direkt bereitstellt oder über einen vorgeschalteten Adapter.
- Von Ihren Systemen zum WCS. ERP, MES und Bildschirme nutzen die API des WCS und seinen Ereigniskanal. Auch das WMS nutzt die Befehle dieser API, wenn das WCS etwas tun soll: Der Vertrag sieht keine Rückrufe vom WMS zum WCS vor.
- Vom WCS zu den Maschinen. Über einen Treiber, auf einem öffentlichen Vertrag. Sun Tech liefert den eigenen Treiber; Sie können auch selbst einen schreiben.
Das WMS schiebt nicht, das WCS fragt
Läuft die Engine, fragt das WCS das WMS einmal pro Sekunde nach anstehender Arbeit. Das WMS bleibt die maßgebliche Quelle für Ware und Aufträge, und es wählt den Platz: Das WCS weiß, wie man hinkommt. Keiner schreibt je in die Datenbank des anderen.
Was das WMS bereitstellen muss
- Die 43 Routen des Vertrags, unter einem gemeinsamen Pfad, in JSON, mit einem Schlüssel im Header
X-Api-Key. - Antworten, die eine Ablehnung von einem Fehler unterscheiden: Ein 4xx ist eine endgültige Ablehnung und die Anfrage wird zurückgestellt, ein 5xx, 408 oder 429 wird wiederholt.
- Quittungen für jeden Fakt, gebunden an seine Vorgangskennung: Derselbe Fakt zweimal gesendet wird nicht zweimal erfasst.
Die Liste der Routen, eine pro Zeile, steht in WMS routes; der vollständige Vertrag mit den Regeln zu Kennungen, Aufzählungen und Wiederholungen in WMS contract. Beides gibt es auch als OpenAPI-3.1-Dokument, aus dem Code erzeugt.
Die Schritte des Leitfadens
- Man beginnt mit dem Beispiel-WMS, das alle 43 Routen auf einem Lager im Arbeitsspeicher beantwortet: Man behält den Teil, der die Routen bereitstellt, und die Schlüsselprüfung und ersetzt die Beispieldaten durch Abfragen auf Ihre Datenbank.
- Man bereitet die Daten vor, die das WMS für das WCS hält: die Türcodes der Plätze, die Tiefen, die Geräte, von denen aus jeder Platz erreichbar ist, die Reservierungen mit Ablauf und die Quittungen.
- Man implementiert in Reihenfolge: zuerst die Einlagerung, dann die Auslagerung, dann den Rest. Eine noch nicht fertige Route antwortet mit 503, nicht mit einer Ablehnung.
- Man testet mit dem Client des WCS selbst und nimmt die Tests des Beispiel-WMS als Vorlage.
In welcher Sprache
Aus .NET nutzt man die Vertragsbibliothek über einen Projektverweis aus einem Klon des Repositorys: NuGet-Pakete gibt es noch nicht. In einer anderen Sprache genügt es, dieselben Pfade mit demselben JSON bereitzustellen.
Soll Sun Tech den Adapter schreiben, oder binden Sie Kazam WMS an? Erzählen Sie uns von Ihrem WMS und der Anlage: Es antwortet ein Ingenieur. Mit einem Ingenieur sprechen