Inhalt:
Die Schnittstelle konnektiert das Logistiksystem mit dem ERP System. Ziel ist der vollautomatische Datenaustausch zwischen beiden Systemen. Die Schnittstelle ist für weitere Anwendungsfälle erweiterbar zu gestalten. Der Datenaustausch finded asynchron statt und eine blockierung lokaler Prozesse bei Ausfall der Gegenseite ist nicht gegeben. Allerdings werden bestimmte lokale Prozesse durch die Einlieferung von Daten der Gegenseite ausgelöst.
Die Schnittstelle ist als RESTful Webservice realisiert. Die Daten werden im JSON Format ausgetauscht. Hierfür werden von beiden Seiten entsprechende Dienstendpunkte bereitgestellt.
Der Datenbereitsteller ist dafür verantwortlich seine Daten an das Fremdsystem über die Vereinbarte API zu übergeben. Das Fremdsystem stellt hierfür einen Dienstendpunkt bereit. Jeder Datenbereitsteller überwacht seinen Dienstendpunkt eigenverantwortlich auf Funktion und Verfügbarkeit.
Störfälle auf Dienstebene stellen in der Regel Ausfälle durch ein Softwarefehlverhalten dar (Server Error). Ebenfalls kann ein Ausfall die Nichterreichbarkeit des Dienstendpunktes selbst betreffen (Timeout). Dies kann geplant, durch Wartungsarbeiten, oder auch ungeplant durch Störungen eintreten.
Falls die Daten nicht erfolgreich übermittelt werden können, wird der Datenbereitsteller diese nach einer definierten Fehlerwartezeit erneut versuchen diese zu übermitteln. Dies wird solange wiederholt, bis die Daten erfolgreich übertragen werden konnten.
Wird bei dem Aufruf der API ein Fehler zurückgegeben, betrachtet der Konsument (einliefender Client) dieses API Aufrufs dieses als fehlgeschlagen. Es wird nach einer definierten Fehlerwartezeit erneut versuchen die Funktion zu konsumieren.
Die nicht erfolgreich übermittelten Daten werden dabei erneut als erstes übertragen. Der Konsument hält dafür alle anstehenden Übermittlungen in einer Warteschlange vor (FiFo Queue).
Die Regelverfügbarkeit des Dienstes für den Datenaustausch seitens Reinsch entspricht der Verfügbarkeitsklasse 3 (99,9 %). Wir können ihnen optional eine höhere Verfügbarkeit, entsprechend ihrer Anforderungen, bis zur Verfügbarkeitsklasse 5 (99,999 %) gewährleisten.
Die Prozesse sind im Dokument Prozessbeschreibung definiert.
Der Aufbau der API ist in den Dokumenten unter API definiert.