Business Central integrieren für die Feinplanung mit SkyPlanner APS

Die Integration nutzt zwei Schnittstellen, die Business Central bereits mitbringt:

1. API v2.0 für kaufmännische Daten und Bestandsdaten. Sie stellt items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers und employees bereit. Fertigungsentitäten sind nicht enthalten. Produktionsdaten werden daher über die zweite Schnittstelle übertragen.
2. OData v4-Webdienste für die Fertigung. Jede Business Central-Seite lässt sich auf der Seite Web Services als OData v4-Webdienst veröffentlichen. Wählen Sie den Objekttyp Page, die Seiten-ID und einen Dienstnamen und aktivieren Sie anschließend Published. Damit ist der Endpunkt verfügbar – ohne AL-Code und ohne eine Erweiterung bereitstellen zu müssen. Die Integration veröffentlicht die Standardseiten für freigegebene Fertigungsaufträge, Fertigungsauftragsarbeitsgänge (Prod. Order Routing Lines), Arbeitsstationen, Maschinenplätze und Arbeitspläne. Sie sind unter /ODataV4/Company('{name}')/{ServiceName} erreichbar.

Veröffentlichte Seiten erlauben Lese- und Schreibzugriffe. Microsoft erklärt: „If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,“ (Wird eine bearbeitbare Seite als Webservice bereitgestellt, lassen sich die Daten der zugrunde liegenden Tabelle per OData-Aufruf lesen und ändern). Aktualisierungen erfolgen dabei mit PATCH. So gelangen die geplanten Termine zurück nach Business Central – über dieselbe Seite und mit derselben Validierung, die auch bei der Arbeit eines Planers zum Einsatz kommt.

Verzichten Sie auf SOAP. Microsoft hat SOAP-Webservices als veraltet eingestuft. Mit 2026 release wave 2 (v29) entfällt die Möglichkeit, Microsoft UI-Seiten als SOAP-Webservices zu veröffentlichen.

Business Central unterstützt Webhook-Abonnements über POST /api/v2.0/subscriptions für API v2.0-Entitäten wie items und salesOrders. Dabei gelten folgende Regeln:

• Beim Anlegen eines Abonnements ist ein Handshake erforderlich: Ihr Endpunkt muss den validationToken mit 200 OK zurückgeben.
• Abonnements laufen nach drei Tagen ab. Verlängern Sie sie mit PATCH; dabei wird der Handshake erneut ausgeführt.
• Benachrichtigungen enthalten den Ressourcenpfad, changeType und Ihren clientState, nicht den vollständigen Datensatz. Diesen rufen Sie anschließend ab.
• Benachrichtigungen werden verzögert gesendet: Business Central online wartet nach der ersten Änderung 30 Sekunden. Werden in diesem Zeitfenster mehr als 1.000 Datensätze geändert, werden sie in einer einzigen collection-Benachrichtigung zusammengefasst.
• Online sind maximal 200 Webhook-Abonnements pro Umgebung möglich.

Fertigungsaufträge, Arbeitsplanzeilen und Bestellungen werden alle paar Minuten über die veröffentlichten Seiten und purchaseOrders abgefragt. Durch die Beschränkung auf offene Aufträge und den seitenweisen Abruf bleibt die Anzahl der Anfragen deutlich unter den Grenzwerten von Business Central.

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

1. Erstimport der Stammdaten. Lesen Sie Arbeitspläne und Fertigungsstücklisten mit dem Status Certified sowie Arbeitsstationen und Maschinenplätze aus den veröffentlichten Seiten ein. Artikel und Maßeinheiten rufen Sie über API v2.0 ab. Legen Sie bewusst fest, wie jede Arbeitsstation und jeder Maschinenplatz einer SkyPlanner-Arbeitsstation zugeordnet wird: Soll eine Arbeitsstation mit drei Maschinenplätzen als eine Arbeitsstationsgruppe oder als drei Arbeitsstationen abgebildet werden?

2. Auftragssynchronisierung. Lesen Sie Fertigungsaufträge mit dem Status Released einschließlich ihrer Arbeitsplanzeilen und Komponenten aus den veröffentlichten Seiten ein. Falls Sie auch Aufträge mit dem Status Firm Planned einplanen, lesen Sie diese ebenfalls ein. Offene Bestellzeilen rufen Sie über API v2.0 ab. SkyPlanner behandelt bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert wird. Damit berücksichtigt die Feinplanung sowohl Lagerbestände als auch erwartete Wareneingänge.

Planen Sie niemals Fertigungsaufträge mit dem Status Planned ein. Laut Microsoft gilt für Business Central: „deletes them the next time you run planning.“ (Sie werden beim nächsten Planungslauf gelöscht.) Das Planning Worksheet schlägt weiterhin Bedarfsdeckungen vor, während SkyPlanner die fest geplanten Aufträge unter Berücksichtigung der tatsächlichen Kapazität einplant.

3. Planungsergebnisse zurückschreiben. Die Standardseite Prod. Order Routing wird als OData v4-Webdienst veröffentlicht. Für jeden Arbeitsgang, den die Planungsengine eingeplant oder verschoben hat, sendet SkyPlanner einen PATCH mit dem If-Match-ETag an die zugehörige Arbeitsplanzeile. Dabei werden Starting Date-Time und Ending Date-Time gesetzt. Wurde der Arbeitsgang auf eine alternative Maschine verlegt, werden außerdem Type und No. gesetzt.

PATCH führt die Seiten- und Tabellentrigger aus. Business Central validiert die Felder daher mit seiner eigenen Logik – genau wie bei einer manuellen Änderung auf der Seite Prod. Order Routing. Die Felder Starting und Ending Date-Time der Fertigungsauftragszeile werden entsprechend angepasst. Mengen, Status und Kosten bleiben in Business Central.

4. Rückmeldungen aus der Fertigung. Mitarbeitende erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Diese Zeiterfassungen halten den Zeitplan aktuell. Fertigmeldungen können wie bisher in Business Central über das Production Journal oder Output Journal erfolgen.

Wenn Sie Istmeldungen und Verbrauch vollautomatisch buchen möchten, wird eine Standard-API-Seite in Business Central für die Buchung über das Output Journal hinzugefügt. SkyPlanner bucht dann Rüstzeit, Bearbeitungszeit und fertiggestellte Menge je Arbeitsgang. Die Buchung aktualisiert die Capacity Ledger Entries. Die Istmeldung am letzten Arbeitsgang des Arbeitsplans erhöht den Artikelbestand.

Legen Sie einen einzigen Weg für die Buchung von Istmeldungen fest. Wenn Sie sowohl über SkyPlanner als auch über das Production Journal in Business Central buchen, entstehen doppelte Einträge.

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

Die häufigsten Konfliktquellen sind die Aktionen Refresh und Replan bei Fertigungsaufträgen. Microsoft erklärt: „If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.“ (Wenn Sie Fertigungsauftragszeilen mit Refresh neu berechnen, löscht Business Central die vorhandenen Zeilen und berechnet neue.) Auch Replan kann den Kapazitätsbedarf ändern. Für die Neuberechnung von Komponenten gilt: „deletes previous changes in the components.“ (Bisherige Änderungen an den Komponenten werden gelöscht.)

Behandeln Sie einen mit Refresh aktualisierten Auftrag als neue Version, synchronisieren Sie ihn erneut und lassen Sie SkyPlanner neu planen. Mit Autopilot plant SkyPlanner automatisch neu, wenn sich in der Produktion etwas ändert.

• Einheiten in Arbeitsplänen. Setup Time gilt pro Fertigungsauftrag, Run Time pro produziertem Artikel. Beide haben einen eigenen Unit of Measure Code. Wait Time und Move Time belegen keine Kapazität der Arbeitsstation. Wenn die Einheit der Arbeitsstation Days ist, entspricht ein Tag 24 Stunden und nicht einer Achtstundenschicht. Rechnen Sie die Werte beim Import um, sonst ist jede Dauer falsch.
• Veraltete Kalender. Kapazität steht erst zur Verfügung, wenn Calculate Work Center Calendar für den Planungshorizont ausgeführt wurde. Prüfen Sie vor dem Erstimport das Feld Calendar Entries Available Until.
• Kapazität der Maschinenplätze nicht sichtbar. Wenn Consolidated Calendar deaktiviert ist, wird nur die eigene Kapazität der Arbeitsstation eingeplant: „The machine center capacity is excluded.“ (Die Kapazität der Maschinenplätze ist ausgeschlossen.) Lesen Sie die Kapazität der Maschinenplätze direkt aus, statt sich auf die Summen der Arbeitsstation zu verlassen.
• Capacity und Efficiency. Business Central berechnet die Dauer als Run Time / Efficiency / Capacity. Die berechneten Kalendereinträge berücksichtigen bereits beide Faktoren. Übertragen Sie Efficiency einmal auf die Effizienz der SkyPlanner-Arbeitsstation, nicht doppelt.
• Alternate Work Center dient nur zur Information. Microsoft erklärt dazu: „isn’t automatically included in planning processes.“ (Wird nicht automatisch in Planungsprozesse einbezogen.) Bilden Sie Alternativen ausdrücklich als alternative Arbeitsstationen in SkyPlanner ab.
• Anfragelimits. Die Online-Grenzwerte gelten pro Benutzer, wobei ein Dienstprinzipal als ein Benutzer zählt: 6.000 OData-Anfragen in einem gleitenden Zeitfenster von 5 Minuten und 5 gleichzeitige Anfragen. Die Seitengröße ist auf 20.000 begrenzt, ein $batch auf 100 Vorgänge. Nach 8 Minuten wird ein Vorgang wegen Zeitüberschreitung abgebrochen. Bei Überschreitung der Anfragerate wird 429 zurückgegeben. Bündeln Sie Anfragen, rufen Sie Daten seitenweise ab und fragen Sie nur Änderungen ab, statt den gesamten Datenbestand erneut zu laden.
• Lizenzierung. Die Fertigungsfunktionen sind nur mit der Benutzererfahrung Premium verfügbar. Benutzer mit Essentials können sich nicht bei einem Mandanten anmelden, der auf Premium eingestellt ist.