JobBOSS² Schnittstelle: Leitfaden zur Feinplanung mit SkyPlanner APS

ECI veröffentlicht seine APIs für die Fertigung samt OpenAPI-Spezifikationen auf der Website ECI-API-Dokumentation für die Fertigung. Für die Feinplanung sind zwei davon relevant:

1. JobBOSS² API (v1). Eine speziell für JobBOSS² entwickelte API auf Basis von REST und JSON. Sie liest und schreibt Aufträge, Order Line Items, Order Routings, Estimates, Routings, Materialien, Job Requirements, Work Centers, Company Calendar, Employees, Bestellungen, Time Tickets und Time Ticket Details. ECI schreibt dazu: „is currently only supported for JobBOSS² hosted (Cloud) customers.“ (Derzeit nur für Kunden unterstützt, die JobBOSS² als gehostete Cloud-Lösung nutzen.)
2. ECI ERP API (v2.1). Eine produktübergreifende REST API für Deacom, M1 und JobBOSS². Für JobBOSS² deckt sie Fertigungsaufträge, Arbeitsgänge, Auftragsmaterialien, Artikel, Artikelarbeitsgänge, Arbeitsstationen, Bestellpositionen und Zeiterfassungspositionen ab. ECI weist darauf hin: „the actual ERP database could be a cloud hosted ERP or on premises install,“ (Die eigentliche ERP-Datenbank kann in der Cloud gehostet oder lokal installiert sein.) Damit ist dies der Weg für lokal installiertes JobBOSS².

Beide APIs verwenden dieselben Konventionen: Filterausdrücke wie lastModDate[gte]=, einen Parameter fields=, sort= sowie eine seitenweise Abfrage mit take und skip. Der Standardwert für take ist 200. „All dates submitted to the API are assumed to be in UTC.“ (Alle an die API übermittelten Datums- und Zeitangaben werden als UTC interpretiert.)

Für beide APIs gilt laut ECI: „All APIs must be activated by ECI before use.“ (Alle APIs müssen vor der Nutzung von ECI freigeschaltet werden.) Wenden Sie sich frühzeitig an Ihren ECI-Kundenbetreuer.

Für keine der beiden ECI-APIs sind Webhooks dokumentiert. Die JobBOSS²-Seite wird daher per Polling abgefragt: Filtern Sie Order Line Items, Order Routings und Bestellpositionen anhand von lastModDate nach Änderungen seit dem letzten Lauf und rufen Sie die Ergebnisse mit take und skip seitenweise ab. Die Häufigkeit wird je Betrieb festgelegt: etwa alle paar Minuten für Fertigungsaufträge und stündlich für Bestände.

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

1. Erstimport der Stammdaten. Lesen Sie Estimates, Routings, Materialien, Work Centers, Company Calendar und Employees ein. Legen Sie die Zuordnung der Arbeitsstationen bewusst fest: Aus einer Arbeitsstation mit vier Drehmaschinen wird eine Arbeitsstationsgruppe oder es werden vier Arbeitsstationen. So plant SkyPlanner die Reihenfolge für jede Maschine.

2. Aufträge synchronisieren. Lesen Sie offene Order Line Items mit den zugehörigen Order Routings, Job Requirements und offenen Bestellpositionen ein. SkyPlanner betrachtet bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert ist. Lassen Sie gesperrte und abgeschlossene Aufträge aus.

3. Planungsdaten zurückschreiben. Wenn die Planungsengine einen Schritt einplant oder verschiebt, löst ein SkyPlanner-Webhook einen PATCH-Aufruf an /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber} aus. Dabei werden estimatedStartDate und estimatedEndDate in UTC gesetzt. Hat SkyPlanner den Schritt einer anderen Maschine oder Person zugewiesen, werden auch workCenter und employeeCode gesetzt. Die Termine werden in die Arbeitsgänge geschrieben, die bereits im Whiteboard, Planning Board und Scheduling Advisor angezeigt werden.

4. Rückmeldungen aus der Fertigung. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Diese Zeiterfassungen halten den Zeitplan aktuell. Sie entscheiden, ob Istzeiten an JobBOSS² zurückgemeldet werden. Wenn ja, wird jede Rückmeldung als Time Ticket Detail mit Rüstzeit, Zykluszeit und Stückzahlen übertragen. Wenn nicht, bleibt die Datenerfassung in JobBOSS² und SkyPlanner liest den Fortschritt aus Order Routings ein.

5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:

Legen Sie ein einziges System fest, das die Termine der Arbeitsgänge schreibt. Für die von SkyPlanner geplanten Aufträge ersetzt SkyPlanner die Umplanung im Whiteboard. Planer verschieben die Arbeit daher in SkyPlanner; die Termine werden an JobBOSS² übertragen.

• Gehostet oder lokal installiert. Die JobBOSS² API steht Kunden mit gehosteter Lösung zur Verfügung. Lokale Installationen nutzen die ERP API, deren verfügbare Ressourcen abweichen. Klären Sie den Anbindungsweg in Schritt 1.
• Durchgängig UTC. Die API liest und schreibt Zeitangaben in UTC. Rechnen Sie diese in die Ortszeit des Werks um, sonst wird ein Start um 7:00 zur falschen Uhrzeit eingeplant.
• Was hinter einer Arbeitsstation steckt. Eine Arbeitsstation kann eine Maschine, eine Gruppe, eine Fertigungszelle oder Personal abbilden. Anhand der Maschinenanzahl und Teamgröße je Arbeitsplanschritt erkennt SkyPlanner, wie viele Ressourcen der Schritt benötigt.
• Fremdleistungen. Schritte, denen statt einer Arbeitsstation ein Lieferant zugeordnet ist, zählen zur Durchlaufzeit, belegen aber keine eigene Kapazität. Bilden Sie diese als Schritte mit reinem Zeitbedarf ab.
• Überlappende und unbemannte Arbeitsgänge. Arbeitsplanschritte können als überlappend oder unbemannt gekennzeichnet sein. Übernehmen Sie beide Kennzeichen, damit auch die mannlose Fertigung korrekt geplant wird.
• Zeiteinheiten. Rüst- und Zykluszeiten haben jeweils eigene Einheiten. Die Zeit in der Warteschlange ist Wartezeit, keine Maschinenzeit. Rechnen Sie die Einheiten beim Import um, sonst stimmen sämtliche Zeitdauern nicht.
• Seitenweise Abfrage. Eine Seite enthält standardmäßig 200 Datensätze. Rufen Sie bei jedem Lesezugriff die Daten seitenweise ab.