Integrationen / ERP / Exact
Exact Online: Integrationsleitfaden für die Feinplanung mit SkyPlanner APS
Dieser Integrationsleitfaden zeigt Exact-Partnern und IT-Teams, wie sie Exact Online Manufacturing mit SkyPlanner APS verbinden. Die Integration zwischen SkyPlanner und Exact Online arbeitet in beide Richtungen:
- Fertigungsaufträge, Arbeitsplanschritte, Materialpläne, Arbeitsstationen, Arbeitsgänge und Stücklisten werden über die Exact Online REST API eingelesen.
- Artikel, Lagerbestände, Bestellungen und Kundenaufträge werden eingelesen. Änderungen werden über Exact Online-Webhooks gemeldet.
- Geplante Start- und Endtermine werden in die einzelnen Arbeitsplanschritte und den Fertigungsauftrag zurückgeschrieben.
- Die Zeiterfassungen der Bediener werden als Zeitbuchungen übertragen, fertiggestellte Mengen als Zugänge aus Fertigungsaufträgen.
Das SkyPlanner-Team stimmt die Schnittstelle während des Onboardings auf Ihre Exact Online-Konfiguration ab und betreut sie auch nach dem Go-live. Dieser Leitfaden richtet sich an Partner und Entwickler, die daran mitwirken oder selbst auf Basis der dokumentierten REST API von SkyPlanner entwickeln möchten (API-Referenz). Am Ende folgt ein kurzer Abschnitt zu Exact Globe+.
Die Exact Online REST API für die Fertigung
Exact Online stellt seine Daten über eine einzige REST API bereit. Die Ressourcen sind nach Diensten gruppiert. Der Basispfad lautet /api/v1/{division}/<service>/<resource>, wobei die Division dem Mandanten in Exact Online entspricht. Die REST API-Referenz führt für den Dienst manufacturing folgende planungsrelevante Ressourcen auf:
| Ressource | Enthaltene Daten | Methoden |
|---|---|---|
manufacturing/ShopOrders | Fertigungsauftragsnummer, Artikel, PlannedQuantity, PlannedStartDate, PlannedDate, Status, Freigabekennzeichen | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Arbeitsplanschritt je Fertigungsauftrag: Arbeitsgang, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Materialpositionen je Fertigungsauftrag | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Code, Typ, Fertigungsbereich, Kapazitätswert, Kostensätze | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Arbeitsgänge mit der jeweils zugeordneten Arbeitsstation sowie Rüst- und Laufzeiten | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Stücklistenversionen, Komponenten und Arbeitsplan | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Gebuchte Stunden je Fertigungsauftrag und Arbeitsplanschritt | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Als Zugang gebuchte Fertigmengen aus einem Fertigungsauftrag | GET, POST |
manufacturing/MaterialIssues | Für einen Fertigungsauftrag entnommenes Material | GET, POST |
manufacturing/ShopOrderPriorities | Prioritätsmodus je Fertigungsauftrag | GET, PUT |
Aus den anderen Diensten:
| Ressource | Enthaltene Daten |
|---|---|
logistics/Items | Artikelstamm |
inventory/ItemWarehouses | Bestand je Artikel und Lager |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Offene Bestellungen und Wareneingangstermine |
salesorder/SalesOrders, SalesOrderLines | Kundenbedarf und Liefertermine |
Authentifizierung und Zugriff
Exact Online verwendet OAuth 2.0 mit dem Authorization Code Flow und Refresh Tokens. Exact: „Before you can start integration with Exact Online, you must first register your app in the App Store.“ (Bevor Sie mit der Integration von Exact Online beginnen können, müssen Sie Ihre App im App Store registrieren.) (Exact Online-Hilfe) Für die Registrierung von Apps ist ein Exact Online Developer-Abonnement erforderlich (Exact App Store).
- Die Integration wird als App mit einer Redirect URI registriert.
- Ein Exact Online-Benutzer mit Zugriff auf Fertigung, Lager und Einkauf erteilt einmalig seine Zustimmung.
- Jede Anfrage übermittelt
Authorization: Bearer <access_token>und die Division im Pfad. - Access Tokens werden mithilfe des Refresh Tokens erneuert. Exact begrenzt, wie oft ein neues Token angefordert werden darf. Speichern Sie das Token daher bis zu seinem Ablauf im Cache.
Exact begrenzt außerdem die Anzahl der Aufrufe pro Minute und pro Tag für jede App und jeden Mandanten. Aufrufe sollen nacheinander statt parallel erfolgen. Die aktuellen Grenzwerte finden Sie im Artikel zu den API-Limits von Exact. Die Integration berücksichtigt diese Vorgaben: Sie liest Daten gezielt mit $filter und $select aus und nutzt die Sync API für Massenänderungen.
Auf der SkyPlanner-Seite erfolgt die Authentifizierung der REST API über ein API-Token im Header Authorization-Token (SkyPlanner Settings > API). Die API ist in Swagger/OpenAPI dokumentiert. Das Integrationstutorial führt Sie durch die ersten Aufrufe.
Webhooks und Polling
Wenn sich ein abonniertes Topic ändert, senden die Webhooks von Exact Online einen POST an Ihre Callback-URL. Dieser ist mit einem HMAC SHA256-Hash signiert (Webhooks). Zu den Topics gehören Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders und SalesOrderLines. So werden Änderungen an Beständen, Bestellungen und Bedarfen unmittelbar an SkyPlanner übermittelt.
Fertigungsaufträge und Arbeitsplanschritte werden in regelmäßigen Abständen eingelesen. Filtern Sie ShopOrders und ShopOrderRoutingStepPlans nach Modified und nutzen Sie die Sync API, um größere Datenmengen auszulesen (API-Einschränkungen).
SkyPlanner sendet bei Planänderungen eigene Webhooks. Das Zurückschreiben nach Exact Online erfolgt damit ereignisgesteuert.
Datenzuordnung
| Ressource in Exact Online | Objekt in SkyPlanner | Richtung | Häufigkeit |
|---|---|---|---|
Items | Produkte und Materialien | Exact Online → SkyPlanner | Erstimport, danach per Webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Produktstruktur, Unterprodukte, Materialien je Produkt | Exact Online → SkyPlanner | Bei Änderungen |
Workcenters, OperationResources | Arbeitsstationen, Arbeitsstationsgruppen | Exact Online → SkyPlanner | Erstimport |
Operations, BillOfMaterialRoutings | Prozessschritte mit Rüst- und Laufzeiten | Exact Online → SkyPlanner | Bei Änderungen |
ShopOrders | Aufträge mit Menge und Fälligkeitstermin | Exact Online → SkyPlanner | Alle paar Minuten |
ShopOrderRoutingStepPlans | Arbeitsgänge mit Reihenfolge, Arbeitsstation sowie Rüst- und Laufzeiten in Stunden | Exact Online → SkyPlanner | Alle paar Minuten |
ShopOrderMaterialPlans | Materialien je Arbeitsgang | Exact Online → SkyPlanner | Alle paar Minuten |
ItemWarehouses, StockPosition | Lagerbestände | Exact Online → SkyPlanner | Webhook |
PurchaseOrderLines | Bestellungen mit voraussichtlichem Lieferdatum | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Liefertermine und Priorität der Kundenaufträge | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Geplanter Beginn, geplantes Ende und Arbeitsstation je Arbeitsgang | SkyPlanner → Exact Online | Bei Änderungen per Webhook |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Auftragsbeginn und -ende | SkyPlanner → Exact Online | Bei Änderungen per Webhook |
TimeTransactions (POST) | Zeitbuchungen und Rückmeldungen der Bediener | SkyPlanner → Exact Online | Je Rückmeldung oder je Schicht |
ShopOrderReceipts (POST) | Fertigmenge am letzten Arbeitsgang | SkyPlanner → Exact Online | Je Rückmeldung |
| Nicht in Exact Online geführt | Rüstzeitmatrix, Werkzeuge als begrenzt verfügbare Ressourcen, Bediener je Arbeitsgang, alternative Arbeitsstationen, Schichten | In SkyPlanner gepflegt | Einrichtung |
Integrationsabläufe
1. Erstimport der Stammdaten. Lesen Sie Workcenters, Operations und OperationResources ein, anschließend Artikel und Stücklistenversionen mit ihren Arbeitsplänen. Eine Arbeitsstation mit drei Maschinen wird als drei Arbeitsstationen oder eine Arbeitsstationsgruppe abgebildet. Schichten, Abwesenheiten und Überstunden werden in SkyPlanner eingerichtet, da Exact je Arbeitsstation nur einen Kapazitätswert führt.
2. Aufträge synchronisieren. Lesen Sie offene ShopOrders mit ihren ShopOrderRoutingStepPlans und ShopOrderMaterialPlans sowie Bestände und Bestellpositionen ein. Die Planung berücksichtigt sowohl Lagerbestände als auch erwartete Wareneingänge aus Bestellungen. MRP liefert weiterhin Auftragsvorschläge in Exact Online. SkyPlanner plant die Fertigungsaufträge ein, die Sie anlegen.
3. Planung zurückschreiben. Für jeden Arbeitsgang, den die Planungsengine eingeplant oder verschoben hat, sendet SkyPlanner einen PUT an ShopOrderRoutingStepPlans mit PlannedStartDate, PlannedEndDate und Workcenter. Die Felder PlannedStartDate und PlannedDate des Fertigungsauftrags richten sich nach dem ersten und letzten Arbeitsgang. Mengen, Materialpläne und Kalkulation bleiben in Exact Online.
4. Rückmeldungen aus dem Shopfloor. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Diese Zeitbuchungen halten die Planung aktuell. Die erfassten Stunden werden als TimeTransactions auf den Fertigungsauftrag und den jeweiligen Arbeitsgang gebucht, getrennt nach Rüst- oder Bearbeitungszeit. Die letzte Rückmeldung erzeugt einen ShopOrderReceipts-Datensatz für die Fertigmenge. Wenn Ihr Werk Zeiten bereits in Shop Floor Control erfasst, entscheiden Sie sich für einen Buchungsweg.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Artikel, Stücklisten, Fertigungsauftragsmengen, Materialpläne, Kosten | Exact Online |
| Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Zuordnung zu Arbeitsstationen | SkyPlanner |
| Rüstzeitmatrix, Werkzeuge, Bediener je Arbeitsgang, alternative Ressourcen, Schichten | SkyPlanner |
| Zeitbuchungen und Fertigmeldungen | Exact Online, mit Daten aus SkyPlanner |
Die häufigste Konfliktursache sind manuelle Terminänderungen. Wenn Planer weiterhin die Termine von Fertigungsaufträgen in Exact Online ändern, werden Termine in zwei Systemen geführt. Lassen Sie SkyPlanner die Termine der Arbeitsgänge bestimmen. Mit Autopilot plant SkyPlanner automatisch neu, wenn sich in der Produktion etwas ändert.
Typischer Projektablauf
Die Implementierung ist in der Regel innerhalb weniger Wochen nach Beginn der Einrichtung abgeschlossen. Prüfen Sie vorher die Planung im kostenlosen 30-tägigen Test anhand eines CSV- oder Excel-Exports Ihrer offenen Fertigungsaufträge und Arbeitsgänge. Das Projekt läuft dann wie folgt ab:
- Anforderungsaufnahme. Legen Sie Edition, Mandanten, Synchronisierungsintervalle, den Weg der Zeitbuchung und die Verbuchung der Fertigmeldungen fest.
- App und Autorisierung. Registrieren Sie die App. Anschließend erteilt ein Exact Online-Benutzer für jeden Mandanten die OAuth-Zustimmung.
- Erstimport. Arbeitsstationen, Arbeitsgänge, Artikel, Stücklistenversionen und Arbeitspläne einlesen.
- Aufträge synchronisieren. Fertigungsaufträge, Arbeitsgangpläne und Materialpläne werden zeitgesteuert synchronisiert, Bestände und Einkaufsdaten per Webhook.
- Planungsbedingungen in SkyPlanner einrichten. Schichten, Rüstzeitmatrix, Werkzeuge, Anzahl der Bediener je Arbeitsgang sowie alternative Maschinen oder Mitarbeiter festlegen.
- Planung zurückschreiben. Geplante Arbeitsgangtermine an Exact Online übertragen, anschließend Zeitbuchungen und Fertigmeldungen.
- Paralleltest und Produktivstart. Vergleichen Sie die Termine mit der aktuellen Planung, korrigieren Sie die Stammdaten und aktivieren Sie anschließend das Zurückschreiben.
Was Sie bei der Exact Online-Integration berücksichtigen sollten
- Arbeitsgangzeiten.
PlannedSetupHoursundPlannedRunHoursstammen aus dem Arbeitsplan der Stückliste. Gleichen Sie diese zuerst mit den tatsächlichen Bearbeitungszeiten ab. - Arbeitsstationen gruppieren. Exact führt je Arbeitsstation einen Kapazitätswert. Entscheiden Sie für jede Arbeitsstation, ob sie als eine, als mehrere oder als Gruppe abgebildet wird.
- Kalender. Schichten, Feiertage und Abwesenheiten werden in SkyPlanner geführt. Richten Sie diese vor dem ersten Planungslauf ein.
- API-Aufrufkontingent. Exact begrenzt die Aufrufe pro App und Unternehmen und erwartet, dass sie nacheinander erfolgen. Nutzen Sie Webhooks, wo entsprechende Topics verfügbar sind,
$filteraufModifiedund die Sync API zum Einlesen großer Datenmengen. - Mehrere Mandanten. Jeder Mandant in Exact Online ist ein Unternehmen mit eigenem Pfad und eigener Autorisierung. Ordnen Sie jedes Werk seinem Mandanten zu.
- Freigegebene Fertigungsaufträge. Vereinbaren Sie, bei welchen Status SkyPlanner Termine ändern darf: bei offenen und freigegebenen Aufträgen oder nur bei offenen Aufträgen.
- Ein führendes System für Termine. Ändern Sie Termine in Exact Online nicht mehr manuell, sobald SkyPlanner die Termine der Arbeitsgänge führt.
Exact Globe+
Exact Globe+ ist das ERP-System von Exact, das über Exact Globe+ Partner vertrieben und implementiert wird. Exact beschreibt die Anbindung so: „koppelt eenvoudig en snel met andere systemen“ (lässt sich einfach und schnell mit anderen Systemen verbinden; Exact Globe+). SkyPlanner plant Fertigungsaufträge aus Exact Globe+ auf dieselbe Weise: Fertigungsaufträge, Arbeitspläne, Ressourcen und Bestände werden eingelesen, geplante Termine und erfasste Stunden zurückgeschrieben. Ihr Exact Globe+ Partner und das SkyPlanner-Team stimmen bei der Anforderungsaufnahme die Schnittstelle und die Objekte für das Zurückschreiben ab.
Die Exact Online-Schnittstelle: Wer richtet sie ein und betreut sie?
- Das SkyPlanner-Team konfiguriert die Schnittstelle während der Einrichtung und betreut sie nach dem Produktivstart.
- Ihr Exact-Partner kann mitwirken. Er kennt Ihre Editionen, Mandanten und die Einrichtung Ihrer Fertigung.
- Ihre eigenen Entwickler können die Integration erweitern. Dafür steht die dokumentierte REST API von SkyPlanner zur Verfügung. Ein API-Token genügt für den Einstieg. Das SkyPlanner-Team unterstützt Sie bei Bedarf.
Sobald die Verbindung steht, plant die Arcturus-Engine anhand der aktuellen Fertigungsaufträge aus Exact Online und überträgt die geplanten Termine auf jeden Arbeitsgang. SkyPlanner ist ab 199 € pro Monat erhältlich, inklusive 5 Arbeitsstationen und bei monatlicher Abrechnung. Sie erhalten vorab ein auf Ihre Abläufe und Anforderungen abgestimmtes Angebot für die Integration zusammen mit Ihrem Tarif. So kennen Sie die Gesamtkosten, bevor Sie starten. Informieren Sie sich über Preise und Funktionen. Wie die integrierte Planung von Exact Online im Vergleich abschneidet, erfahren Sie unter Feinplanung mit Exact Online. Einen Überblick finden Sie auf der Exact Online-Seite, weitere ERP-Systeme in der Übersicht der ERP-Integrationen.
Erfahrungen von Fertigungsunternehmen mit SkyPlanner
Weniger Stillstände durch Materialmangel
„Der Mehrwert von SkyPlanner liegt für uns darin, dass es im Alltag funktioniert – besonders beim Festlegen von Lieferterminen.“
Tommi Männistö, Leiter Produktionsplanung
Eskomatic · Lohnzerspanung
Die automatische Belegungsplanung ermöglicht genauere Liefertermine. Produktionsstillstände durch Materialmangel sind deutlich zurückgegangen.
Mehrere 1.000 Fertigungsaufträge automatisch eingeplant
„Wir haben die Produktion ganz anders im Griff, und unser Verständnis der Kapazitäten ist auf einem völlig anderen Niveau.“
Hannu Ryynänen, Geschäftsführer
Mamec · Industriemischer, Pumpen und Hightech-Auftragsfertigung
Tausende Fertigungsaufträge werden automatisch eingeplant. Das gesamte Unternehmen hat dabei einen Echtzeitüberblick über die Produktion.
Häufig gestellte Fragen
Umfasst die Exact Online API Fertigungsaufträge und Arbeitsgänge?
Ja. Der Fertigungsdienst bietet ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations und BOM-Ressourcen. Alle lassen sich lesen und schreiben. Zeiten werden über TimeTransactions gebucht, fertiggestellte Mengen über ShopOrderReceipts.
Wie werden geplante Termine an Exact Online zurückgeschrieben?
Für jeden Arbeitsgang, den SkyPlanner einplant oder verschiebt, sendet es eine PUT-Anfrage an ShopOrderRoutingStepPlans mit PlannedStartDate, PlannedEndDate und dem Wert für Workcenter. Die Felder PlannedStartDate und PlannedDate des Fertigungsauftrags werden entsprechend aktualisiert.
Wer richtet die Integration mit Exact Online ein?
Das SkyPlanner-Team richtet die bidirektionale Integration während des Onboardings passend zu Ihrer Exact Online-Umgebung ein und betreut sie auch nach dem Go-live. Ihr Exact-Partner kann sich daran beteiligen. Auch Ihre eigenen Entwickler können die dokumentierte REST API von SkyPlanner nutzen, um eine Integration zu entwickeln. Ein API-Token reicht für den Einstieg aus.
Kann Exact Online Änderungen in Echtzeit übertragen?
Die Webhooks von Exact Online übertragen Änderungen an Artikeln, Lagerbeständen, Bestellungen und Kundenaufträgen. Fertigungsaufträge und Arbeitsgänge werden in kurzen Intervallen mit gefilterten Anfragen abgerufen. In der Gegenrichtung übertragen die Webhooks von SkyPlanner Änderungen am Zeitplan, sobald sie auftreten.
Können wir SkyPlanner testen, bevor wir die Integration umsetzen?
Ja. In der kostenlosen 30-tägigen Testphase können Sie bis zu 20 Arbeitsstationen nutzen und Ihre Fertigungsaufträge per CSV oder Excel importieren. Eine Kreditkarte ist nicht erforderlich. Testphase starten oder mit dem Vertrieb sprechen, um die Anforderungen an die Integration aufzunehmen.