Integrationen / ERP / Lemonsoft
Leitfaden zur Lemonsoft Schnittstelle für die Feinplanung mit SkyPlanner APS
Dieser Leitfaden zeigt Partnern und IT-Teams, wie sie Lemonsoft ERP mit SkyPlanner APS verbinden. Über die REST API von Lemonsoft tauschen beide Systeme Daten in beide Richtungen aus:
- Auftragsnummern (työnumero), Arbeitsgänge (työvaihe), Maschinen, Produktstrukturen, Materialien und geplante Schichten werden importiert.
- Geplante Start- und Endzeiten sowie die gewählte Maschine werden in die Arbeitsgänge zurückgeschrieben.
- Rückmeldungen der Bediener werden als Fertigmeldungen zurückgebucht.
- SkyPlanner-Webhooks übertragen Planänderungen, sobald sie auftreten.
Kaskea Group nutzt SkyPlanner mit einer bidirektionalen Lemonsoft Schnittstelle. Das SkyPlanner-Team passt die Schnittstelle während der Einführung an Ihre Lemonsoft-Umgebung an und betreut sie auch nach dem Produktivstart. Partner und Entwickler können auch auf der dokumentierten REST API von SkyPlanner aufbauen (API-Referenz).
Die REST API von Lemonsoft
Die Integrations-API von Lemonsoft heißt LemonRest und ist in Swagger 2.0 als Version v1 dokumentiert. Der Build „LemonRest 2026.10 release-2026.10.2“ führt 422 Pfade auf. (Swagger)
- Die Basis-URL ist je nach Umgebung unterschiedlich. Sie finden sie in der Benutzerverwaltung unter Umgebungsverwaltung und Dienstadressen im Feld Rest API. Auf der Azure-Plattform von Lemonsoft lautet sie
https://rest.lemon.fi. - Verfügbarkeit. Bei Kunden des Lemonsoft-Plattformdienstes (Alustapalvelu) sind die REST APIs vorinstalliert. Es müssen lediglich die Benutzerrechte vergeben werden. (Quelle)
- Testumgebung. Der Endkunde bestellt sie beim Lemonsoft Service Desk.
Die separate API zur Zeiterfassung von Kellokortti wird für die Feinplanung nicht benötigt.
Authentifizierung
LemonRest arbeitet mit einer Sitzung:
POST /api/auth/loginmit UserName, Password, Database und ApiKey liefert einesession_idzurück.- Senden Sie diese bei jedem Aufruf im Header
Session-Idmit. - Erneuern Sie die Sitzung mit
POST /api/auth/renew. MitGET /api/auth/aliveprüfen Sie, ob sie aktiv ist.
POST /api/auth/login/token nimmt statt Benutzername und Passwort einen Token entgegen. Legen Sie einen eigenen Integrationsbenutzer mit einem API-Schlüssel an und vergeben Sie nur die Rechte, die die Integration benötigt. (Quelle)
Bei SkyPlanner erfolgt die Authentifizierung an der REST API über ein API-Token (SkyPlanner Settings > API). Die API ist in Swagger/OpenAPI dokumentiert. Die Integrationsanleitung führt Sie durch die ersten Aufrufe.
Änderungen erkennen: Delta-Abfragen
LemonRest bietet keine Endpunkte für Webhooks oder Abonnements. Änderungen werden über eine Delta-Abfrage abgerufen:
GET /api/production/main_ws/changed?updated_after=...liefert die seit dem letzten Durchlauf geänderten Arbeitsgänge.- Ergänzen Sie
optimization=true. Dieser Parameter wurde mit Release 2026.6.3 eingeführt, um die Abhängigkeit vom Protokoll zu beseitigen und die Abfrage zu beschleunigen. (Versionshinweise) GET /api/log/deletion_eventserfasst gelöschte Arbeitsgänge, damit stornierte Arbeiten aus dem Plan entfernt werden.
Fragen Sie Änderungen alle paar Minuten ab. SkyPlanner sendet Webhooks, wenn sich der Status oder der Plan ändert. Das Rückschreiben erfolgt somit ereignisgesteuert.
Datenzuordnung
| Lemonsoft-Objekt (Endpunkt) | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|
Tuote, product_code (/api/products) | Produkte und Materialien | Lemonsoft → SkyPlanner | Erstimport, danach bei Änderungen |
Tuoterakenne mit Työvaiheet-Zeilen (/api/products/structure, all_levels) | Produktstruktur, Unterprodukte, Prozessschritte mit Rüstzeiten | Lemonsoft → SkyPlanner | Erstimport, danach bei Änderungen |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Arbeitsstationen, Arbeitsstationsgruppen | Lemonsoft → SkyPlanner | Erstimport, danach selten |
Työnumero als ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Aufträge mit Fälligkeitsterminen und Priorität | Lemonsoft → SkyPlanner | Delta-Abfrage alle paar Minuten |
Työvaihe als ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Arbeitsgänge (Prozessschritte) je Arbeitsstation | Lemonsoft → SkyPlanner | Delta-Abfrage alle paar Minuten |
Komponentenbedarf (main_ws/{worknumber}/materials) | Materialbedarf je Arbeitsgang | Lemonsoft → SkyPlanner | Mit jedem Arbeitsgang |
Geplante Schichten (/api/persons/plannedshifts) | Schichten, Personal | Lemonsoft → SkyPlanner | Täglich; alternativ Schichtpflege in SkyPlanner |
Kundenauftrag zur Auftragsnummer (/api/orders/work/{work_number}) | Angaben zu Kunde und Priorität | Lemonsoft → SkyPlanner | Mit jedem Arbeitsgang |
Työvaihe start_time, end_time, machine_id (PUT /api/production/workstage) | Geplanter Start, geplantes Ende und Arbeitsstation | SkyPlanner → Lemonsoft | Bei Planänderungen über einen SkyPlanner-Webhook |
Fertigmeldung (POST main_ws/sub_ws/completion_entry) | Rückmeldungen: Gut- und Ausschussmenge, Stunden, Person | SkyPlanner → Lemonsoft | Bei jeder Rückmeldung |
| In SkyPlanner festgelegte Planungsregeln | Zulässige Arbeitsstationen je Arbeitsgang, Rüstzeitmatrix, Werkzeuge | Pflege in SkyPlanner | Einrichtung während der Einführung |
Integrationsmuster
1. Stammdaten erstmals importieren. Lesen Sie Maschinen und Maschinengruppen, Produktstrukturen mit ihren Arbeitsgängen sowie Standardarbeitsphasen ein. Ordnen Sie jede konkrete Maschine einer SkyPlanner-Arbeitsstation zu. Verwenden Sie übergeordnete Maschinen (Isäkone) nur zur Gruppierung, da sie die Kapazitäten der untergeordneten Maschinen summieren.
2. Auftragsnummern synchronisieren. Lesen Sie offene Auftragsnummern mit ihren Arbeitsgängen über /api/production/workstage oder main_ws/sub_ws ein, nach Status gefiltert und seitenweise. Halten Sie sie anschließend mit main_ws/changed aktuell. Ordnen Sie work_amount_left zu, nicht work_amount, denn Lemonsoft plant anhand der Restmenge. Bestellungen fließen in die materialgesteuerte Feinplanung von SkyPlanner ein. Ein Arbeitsgang wartet deshalb bis zum Liefertermin der Bestellung.
3. Planung zurückschreiben. Für jeden Arbeitsgang, den die Planungsengine eingeplant oder verschoben hat, sendet SkyPlanner PUT /api/production/workstage mit dem Arbeitsgang und seinen sub_workstages. Jeder Arbeitsgang enthält start_time und end_time sowie machine_id, wenn er auf eine alternative Maschine verschoben wurde.
4. Rückmeldungen aus der Fertigung. Bediener melden ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer zurück. Jede Rückmeldung wird mit sub_workstage_id, person_number, done_amount, hours, failed_amount und job_done an completion_entry gesendet. Senden Sie material_consumptions mit, wenn der Arbeitsgang Material verbraucht. Lemonsoft führt dann eine normale Fertigmeldungsbuchung (valmistuskirjaus) aus.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Produkte, Strukturen, Arbeitsgänge, Mengen, Arbeitsgangstatus | Lemonsoft |
| Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Maschinenauswahl | SkyPlanner |
| Zulässige Arbeitsstationen je Arbeitsgang, Rüstzeitmatrix, Werkzeuge | SkyPlanner |
| Schichten und Abwesenheiten | Ein System, bei der Anforderungsaufnahme festgelegt |
| Fertigmeldungen und Lagerbuchungen | Lemonsoft, gebucht auf Basis der SkyPlanner-Rückmeldungen |
Konflikte entstehen vor allem durch die automatische Planung von Lemonsoft und die Aktualisierungsfunktion: Beide planen nicht gesperrte Arbeitsgänge neu ein. Lassen Sie AUTOTIMING auf 0, solange SkyPlanner das führende Planungssystem ist. Wenn Sie die Funktion eingeschaltet lassen, setzen Sie für jede zurückgeschriebene Auftragsnummer die Planungssperre. Diese fixiert sämtliche Arbeitsgänge der Nummer. Koneiden kapasiteetin lukitus allein reicht nicht aus, da die automatische Planung nicht gesperrte Arbeitsgänge von einem gesperrten Tag auf einen anderen verschiebt. (Quelle)
Typischer Projektablauf
Die Implementierung ist normalerweise innerhalb weniger Wochen nach Beginn der Einführung abgeschlossen. Davor testen Sie SkyPlanner 30 Tage kostenlos mit Ihren eigenen Daten aus einem Excel-Export von Auftragsnummern, Arbeitsgängen und Maschinen.
- Anforderungsaufnahme. Legen Sie die Zuordnungstabelle, die Regeln zur Datenhoheit und das Abfrageintervall fest.
- Zugang. Der Endkunde bestellt eine Testumgebung beim Lemonsoft Service Desk und legt den Integrationsbenutzer sowie den API-Schlüssel an.
- Erstimport. Maschinen, Gruppen, Produktstrukturen und Arbeitsgänge.
- Auftragsnummern synchronisieren. Delta-Abfragen, Löschereignisse und Sitzungserneuerung.
- Restriktionen in SkyPlanner einrichten. Zulässige Arbeitsstationen je Arbeitsgang, Rüstzeitmatrix und Werkzeuge.
- Rückschreiben. Arbeitsgangzeiten und Fertigmeldungen in der Testumgebung prüfen.
- Parallelbetrieb und Produktivstart. Mit dem aktuellen Gantt-Plan vergleichen, Stammdaten korrigieren und anschließend das Rückschreiben im Produktivsystem aktivieren.
Was Sie bei einer Lemonsoft-Integration einplanen sollten
- Eine Maschine je Arbeitsgang. In Lemonsoft ist jedem Arbeitsgang eine Maschine zugeordnet. Welche Maschinen für ein Produkt zulässig sind, wird bei der Einführung anhand einer Liste oder der Produkteigenschaften festgelegt. SkyPlanner wählt dann aus diesen Alternativen.
- Tageskapazität. Die feste Kapazität ist ein Tageswert; Abweichungen werden ohne Uhrzeit angegeben. Bilden Sie die tatsächlichen Schichten in SkyPlanner ab oder lesen Sie geplante Schichten ein.
- Restmenge. Ordnen Sie
work_amount_leftzu. Die Einstellungen STARTJOB_AUTOTIMENOW und JOBDONE_AUTOTIMENOW verschieben auch die in Lemonsoft eingeplante Last. - Sitzungen laufen ab. Erneuern Sie die Sitzung vor längeren Synchronisierungen und sorgen Sie dafür, dass eine erzwungene Neuanmeldung abgewickelt werden kann.
- Regeln für Rückmeldungen. Prüfen Sie jede Rückmeldung vor dem Buchen anhand des Arbeitsgangstatus und begrenzen Sie die Aufrufrate bei Lastspitzen.
- Zwei Clients. LemonOnline und die Windows-Version nutzen dieselbe Datenbank. Die Schnittstelle bedient daher beide.
- Große Strukturen. Nutzen Sie für umfangreiche Importe
/api/async/product/structurezusammen mit/api/async/status/{jobId}.
Lemonsoft-Integration: Wer übernimmt Einrichtung und Support?
Zur Einrichtung gehört die Zuordnung zu Ihren Maschinen, Arbeitsgängen und Ihrer Lemonsoft-Konfiguration. Dazu kommen die Planungsregeln, die Sie in SkyPlanner pflegen: zulässige Arbeitsstationen je Arbeitsgang, die Rüstzeitmatrix und Werkzeuge.
- Das SkyPlanner-Team richtet die Schnittstelle während der Einführung ein und betreut sie nach dem Produktivstart. Jedes Werk nutzt Lemonsoft anders. Dieses Wissen fließt hier ein.
- Ihr Lemonsoft-Partner kann mitwirken. Er kennt Ihre Konfiguration und kann sich um den API-Benutzer, die Berechtigungen und die Testumgebung kümmern. SkyPlanner stellt die REST API, die Swagger/OpenAPI-Dokumentation und Webhooks bereit.
- Ihre eigenen Entwickler können darauf aufbauen und mit einem API-Token dieselbe dokumentierte REST API nutzen. Für den Einstieg genügt ein API-Token. Bei Bedarf unterstützt das SkyPlanner-Team.
Sobald die Verbindung steht, plant die Arcturus-Engine auf Basis der aktuellen Lemonsoft-Auftragsnummern. Die geplanten Zeiten werden in die Arbeitsgänge übertragen. SkyPlanner ist ab 199 € pro Monat inklusive 5 Arbeitsstationen erhältlich, bei monatlicher Abrechnung. 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.
Wie die eigene Planung von Lemonsoft im Vergleich abschneidet, erfahren Sie unter Feinplanung mit Lemonsoft. Einen Überblick finden Sie auf der Lemonsoft-Seite, weitere Systeme in der Übersicht der ERP-Integrationen.
Erfahrungen von Fertigungsunternehmen mit SkyPlanner
Lemonsoftbidirektional mit SkyPlanner verbunden
Kaskea Group
Auftragsfertigung: CNC-Bearbeitung, Stahlbau und Montage
Die Produktion wird in SkyPlanner geplant, mit einer bidirektionalen Schnittstelle zu Lemonsoft.
WenigerStillstände durch Materialengpässe
„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 Einplanung sorgt für genauere Liefertermine. Produktionsstillstände durch Materialengpässe sind deutlich zurückgegangen.
2 hjede Woche eingespart
„Mit SkyPlanner haben wir den Schritt von der Produktionsplanung mit Excel-Tabellen zur Optimierung unserer Produktion in Echtzeit gemacht.“
Kalle Kalliomäki, Supply-Chain-Spezialist
UTU · Elektroverteilungen und Schaltanlagen
In der Produktionsplanung werden jede Woche 2 Stunden Arbeitszeit eingespart. Eine neue Auftragsreihenfolge erreicht die Fertigungslinie innerhalb von 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.
Häufige Fragen
Hat Lemonsoft eine API für Produktionsdaten?
Ja. LemonRest bietet Zugriff auf Fertigungsaufträge und Arbeitsgänge, Maschinen, Produktstrukturen, Materialien und Schichten sowie die Möglichkeit, Fertigmeldungen zu buchen. Für Alustapalvelu-Kunden ist LemonRest vorinstalliert. Zur Nutzung sind ein API-Schlüssel und Benutzerberechtigungen erforderlich.
Unterstützt Lemonsoft Webhooks?
In LemonRest sind keine Webhook-Endpunkte aufgeführt. Änderungen werden über die Delta-Abfrage main_ws/changed und Löschereignisse alle paar Minuten abgerufen. Die eigenen Webhooks von SkyPlanner übertragen Planänderungen unmittelbar, sobald sie auftreten.
Wie werden geplante Zeiten nach Lemonsoft zurückgeschrieben?
Über PUT /api/production/workstage. Damit werden Startzeit, Endzeit und Maschine eines Auftrags und seiner Arbeitsgänge aktualisiert. Lassen Sie die automatische Planung in Lemonsoft deaktiviert, solange SkyPlanner für die Feinplanung zuständig ist. Alternativ setzen Sie die Planungssperre für jede zurückgeschriebene Auftragsnummer. So bleiben die von SkyPlanner gesetzten Zeiten erhalten.
Können Mitarbeiterrückmeldungen aus SkyPlanner in Lemonsoft gebucht werden?
Ja. Jede Rückmeldung wird als Fertigmeldung mit Gutmenge, Ausschussmenge, Stunden und Person gebucht. In Kundenprojekten ist dies täglich im Einsatz.
Wer richtet die Lemonsoft-Integration ein?
Das SkyPlanner-Team richtet die bidirektionale Schnittstelle während der Einführung passend zu Ihrer Lemonsoft-Konfiguration ein und betreut sie nach dem Produktivstart. Auch Ihr Lemonsoft-Partner oder Ihre eigenen Entwickler können auf der dokumentierten REST API von SkyPlanner aufbauen. Für den Einstieg genügt ein API-Token.
Können wir SkyPlanner testen, bevor die Schnittstelle eingerichtet wird?
Ja. Mit der kostenlosen 30-Tage-Testversion können Sie bis zu 20 Arbeitsstationen nutzen und Daten aus Lemonsoft per Excel oder CSV importieren. Eine Kreditkarte ist nicht erforderlich. Jetzt testen oder den Vertrieb kontaktieren, um die Anforderungen an die Integration aufzunehmen.
