Integrationen / ERP / E2 Shop System
E2 Shop System Schnittstelle: Leitfaden zur Feinplanung mit SkyPlanner APS
Dieser Leitfaden zur E2 Shop System Schnittstelle zeigt Partnern und IT-Teams, wie sie E2 Shop System (E2 SHOP) oder E2 MFG mit SkyPlanner APS verbinden. SkyPlanner tauscht Daten mit E2 in beide Richtungen aus:
- Aufträge und Fertigungsaufträge mit ihren Arbeitsgängen, Arbeitsstationen, Mitarbeitern und Schichten sowie Stücklisten, Materialbedarfe und Bestellungen werden übernommen.
- Geplante Start- und Endzeiten werden für jeden Arbeitsgang zurückgeschrieben, zusammen mit der von SkyPlanner zugewiesenen Maschine und dem zugewiesenen Mitarbeiter.
- Abgeschlossene Arbeitsgänge und erfasste Zeiten können auf Wunsch an den Fertigungsauftrag zurückgemeldet werden.
- SkyPlanner-Webhooks übertragen Planänderungen, sobald sie auftreten.
Das SkyPlanner-Team richtet die Schnittstelle beim Onboarding für Ihre E2-Installation ein und betreut sie auch nach dem Produktivstart. Dieser Leitfaden richtet sich an Partner und Entwickler, die daran mitwirken oder selbst auf der dokumentierten REST API von SkyPlanner aufbauen möchten (API-Referenz).
Welche E2-Version setzen Sie ein?
Klären Sie das zuerst, denn davon hängt der Integrationsweg ab:
| Ihr System | Heutige Einordnung | Integrationsweg |
|---|---|---|
| E2 Shop System (Desktop, auf Ihrem Server) | Das ursprüngliche E2 von Shoptech für Auftragsfertiger | Direkte Verbindung zu Ihrem E2-Server, bei Bedarf ergänzt durch Dateien |
| E2 MFG (E2 Manufacturing System) | Die E2-Version für Serienfertigung, diskrete Fertigung und Mischformen, von ECI als „for existing customers“ (für Bestandskunden) geführt | Wie bei lokal betriebenem E2 Shop System |
| Gehostetes E2 SHOP | Die Webplattform, die ECI als JobBOSS² neu entwickelt hat | Wenn Sie inzwischen JobBOSS² einsetzen, nutzen Sie den Leitfaden zur JobBOSS²-Schnittstelle |
ECI bezeichnet JobBOSS² als „formerly E2 Shop“ (ehemals E2 Shop) und erklärt, es „combines E2 SHOP’s cloud-native, user-friendly platform with JobBOSS‘ depth of functionality“ (verbindet die cloudnative, benutzerfreundliche Plattform von E2 SHOP mit dem Funktionsumfang von JobBOSS) (ECI). Der weitere Leitfaden behandelt Betriebe, die E2 Shop System oder E2 MFG einsetzen.
Integrationswege für E2
Die von ECI auf der Website ECI Manufacturing API Documentation veröffentlichten Fertigungs-APIs sind für JobBOSS², M1, Macola und Deacom vorgesehen. E2 wird dagegen direkt an der Installation angebunden. Das passt gut zum lokalen Betrieb von E2: Die Daten liegen auf einem Server, den Ihr eigenes IT-Team verwaltet. Wie Daten in Ihrer Installation genau gelesen und geschrieben werden, wird bei der Anforderungsaufnahme im Rahmen des Onboardings festgelegt.
- Direkte Serververbindung (On-Premise). Ein Integrationsdienst in Ihrem Netzwerk liest offene Fertigungsaufträge, Arbeitsgänge, Arbeitsstationen, Mitarbeiter, Materialien und Bestellungen aus der E2-Datenbank. Geplante Start- und Endzeiten schreibt er in die jeweiligen Arbeitsgänge zurück. Ihr IT-Team gibt den Zugriff, ein eigenes Dienstkonto und die zu beschreibenden Felder frei. Dies ist der Hauptweg für eine laufende bidirektionale Integration.
- Zeitgesteuerte Exporte und Importe. Über Berichte und Tabellenexporte in E2 lassen sich Fertigungsaufträge, Arbeitspläne und Arbeitsstationen als CSV- oder Excel-Dateien ausgeben. Der Datenimport von SkyPlanner liest diese Dateien ein. Dieser Weg eignet sich für die Testphase und auch für Stammdaten, die Sie nur gelegentlich laden.
- Gehostete Installationen. Wird E2 von ECI gehostet, wird der Datenzugriff mit ECI vereinbart. Sprechen Sie Ihren ECI-Kundenbetreuer frühzeitig darauf an.
Auf der SkyPlanner-Seite liest und schreibt die REST API Aufträge, Produkte, Materialien, Prozessschritte, Zeiterfassungen und Bestellungen. Die Authentifizierung erfolgt ü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.
Ereignisse und Polling
E2 wird per Polling abgefragt. Der Integrationsdienst liest Fertigungsaufträge und Arbeitsgänge, die sich seit dem letzten Lauf geändert haben. Fertigungsaufträge werden alle paar Minuten abgefragt, Bestände und Bestellungen stündlich – nach Vereinbarung mit dem jeweiligen Betrieb.
SkyPlanner sendet Webhooks, wenn sich der Status oder der Plan ändert. Der Dienst empfängt sie und schreibt die neuen Termine sofort nach E2 zurück. Das Zurückschreiben erfolgt somit ereignisgesteuert. Ereignisse aus der Fertigung können auch zeitgesteuert über den SkyPlanner-Endpunkt /timelogs ausgelesen werden.
Datenzuordnung
| E2-Objekt | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|
| Artikel und Kalkulationen, mehrstufige Stücklisten | Produkte, Materialien, Produktstruktur | E2 → SkyPlanner | Erstimport, danach bei Änderungen |
| Arbeitsgänge im Arbeitsplan: Arbeitsstation, Rüstzeit, Bearbeitungszeit | Prozessschritte mit Dauer und Rüstzeiten | E2 → SkyPlanner | Erstimport, danach bei Änderungen |
| Arbeitsstationen und Maschinen | Arbeitsstationen, Arbeitsstationsgruppen, Wirkungsgrade | E2 → SkyPlanner | Erstimport, danach selten |
| Mitarbeiter, Schichten, Abteilungen, arbeitsfreie Tage | Personal, Schichten, Kalender | E2 → SkyPlanner | Täglich oder Schichten direkt in SkyPlanner pflegen |
| Aufträge und Fertigungsaufträge: Auftragsnummer, Artikel, Menge, Fälligkeitstermin, Priorität, Eilkennzeichen | Aufträge mit Fälligkeitsterminen und Prioritäten | E2 → SkyPlanner | Polling alle paar Minuten |
| Arbeitsgänge des Fertigungsauftrags: Status, fertiggestellte Menge, Reststunden | Arbeitsgänge je Prozessschritt | E2 → SkyPlanner | Polling alle paar Minuten |
| Materialbedarfe, Bestellungen mit Fälligkeitsterminen | Materialbedarfe, Bestellungen nach Liefertermin | E2 → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Geplanter Start und geplantes Ende je Arbeitsgang, Arbeitsstation, Mitarbeiter | Geplanter Start und geplantes Ende, Maschine und Bediener je Prozessschritt | SkyPlanner → E2 | Bei Planänderungen per SkyPlanner-Webhook |
| Erfasste Zeiten und fertiggestellte Mengen je Arbeitsgang | Zeiterfassungen und Rückmeldungen der Bediener | SkyPlanner → E2 | Je Rückmeldung oder Schicht, sofern gewünscht |
| Nicht in E2 | Rüstzeitmatrix, Werkzeuge als begrenzte Ressourcen, alternative Maschinen und Mitarbeiter | Pflege in SkyPlanner | Einrichtung beim Onboarding |
Integrationsabläufe
1. Stammdaten erstmalig laden. Lesen Sie Artikel, Stücklisten, Arbeitspläne, Arbeitsstationen, Mitarbeiter und Schichten ein. Legen Sie bewusst fest, wie Arbeitsstationen abgebildet werden: Eine Arbeitsstation mit drei Fräsmaschinen wird zu einer Arbeitsstationsgruppe oder zu drei Arbeitsstationen, damit SkyPlanner jede Maschine einzeln einplant.
2. Fertigungsaufträge synchronisieren. Lesen Sie offene Fertigungsaufträge mit ihren Arbeitsgängen, Materialbedarfen und offenen Bestellungen ein. SkyPlanner betrachtet bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert ist. Überspringen Sie abgeschlossene und zurückgestellte Fertigungsaufträge. Übernehmen Sie das Eilkennzeichen als Priorität in SkyPlanner.
3. Planung zurückschreiben. Wenn die Planungsengine einen Prozessschritt einplant oder verschiebt, löst ein SkyPlanner-Webhook den Dienst aus. Dieser schreibt die geplante Start- und Endzeit in den entsprechenden Arbeitsgang in E2. Hat SkyPlanner den Prozessschritt einer anderen Maschine oder Person zugewiesen, werden auch Arbeitsstation und Mitarbeiter zurückgeschrieben. Whiteboard und Planning Board zeigen dann die Termine aus SkyPlanner an.
4. Rückmeldungen aus der Fertigung. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Diese Zeiterfassungen halten den Plan aktuell. Sie entscheiden, ob Istzeiten nach E2 zurückgeschrieben werden. Wenn ja, werden Zeit und Menge jeder Rückmeldung im jeweiligen Arbeitsgang gebucht. Wenn nicht, bleibt E2 Data Collection unverändert und SkyPlanner liest den Fortschritt aus den Arbeitsgängen.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Kalkulationen, Arbeitspläne, Mengen, Fälligkeitstermine, Auftragsstatus | E2 |
| Reihenfolge der Prozessschritte, Start- und Endzeiten, Maschine und Bediener je Prozessschritt | SkyPlanner |
| Rüstzeitmatrix, Werkzeug- und Personalbedarf, alternative Ressourcen | SkyPlanner |
| Schichten und arbeitsfreie Tage | Ein System, bei der Anforderungsaufnahme festgelegt |
| Zeiten, Materialentnahmen, Wareneingänge, Kostenrechnung | E2; dort erfasst oder aus SkyPlanner-Zeiterfassungen gebucht |
Legen Sie genau ein System fest, das die Termine der Arbeitsgänge schreibt. Planer verschieben die Arbeit in SkyPlanner, und die Termine werden an E2 übertragen. Bei Fertigungsaufträgen, die SkyPlanner einplant, dürfen Karten nicht mehr auf dem Planning Board verschoben werden. Sonst laufen die beiden Pläne auseinander.
Typischer Projektablauf
Die Implementierung ist in der Regel innerhalb weniger Wochen nach Beginn des Onboardings abgeschlossen. Prüfen Sie den Plan vorab in der kostenlosen 30-tägigen Testphase mit Arbeitsstationen, Arbeitsplänen und offenen Fertigungsaufträgen, die Sie als CSV- oder Excel-Datei aus E2 exportieren.
- Anforderungsaufnahme. Klären Sie die E2-Edition und -Version, den Server, die Zuordnungstabelle, die Regeln zur Datenhoheit und ob Zeiten zurückgemeldet werden.
- Zugriff. Ihr IT-Team legt das Dienstkonto an und genehmigt die Lese- und Schreibzugriffe. Erstellen Sie eine vollständige E2-Sicherung und testen Sie zunächst mit einer Kopie der Unternehmensdaten.
- Erstimport. Teile, Stücklisten, Arbeitspläne, Arbeitsstationen, Mitarbeiter und Schichten.
- Fertigungsaufträge und Bestellungen synchronisieren. Änderungsbasierte Abfragen mit Wiederholungsversuchen und Protokollierung.
- Restriktionen in SkyPlanner einrichten. Rüstzeitmatrix, Werkzeuge, Anzahl der Bediener je Arbeitsgang sowie alternative Maschinen oder Mitarbeiter.
- Plan zurückschreiben. Termine per Webhook in die Arbeitsgänge zurückschreiben, auf Wunsch auch Zeiten und Mengen.
- Parallel testen. Nutzen Sie SkyPlanner parallel zum bisherigen Whiteboard, vergleichen Sie die Termine und korrigieren Sie die Stammdaten.
- Produktivstart. Aktivieren Sie das Zurückschreiben, sobald die Daten übereinstimmen.
Was Sie bei einer E2-Integration einplanen sollten
- Edition und Version. Installationen von E2 Shop System und E2 MFG unterscheiden sich je nach Version. Klären Sie Ihre Version bei der Anforderungsaufnahme und testen Sie die Integration nach jedem E2-Update erneut.
- Ihr Server, Ihre Regeln. Bei einer lokalen Installation läuft E2 in Ihrem Netzwerk. Vereinbaren Sie mit Ihrer IT, wo der Integrationsdienst läuft, welches Konto er verwendet und welche Felder er beschreiben darf.
- Maschinen hinter den Arbeitsstationen. Eine Arbeitsstation kann eine einzelne Maschine, eine Gruppe oder eine Fertigungszelle abbilden. Legen Sie vor dem Erstimport fest, wie diese den Arbeitsstationen in SkyPlanner zugeordnet werden.
- Fremdbearbeitung. Arbeitsschritte bei einem Lieferanten bedeuten Durchlaufzeit, beanspruchen aber nicht Ihre Kapazität. Bilden Sie sie als rein zeitbasierte Schritte ab.
- Zeiteinheiten. Rüst- und Bearbeitungszeiten können pro Stück, pro Los oder pro Stunde angegeben sein. Rechnen Sie diese beim Import um, sonst ist jede Dauer falsch.
- Eilaufträge. E2 kennzeichnet Fertigungsaufträge mit hoher Priorität. Ordnen Sie diese Kennzeichnung der Priorität in SkyPlanner oder Fast Track zu, damit dringende Arbeiten ihren Vorrang behalten.
- Planen Sie einen Wechsel zu JobBOSS²? Richten Sie die SkyPlanner-Seite nur einmal ein. In JobBOSS² wird derselbe Plan über die JobBOSS² API (gehostet) oder die ERP API von ECI angebunden. Einzelheiten finden Sie im Leitfaden zu JobBOSS².
Wer die E2-Integration einrichtet und betreut
- Das SkyPlanner-Team richtet die Integration beim Onboarding ein und betreut sie nach dem Produktivstart für die vereinbarten Objekte und Synchronisierungsregeln. Jeder Betrieb nutzt E2 anders. Dieses Wissen fließt hier ein.
- Ihr E2-Partner oder IT-Dienstleister kann mitwirken. Er kennt Ihren Server und Ihre E2-Konfiguration und kann sich gemeinsam mit dem SkyPlanner-Team um die Zugriffe und das Dienstkonto kümmern.
- Ihre eigenen Entwickler können darauf aufbauen und die REST API von SkyPlanner mit einem API-Token nutzen. 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 bei 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 E2 Shop System, auf der Seite zu E2 Shop System, unter SkyPlanner-Funktionen und in der Übersicht der ERP-Integrationen.
Fertigungsunternehmen, die SkyPlanner nutzen
2 hZeitersparnis pro Woche
„Mit SkyPlanner sind wir in der Produktionsplanung von Excel-Tabellen zur Produktionsoptimierung in Echtzeit übergegangen.“
Kalle Kalliomäki, Supply-Chain-Spezialist
UTU · Elektrische Verteilungen und Schaltanlagen
Die Produktionsplanung spart jede Woche 2 Stunden Arbeitszeit, und eine neue Auftragsreihenfolge erreicht die Fertigungslinie innerhalb von 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 ist in weniger als 30 Minuten erstellt.
Mehrere 1.000Fertigungsaufträge automatisch eingeplant
„Wir haben die Produktion auf ganz andere Weise im Griff, und unser Verständnis der Kapazitäten ist auf einem völlig neuen Niveau.“
Hannu Ryynänen, Geschäftsführer
Mamec · Industriemischer, Pumpen und Hightech-Auftragsfertigung
Tausende Fertigungsaufträge werden automatisch eingeplant. Das gesamte Unternehmen hat dabei in Echtzeit Einblick in die Produktion.
98%Liefertreue, zuvor etwa 50%
„SkyPlanner spielt eine entscheidende Rolle dabei, unsere Liefertreue aufrechtzuerhalten.“
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.
Häufig gestellte Fragen
Hat E2 Shop System eine API?
Die von ECI veröffentlichten APIs für die Fertigung unterstützen JobBOSS², M1, Macola und Deacom. Bei lokal betriebenen Installationen von E2 Shop System und E2 MFG erfolgt die Anbindung vor Ort: Ein Integrationsdienst in Ihrem Netzwerk liest und schreibt E2-Daten mit den von Ihrem IT-Team genehmigten Zugriffsrechten. Den Rest decken Dateiexporte ab.
Wie werden geplante Termine nach E2 zurückgeschrieben?
Für jeden Arbeitsgang einzeln. Ein Webhook von SkyPlanner löst den Integrationsdienst aus. Dieser schreibt die geplante Start- und Endzeit in den Arbeitsgang in E2. Hat SkyPlanner den Arbeitsgang verschoben, werden auch die Arbeitsstation und der Mitarbeiter übertragen.
Kann SkyPlanner Zeiten aus der Fertigung an E2 zurückmelden?
Ja, wenn Sie das wünschen. Jede Rückmeldung in SkyPlanner wird als Zeit und Menge am Arbeitsgang erfasst. Betriebe, die E2 Data Collection bevorzugen, nutzen es weiter. SkyPlanner liest dann den Fortschritt aus E2.
Wir nutzen gehostetes E2 SHOP. Welcher Leitfaden gilt für uns?
Aus dem gehosteten E2 SHOP wurde JobBOSS². Wenn Sie sich inzwischen bei JobBOSS² anmelden, nutzen Sie den Integrationsleitfaden für JobBOSS². Falls Sie weiterhin gehostetes E2 einsetzen, wird der Datenzugriff bei der Anforderungsaufnahme mit ECI abgestimmt.
Bleibt die Integration bei einem späteren Wechsel zu JobBOSS² erhalten?
Auf der SkyPlanner-Seite bleibt alles gleich: Arbeitsstationen, Restriktionen, die Rüstzeitmatrix und Ihr Plan. Nur die E2-Anbindung wird durch die JobBOSS² API oder die ERP API von ECI ersetzt.
Können wir SkyPlanner testen, bevor die Integration umgesetzt wird?
Ja. In der kostenlosen 30-tägigen Testphase können Sie bis zu 20 Arbeitsstationen mit CSV- oder Excel-Importen aus E2 nutzen. Eine Kreditkarte ist nicht erforderlich. Starten Sie die Testphase oder sprechen Sie mit dem Vertrieb, um die Anforderungen an die Integration aufzunehmen.
