Integrationen / ERP / SYSPRO
Leitfaden zur SYSPRO Schnittstelle für die Feinplanung mit SkyPlanner APS
Dieser Leitfaden zeigt Partnern und IT-Teams, wie sie SYSPRO 8 mit SkyPlanner APS verbinden. SkyPlanner tauscht Daten in beide Richtungen mit SYSPRO aus und nutzt dafür die SYSPRO-eigenen Schnittstellen:
- Fertigungsaufträge, zugehörige Arbeitsgänge, Structures and Routings, Arbeitsstationen, Maschinen, Stock Codes, Lagerbestände und Bestellungen werden eingelesen.
- Geplante Start- und Endtermine werden in die Fertigungsaufträge zurückgeschrieben.
- Auf Wunsch lassen sich die erfassten Zeiten der Mitarbeiter als Arbeitszeiten zurückmelden.
- SkyPlanner-Webhooks übertragen Planänderungen, sobald sie auftreten.
Das SkyPlanner-Team passt die Schnittstelle beim Onboarding an Ihre SYSPRO-Umgebung an und betreut sie auch nach dem Produktivstart. 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).
Die Integrationsschnittstellen von SYSPRO
SYSPRO bietet einem externen Feinplanungssystem zwei Wege für den Datenzugriff:
- e.net Solutions Business Objects. Damit wird die Geschäftslogik von SYSPRO von außen aufgerufen; Ein- und Ausgabe erfolgen im XML-Format. Es gibt drei Gruppen: Query (zum Beispiel WIPQBL, WIP Balance Query), Transaction oder Post (zum Beispiel WIPTJB, WIP Job Creation and Maintenance) und Setup für Stammdaten. Business Objects prüfen die Daten nach denselben Regeln wie die SYSPRO-Masken und bleiben über Releases hinweg kompatibel. Der Best-Practice-Leitfaden von SYSPRO formuliert es klar: „SYSPRO’s Business Objects are used to query and post data to SYSPRO.“ (Die Business Objects von SYSPRO dienen dazu, Daten aus SYSPRO abzufragen und in SYSPRO zu schreiben.)
- SYSPRO OData Service (OData v4). Bietet ausschließlich lesenden RESTful-Zugriff auf die Mandanten- und Systemdatenbanken sowie auf Business Activity Queries, also in SYSPRO definierte SQL-Views. Der Dienst ist ab SYSPRO 8 2021 R2 verfügbar. Für SYSPRO Cloud ERP gilt: „Syspro OData is the only mechanism available when applications need access to SYSPRO data.“ (Syspro OData ist der einzige verfügbare Zugriffsweg für Anwendungen, die auf SYSPRO-Daten zugreifen müssen.)
Business Objects werden über den Dienst e.net Communications aufgerufen, entweder mit dem SYSPRO WCF Service oder dem SYSPRO Web Service.
Master Data Take On (IMPIMP) importiert Tabellen über Setup Business Objects und eignet sich für das einmalige Einlesen von Stammdaten. SYSPRO Harmony erreicht am 31. Dezember 2026 sein Supportende. Entwickeln Sie daher nichts Neues mehr darauf.
Authentifizierung und Lizenzierung
- e.net-Anmeldung. Die Schnittstelle meldet sich als SYSPRO Operator bei einem Mandanten an und erhält eine Sitzungs-GUID für die weiteren Aufrufe.
- Lizenzierung. Die vom Operator aufgerufenen Funktionsbereiche der Business Objects müssen in Ihrer SYSPRO-Lizenz für ihn freigeschaltet sein.
- OData. Der Zugriff erfolgt über HTTPS mit Operatoren, die für OData konfiguriert sind.
Auf der SkyPlanner-Seite erfolgt die Authentifizierung für die REST API mit einem API-Token (SkyPlanner Settings > API). Die API ist in Swagger/OpenAPI dokumentiert. Das Integrationstutorial führt durch die ersten Aufrufe.
Ereignisse und Polling
SYSPRO sendet keine ausgehenden Webhooks. Electronic Signature Transaction Setup kann nach einer erfolgreichen Transaktion Trigger auslösen, etwa eine E-Mail oder ein VBScript. SYSPRO stellt jedoch klar: „It is not intended that triggers from e.net Business Objects fire VBScript triggers.“ (Es ist nicht vorgesehen, dass Trigger aus e.net Business Objects VBScript-Trigger auslösen.)
Die SYSPRO-Seite wird deshalb per Polling abgefragt. Abfragen über Business Objects oder OData werden auf offene Fertigungsaufträge und jüngste Änderungen gefiltert, um neue Aufträge zu erfassen. Die Intervalle werden je Werk festgelegt: von wenigen Minuten bei Fertigungsaufträgen bis zu einer Stunde bei Lagerbeständen.
SkyPlanner sendet Webhooks, wenn sich der Status oder der Produktionsplan ändert. Das Zurückschreiben erfolgt daher ereignisgesteuert.
Datenzuordnung
| SYSPRO-Objekt (Schnittstelle) | Objekt in SkyPlanner | Richtung | Häufigkeit |
|---|---|---|---|
| Stock Codes, Mengeneinheiten (OData oder Query Business Objects) | Produkte und Materialien | SYSPRO → SkyPlanner | Erstimport, danach Polling |
| Structures (Komponenten, fiktive Artikel, Kuppelprodukte) | Produktstruktur, Unterprodukte, Materialien je Produkt | SYSPRO → SkyPlanner | Erstimport, danach bei Änderungen |
| Routings: Arbeitsstation, Rüst-, Bearbeitungs-, Warte- und Transportzeit, Maximum units | Arbeitsschritte mit Dauer sowie Rüst- und Abrüstzeiten | SYSPRO → SkyPlanner | Erstimport, danach bei Änderungen |
| Work Centers (Produktionseinheiten, Kapazität) und Machines | Arbeitsstationen, Arbeitsstationsgruppen, Wirkungsgrade | SYSPRO → SkyPlanner | Erstimport, danach selten |
| Capacity Calendar, Shift Patterns | Schichten und arbeitsfreie Tage | SYSPRO → SkyPlanner | Täglich oder eigene Schichten in SkyPlanner |
| Fertigungs- und Unteraufträge (WipMaster), zugehörige Arbeitsgänge und Materialien | Aufträge und Arbeitsgänge mit Fälligkeitsterminen und Materialbedarf | SYSPRO → SkyPlanner | Polling alle paar Minuten |
| Vorhandener Lagerbestand je Stock Code | Lagerbestände | SYSPRO → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Bestellungen mit Fälligkeitsterminen | Bestellungen, erwartete Materialeingänge nach Liefertermin | SYSPRO → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Geplante Start- und Endtermine des Fertigungsauftrags (WIPTJB, WIP Job Creation and Maintenance) | Geplanter Start und geplantes Ende je Arbeitsgang | SkyPlanner → SYSPRO | Bei Planänderung über einen SkyPlanner-Webhook |
| Labor Posting: Rüst- und Bearbeitungszeit je Auftragsarbeitsgang, Maschine und Mitarbeiter | Zeiterfassungen und Mitarbeiterrückmeldungen | SkyPlanner → SYSPRO | Je Rückmeldung oder Schicht, falls gewünscht |
| Job Receipts (Business Object WIP Job Receipts) | Fertiggestellte Mengen | SkyPlanner → SYSPRO | Je Rückmeldung, falls gewünscht |
| Nicht in SYSPRO | Rüstzeitmatrix, Werkzeuge als begrenzt verfügbare Ressourcen, alternative Maschinen und Mitarbeiter | Pflege in SkyPlanner | Einrichtung beim Onboarding |
Integrationsabläufe
1. Stammdaten erstmals einlesen. Lesen Sie Stock Codes, Structures and Routings, Arbeitsstationen, Maschinen und Kalender über OData oder Query Business Objects ein. Legen Sie die Zuordnung der Arbeitsstationen in SkyPlanner bewusst fest: Eine Arbeitsstation mit vier Maschinen wird zu einer Arbeitsstationsgruppe oder zu vier Arbeitsstationen.
2. Fertigungsaufträge synchronisieren. Lesen Sie aktuelle Fertigungsaufträge mit ihren Arbeitsgängen und Materialien sowie offene Bestellungen ein. SkyPlanner behandelt bestelltes Material ab dem Liefertermin der Bestellung als verfügbar und aktualisiert den Lagerbestand, sobald die Bestellung den Status Delivered erhält.
Planen Sie nur tatsächlich angelegte Fertigungsaufträge ein. Auftragsvorschläge verbleiben im MRP-Snapshot, bis MRP Job Review sie in Fertigungsaufträge umwandelt.
3. Planungstermine zurückschreiben. Wenn die Planungsengine einen Arbeitsgang einplant oder verschiebt, löst ein SkyPlanner-Webhook einen Schreibaufruf an das Business Object WIP Job Creation and Maintenance (WIPTJB) aus. Dieser setzt die geplanten Start- und Endtermine des Fertigungsauftrags. Das Business Object prüft die Änderung genau wie Job Entry.
4. Rückmeldungen aus der Fertigung. Mitarbeiter erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Diese Zeiterfassungen halten den Produktionsplan aktuell. Sie entscheiden, ob Istzeiten an SYSPRO zurückgemeldet werden. Falls ja, gehen Rüst- und Bearbeitungszeiten je Auftragsarbeitsgang an Labor Posting und fertiggestellte Mengen an Job Receipts. Falls nein, werden die Arbeitszeiten wie bisher in SYSPRO erfasst.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Stock Codes, Structures and Routings, Mengen, Auftragsstatus | SYSPRO |
| Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Maschinenzuordnung | SkyPlanner |
| Rüstzeitmatrix, Werkzeug- und Personalbedarf, alternative Ressourcen | SkyPlanner |
| Schichten und arbeitsfreie Tage | Ein System, das bei der Anforderungsaufnahme festgelegt wird |
| Arbeitszeiten, Materialentnahmen und Wareneingänge | SYSPRO; dort erfasst oder aus SkyPlanner-Zeiterfassungen gebucht |
Legen Sie genau ein System fest, das die Auftragstermine aktualisiert. SkyPlanner benötigt kein Feinplanungsmodul von SYSPRO und ersetzt daher Factory Scheduling, Visual APS oder APS (Nexsys) bei der Pflege der geplanten Termine. Falls eines dieser Module weiterhin geplante Termine aktualisiert, deaktivieren Sie dies für die von SkyPlanner geplanten Fertigungsaufträge. In Factory Scheduling heißt die Option in Job Entry „Update planned dates to scheduled dates.“ (Geplante Termine auf die eingeplanten Termine aktualisieren.)
Typischer Projektablauf
Die Implementierung ist normalerweise innerhalb weniger Wochen nach Beginn des Onboardings abgeschlossen. Prüfen Sie zuvor den Produktionsplan im kostenlosen 30-tägigen Test mit Arbeitsstationen, Arbeitsplänen und offenen Fertigungsaufträgen, die Sie aus SYSPRO als CSV- oder Excel-Datei exportiert haben.
- Datenzuordnung. Legen Sie die Zuordnungstabelle, die Datenhoheit und die Synchronisationsintervalle fest. Entscheiden Sie außerdem, ob Arbeitszeiten zurückgemeldet werden.
- SYSPRO-Zugriff. Legen Sie den Operator für die Schnittstelle an, prüfen Sie die Lizenzierung der Business Objects und aktivieren Sie OData, sofern es genutzt wird. Testen Sie zunächst in einer Kopie des Mandanten.
- Erstimport. Stock Codes, Structures and Routings, Arbeitsstationen, Maschinen und Kalender.
- Fertigungsaufträge und Bestellungen synchronisieren. Polling mit Filtern, seitenweiser Abfrage und Wiederholungsversuchen.
- Restriktionen in SkyPlanner einrichten. Rüstzeitmatrix, Werkzeuge, Mitarbeiteranzahl je Arbeitsgang sowie alternative Maschinen oder Mitarbeiter.
- Planungstermine zurückschreiben. Schreibaufrufe an WIPTJB über SkyPlanner-Webhooks, auf Wunsch zusätzlich Arbeitszeitbuchungen.
- Parallel testen. Lassen Sie SkyPlanner parallel zur bisherigen Planung laufen, vergleichen Sie Termine und korrigieren Sie Stammdaten.
- Produktivstart. Aktivieren Sie das Zurückschreiben, sobald die Daten übereinstimmen.
Worauf Sie bei einer SYSPRO-Integration achten sollten
- _TMP-Aufträge. Testläufe mit begrenzter Kapazität in Job Entry können _TMP-Aufträge in WipMaster erzeugen. Filtern Sie diese bei jedem Lesezugriff heraus.
- Begonnene Arbeitsgänge. Forward Finite Scheduling meldet Fehler bei begonnenen Arbeitsgängen, die sich nicht einplanen lassen. Lesen Sie vor jedem Planungslauf den Arbeitsfortschritt in SkyPlanner ein, damit die Planung auf der bereits erledigten Arbeit aufsetzt. Running Time Lock fixiert anschließend die für die nächsten Stunden eingeplanten Arbeitsgänge.
- Zeiteinheiten im Arbeitsplan. Rüst-, Bearbeitungs-, Warte- und Transportzeiten benötigen jeweils die richtige Einheit und Bezugsgröße. Warte- und Transportzeiten sind Wartezeiten, keine Maschinenbelegungszeiten. Rechnen Sie die Werte beim Import um, sonst ist jede Zeitdauer falsch.
- Fremdbearbeitung. Offsite Days und Dock to Stock Days geben Zeitspannen an und beanspruchen keine Ihrer Kapazitäten. Bilden Sie sie als Schritte ab, die nur Zeit beanspruchen.
Wer richtet die SYSPRO-Schnittstelle ein und betreut sie?
- Das SkyPlanner-Team richtet die Schnittstelle beim Onboarding ein und betreut sie nach dem Produktivstart. Das umfasst die vereinbarten Business Objects und OData-Abfragen. Jedes Werk nutzt SYSPRO anders. Dieses Wissen fließt in die Einrichtung ein.
- Ihr SYSPRO-Partner kann mitwirken. Er kennt Ihre Konfiguration, individuellen Formulare und Lizenzierung und kann gemeinsam mit dem SkyPlanner-Team den Operator und den OData-Zugang einrichten.
- Ihre eigenen Entwickler können die Integration erweitern. Dafür nutzen sie die REST API von SkyPlanner mit einem API-Token. Ein API-Token genügt für den Einstieg; bei Bedarf unterstützt das SkyPlanner-Team. Technische Informationen finden Sie in der SkyPlanner-Integrationsdokumentation.
SkyPlanner ist ab 199 € pro Monat erhältlich, inklusive 5 Arbeitsstationen und mit monatlicher Abrechnung. Für die Integration erhalten Sie vorab zusammen mit Ihrem Tarif ein Angebot, das auf Ihre Abläufe und Anforderungen abgestimmt ist. Weitere Informationen finden Sie unter Preise, Feinplanung für SYSPRO, auf der SYSPRO-Seite und in der Übersicht der ERP-Schnittstellen.
Erfahrungen von Fertigungsunternehmen mit SkyPlanner
2 hZeitersparnis pro Woche
„Mit SkyPlanner haben wir unsere Produktionsplanung von Excel-Tabellen auf die Optimierung der Produktion in Echtzeit umgestellt.“
Kalle Kalliomäki, Supply-Chain-Spezialist
UTU · Schalttafeln und Schaltanlagen
Bei der Produktionsplanung werden jede Woche 2 Stunden Arbeitszeit eingespart. Eine neue Auftragsreihenfolge erreicht die Fertigungslinie in Sekunden.
+90%Produktionseffizienz
„Die Effizienz in der Produktion ist um 90% gestiegen.“
Abdul Rucyinga, IT-Leiter
Laboratory & Allied · Pharmazeutische Fertigung
Die Produktionseffizienz ist um 90% gestiegen. Ein optimierter Plan für drei Monate über alle Arbeitsstationen hinweg lässt sich in weniger als 30 Minuten erstellen.
98%Liefertreue, zuvor etwa 50%
„SkyPlanner trägt entscheidend dazu bei, unsere Liefertreue zu halten.“
Hannu Lahtinen, Geschäftsführer
KJH-Comp · Blechbearbeitung und Auftragsfertigung
Die Liefertreue stieg von rund 50% auf bis zu 98%. Für die Feinplanung wird jetzt nur noch eine Führungskraft statt zwei benötigt.
99,2%Liefertreue
„SkyPlanner macht Engpässe sichtbar und hat mehr Klarheit in die Produktionssteuerung gebracht.“
Toni Tuori, Produktionsleiter
Piristeel · Dachsicherheits- und Regenwassersysteme
Die Liefertreue erreichte dieses Jahr 99,2%. Bei der Feinplanung werden täglich bis zu vier Stunden Arbeitszeit eingespart.
Häufige Fragen
Hat SYSPRO eine API für Fertigungsaufträge?
Ja. Über e.net Solutions Business Objects lassen sich SYSPRO-Daten abfragen und schreiben, unter anderem mit WIPTJB zum Anlegen und Pflegen von Fertigungsaufträgen. Der SYSPRO OData-Dienst bietet zusätzlich einen RESTful-Zugriff auf Tabellen und Business Activity Queries, allerdings nur lesend.
Unterstützt SYSPRO Webhooks?
Keine ausgehenden Webhooks. Die Trigger in Electronic Signature Transaction Setup sind nicht dafür vorgesehen, durch Aufrufe von Business Objects ausgelöst zu werden. Deshalb fragt die Schnittstelle SYSPRO in einem für jedes Werk festgelegten Intervall ab. Die eigenen Webhooks von SkyPlanner übertragen Planänderungen, sobald sie auftreten.
Wie werden geplante Termine an SYSPRO zurückgeschrieben?
Über das Business Object WIP Job Creation and Maintenance (WIPTJB), das die geplanten Start- und Endtermine des Fertigungsauftrags setzt. SYSPRO prüft die übermittelten Daten nach denselben Regeln wie in Job Entry.
Funktioniert die Schnittstelle mit SYSPRO Cloud ERP?
Ja. SkyPlanner liest Daten aus Cloud ERP über den SYSPRO OData-Dienst. SYSPRO nennt diesen als einzigen Weg für den Datenzugriff in Cloud ERP. Den Weg zum Zurückschreiben richtet das SkyPlanner-Team während der Anforderungsaufnahme gemeinsam mit Ihnen und Ihrem SYSPRO-Partner ein.
Sollte ein SYSPRO-Partner SYSPRO MOM Visual APS oder SkyPlanner empfehlen?
SkyPlanner, wenn der Kunde innerhalb von Wochen eine funktionierende Feinplanung benötigt, die die verfügbaren Kapazitäten berücksichtigt. Visual APS gehört zur SYSPRO MOM-Suite, hat eine eigene Lizenz und wird mit Anbindung an den SYSPRO SQL Server installiert. Für Benutzer von MOM Workbench sind Einzelplatzlizenzen erforderlich (SYSPRO-Hilfe). SkyPlanner wird über e.net Business Objects und OData angebunden, plant automatisch neu und berücksichtigt Umrüstungen, Werkzeuge, Teams und Material. Die Nutzerzahl ist unbegrenzt, der Preis beginnt bei 199 € pro Monat.
Können wir SkyPlanner testen, bevor die Schnittstelle entwickelt wird?
Ja. Mit der kostenlosen 30-Tage-Testversion können Sie bis zu 20 Arbeitsstationen nutzen und Daten aus SYSPRO per CSV oder Excel importieren. Eine Kreditkarte ist nicht erforderlich. Jetzt testen oder den Vertrieb kontaktieren, um die Anforderungen an die Schnittstelle aufzunehmen.