Monitor ERP Schnittstelle: Leitfaden zur Feinplanung mit SkyPlanner APS

Die dokumentierte Integrationsschnittstelle von Monitor G5 ist die Monitor ERP API v1. Sie kombiniert CQRS und REST und überträgt JSON über HTTPS. (Monitor ERP API)

• Queries lesen Daten per GET. Sie unterstützen Optionen im OData-Stil: $filter, $select, $expand, $orderby, $top und $skip.
• Commands schreiben Daten per POST, zum Beispiel Manufacturing/ManufacturingOrderOperations/Update.
• Batch führt über POST /api/v1/Batch mehrere Commands in einer Transaktion aus: entweder alle oder keinen. Hängen Sie /Simulate oder /Validate an, um einen Batch zu testen und anschließend zurückzurollen. So lässt sich ein vollständiger Terminplan sicher schreiben. (Batch)

Die Basis-URL lautet https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Die Firmennummer setzt sich aus der Datenbanknummer und der Firmen-ID zusammen, zum Beispiel 004.1.

Zur Lizenzierung erklärt Monitor: „It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.“ (Alle Kunden können kostenlos Informationen über die API abfragen und auslesen. Um Commands zu nutzen und Daten in das ERP-System zu schreiben, müssen Sie jedoch Monitor ERP API erwerben.) Planen Sie die Lizenz für den Schreibzugriff von Anfang an im Projekt ein. (api.monitor.se)

In der Referenz der Monitor ERP API sind weder Webhooks noch Ereignisabonnements dokumentiert. Änderungen werden per Polling erfasst:

• Common/EntityChangeLogs (ab 2.33) liefert ChangeType (Update, Create, Delete), EntityTypeId, EntityId und ModifiedTimestamp. Fragen Sie das Änderungsprotokoll alle paar Minuten ab und rufen Sie nur die geänderten Datensätze ab. (EntityChangeLog)
• Beschränken Sie Abfragen von Fertigungsaufträgen auf offene Aufträge und rufen Sie die Ergebnisse mit $top und $skip seitenweise ab.

SkyPlanner sendet Webhooks, wenn sich der Status oder der Terminplan ändert. Das Zurückschreiben erfolgt daher ereignisgesteuert.

1. Erstimport der Stammdaten. Lesen Sie Arbeitsstationen, Arbeitsgangzeilen, alternative Arbeitsgangzeilen, Materialzeilen, Artikel und Schichtpläne ein. Legen Sie für jede Arbeitsstation gezielt fest, welcher SkyPlanner-Arbeitsstation sie entspricht. Eine Arbeitsstation vom Typ Pool wird zu einer Arbeitsstationsgruppe. Die darin enthaltenen Arbeitsstationen werden zu den Arbeitsstationen, zwischen denen die Planungsengine auswählt.

2. Aufträge synchronisieren. Lesen Sie offene Fertigungsaufträge mit ihren Knoten, Arbeitsgängen und Materialien sowie Lagerbestände und offene Bestellungen ein. SkyPlanner behandelt bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Lagerbestand, sobald die Bestellung als Delivered gekennzeichnet wird. Nach dem Erstimport werden Änderungen anhand von Common/EntityChangeLogs synchronisiert.

3. Terminplan zurückschreiben. Für jeden Arbeitsgang, den die Planungsengine eingeplant oder verschoben hat, sendet SkyPlanner ManufacturingOrderOperations/Update mit PlannedStartDate und PlannedFinishDate. Hat die Planungsengine einen Arbeitsgang auf eine andere Maschine im Pool verschoben, wird zuerst SetWorkCenter ausgeführt. Die Commands für einen Auftrag werden in einem Batch zusammengefasst. So übernimmt Monitor entweder alle oder keinen davon. Führen Sie den Batch während der Tests mit /Validate aus.

In Monitor-Versionen vor 24.5 lassen sich die geplanten Termine nicht über Update schreiben. Verwenden Sie stattdessen ManufacturingOrders/ReplanOperation (ab 2.40) mit StartDate und FinishDate und setzen Sie RestrictToOrderBounds entsprechend Ihren Regeln.

4. Rückmeldungen aus der Fertigung. Nutzen Sie nur einen Rückmeldekanal:

• Monitor bleibt der Rückmeldekanal. Die Bediener melden wie bisher über das Recording terminal oder die Maschinenanbindung zurück. SkyPlanner liest ManufacturingOrderOperationReportings als Fortschrittsmeldung ein und plant neu.
• SkyPlanner wird zum Rückmeldekanal. Die Bediener erfassen ihre Arbeit mit Mobile Confirmations oder dem Production Timer. SkyPlanner sendet dann ReportManufacturingOrderOperation per POST an Monitor.

Werden Rückmeldungen in beiden Systemen erfasst, werden Zeiten und Mengen doppelt gebucht.

5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Go-live schriftlich fest:

Konflikte entstehen vor allem dann, wenn Planer weiterhin den Prioritätsplan bearbeiten. Rescheduling according to New finish und das Verschieben von Zeilen in Priority planning überschreiben die von SkyPlanner eingetragenen Termine. Sobald SkyPlanner die Reihenfolge vorgibt, dient Priority planning nur noch als Ansicht. Mit Autopilot plant SkyPlanner automatisch neu, wenn sich in der Produktion etwas ändert.

• Verfügbarkeitsfaktor. Monitor berechnet mit dem Verfügbarkeitsfaktor aus der Bruttokapazität die Nettokapazität. Bei einer neuen Arbeitsstation beträgt er standardmäßig 80 %. Berücksichtigen Sie ihn nur einmal: entweder als Effizienz in SkyPlanner oder durch kürzere Schichten, niemals beides.
• Zeitliche Genauigkeit. Bei Arbeitsstationen mit Day planning wird die Kapazität als Grundzeit pro Tag geführt, ohne Schichtzeiten. Bilden Sie die tatsächlichen Schichten anhand der Produktionszeitpläne in SkyPlanner ab, damit Aufträge innerhalb der Arbeitszeiten eingeplant werden.
• Wartezeit und Überlappung. Arbeitsgangzeilen enthalten Wartezeiten und Überlappungen in %. Legen Sie bei der Anforderungsaufnahme fest, wie beide in SkyPlanner abgebildet werden. Andernfalls ändern sich nach dem Produktivstart die Durchlaufzeiten.
• Pools. Pool-Arbeitsstationen werden in Pool planning geplant, nicht in Priority planning. Lesen Sie die zugehörigen Arbeitsstationen aus, nicht nur die Pool-Zeile.
• Versionsvoraussetzungen. Plantermine über Update zu schreiben, erfordert 24.5. Die Kapazitätsfelder der Arbeitsstationen in der API benötigen 24.3, OIDC benötigt 25.8. Prüfen Sie den Build vor der Anforderungsaufnahme.
• Netzwerk und Zertifikat. Bei einer lokalen Installation stellt Monitor die API auf Port 8001 mit einem selbstsignierten Zertifikat bereit. SkyPlanner läuft in der Cloud. Planen Sie deshalb eine Firewall-Regel oder ein Relay ein und stufen Sie das Zertifikat ausdrücklich als vertrauenswürdig ein.
• Lizenzen. Jede Drittanwendung mit Schreibzugriff benötigt eigene lizenzierte API-Benutzer. Ein API-Benutzer mit reinem Lesezugriff ist in jedem System enthalten.