Integrationen / ERP / Senior ERP
Leitfaden zur Senior ERP Schnittstelle für die Feinplanung mit SkyPlanner APS
Dieser Leitfaden zeigt Partnern und IT-Teams, wie sie Senior ERP von Senior Sistemas (Gestão Empresarial | ERP XT mit Senior X) an SkyPlanner APS anbinden. SkyPlanner tauscht Daten in beide Richtungen mit Senior ERP aus und nutzt dafür die Schnittstellen von Senior:
- SkyPlanner übernimmt Fertigungsaufträge (OPs) mit ihren Stufen, Arbeitsplänen (roteiros), Ressourcen und Ressourcenzentren sowie SKUs, Produktstrukturen, Bestände und Bestellungen.
- Geplanter Beginn und geplantes Ende jeder OP-Stufe sowie die jeweils gewählte Ressource werden in den OP zurückgeschrieben.
- Auf Wunsch werden die Zeitbuchungen der Bediener als apontamentos de produção zurückgemeldet.
- Senior X Events Hub meldet SkyPlanner, wenn sich der Status einer OP-Stufe ändert. SkyPlanner-Webhooks übertragen Änderungen am Plan, sobald sie eintreten.
Das SkyPlanner-Team richtet die Integration während des Onboardings passend zu Ihrer Senior ERP-Umgebung ein und betreut sie auch nach dem Go-live. 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).
Die Integrationsschnittstellen von Senior ERP
ERP XT ist ein Hybridsystem. In der Senior-Dokumentation heißt es über Gestão Empresarial XT: „becomes a hybrid system: an on-premises (local) system with integration of cloud solutions“ (wird zu einem Hybridsystem: einem lokalen On-Premises-System mit angebundenen Cloud-Lösungen) (Senior-Dokumentation, übersetzt). Eine Planungssoftware nutzt drei Schnittstellen von Senior:
- G5-Webservices (SOAP). Diese Dienste laufen auf Ihrem Senior-Server und sind nach Modulen benannt (com.senior.g5.co.<module>…). Jeder Dienst wird in drei WSDL-Varianten veröffentlicht: sapiens_Sync, sapiens_Async und sapiens_Scheduled. Zu den Fertigungsdiensten gehört com.senior.g5.co.mpr.pcp.ordemproducao. Dieser Dienst „calls the same production order generation routine“ (ruft dieselbe Routine zur Erzeugung von Fertigungsaufträgen auf) wie die ERP-Maske (Senior-Dokumentation, übersetzt). Hinzu kommen Dienste für Produkte (com.senior.g5.co.ger.cad.produto) und Fertigungsrückmeldungen.
- Senior X Platform REST APIs unter api.senior.com.br für die ERP-Domänen, die Senior auf Senior X bereitstellt, etwa Produkte und Kundenaufträge (Senior-Dokumentation).
- Events Hub-Webhooks. Sie werden in Senior X unter Tecnologia > Customização > Events Hub > Webhooks angelegt. Manufacturing veröffentlicht das Ereignis erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus, wenn eine OP-Stufe ihren Status ändert (Senior-Dokumentation).
Authentifizierung und Zugriff
- Senior X Platform. Die Integration meldet sich per POST bei platform.senior.com.br unter /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login an. Der Benutzer wird als user@tenant angegeben. Die Antwort enthält ein Bearer-Zugriffstoken und ein Refresh-Token. Mit Anwendungsschlüsseln erfolgt die Anmeldung über loginWithKey (access key, secret, tenant). REST-Aufrufe enthalten den Header authorization und einen Header client_id. Dieser identifiziert die angebundene Anwendung, die im Senior-API-Portal registriert und mit einer Rolle im ERP verknüpft ist.
- G5-Webservices. Die Aufrufe enthalten Parameter für Benutzer, Passwort und Verschlüsselung. Wird ein Senior X-Token verwendet, ersetzt es das Passwort (Senior-Dokumentation).
- Berechtigungen. Legen Sie für die Integration einen eigenen Senior-Benutzer an. Er benötigt Zugriff auf die Daten aus PCP, Engineering, Lager und Einkauf, die die Integration liest und schreibt.
Auf SkyPlanner-Seite erfolgt die Authentifizierung an der REST API mit einem 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
Events Hub deckt die Fertigungsebene ab: Ändert eine OP-Stufe ihren Status, erreicht der Webhook SkyPlanner und der Plan wird aktualisiert. Andere Daten werden per Polling abgerufen. Abfragen mit Filtern auf fixierte und freigegebene OPs sowie auf aktuelle Änderungen erfassen neue Aufträge. Die Häufigkeit wird pro Werk festgelegt: von wenigen Minuten bei OPs bis hin zu stündlichen Bestandsabfragen.
SkyPlanner sendet Webhooks, wenn sich der Status oder der Zeitplan ändert. Das Zurückschreiben erfolgt somit ereignisgesteuert.
Datenzuordnung
| Senior ERP-Objekt (Schnittstelle) | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|
| SKU: produto und derivação, Mengeneinheiten (G5-Webservices oder Senior X-Entitäten) | Produkte und Materialien | Senior → SkyPlanner | Erstimport, danach Polling |
| Produktstruktur (engenharia do SKU) | Produktstruktur, Unterprodukte, Materialien je Produkt | Senior → SkyPlanner | Erstimport, danach bei Änderungen |
| Roteiro mit estágios: Reihenfolge, Abhängigkeit von der vorherigen Stufe | Prozessschritte in ihrer Reihenfolge | Senior → SkyPlanner | Erstimport, danach bei Änderungen |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Arbeitsstationen, Dauern, Rüst- und Abrüstzeiten, Wirkungsgrade | Senior → SkyPlanner | Erstimport, danach selten |
| Centro de recurso | Arbeitsstationsgruppen | Senior → SkyPlanner | Erstimport, danach selten |
| Calendário: Feriados, Produktionskalender je Schicht | Schichten und arbeitsfreie Tage | Senior → SkyPlanner | Täglich oder eigene Schichten in SkyPlanner |
| Ordens de produção (Firme, Liberada) mit Stufen und Materialien | Aufträge und Arbeitsgänge mit Fälligkeitsterminen und Materialbedarf | Senior → SkyPlanner | Polling alle paar Minuten |
| Status der OP-Stufe (Events Hub orderProductionStageChangeStatus) | Fortschritt des Arbeitsgangs | Senior → SkyPlanner | In Echtzeit per Webhook |
| Estoque je SKU | Lagerbestände | Senior → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Ordens de compra mit Lieferterminen | Bestellungen, Materialzugänge nach Liefertermin | Senior → SkyPlanner | Polling, stündlich oder bei einem Planungslauf |
| OP-Stufe: geplanter Beginn und geplantes Ende, Ressource | Geplanter Beginn und geplantes Ende je Arbeitsgang, zugewiesene Arbeitsstation | SkyPlanner → Senior | Bei Planänderungen per SkyPlanner-Webhook |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, Datum und Uhrzeit von Beginn und Ende | Zeitbuchungen und Bedienerrückmeldungen | SkyPlanner → Senior | Je Rückmeldung oder je Schicht, falls gewünscht |
| Nicht in Senior ERP | Rüstzeitmatrix, Werkzeuge als begrenzte Ressourcen, Arbeitsgänge mit mehreren Bedienern, alternative Maschinen und Mitarbeiter | In SkyPlanner gepflegt | Einrichtung während des Onboardings |
Integrationsabläufe
1. Erstimport der Stammdaten. Lesen Sie SKUs, Strukturen, roteiros, recursos, centros de recurso und den Produktionskalender ein. Legen Sie bewusst fest, wie Ressourcenzentren abgebildet werden: Ein centro de recurso mit vier Maschinen wird zu einer Arbeitsstationsgruppe oder zu vier Arbeitsstationen. Bilden Sie Fator de carga entweder über den Wirkungsgrad der Arbeitsstation in SkyPlanner oder über Schichten ab, nicht über beides.
2. OP-Synchronisierung. Lesen Sie OPs im Status Firme und Liberada mit ihren Stufen und Materialien sowie offene Bestellungen ein. OPs im Status Planejada können vom MRP noch geändert oder gelöscht werden. Planen Sie diese daher nur ein, wenn Sie eine Vorschau wünschen. SkyPlanner betrachtet bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert wird.
3. Planungsergebnisse zurückschreiben. Sobald die Planungsengine eine Stufe einplant oder verschiebt, löst ein SkyPlanner-Webhook das Zurückschreiben aus. Dabei werden der geplante Beginn, das geplante Ende und die gewählte Ressource jeder OP-Stufe gesetzt. Das sind dieselben Felder, die der Planer in Programação de produção bearbeitet. Welcher Webservice dafür genau verwendet wird, stimmt das SkyPlanner-Team während der Anforderungsaufnahme mit Ihnen und Ihrem Senior-Partner ab.
4. Rückmeldungen aus der Fertigung. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Diese Zeitbuchungen halten den Plan aktuell. Sie entscheiden, ob Istzeiten an Senior zurückgemeldet werden. Falls ja, wird jede Rückmeldung zu einem apontamento de produção an der OP-Stufe, mit produzierter Menge, Ausschuss sowie Beginn und Ende. Senior akzeptiert Fertigungsrückmeldungen nur für OPs im Status Liberada oder Andamento. Wenn Sie über Fábrica ao Vivo rückmelden, liest SkyPlanner den Fortschritt stattdessen über Events Hub ein.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Go-live schriftlich fest:
| Daten | Führendes System |
|---|---|
| SKUs, Strukturen, roteiros, OP-Mengen und -Status | Senior ERP |
| Reihenfolge der Stufen, Beginn und Ende, Ressourcenzuweisung | SkyPlanner |
| Rüstzeitmatrix, Werkzeug- und Bedienerbedarf, alternative Ressourcen | SkyPlanner |
| Produktionskalender und Schichten | Ein System, das während der Anforderungsaufnahme festgelegt wird |
| Apontamentos, Lagerbewegungen, Kalkulation | Senior ERP; dort erfasst oder aus SkyPlanner-Zeitbuchungen übertragen |
Legen Sie ein einziges System fest, das die Termine der Stufen schreibt. Wenn Planer dieselben OPs weiterhin in Programação de produção oder im Gantt-Diagramm einplanen, vereinbaren Sie, für welche OPs SkyPlanner zuständig ist.
Typischer Projektablauf
Die Implementierung ist normalerweise innerhalb weniger Wochen nach Beginn des Onboardings abgeschlossen. Prüfen Sie vorher den Plan in der kostenlosen 30-tägigen Testphase mit Ressourcen, roteiros und offenen OPs, die Sie aus Senior als CSV oder Excel exportieren.
- Datenzuordnung. Legen Sie die Zuordnungstabelle, die Zuständigkeitsregeln und die Synchronisierungsintervalle fest. Entscheiden Sie außerdem, ob apontamentos zurückgemeldet werden.
- Zugriff auf Senior. Legen Sie den Integrationsbenutzer an, registrieren Sie die Anwendung im Senior-API-Portal und aktivieren Sie die G5-Webservices sowie den Events Hub-Webhook. Testen Sie zunächst in einer Abnahmeumgebung.
- Erstimport. SKUs, Strukturen, roteiros, recursos, centros de recurso, Kalender.
- OPs und Bestellungen synchronisieren. Polling mit Filtern und Wiederholungsversuchen, ergänzt um den Webhook für den Stufenstatus.
- Planungsrestriktionen in SkyPlanner einrichten. Rüstzeitmatrix, Werkzeuge, Mitarbeiteranzahl je Arbeitsgang sowie alternative Maschinen oder Mitarbeitende.
- Planungsergebnisse zurückschreiben. Termine und Ressourcen der Stufen über SkyPlanner-Webhooks übertragen, auf Wunsch auch apontamentos.
- 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 einer Senior ERP-Integration achten sollten
- Vier Zeitarten je Ressource. Recurso enthält Bearbeitungszeit, Rüstzeit, Be- und Entladezeit sowie Transferzeit. Lade- und Transferzeiten können Handhabungszeiten statt Maschinenzeiten sein. Legen Sie für jede Ressource fest, wie diese Zeiten zugeordnet werden. Andernfalls ist jede Dauer falsch.
- Ein Rüstzeitwert je Ressource. Tempo setup in Senior ist ein einzelner Wert. Erstellen Sie während des Onboardings die Rüstzeitmatrix in SkyPlanner anhand Ihrer tatsächlichen Rüstwechsel.
- Varianten. Eine SKU in Senior besteht aus einem Produkt und einer derivação. Die roteiros können sich je Variante unterscheiden. Übernehmen Sie den Variantencode in die Produktschlüssel von SkyPlanner.
- OP-Status. Fertigungsrückmeldungen sind nur für OPs im Status Liberada oder Andamento möglich. Nehmen Sie Statusänderungen weiterhin in Senior vor und lassen Sie SkyPlanner diese über Events Hub übernehmen.
- Hybrider Betrieb. Die G5-Webservices laufen auf Ihrem Senior-Server, Events Hub läuft in Senior X. Planen Sie den Netzwerkzugriff auf beide ein.
- Zahlenformat. Die Webservices von Senior akzeptieren keine Zahlen mit Tausendertrennzeichen und verlangen ein Dezimalkomma. Senden Sie Zahlen in diesem Format.
Wer die Senior ERP Schnittstelle einrichtet und betreut
- Das SkyPlanner-Team richtet die Schnittstelle beim Onboarding ein und betreut sie nach dem Go-live. Das umfasst die vereinbarten Webservices, Senior X APIs und Events Hub-Webhooks. Jedes Werk nutzt Senior ERP anders. Dieses Know-how fließt in die Einrichtung und Betreuung ein.
- Ihr Senior-Partner kann mitwirken. Er kennt Ihre Konfiguration, Anpassungen und Lizenzen und kann gemeinsam mit dem SkyPlanner-Team den Integrationsbenutzer einrichten, die Registrierung im API-Portal vornehmen und die Webservices konfigurieren.
- Ihre eigenen Entwickler können darauf aufbauen und mit einem API-Token die REST API von SkyPlanner nutzen. Ein API-Token reicht für den Einstieg aus. Bei Bedarf unterstützt Sie das SkyPlanner-Team. Die technische Dokumentation finden Sie in der Integrationsdokumentation von SkyPlanner.
SkyPlanner gibt es ab 199 € pro Monat inklusive 5 Arbeitsstationen, bei monatlicher Abrechnung. Sie erhalten vorab zusammen mit Ihrem Tarif ein Angebot für die Integration, abgestimmt auf Ihre Abläufe und Anforderungen. Weitere Informationen finden Sie unter Preise, Feinplanung für Senior ERP, auf der Senior ERP-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.
Mehrere 1.000Fertigungsaufträ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 in Echtzeit Einblick in die Produktion.
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 Senior ERP eine API für Fertigungsaufträge?
Ja. Der G5-Webservice com.senior.g5.co.mpr.pcp.ordemproducao erzeugt OPs mit derselben Routine wie die ERP-Maske. Weitere G5-Dienste decken Produkte und Produktionsrückmeldungen ab. Senior X Platform ergänzt REST APIs mit Anmeldung per Bearer-Token und Events Hub-Webhooks.
Unterstützt Senior ERP Webhooks?
Ja. Senior X Events Hub sendet Webhooks, darunter orderProductionStageChangeStatus, wenn sich der Status eines OP-Arbeitsgangs ändert. SkyPlanner verfolgt damit den Fertigungsfortschritt in Echtzeit und übermittelt Änderungen am Produktionsplan über eigene Webhooks zurück.
Wie werden geplante Termine an Senior ERP zurückgeschrieben?
SkyPlanner legt für jeden OP-Arbeitsgang den geplanten Beginn, das geplante Ende und die ausgewählte Ressource fest. Das sind dieselben Felder, die der Planer in Programação de produção bearbeitet. Bei jeder Änderung am Produktionsplan löst ein SkyPlanner-Webhook das Zurückschreiben aus. Der Übertragungsweg wird vom SkyPlanner-Team bei der Anforderungsaufnahme im Rahmen des Onboardings für Ihre Senior-Installation festgelegt.
Funktioniert die Integration mit Senior X und ERP XT?
Ja. ERP XT läuft auf Ihrem Server und nutzt Cloud-Dienste auf Senior X. Die Integration verwendet G5-Webservices auf dem Server sowie Senior X APIs und Events Hub in der Cloud.
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 Senior per CSV oder Excel importieren. Eine Kreditkarte ist nicht erforderlich. Starten Sie die Testphase oder sprechen Sie mit dem Vertrieb, um die Anforderungen an die Integration aufzunehmen.
