Mit jedem ERP verbinden

Die offene REST API von SkyPlanner verbindet ERP-, MES- und Betriebssysteme, einschließlich hauseigener ERPs. Erstellen Sie die Integration selbst oder lassen Sie unser Team helfen.

Funktioniert auch eigenständig — eine ERP-Integration ist optional, nicht erforderlich.

Integrationsprojekt besprechen

Verbindet sich mit ERP & MES Systemen wie

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.
Gantt-Zeitachse in SkyPlanner APS mit Arbeitsgängen, die auf Arbeitsstationen eingeplant sind, und einer Auftragsliste darunter.

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:

RessourceEnthaltene DatenMethoden
manufacturing/ShopOrdersFertigungsauftragsnummer, Artikel, PlannedQuantity, PlannedStartDate, PlannedDate, Status, FreigabekennzeichenGET, POST, PUT, DELETE
manufacturing/ShopOrderRoutingStepPlansArbeitsplanschritt je Fertigungsauftrag: Arbeitsgang, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHoursGET, POST, PUT, DELETE
manufacturing/ShopOrderMaterialPlansMaterialpositionen je FertigungsauftragGET, POST, PUT, DELETE
manufacturing/WorkcentersCode, Typ, Fertigungsbereich, Kapazitätswert, KostensätzeGET, POST, PUT, DELETE
manufacturing/Operations, OperationResourcesArbeitsgänge mit der jeweils zugeordneten Arbeitsstation sowie Rüst- und LaufzeitenGET, POST, PUT, DELETE
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutingsStücklistenversionen, Komponenten und ArbeitsplanGET, POST, PUT, DELETE
manufacturing/TimeTransactionsGebuchte Stunden je Fertigungsauftrag und ArbeitsplanschrittGET, POST, PUT, DELETE
manufacturing/ShopOrderReceiptsAls Zugang gebuchte Fertigmengen aus einem FertigungsauftragGET, POST
manufacturing/MaterialIssuesFür einen Fertigungsauftrag entnommenes MaterialGET, POST
manufacturing/ShopOrderPrioritiesPrioritätsmodus je FertigungsauftragGET, PUT

Aus den anderen Diensten:

RessourceEnthaltene Daten
logistics/ItemsArtikelstamm
inventory/ItemWarehousesBestand je Artikel und Lager
purchaseorder/PurchaseOrders, PurchaseOrderLinesOffene Bestellungen und Wareneingangstermine
salesorder/SalesOrders, SalesOrderLinesKundenbedarf 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 OnlineObjekt in SkyPlannerRichtungHäufigkeit
ItemsProdukte und MaterialienExact Online → SkyPlannerErstimport, danach per Webhook
BillOfMaterialVersions, BillOfMaterialMaterialsProduktstruktur, Unterprodukte, Materialien je ProduktExact Online → SkyPlannerBei Änderungen
Workcenters, OperationResourcesArbeitsstationen, ArbeitsstationsgruppenExact Online → SkyPlannerErstimport
Operations, BillOfMaterialRoutingsProzessschritte mit Rüst- und LaufzeitenExact Online → SkyPlannerBei Änderungen
ShopOrdersAufträge mit Menge und FälligkeitsterminExact Online → SkyPlannerAlle paar Minuten
ShopOrderRoutingStepPlansArbeitsgänge mit Reihenfolge, Arbeitsstation sowie Rüst- und Laufzeiten in StundenExact Online → SkyPlannerAlle paar Minuten
ShopOrderMaterialPlansMaterialien je ArbeitsgangExact Online → SkyPlannerAlle paar Minuten
ItemWarehouses, StockPositionLagerbeständeExact Online → SkyPlannerWebhook
PurchaseOrderLinesBestellungen mit voraussichtlichem LieferdatumExact Online → SkyPlannerWebhook
SalesOrderLinesLiefertermine und Priorität der KundenaufträgeExact Online → SkyPlannerWebhook
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT)Geplanter Beginn, geplantes Ende und Arbeitsstation je ArbeitsgangSkyPlanner → Exact OnlineBei Änderungen per Webhook
ShopOrders: PlannedStartDate, PlannedDate (PUT)Auftragsbeginn und -endeSkyPlanner → Exact OnlineBei Änderungen per Webhook
TimeTransactions (POST)Zeitbuchungen und Rückmeldungen der BedienerSkyPlanner → Exact OnlineJe Rückmeldung oder je Schicht
ShopOrderReceipts (POST)Fertigmenge am letzten ArbeitsgangSkyPlanner → Exact OnlineJe Rückmeldung
Nicht in Exact Online geführtRüstzeitmatrix, Werkzeuge als begrenzt verfügbare Ressourcen, Bediener je Arbeitsgang, alternative Arbeitsstationen, SchichtenIn SkyPlanner gepflegtEinrichtung

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:

DatenFührendes System
Artikel, Stücklisten, Fertigungsauftragsmengen, Materialpläne, KostenExact Online
Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Zuordnung zu ArbeitsstationenSkyPlanner
Rüstzeitmatrix, Werkzeuge, Bediener je Arbeitsgang, alternative Ressourcen, SchichtenSkyPlanner
Zeitbuchungen und FertigmeldungenExact 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:

  1. Anforderungsaufnahme. Legen Sie Edition, Mandanten, Synchronisierungsintervalle, den Weg der Zeitbuchung und die Verbuchung der Fertigmeldungen fest.
  2. App und Autorisierung. Registrieren Sie die App. Anschließend erteilt ein Exact Online-Benutzer für jeden Mandanten die OAuth-Zustimmung.
  3. Erstimport. Arbeitsstationen, Arbeitsgänge, Artikel, Stücklistenversionen und Arbeitspläne einlesen.
  4. Aufträge synchronisieren. Fertigungsaufträge, Arbeitsgangpläne und Materialpläne werden zeitgesteuert synchronisiert, Bestände und Einkaufsdaten per Webhook.
  5. Planungsbedingungen in SkyPlanner einrichten. Schichten, Rüstzeitmatrix, Werkzeuge, Anzahl der Bediener je Arbeitsgang sowie alternative Maschinen oder Mitarbeiter festlegen.
  6. Planung zurückschreiben. Geplante Arbeitsgangtermine an Exact Online übertragen, anschließend Zeitbuchungen und Fertigmeldungen.
  7. 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. PlannedSetupHours und PlannedRunHours stammen 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, $filter auf Modified und 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?

  1. Das SkyPlanner-Team konfiguriert die Schnittstelle während der Einrichtung und betreut sie nach dem Produktivstart.
  2. Ihr Exact-Partner kann mitwirken. Er kennt Ihre Editionen, Mandanten und die Einrichtung Ihrer Fertigung.
  3. 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.

Erfahrungsbericht von Eskomatic lesen

Hannu Ryynänen, Geschäftsführer von Mamec, in der Produktionshalle des Unternehmens in Lohja

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.

Erfahrungsbericht von Mamec lesen

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.