Epicor Kinetic: Integrationsleitfaden für die Feinplanung mit SkyPlanner APS

Epicor erklärt: „All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.“ (Alle Kinetic-Dienste, einschließlich Geschäftsobjekten, Prozessen, Berichten, BAQs und Epicor Functions, sind über REST-Endpunkte zugänglich.) Eine Integration zur Feinplanung basiert auf vier Epicor-Technologien:

1. Kinetic REST API v2 (OData v4). Business Objects werden als Services mit dem Namen Erp.BO.<Name>Svc bereitgestellt. Der übliche Pfad lautet /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 ist weiterhin verfügbar, gilt aber als veraltet. Setzen Sie daher auf v2. Prüfen Sie die Entity Sets und Methoden Ihrer Version in REST Help unter /api/help/v2/.
2. Business Activity Queries (BAQ) über REST. Eine BAQ wird unter /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data bereitgestellt. Damit lassen sich Planungsdaten praktisch auslesen: JobHead, JobOper, JobMtl, PartWhse und PORel werden in einem einzigen Aufruf verknüpft (Beispiel aus der Community).
3. Epicor Functions (EFx). Serverseitige Funktionen, die unter /api/v2/efx/{Company}/{Library}/{Function} aufgerufen werden können. Epicor schreibt dazu: „can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.“ (Sie können über mehrere Einstiegspunkte ausgelöst werden, darunter BPMs, REST-Services, Zeitpläne und Anwendungsereignisse.)
4. BPM-Direktiven. Method Directives und Data Directives werden ausgelöst, wenn sich ein Auftrag oder Arbeitsgang ändert. Sie können eine Funktion aufrufen, die Daten nach außen überträgt.

Für den dateibasierten Austausch übernimmt DMT die Importe; BAQ-Exporte liefern die ausgehenden Daten. Epicor bietet außerdem Epicor Automation Studio an und beschreibt es als „a low-code app for integration-led automations“ (eine Low-Code-App für Automatisierungen auf Basis von Integrationen). Verzichten Sie auf direkte Datenbankzugriffe: REST, BAQs und Funktionen arbeiten im lokalen Betrieb genauso wie in Kinetic Cloud.

Epicor dokumentiert keine allgemeine API für ausgehende Webhooks. Änderungen in Kinetic erreichen SkyPlanner daher auf einem von zwei Wegen:

• Ereignisgesteuert. Eine BPM Data Directive auf JobHead oder JobOper ruft eine Epicor Function auf, die den geänderten Fertigungsauftrag an die REST API von SkyPlanner sendet.
• Zeitgesteuertes Polling. Eine nach Änderungsdatum gefilterte BAQ wird alle paar Minuten oder stündlich ausgeführt. Diese Variante lässt sich einfacher betreiben und nach Fehlern wiederherstellen.

In der Gegenrichtung überträgt SkyPlanner Status- und Planänderungen über seine Webhooks. Ihre Middleware oder ein EFx-Endpunkt empfängt sie und schreibt die Daten in Kinetic.

1. Stammdaten erstmals laden. Lesen Sie Artikel, Ressourcengruppen, Ressourcen, Fähigkeiten, Kalender und Mitarbeiter aus. Legen Sie aus den Kinetic-Ressourcen Arbeitsstationen in SkyPlanner an und aus den Ressourcengruppen die zugehörigen Arbeitsstationsgruppen. Lesen Sie große Datenmengen mit $top und $skip seitenweise aus oder rufen Sie Massendaten über eine BAQ ab.

2. Aufträge synchronisieren. Übertragen Sie freigegebene und fixierte Fertigungsaufträge samt Arbeitsgängen und Materialien. Rufen Sie die Auftragsstruktur mit GetDatasetForTree oder einer BAQ ab, nicht Entität für Entität. Belassen Sie nicht fixierte MRP-Aufträge in Kinetic, bis sie fixiert sind. Synchronisieren Sie beim Auslesen der Bestände auch offene Bestellabrufe samt Fälligkeitsterminen. SkyPlanner betrachtet bestelltes Material ab dem Liefertermin als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert wird. So berücksichtigt die Planung sowohl Lagerbestände als auch erwartete Zugänge aus Bestellungen.

3. Planung zurückschreiben. Der Webhook von SkyPlanner sendet den geplanten Beginn, das geplante Ende und die Arbeitsstation je Arbeitsgang an einen EFx-Endpunkt (/api/v2/efx/{Company}/{Library}/{Function}). Die Funktion schreibt die Daten über die Planungs-Engine von Kinetic. Dahinter steht dasselbe Business Object, das auch die Planung in Job Entry und die Plantafeln nutzen (Beispiel aus der Community):

1. ScheduleEngine.GetNewParamsForJob erstellt das Dataset der Planungs-Engine für den Fertigungsauftrag.
2. Die Funktion setzt Auftragsnummer, Baugruppen- und Arbeitsgangsequenz sowie Datum und Uhrzeit des geplanten Beginns. Anschließend ruft sie ScheduleEngine.MoveJobItem auf.
3. Hat SkyPlanner den Arbeitsgang einer anderen Ressource innerhalb der Gruppe zugewiesen, verschiebt ScheduleEngine.ChangeResource ihn dorthin. MoveJobItem allein behält die Standardressource der Gruppe bei.
4. Die Funktion setzt die Planungssperre des Fertigungsauftrags (JobHead.SchedLocked, die Option Lock in Job Entry), damit Global Scheduling die von SkyPlanner festgelegten Termine beibehält.

Wenn Sie diese Aufrufe in einer Epicor Function bündeln, bleibt der Schreibvorgang je Fertigungsauftrag atomar, und Sie können eigene Validierungen ergänzen. Möchte ein Standort auf eine eigene Funktion verzichten, lässt sich dieselbe Abfolge mit direkten REST-Aufrufen an Erp.BO.ScheduleEngineSvc ausführen. Beschreiben Sie niemals ResourceTimeUsed oder die Datumsfelder von JobOper direkt: Damit umgehen Sie die Engine, und die Belegungen auf den Plantafeln stimmen nicht mehr mit der Planung überein.

4. Rückmeldungen aus der Fertigung. Bediener erfassen ihre Arbeit in SkyPlanner mit Mobile Confirmations, dem Production Timer oder Quick Log Mode. Jede abgeschlossene Zeitbuchung wird über Erp.BO.LaborSvc als Arbeitszeit in Kinetic gebucht: mit StartActivity und EndActivityByEmp für laufende Tätigkeiten oder mit Labors und Update für nachträgliche Einträge. Falls Ihr Standort eine Genehmigung verlangt, nehmen Sie submitForApproval in den Ablauf und den Berechtigungsumfang auf.

5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Go-live schriftlich fest:

Aufträge, die SkyPlanner plant, sind mit einer Planungssperre versehen. Global Scheduling lässt ihre Termine daher unverändert. Nutzen Sie die Kinetic-Planung weiterhin für alle Ressourcen, die SkyPlanner nicht plant.

Die Implementierung ist normalerweise innerhalb weniger Wochen nach Beginn des Onboardings abgeschlossen. Ein Kinetic-Projekt umfasst:

1. Eine 30-tägige Testphase mit CSV- oder Excel-Exporten von Aufträgen, Arbeitsgängen und Ressourcen, noch bevor die Entwicklung beginnt.
2. API-Schlüssel, Zugriffsumfang, ein eigenes Benutzerkonto für die Integration und die BAQs, die die Integration ausliest.
3. Stammdatenzuordnung: Fähigkeiten, Ressourcengruppen, Ressourcen, Kalender und Mitarbeiter werden den Arbeitsstationen, Gruppen, Schichten und dem Personal in SkyPlanner zugeordnet.
4. Erstimport von Artikeln, Fertigungsmethoden (BOM und Arbeitsgänge) und Ressourcen.
5. Synchronisierung von Fertigungsaufträgen und Bestellungen (Fälligkeitstermine aus PORel) sowie Beständen aus PartWhse.
6. Zurückschreiben der geplanten Arbeitsgangtermine über ScheduleEngineSvc (MoveJobItem, ChangeResource) in einer Epicor Function, einschließlich gesetzter Planungssperre für den Fertigungsauftrag.
7. Rückmeldungen aus der Fertigung, die über LaborSvc als Arbeitszeit gebucht werden.
8. Tests parallel zur bestehenden Kinetic-Planung, anschließend Go-live.

Kein Werk nutzt Kinetic genau wie ein anderes. Die fähigkeitsbasierte Arbeitsplanung, Kalender der Ressourcengruppen, der Aufbau der BAQs, BPM-Direktiven und versionsabhängige Methoden zum Zurückschreiben unterscheiden sich von Standort zu Standort. Ihre korrekte Einrichtung entscheidet darüber, ob Planer dem Plan vertrauen oder ihn nacharbeiten müssen.

1. Das SkyPlanner-Team richtet die Integration während des Onboardings ein und betreut sie nach dem Go-live. Das Team ordnet Ihre Ressourcen, Aufträge und Bestellabrufe zu und richtet die BAQ-Abfragen, BPM-Trigger und die Funktion zum Zurückschreiben ein. Es verbindet die REST API und Webhooks von SkyPlanner mit Kinetic REST v2. Die Betreuung geht weiter, wenn sich Ihre BAQs, BPMs oder Ihre Kinetic-Version ändern.
2. Ihr Epicor-Partner. Partner, die bereits BAQs, BPMs und Epicor Functions erstellen, können dieselbe dokumentierte REST API von SkyPlanner nutzen. Darüber lassen sich Aufträge, Produkte, Materialien, Prozessschritte und Zeiterfassungen lesen und schreiben.
3. Ihre eigenen Entwickler. Interne Teams mit Erfahrung in Kinetic REST können die Integration direkt entwickeln oder dafür Automation Studio nutzen, sofern Sie es einsetzen. Für den Einstieg genügt ein SkyPlanner-API-Schlüssel (Integrationsanleitung). Das SkyPlanner-Team unterstützt Sie bei Bedarf. Die Produktdokumentation ist unter SkyPlanner-Dokumentation öffentlich zugänglich.

Dasselbe Integrationsprinzip mit API und Webhooks ist bereits mit anderen ERP-Systemen im Produktivbetrieb, etwa bei UTU. Bei Laboratory & Allied hat das interne IT-Team die Integration mit SAP Business One weitgehend selbstständig mit Unterstützung von SkyPlanner entwickelt.

Jeder Weg beginnt gleich: Nutzen Sie zunächst die 30-tägige kostenlose Testphase mit CSV-Importen, prüfen Sie den Plan in der Praxis und setzen Sie dann die Integration um. Die Preise beginnen ab 199 € pro Monat für 5 Arbeitsstationen, bei monatlicher Abrechnung und jederzeitiger Kündbarkeit. Sie erhalten vorab zusammen mit Ihrem Tarif ein Angebot für die Integration, abgestimmt auf Ihre Abläufe und Anforderungen. So kennen Sie die Gesamtkosten, bevor Sie starten.