Integrationen / ERP / KARAT
Leitfaden zur KARAT Schnittstelle für die Feinplanung mit SkyPlanner APS
Dieser Leitfaden zeigt Partnern und IT-Teams, wie sie IS KARAT an SkyPlanner APS anbinden. SkyPlanner tauscht Daten in beide Richtungen mit KARAT aus und nutzt dafür die KARAT-eigenen Schnittstellen:
- Importiert werden Fertigungsaufträge (výrobní příkazy) und Produktionsaufträge (výrobní zakázky) mit ihren Arbeitsgängen, Artikelkarten, Stücklisten, Arbeitsplänen, Maschinen, Arbeitsplätzen, Personalressourcen, Lagerbeständen und erteilten Bestellungen.
- Geplante Start- und Endtermine werden in die Produktionsdaten in KARAT zurückgeschrieben.
- Auf Wunsch lassen sich die erfassten Arbeitszeiten der Bediener über die Terminalrückmeldung an KARAT zurückmelden.
- SkyPlanner-Webhooks übertragen Planänderungen, sobald sie auftreten.
Das SkyPlanner-Team richtet die Integration während des Onboardings passend zu Ihrer KARAT-Installation ein und betreut sie auch nach dem Produktivstart. Dieser Leitfaden richtet sich an KARAT-Partner und Entwickler, die daran mitwirken oder selbst auf der dokumentierten REST API von SkyPlanner aufbauen möchten (API-Referenz).
Schnittstellen von KARAT
Vereinbarte Datenschnittstelle.
Laut KARAT Software ermöglicht die Offenheit von ERP KARAT die Anbindung an andere externe Informationssysteme. Das System unterstützt den elektronischen Datenaustausch in XML, EDI, ISDOC und ISDS (Softwareentwicklung bei KARAT). Für die Feinplanung wird daher eine Schnittstelle für Ihre Installation vereinbart: Sie exportiert offene Fertigungsaufträge, Arbeitspläne, Ressourcen, Lagerbestände und Bestellungen und importiert geplante Termine.
Schnittstelle für Terminalrückmeldungen.
Das KARAT-Modul für Terminalrückmeldungen (terminálové odvádění) bereitet Daten für den Export in ein externes System auf und nimmt Importdaten über eine vereinbarte Schnittstelle entgegen (Terminalrückmeldungen). Es verarbeitet Arbeitsbeginn, -unterbrechung und -ende, die Übergabe von Arbeitsgängen, Materialentnahmen für die Produktion und Zugänge von Fertigerzeugnissen. Damit ist es der naheliegende Weg für die in SkyPlanner erfassten Arbeitsdaten.
Systemintegration als Dienstleistung.
KARAT Software bietet die Anbindung von IS KARAT an Betriebsdatenerfassung, automatisierte Lager, CAD/CAM und weitere Spezialanwendungen als Dienstleistung an (Systemintegration). Das SkyPlanner-Team stimmt die Schnittstelle während der Anforderungsaufnahme mit KARAT Software oder Ihrem KARAT-Partner ab.
Excel und CSV.
Für den Testimport reichen offene Fertigungsaufträge, die als Excel- oder CSV-Datei exportiert wurden.
Authentifizierung und Lizenzierung
- Integrationsbenutzer. Die Schnittstelle läuft unter einem KARAT-Benutzer mit Zugriffsrechten auf die Produktions-, Lager- und Einkaufsdaten, die sie liest und schreibt. In KARAT lassen sich Zugriffsrechte bis auf einzelne Tabellenschlüssel einschränken. Vergeben Sie daher nur die erforderlichen Rechte.
- Betriebsmodell. IS KARAT läuft On-Premise, im Outsourcing oder als SaaS. Der Übertragungsweg für die vereinbarte Schnittstelle – Dateiaustausch oder Service-Endpunkt – wird bei der Anforderungsaufnahme passend zu Ihrem Betriebsmodell eingerichtet.
- Lizenzierung. Die vereinbarte Schnittstelle und etwaige Leistungen von KARAT Software stimmen Sie mit KARAT Software oder Ihrem Partner ab.
Bei SkyPlanner erfolgt die Authentifizierung an der REST API ü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
SkyPlanner liest KARAT-Daten in festgelegten Intervallen aus. Neue Aufträge werden über regelmäßige Exporte oder Lesezugriffe auf die vereinbarte Schnittstelle erfasst, gefiltert nach offenen Fertigungsaufträgen und aktuellen Änderungen. Die Intervalle werden pro Werk festgelegt: von wenigen Minuten bei Fertigungsaufträgen bis zu einer Stunde bei Lagerbeständen.
SkyPlanner sendet Webhooks, sobald sich der Status oder der Terminplan ändert. Das Zurückschreiben erfolgt somit ereignisgesteuert.
Datenzuordnung
| KARAT-Objekt | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|
| Artikelkarten (karty), Einheiten | Produkte und Materialien | KARAT → SkyPlanner | Erstimport, danach Polling |
| Stücklisten (kusovníky) | Produktstruktur, Teilprodukte, Materialien je Produkt | KARAT → SkyPlanner | Erstimport, danach bei Änderungen |
| Arbeitspläne (technologické postupy), Arbeitsgänge und Zeiten | Prozessschritte mit Dauer, Rüst- und Abrüstzeiten | KARAT → SkyPlanner | Erstimport, danach bei Änderungen |
| Ressourcen (zdroje): Maschinen, Arbeitsplätze | Arbeitsstationen, Arbeitsstationsgruppen, alternative Arbeitsstationen | KARAT → SkyPlanner | Erstimport, danach selten |
| Personalressourcen | Personal und Anzahl der Bediener je Arbeitsgang | KARAT → SkyPlanner | Erstimport, danach bei Änderungen |
| Fertigungsaufträge (výrobní příkazy), Produktionsaufträge (výrobní zakázky), Arbeitsgänge, Material | Aufträge und Arbeitsgänge mit Fälligkeitsterminen und Materialbedarf | KARAT → SkyPlanner | Polling alle paar Minuten |
| Lagerbestände (sklady) | Bestandsmengen | KARAT → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Erteilte Bestellungen (objednávky vydané) mit Lieferterminen | Bestellungen, Materialzugänge nach Liefertermin | KARAT → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Geplanter Start und Abschluss je Auftragsarbeitsgang (vereinbarter Import) | Geplanter Start und Abschluss je Arbeitsgang | SkyPlanner → KARAT | Bei Planänderungen über einen SkyPlanner-Webhook |
| Terminalrückmeldungen: Start, Stopp, Übergabe, Mengen | Zeiterfassungen und Bedienerrückmeldungen | SkyPlanner → KARAT | Je Rückmeldung oder je Schicht, sofern gewünscht |
| Nicht in KARAT | Rüstzeitmatrix, Werkzeuge als begrenzte Ressourcen, Arbeitsgänge mit mehreren Bedienern | Pflege in SkyPlanner | Einrichtung während des Onboardings |
Integrationsabläufe
1. Erstimport der Stammdaten. Lesen Sie Artikelkarten, Stücklisten, Arbeitspläne und Ressourcen ein. Ordnen Sie Ressourcen in SkyPlanner bewusst zu: Ein Arbeitsplatz mit vier Maschinen wird zu einer Arbeitsstationsgruppe oder zu vier Arbeitsstationen. Personalressourcen für die Arbeitsvorbereitung, etwa Technologen und Konstrukteure, die über eine gewichtete Planung eingeplant werden, bleiben außerhalb des Fertigungsplans, sofern Sie nichts anderes festlegen.
2. Auftragssynchronisierung. Lesen Sie freigegebene Fertigungsaufträge mit ihren Arbeitsgängen und Materialien sowie erteilte Bestellungen ein. SkyPlanner betrachtet bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Lagerbestand, sobald die Bestellung als Delivered markiert wird.
3. Zurückschreiben der Planung. Sobald die Planungsengine einen Arbeitsgang einplant oder verschiebt, löst ein SkyPlanner-Webhook über die vereinbarte Schnittstelle den Import der geplanten Start- und Endtermine in KARAT aus. Das Importziel in KARAT – die Ressourcenreservierungen oder die Arbeitsgangtermine im Fertigungsauftrag – wird bei der Anforderungsaufnahme während des Onboardings festgelegt.
4. Rückmeldungen aus der Fertigung. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Diese Zeiterfassungen halten den Terminplan aktuell. Sie entscheiden, ob Istzeiten an KARAT zurückgemeldet werden. Falls ja, werden sie über die Schnittstelle für Terminalrückmeldungen als Start-, Stopp- und Mengenereignisse je Arbeitsgang importiert. Falls nein, melden die Bediener weiterhin an den KARAT-Terminals zurück, und SkyPlanner liest diese Rückmeldungen ein.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Artikelkarten, Stücklisten, Arbeitspläne, Mengen, Auftragsstatus | KARAT |
| Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Maschinenzuordnung | SkyPlanner |
| Rüstzeitmatrix, Werkzeug- und Bedienerbedarf, alternative Ressourcen | SkyPlanner |
| Schichten und arbeitsfreie Tage | Ein System, festgelegt bei der Anforderungsaufnahme |
| Arbeitsgangrückmeldungen, Materialentnahmen und -zugänge | KARAT, dort erfasst oder aus den SkyPlanner-Zeiterfassungen übertragen |
Legen Sie genau ein System fest, das Auftragstermine schreibt. Falls APS KARAT weiterhin Pläne in die Produktionsdaten zurückschreibt, deaktivieren Sie dies für die von SkyPlanner geplanten Aufträge. So überschreiben sich die beiden Systeme nicht gegenseitig.
Typischer Projektablauf
Die Implementierung ist in der Regel innerhalb weniger Wochen nach Beginn des Onboardings abgeschlossen. Prüfen Sie den Terminplan vorher im kostenlosen 30-tägigen Test mit Maschinen, Arbeitsplänen und offenen Fertigungsaufträgen, die Sie aus KARAT als CSV- oder Excel-Datei exportieren.
- Datenzuordnung. Legen Sie die Zuordnungstabelle, die Regeln zur Datenhoheit und die Synchronisierungsintervalle fest. Entscheiden Sie auch, ob Arbeitsgangrückmeldungen zurückgeschrieben werden.
- KARAT-Schnittstelle. Vereinbaren Sie mit KARAT Software oder Ihrem Partner das Export- und Importformat sowie den Übertragungsweg und richten Sie den Integrationsbenutzer ein. Testen Sie zunächst mit einer Kopie der Datenbank.
- Erstimport. Artikelstammsätze, Stücklisten, Arbeitspläne und Ressourcen.
- Aufträge und Bestellungen synchronisieren. Zeitgesteuertes Auslesen mit Filtern und Wiederholungsversuchen.
- Planungsrestriktionen in SkyPlanner einrichten. Rüstzeitmatrix, Werkzeuge, Anzahl der Bediener je Arbeitsgang sowie alternative Maschinen oder Mitarbeiter.
- Plan zurückschreiben. Testen Sie den Import der Plantermine und, falls vorgesehen, den Import der Terminalrückmeldungen.
- Parallel testen. Lassen Sie SkyPlanner parallel zur bisherigen Planung laufen, vergleichen Sie Termine und korrigieren Sie die Stammdaten.
- Produktivstart. Aktivieren Sie das Zurückschreiben, sobald die Daten übereinstimmen.
Was Sie bei einer KARAT-Integration einplanen sollten
- Die Schnittstelle wird für jede Installation vereinbart. Planen Sie Zeit für die Anforderungsaufnahme mit KARAT Software oder Ihrem Partner ein und dokumentieren Sie das Export- und Importformat als Teil der Datenzuordnung.
- Zuständigkeit für die Planung. APS KARAT speichert Pläne beim Schließen in den Produktionsdaten. Legen Sie fest, ob und welche Aufträge es weiterhin planen soll.
- Werksübergreifender Gesamtplan. Legen Sie für jedes Werk fest, welche Aufträge SkyPlanner einplant.
- Bestehende Terminalanbindungen. Wenn Terminalrückmeldungen bereits an ein anderes System exportiert werden, nutzen Sie die vereinbarte Schnittstelle auch für die SkyPlanner-Zeitbuchungen, statt eine zweite einzurichten.
- Zeiteinheiten. Prüfen Sie beim Erstimport, in welchen Einheiten die Arbeitsgangzeiten in den Arbeitsplänen angegeben sind. Diese Einheiten sind für sämtliche Zeitangaben maßgeblich.
Wer die KARAT-Integration einrichtet und betreut
- Das SkyPlanner-Team richtet die Integration während der Einführung ein und betreut sie nach dem Produktivstart. Das umfasst die vereinbarten Abläufe für Export, Import und Terminalrückmeldungen. Jedes Werk nutzt KARAT anders. Dieses Wissen fließt in die Einrichtung ein.
- KARAT Software oder Ihr KARAT-Partner kann mitwirken. Beide kennen Ihre Installation und Datenstrukturen und können gemeinsam mit dem SkyPlanner-Team die vereinbarte Schnittstelle und den Integrationsbenutzer einrichten.
- Ihre eigenen Entwickler können die Integration erweitern. Dafür nutzen sie die REST API von SkyPlanner mit einem API-Token. Ein API-Token genügt für den Einstieg; bei Bedarf unterstützt das SkyPlanner-Team. Die Dokumentation finden Sie unter 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 mit KARAT, auf der KARAT-Seite und in der Übersicht der ERP-Integrationen. Grundlagen erläutert die Seite zur Feinplanung.
Erfahrungen von Fertigungsunternehmen mit SkyPlanner
2 hjede Woche eingespart
„Mit SkyPlanner sind wir von der Produktionsplanung in Excel-Tabellen zur Produktionsoptimierung in Echtzeit übergegangen.“
Kalle Kalliomäki, Supply-Chain-Spezialist
UTU · Elektrische Schalttafeln und Schaltanlagen
Die Produktionsplanung spart jede Woche 2 Stunden Arbeitszeit, und eine neue Arbeitsliste 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.
99,2%Liefertreue
„SkyPlanner hat Engpässe sichtbar gemacht und für mehr Klarheit in der Produktionssteuerung gesorgt.“
Toni Tuori, Produktionsleiter
Piristeel · Dachsicherheits- und Regenwassersysteme
Die Liefertreue erreichte dieses Jahr 99,2%, und die Feinplanung spart täglich bis zu vier Stunden Arbeitszeit.
WenigerStillstände durch Materialmangel
„Der Mehrwert 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 Belegungsplanung liefert genauere Liefertermine, und Produktionsstillstände durch Materialmangel sind stark zurückgegangen.
Häufige Fragen
Wie wird SkyPlanner an KARAT angebunden?
Über eine vereinbarte KARAT-Datenschnittstelle im XML-Format für Aufträge, Stammdaten und Plantermine sowie über KARAT-Terminalrückmeldungen für erfasste Arbeitszeiten. Das SkyPlanner-Team richtet die Anbindung während der Einführung gemeinsam mit KARAT Software oder Ihrem KARAT-Partner ein.
Wie übernimmt SkyPlanner Änderungen aus KARAT?
SkyPlanner liest KARAT nach einem je Werk festgelegten Zeitplan aus und filtert dabei nach offenen Fertigungsaufträgen und aktuellen Änderungen. Die eigenen Webhooks von SkyPlanner übertragen Planänderungen, sobald sie auftreten.
Wie werden Plantermine nach KARAT zurückgeschrieben?
Die geplanten Start- und Endtermine werden je Auftragsarbeitsgang über die vereinbarte Schnittstelle importiert. Bei der Anforderungsaufnahme während der Einführung legt das SkyPlanner-Team das Importziel fest: Ressourcenreservierungen oder Arbeitsgangtermine im Fertigungsauftrag.
Können Zeitbuchungen der Mitarbeiter an KARAT zurückgemeldet werden?
Ja, wenn Sie das wünschen. Die KARAT-Terminalrückmeldung nimmt Daten über eine vereinbarte Schnittstelle entgegen. So werden SkyPlanner-Zeitbuchungen als Start-, Stopp- und Mengenmeldungen je Arbeitsgang übertragen.
Sollte ein KARAT-Partner APS KARAT oder SkyPlanner empfehlen?
SkyPlanner, wenn sich der Plan des Kunden häufig ändert und auf aktuellen Daten beruhen muss. APS KARAT plant mit Daten, die aus der Produktion exportiert wurden. Die Planer erstellen Varianten, bevor sie eine davon zurückspeichern (KARAT). SkyPlanner plant automatisch neu, berücksichtigt Umrüstungen, Werkzeuge, Teams und Material und erlaubt unbegrenzt viele Benutzer – ab 199 € pro Monat.
Können wir SkyPlanner testen, bevor wir die Integration aufbauen?
Ja. Mit der kostenlosen 30-tägigen Testversion können Sie bis zu 20 Arbeitsstationen nutzen und Daten aus KARAT per CSV oder Excel importieren. Eine Kreditkarte ist nicht erforderlich. Starten Sie den Test oder sprechen Sie mit dem Vertrieb, um die Anforderungen an die Integration aufzunehmen.