Integrationen / ERP / PSIpenta
Leitfaden zur PSIpenta-Schnittstelle für die Feinplanung mit SkyPlanner APS
Dieser Leitfaden zur PSIpenta-Schnittstelle zeigt PSI-Partnern und IT-Teams, wie sie PSIpenta/ERP mit SkyPlanner APS verbinden. SkyPlanner tauscht Daten in beide Richtungen mit PSIpenta aus und nutzt dafür die Schnittstellen von PSI:
- Fertigungsaufträge mit ihren Arbeitsgängen, Arbeitspläne, Stücklisten, Arbeitsstationen, Maschinen, Werkzeuge (Betriebsmittel), Lagerbestände und Bestellungen werden übernommen.
- Geplanter Start, geplantes Ende und Arbeitsstation werden je Arbeitsgang in den Fertigungsauftrag zurückgeschrieben.
- Auf Wunsch können die von den Mitarbeitenden erfassten Zeiten als BDE-Rückmeldungen zurückgebucht werden.
- SkyPlanner-Webhooks übertragen Planänderungen, sobald sie auftreten.
Das SkyPlanner-Team richtet die Schnittstelle beim Onboarding passend zu Ihrer PSIpenta-Installation ein 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).
Schnittstellen von PSIpenta
PSI bietet drei Wege, ein externes Feinplanungssystem anzubinden (PSI-Broschüre):
- PSIpenta/ERP REST API. PSI nennt eine REST- und SOAP-API für PSIpenta/ERP und gibt an, dass sich alle PSIpenta-Komponenten über RESTful Webservices in bestehende Architekturen integrieren lassen. Dies ist der Hauptweg, um Produktionsdaten zu lesen und geplante Termine zu schreiben.
- PSIpenta/BDE REST and SOAP API. Das Modul zur Betriebsdatenerfassung verfügt über eine eigene API. Über sie werden Rückmeldungen der Mitarbeitenden gebucht.
- PSIintegration. Die standardmäßige Integrationsschicht von PSI verbindet die PSIpenta-Module. Sie arbeitet nach dem Hub-and-Spoke-Prinzip, ermöglicht die grafische Zuordnung von Nachrichten in Adaptern und archiviert jede Nachricht in einer Datenbank. Nutzen Sie diesen Weg, wenn externe Systeme in Ihrer Installation bereits darüber angebunden sind.
PSIpenta/ERP 10 ergänzt BPMN 2.0-Workflows zur Integration externer Systeme. Sie werden im webbasierten Workflow Developer erstellt (PSI). Ein Workflow kann auf eine Änderung in PSIpenta reagieren und SkyPlanner aufrufen.
Authentifizierung und Zugriff
- Auf PSIpenta-Seite. Die Schnittstelle läuft unter einem eigenen technischen Benutzer. Dessen Rechte sind auf die Objekte beschränkt, die er liest und schreibt. Ihr PSI-Partner richtet den Benutzer und den API-Zugriff in Ihrer Installation ein.
- Netzwerk. PSIpenta läuft üblicherweise lokal. Die Schnittstelle greift über den von Ihrem IT-Team freigegebenen Weg darauf zu, etwa über einen veröffentlichten API-Endpunkt oder einen kleinen Konnektor innerhalb Ihres Netzwerks.
- Auf SkyPlanner-Seite. Die Authentifizierung an der REST API erfolgt mit einem API-Token im Header
Authorization-Token. Das Token wird unter Settings > API erstellt. Die API ist in Swagger/OpenAPI dokumentiert. Das Integrationstutorial führt Sie durch die ersten Aufrufe.
Ereignisse und Polling
Auf PSIpenta-Seite fragt die Schnittstelle offene Fertigungsaufträge und aktuelle Änderungen über die REST API ab. Alternativ übermittelt ein BPMN-Workflow oder eine PSIintegration-Nachricht die Änderung an SkyPlanner. Die Häufigkeit wird je Werk festgelegt: von wenigen Minuten bei Aufträgen bis zu stündlichen Abfragen bei Lagerbeständen.
SkyPlanner sendet Webhooks, wenn sich der Status oder der Zeitplan ändert. Das Zurückschreiben erfolgt somit ereignisgesteuert.
Datenzuordnung
| PSIpenta-Objekt | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|
| Artikel, Einheiten | Produkte und Materialien | PSIpenta → SkyPlanner | Erstimport, danach Polling |
| Mehrstufige Stücklisten | Produktstruktur, Unterprodukte, Materialien je Produkt | PSIpenta → SkyPlanner | Erstimport, danach bei Änderungen |
| Arbeitspläne mit Arbeitsgängen, Rüst- und Ausführungszeiten | Prozessschritte mit Dauer, Rüst- und Abrüstzeiten | PSIpenta → SkyPlanner | Erstimport, danach bei Änderungen |
| Arbeitsstationen und Maschinen | Arbeitsstationen, Arbeitsstationsgruppen, Wirkungsgrade | PSIpenta → SkyPlanner | Erstimport, danach selten |
| Werkzeuge und Vorrichtungen (Betriebsmittel) | Werkzeuge als gemeinsam genutzte Ressourcen mit begrenzter Verfügbarkeit | PSIpenta → SkyPlanner | Erstimport, danach bei Änderungen |
| Schichtkalender | Schichten und arbeitsfreie Tage | PSIpenta → SkyPlanner | Täglich oder eigene Schichten in SkyPlanner |
| Fertigungsaufträge mit Arbeitsgängen und Material | Aufträge und Arbeitsgänge mit Fälligkeitsterminen und Materialbedarf | PSIpenta → SkyPlanner | Polling alle paar Minuten |
| Lagerbestand | Bestandsmengen | PSIpenta → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Bestellungen mit Lieferterminen | Bestellungen, eingehendes Material nach Liefertermin | PSIpenta → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Geplanter Start, geplantes Ende und Arbeitsstation je Arbeitsgang des Fertigungsauftrags | Geplanter Beginn und geplantes Ende je Arbeitsgang | SkyPlanner → PSIpenta | Bei Planänderungen über einen SkyPlanner-Webhook |
| BDE-Rückmeldungen: Zeit und Menge je Arbeitsgang, Mitarbeiter | Zeiterfassungen und Werkerrückmeldungen | SkyPlanner → PSIpenta | Je Rückmeldung oder je Schicht, falls gewünscht |
| Planungsregeln in SkyPlanner | Rüstzeitmatrix, Werkeranzahl je Arbeitsgang, alternative Maschinen und Mitarbeiter | Pflege in SkyPlanner | Einrichtung während des Onboardings |
Integrationsabläufe
1. Erstimport der Stammdaten. Lesen Sie Teile, Stücklisten, Arbeitspläne, Arbeitsstationen, Maschinen, Betriebsmittel und Kalender über die PSIpenta/ERP REST API ein. Legen Sie die Zuordnung der Arbeitsstationen bewusst fest: Eine Arbeitsstation mit vier Maschinen wird zu einer Arbeitsstationsgruppe oder zu vier Arbeitsstationen.
2. Aufträge synchronisieren. Lesen Sie freigegebene Fertigungsaufträge samt Arbeitsgängen und Material sowie offene Bestellungen ein. SkyPlanner betrachtet bestelltes Material zum Lieferdatum der Bestellung als verfügbar und aktualisiert den Lagerbestand, sobald die Bestellung als Delivered markiert ist. Bestellvorschläge bleiben in PSIpenta, bis daraus Bestellungen werden.
3. Planung zurückschreiben. Wenn die Planungsengine einen Arbeitsgang einplant oder verschiebt, löst ein SkyPlanner-Webhook einen Aufruf der PSIpenta/ERP REST API aus. Dieser aktualisiert den geplanten Start, das geplante Ende und die Arbeitsstation des Arbeitsgangs im Fertigungsauftrag. Die Auftragstermine ergeben sich aus den Arbeitsgängen. Welche Ressourcen und Felder für Ihre Installation verwendet werden, wird bei der Anforderungsaufnahme im Onboarding festgelegt.
4. Rückmeldungen aus der Fertigung. Mitarbeitende erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Die erfassten Zeiten halten den Plan aktuell. Sie entscheiden, ob Istzeiten zurückgebucht werden. Falls ja, werden Zeit und Menge je Arbeitsgang als BDE-Rückmeldungen über die PSIpenta/BDE API gebucht. Bleiben BDE-Terminals im Einsatz, liest SkyPlanner die Rückmeldungen stattdessen aus PSIpenta ein.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Go-live schriftlich fest:
| Daten | Führendes System |
|---|---|
| Teile, Stücklisten, Arbeitspläne, Mengen, Auftragsstatus | PSIpenta |
| Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Maschinenzuordnung | SkyPlanner |
| Rüstzeitmatrix, Mitarbeiteranzahl, alternative Ressourcen | SkyPlanner |
| Betriebsmittelstammdaten | PSIpenta; die zeitliche Verfügbarkeit wird in SkyPlanner geplant |
| Schichten und arbeitsfreie Tage | Ein System, bei der Anforderungsaufnahme festgelegt |
| Rückmeldungen, Materialentnahmen und Wareneingänge | PSIpenta; dort erfasst oder aus den Zeiterfassungen in SkyPlanner gebucht |
Legen Sie genau ein System fest, das die Arbeitsgangtermine schreibt. Wenn auch der Leitstand, Adaptive Planung oder MES Scheduling geplante Termine setzen, deaktivieren Sie dies für die von SkyPlanner geplanten Aufträge.
Typischer Projektablauf
Die Implementierung ist normalerweise innerhalb von Wochen nach Beginn des Onboardings abgeschlossen. Prüfen Sie vorher den Plan in der kostenlosen 30-tägigen Testphase mit Arbeitsstationen, Arbeitsplänen und offenen Fertigungsaufträgen, die Sie als CSV- oder Excel-Dateien aus PSIpenta exportieren.
- Datenzuordnung. Legen Sie die Zuordnungstabelle, die Regeln zur Datenhoheit und die Synchronisierungsintervalle fest. Entscheiden Sie auch, ob Rückmeldungen zurückgebucht werden.
- PSIpenta-Zugriff. Legen Sie den technischen Benutzer an, schalten Sie die API-Zugänge mit Ihrem PSI-Partner frei und testen Sie zunächst in einer Testinstallation.
- Erstimport. Teile, Stücklisten, Arbeitspläne, Arbeitsstationen, Maschinen, Betriebsmittel, Kalender.
- Aufträge und Bestellungen synchronisieren. Per Polling mit Filtern, seitenweiser Abfrage und Wiederholungsversuchen oder über Nachrichten, die ein Workflow auslöst.
- Planungsrestriktionen in SkyPlanner einrichten. Rüstzeitmatrix, Werkzeuge, Mitarbeiteranzahl je Arbeitsgang sowie alternative Maschinen oder Mitarbeitende.
- Planung zurückschreiben. Arbeitsgangtermine über SkyPlanner-Webhooks, auf Wunsch auch BDE-Rückmeldungen.
- Parallel testen. Lassen Sie SkyPlanner parallel zum bestehenden Plan laufen, vergleichen Sie die Termine und korrigieren Sie die Stammdaten.
- Go-live. Aktivieren Sie das Zurückschreiben, sobald die Daten übereinstimmen.
Worauf Sie bei der PSIpenta-Integration achten sollten
- Eingesetzte Module. Prüfen Sie, welche PSI-Planungsmodule lizenziert und im Einsatz sind. Für jedes Modul, das Termine schreibt, brauchen Sie eine klare Regel.
- Arbeitsstation oder Maschine. Entscheiden Sie, ob SkyPlanner auf Arbeitsstations- oder Maschinenebene plant, und verwenden Sie diese Ebene in beiden Übertragungsrichtungen.
- Betriebsmittel. Vorrichtungen und Werkzeuge aus der Betriebsmittelliste werden in SkyPlanner als Werkzeuge mit begrenzter Verfügbarkeit abgebildet. Ein Arbeitsgang reserviert damit auch sein Werkzeug.
- Einheiten für Rüst- und Laufzeiten. Rechnen Sie Rüst- und Laufzeiten beim Import mit der richtigen Einheit und Bezugsgröße um. Andernfalls ist jede Dauer falsch.
- Externe Arbeitsgänge. Fremdvergebene Arbeitsgänge beanspruchen Zeit, aber keine eigene Kapazität. Bilden Sie sie als Schritte mit reinem Zeitbedarf ab.
- Begonnene Arbeitsgänge. Lesen Sie vor jedem Planungslauf den Fortschritt aus den Rückmeldungen 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.
Wer richtet die PSIpenta-Schnittstelle ein und betreut sie?
- Das SkyPlanner-Team richtet die Schnittstelle beim Onboarding ein und betreut sie nach dem Go-live. Das umfasst die vereinbarten API-Aufrufe und Nachrichten. Jedes Werk setzt PSIpenta anders ein. Dieses Wissen fließt hier in die Einrichtung ein.
- Ihr PSI-Partner kann mitwirken. Er kennt Ihre Module, individuellen Felder und die Konfiguration von PSIintegration und kann den API-Zugriff gemeinsam mit dem SkyPlanner-Team freischalten.
- Ihre eigenen Entwickler können darauf aufbauen. Sie nutzen dafür die REST API von SkyPlanner mit einem API-Token. Ein API-Token genügt für den Einstieg, und das SkyPlanner-Team hilft bei Bedarf. Die Dokumentation finden Sie in der SkyPlanner-Integrationsdokumentation.
SkyPlanner ist ab 199 € pro Monat inklusive 5 Arbeitsstationen erhältlich, bei monatlicher Abrechnung. Für die Integration erhalten Sie vorab zusammen mit Ihrem Tarif ein Angebot, das auf Ihren Prozess und Ihre Anforderungen abgestimmt ist. Weitere Informationen finden Sie unter Preise, Feinplanung mit PSIpenta, auf der PSIpenta-Seite und in der Übersicht der ERP-Integrationen.
Erfahrungen von Fertigungsunternehmen mit SkyPlanner
2 hZeitersparnis pro Woche
„Mit SkyPlanner sind wir in der Produktionsplanung von Excel-Tabellen zur Produktionsoptimierung in Echtzeit übergegangen.“
Kalle Kalliomäki, Spezialist für Lieferketten
UTU · Elektrische Schalttafeln und Schaltanlagen
Die Produktionsplanung spart jede Woche 2 Stunden Arbeitszeit, und 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.
100%Liefertreue seit 2021
„SkyPlanner macht unsere Kapazitäten transparent und die Planung berechenbar.“
Dan Berglund, COO/CFO
Opes Corporation · Chemie- und Lebensmittelproduktion
Seit SkyPlanner 2021 eingeführt wurde, liegt die Liefertreue durchgehend bei 100%.
WenigerStillstände durch Materialengpässe
„Der Nutzen von SkyPlanner liegt für uns darin, dass es im Alltag funktioniert – besonders bei der Festlegung von Lieferterminen.“
Tommi Männistö, Leiter Produktionsplanung
Eskomatic · Lohnzerspanung
Die automatische Einplanung der Aufträge ermöglicht genauere Liefertermine. Produktionsstillstände durch Materialengpässe sind deutlich zurückgegangen.
Häufig gestellte Fragen
Hat PSIpenta eine API für Fertigungsaufträge?
Ja. PSI nennt eine REST- und SOAP-API für PSIpenta/ERP und PSIpenta/BDE. Laut PSI lassen sich alle PSIpenta-Komponenten über RESTful-Webservices integrieren. PSIintegration ergänzt eine modulübergreifende, nachrichtenbasierte Integrationsschicht.
Wie werden geplante Termine nach PSIpenta zurückgeschrieben?
Über die PSIpenta/ERP REST API. Bei jeder Planänderung löst ein SkyPlanner-Webhook die Aktualisierung von geplantem Start, geplantem Ende und Arbeitsstation für jeden Arbeitsgang des Fertigungsauftrags aus.
Kann SkyPlanner Rückmeldungen an PSIpenta BDE übermitteln?
Ja, wenn Sie das möchten. Die in SkyPlanner erfassten Arbeitszeiten der Mitarbeiter werden über die PSIpenta/BDE API als BDE-Rückmeldungen mit Zeit und Menge je Arbeitsgang übermittelt. Werke, die ihre BDE-Terminals beibehalten, lassen SkyPlanner stattdessen die Rückmeldungen einlesen.
Sollte ein PSI-Partner den PSIpenta Leitstand oder SkyPlanner empfehlen?
SkyPlanner, wenn der Kunde innerhalb von Wochen eine einsatzfähige Feinplanung benötigt, die die verfügbaren Kapazitäten berücksichtigt. Leitstand, Adaptive Planung und MES Scheduling sind eigenständige Module des modularen Produkts von PSI (PSI). SkyPlanner wird über die APIs von PSIpenta/ERP und BDE angebunden und plant bei Änderungen in der Produktion automatisch neu. Dabei werden Umrüstungen, Werkzeuge, Teams und Material eingeplant. Die Nutzerzahl ist unbegrenzt, der Preis beginnt bei 199 € pro Monat.
Wird für die Integration PSIpenta/MES benötigt?
Nein. SkyPlanner wird an PSIpenta/ERP und für Rückmeldungen an PSIpenta/BDE angebunden. Mitarbeiter können ihre Arbeit in SkyPlanner auf dem Smartphone oder Tablet erfassen.
Können wir SkyPlanner testen, bevor wir die Schnittstelle umsetzen?
Ja. In der kostenlosen 30-tägigen Testphase können Sie bis zu 20 Arbeitsstationen nutzen und Daten aus PSIpenta per CSV oder Excel importieren. Alle Funktionen von Basic sind enthalten; eine Kreditkarte ist nicht erforderlich. Starten Sie den Test oder kontaktieren Sie den Vertrieb für die Anforderungsaufnahme zur Integration.
