Integrationen / ERP / APplus
Leitfaden zur APplus Schnittstelle für die Feinplanung mit SkyPlanner APS
Dieser Leitfaden zeigt APplus-Partnern und IT-Teams, wie sie APplus an SkyPlanner APS anbinden. SkyPlanner tauscht Daten in beide Richtungen mit APplus aus und nutzt dafür die Schnittstellen von Asseco:
- SkyPlanner übernimmt Fertigungsaufträge mit ihren Arbeitsgängen, Arbeitsplänen und Stücklisten sowie Kapazitätsstellen und Kapazitätseinheiten, Betriebsmittel, Lagerbestände und Bestellungen.
- Geplanter Beginn, geplantes Ende und Kapazitätseinheit werden je Arbeitsgang in den Fertigungsauftrag zurückgeschrieben.
- Auf Wunsch können die erfassten Zeiten der Werker als BDE-Meldungen zum Auftrag zurückgebucht werden.
- SkyPlanner-Webhooks übertragen Planänderungen, sobald sie auftreten.
Das SkyPlanner-Team richtet die Integration während des Onboardings passend zu Ihrer APplus-Umgebung ein 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).
Schnittstellen zur Anbindung von APplus
APplus bietet folgende Wege zur Anbindung eines externen Planungssystems:
- APplus-Webservices. APplus basiert auf einer Webservice-Architektur. Laut Asseco sind alle benötigten Planungsfunktionen direkt über das Internet erreichbar und können von den IT-Systemen der Kunden und Lieferanten genutzt werden (Asseco). Dies ist der wichtigste Weg, um Produktionsdaten zu lesen und geplante Termine zurückzuschreiben.
- Business Integration Framework. Seit APplus 6.3 bindet das Framework Drittsysteme über anpassbare Datenstrukturen ohne Programmierung an (Asseco). Nutzen Sie es, um APplus-Objekte auf die REST API von SkyPlanner abzubilden.
- Universal Cloud Connector. Er wurde mit APplus 7.1 eingeführt, um Partnerlösungen und SaaS-Angebote an APplus anzubinden und dabei eine hohe Sicherheit der übertragenen Daten zu gewährleisten (Asseco).
Mit APplus 10 startet Flow Mode Prozesse zu festgelegten Zeiten oder bei bestimmten Ereignissen, ohne manuelle Schritte (Asseco). Welcher Weg für welches Objekt genutzt wird, wird bei der Anforderungsaufnahme im Onboarding festgelegt.
Authentifizierung und Zugriff
- Auf APplus-Seite. Die Integration läuft in APplus unter einem eigenen technischen Benutzer. Seine Berechtigungen sind auf die Objekte beschränkt, die er liest und schreibt. Ihr APplus-Partner richtet den Benutzer und den Webservice-Zugang ein.
- Netzwerk. APplus läuft lokal oder als gehostete Version (Fakten zu APplus). Die Integration greift über den Zugangsweg darauf zu, den Ihr IT-Team oder Hosting-Anbieter freigibt.
- 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 APplus-Seite fragt die Integration offene Fertigungsaufträge und aktuelle Änderungen regelmäßig über die Webservices ab. Alternativ sendet das Business Integration Framework Änderungen an SkyPlanner. Die Intervalle werden je Werk festgelegt und reichen von alle paar Minuten für Aufträge bis zu stündlich für Lagerbestände.
SkyPlanner sendet Webhooks, wenn sich der Status oder der Zeitplan ändert. Das Zurückschreiben erfolgt somit ereignisgesteuert.
Datenzuordnung
| APplus-Objekt | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|
| Artikel, Einheiten | Produkte und Materialien | APplus → SkyPlanner | Erstimport, danach Polling |
| Stücklisten, Strukturstücklisten | Produktstruktur, Unterprodukte, Materialien je Produkt | APplus → SkyPlanner | Erstimport, danach bei Änderungen |
| Arbeitspläne mit Arbeitsgängen, Rüst- und Ausführungszeiten | Prozessschritte mit Dauer, Rüst- und Abrüstzeiten | APplus → SkyPlanner | Erstimport, danach bei Änderungen |
| Kapazitätsstellen und Kapazitätseinheiten | Arbeitsstationsgruppen und Arbeitsstationen, Wirkungsgrade | APplus → SkyPlanner | Erstimport, danach selten |
| Personalkapazität | Personal mit Schichtzuordnung | APplus → SkyPlanner | Täglich oder eigene Schichtpflege in SkyPlanner |
| Werkzeuge und Vorrichtungen (Betriebsmittel) | Werkzeuge als gemeinsam genutzte Ressourcen mit begrenzter Kapazität | APplus → SkyPlanner | Erstimport, danach bei Änderungen |
| Fertigungsaufträge mit Arbeitsgängen und Material | Aufträge und Arbeitsgänge mit Fälligkeitsterminen und Materialbedarf | APplus → SkyPlanner | Polling alle paar Minuten |
| Lagerbestand | Bestandsmengen | APplus → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Bestellungen mit Lieferterminen | Bestellungen, eingehendes Material nach Liefertermin | APplus → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Geplanter Beginn, geplantes Ende und Kapazitätseinheit je Arbeitsgang des Fertigungsauftrags | Geplanter Beginn und geplantes Ende je Arbeitsgang | SkyPlanner → APplus | Bei Planänderungen über einen SkyPlanner-Webhook |
| BDE-Meldungen: Zeit und Menge je Arbeitsgang und Mitarbeiter | Zeiterfassungen und Werkerrückmeldungen | SkyPlanner → APplus | Je Rückmeldung oder je Schicht, falls gewünscht |
| Nicht in APplus | 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 Artikel, Stücklisten, Arbeitspläne, Kapazitätsstellen und Kapazitätseinheiten, Betriebsmittel und Personalkapazitäten über die APplus-Webservices ein. Legen Sie die Zuordnung bewusst fest: Eine Kapazitätsstelle mit vier Kapazitätseinheiten wird zu einer Arbeitsstationsgruppe mit vier Arbeitsstationen.
2. Auftragssynchronisierung. Lesen Sie Fertigungsaufträge mit ihren Arbeitsgängen und ihrem Material sowie offene Bestellungen ein. SkyPlanner betrachtet bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert wird. Bestellvorschläge bleiben in der APplus Disposition, bis sie zu Bestellungen werden.
3. Planung zurückschreiben. Wenn die Planungslogik einen Arbeitsgang einplant oder verschiebt, löst ein SkyPlanner-Webhook die Aktualisierung in APplus aus. Dafür wird der bei der Anforderungsaufnahme vereinbarte Weg genutzt: Webservices oder das Business Integration Framework. Für den Arbeitsgang werden der geplante Beginn, das geplante Ende und die Kapazitätseinheit im Fertigungsauftrag gesetzt. So zeigt die Plantafel in APplus die von SkyPlanner festgelegte Reihenfolge.
4. Werkstattaufträge freigeben. Der Planer gibt Werkstattaufträge weiterhin in APplus frei, nun mit den Terminen aus SkyPlanner. Die freigegebenen Aufträge und ihr Status werden bei der nächsten Synchronisierung wieder an SkyPlanner übertragen.
5. Rückmeldungen aus der Fertigung. Werker erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Die erfassten Zeiten halten den Zeitplan aktuell. Sie entscheiden, ob Istzeiten zurückgebucht werden. Wenn ja, werden Zeit und Menge je Arbeitsgang als BDE-Meldungen zum Auftrag gebucht. Bleibt die Barcode-BDE im Einsatz, liest SkyPlanner stattdessen die Meldungen aus APplus.
6. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Artikel, Stücklisten, Arbeitspläne, Mengen, Auftragsstatus, Freigabe von Werkstattaufträgen | APplus |
| Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Zuordnung der Kapazitätseinheiten | SkyPlanner |
| Rüstzeitmatrix, Werkeranzahl, alternative Ressourcen | SkyPlanner |
| Betriebsmittelstammdaten | APplus; die zeitliche Verfügbarkeit wird in SkyPlanner geplant |
| Schichten und arbeitsfreie Tage | Ein System, das bei der Anforderungsaufnahme festgelegt wird |
| BDE-Meldungen, Materialentnahmen und Wareneingänge | APplus; dort erfasst oder aus SkyPlanner-Zeiterfassungen gebucht |
Legen Sie genau ein System fest, das die Termine der Arbeitsgänge schreibt. Wenn die PPS-Terminierung läuft oder Feinplanung oder APplus APS Termine schreibt, deaktivieren Sie dies für die Aufträge, die SkyPlanner plant.
Typische Projektschritte
Die Implementierung ist normalerweise innerhalb weniger Wochen nach Beginn des Onboardings abgeschlossen. Prüfen Sie den Zeitplan vorab in der kostenlosen 30-tägigen Testphase. Nutzen Sie dafür Kapazitätseinheiten, Arbeitspläne und offene Fertigungsaufträge, die Sie aus APplus als CSV oder Excel exportieren.
- Datenzuordnung. Legen Sie die Zuordnungstabelle, die Regeln zur Datenhoheit und die Synchronisierungsintervalle verbindlich fest. Entscheiden Sie auch, ob BDE-Meldungen zurückgebucht werden.
- APplus-Zugang. Legen Sie den technischen Benutzer an und aktivieren Sie die Webservices gemeinsam mit Ihrem APplus-Partner. Testen Sie zunächst in einem Testsystem.
- Erstimport. Artikel, Stücklisten, Arbeitspläne, Kapazitätsstellen und Kapazitätseinheiten, Betriebsmittel, Personal.
- Aufträge und Bestellungen synchronisieren. Per Polling mit Filtern, seitenweisem Abruf und Wiederholungsversuchen oder per Push über das Business Integration Framework.
- Restriktionen in SkyPlanner einrichten. Rüstzeitmatrix, Werkzeuge, benötigte Mitarbeiterzahl je Arbeitsgang sowie alternative Maschinen oder Mitarbeiter.
- Planungsergebnisse zurückschreiben. Arbeitsgangtermine über SkyPlanner-Webhooks, auf Wunsch auch BDE-Meldungen.
- Parallel testen. Betreiben Sie SkyPlanner parallel zur bisherigen Plantafel, vergleichen Sie Termine und korrigieren Sie Stammdaten.
- Produktivstart. Aktivieren Sie das Zurückschreiben, sobald die Daten übereinstimmen.
Worauf Sie bei einer APplus-Integration achten sollten
- Begrenzte und unbegrenzte Kapazitätseinheiten. In APplus können einige Kapazitätseinheiten mit unbegrenzter Kapazität geplant werden. In SkyPlanner hat jede Arbeitsstation eine begrenzte Kapazität. Prüfen Sie deshalb beim Import für jede Station die Schichten und Wirkungsgrade.
- Aktive Planungssysteme. Prüfen Sie, ob Feinplanung oder APplus APS lizenziert und im Einsatz ist, und legen Sie fest, dass nur ein System Termine schreibt.
- Arbeitspapiere und Barcodes. BDE-Meldungen werden auf Aufträge gebucht, für die Arbeitspapiere gedruckt wurden. Stimmen Sie ab, ob Freigabe und Druck wie bisher in APplus bleiben.
- Einheiten für Rüst- und Bearbeitungszeiten. Rechnen Sie Rüst- und Bearbeitungszeiten beim Import mit der richtigen Einheit und Bezugsbasis um. Andernfalls sind sämtliche Dauern falsch.
- Fremdarbeitsgänge. Fremdvergebene Arbeitsgänge beanspruchen Zeit, aber keine eigene Kapazität. Bilden Sie sie als Schritte ab, die nur eine Zeitdauer haben.
- Gehostete Installationen. Stimmen Sie bei der gehosteten Version frühzeitig mit dem Hosting-Anbieter ab, wie die Webservices über das Netzwerk erreichbar sind.
Wer die APplus-Integration einrichtet und betreut
- Das SkyPlanner-Team richtet die Integration beim Onboarding ein und betreut sie nach dem Produktivstart. Das umfasst die vereinbarten Webservices und Datenzuordnungen. Jedes Werk nutzt APplus anders. Dieses Wissen fließt in die Einrichtung ein.
- Ihr APplus-Partner kann mitwirken. Er kennt Ihr Customizing, Ihre Benutzerrechte und Ihre Konfiguration für das Business Integration Framework und kann gemeinsam mit dem SkyPlanner-Team den Zugang freischalten.
- Ihre eigenen Entwickler können darauf aufbauen. Dafür nutzen sie die REST API von SkyPlanner mit einem API-Token. Ein API-Token reicht für den Einstieg aus; bei Bedarf unterstützt das SkyPlanner-Team. Die Dokumentation finden Sie unter SkyPlanner-Integrationsdokumentation.
SkyPlanner ist ab 199 € pro Monat mit 5 enthaltenen Arbeitsstationen erhältlich, 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 APplus, auf der APplus-Seite und in der Übersicht der ERP-Integrationen.
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.
6 Monateim Voraus sieht der Vertrieb freie Kapazitäten
„SkyPlanner bildet die Grundlage für die gesamte Produktionsplanung und macht sie verlässlich.“
Anu Järvinen, Produktionsleiterin
Fredman Operations · Lebensmittelechte Verpackungspapiere
Der Vertrieb sieht freie Kapazitäten sechs Monate im Voraus. Anfragen zu Planänderungen, deren Beantwortung früher eine Stunde oder länger dauerte, werden in Sekunden beantwortet.
WenigerStillstä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 Einplanung der Aufträge sorgt für genauere Liefertermine. Produktionsstillstände durch Materialmangel sind deutlich zurückgegangen.
Häufige Fragen
Hat APplus eine API für Fertigungsaufträge?
Ja. APplus basiert auf einer Webservice-Architektur. Laut Asseco können die Funktionen zur Feinplanung direkt von den IT-Systemen der Kunden und Lieferanten genutzt werden. Das Business Integration Framework bindet Drittsysteme über adaptive Datenstrukturen an, und der Universal Cloud Connector verbindet SaaS-Angebote mit APplus.
Wie werden geplante Termine nach APplus zurückgeschrieben?
Bei jeder Planänderung löst ein SkyPlanner-Webhook die Aktualisierung von geplantem Start, geplantem Ende und Kapazitätseinheit für jeden Arbeitsgang des Fertigungsauftrags aus. Die Aktualisierung erfolgt über die APplus-Webservices oder das Business Integration Framework. Welcher Weg genutzt wird, legen wir bei der Anforderungsaufnahme im Onboarding fest.
Kann SkyPlanner BDE-Meldungen an APplus übermitteln?
Ja, wenn Sie das wünschen. Die in SkyPlanner erfassten Mitarbeiterzeiten werden als BDE-Meldungen mit Zeit und Menge je Arbeitsgang auf den Auftrag gebucht. In Werken, die ihre Barcode-BDE beibehalten, liest SkyPlanner stattdessen die Meldungen ein.
Sollte ein APplus-Partner APplus APS oder SkyPlanner empfehlen?
SkyPlanner, wenn der Kunde innerhalb von Wochen eine funktionierende Feinplanung unter Berücksichtigung der verfügbaren Kapazitäten möchte. APplus APS ist ein in APplus integriertes Partnerprodukt für Rüstmatrizen über mehrere Werkzeuge hinweg und für die Multiressourcenplanung (Asseco). SkyPlanner deckt diese Fälle ab, wird über die APplus-Webservices angebunden und plant automatisch neu – mit unbegrenzter Nutzerzahl ab 199 € pro Monat.
Funktioniert die Integration auch mit gehostetem APplus?
Ja. APplus läuft vor Ort oder als gehostete Version. SkyPlanner verbindet sich in beiden Fällen über die Webservices. Der Netzwerkzugang wird bei der Anforderungsaufnahme mit Ihrem IT-Team oder Hosting-Anbieter abgestimmt.
Können wir SkyPlanner testen, bevor die Schnittstelle entwickelt wird?
Ja. Mit der kostenlosen 30-tägigen Testversion können Sie bis zu 20 Arbeitsstationen nutzen und Daten per CSV oder Excel aus APplus importieren. Alle Funktionen des Tarifs Basic sind enthalten, eine Kreditkarte ist nicht erforderlich. Starten Sie den Test oder sprechen Sie mit dem Vertrieb, um die Anforderungen an die Integration aufzunehmen.
