Integrationen / ERP / Visma L7
Visma L7 Schnittstelle: Leitfaden zur APS-Feinplanung
Dieser Leitfaden zur Visma L7 Schnittstelle zeigt Partnern und IT-Teams, wie sie Visma L7 mit SkyPlanner APS verbinden. SkyPlanner tauscht Daten mit Visma L7 in beide Richtungen über die Visma L7 REST API aus:
- Auftragsnummern (työnumero), Arbeitsgänge (työnvaihe), Ressourcen, Produktstrukturen, Teile, Materialien, Lagerbestände, Verkaufspositionen und Bestellpositionen werden eingelesen.
- Für jede Arbeitskarte werden Ressource, Startdatum, Priorität, Person und die Stunden je Tag mit
PUT /manufphases/zurückgeschrieben. - Die Kapazität im Ressourcenkalender wird mit
POST /resourceupdates/synchronisiert. - Produktionsereignisse, die in den L7-Arbeitsvorräten gebucht wurden, werden mit
GET /manufevents/zurückgelesen. - SkyPlanner-Webhooks übertragen Planänderungen, sobald sie auftreten.
Das SkyPlanner-Team passt die Integration beim Onboarding an Ihre L7-Konfiguration an und betreut sie auch nach dem Produktivstart. Partner und Entwickler können zudem die dokumentierte REST API von SkyPlanner für eigene Anbindungen nutzen (API-Referenz).
Die REST API von Visma L7
Die API heißt Visma L7 – REST API und ist im Format OpenAPI 3.0.3 mit Änderungsprotokoll dokumentiert (Dokumentation). Sie läuft auf Visma LTR.
- Der Basispfad lautet
/ltrws/REST/L7auf Ihrem eigenen LTR-Host, entweder lokal oder im gehosteten Anwendungsdienst von Visma. - Lizenzierung. Jeder Endpunkt wird separat lizenziert. Zum Zurückschreiben des Plans ist die Lizenz L7RMFPP für
PUT /manufphases/erforderlich, für Kapazitätsaktualisierungen die Lizenz L7RMCAP. Für Leseendpunkte sind jeweils eigene Lizenzen nötig. - Paginierung. Listen werden mit
pageSizeundrecAfterseitenweise abgerufen und mitqueryKey1,queryKey2undqueryStringgefiltert.
Authentifizierung
Bei jedem L7-Aufruf werden zwei Tokens mitgesendet:
- hash wählt die Datenbank und den Mandanten aus.
- token identifiziert den API-Benutzer.
Ihr LTR-Administrator legt den API-Benutzer in Visma LTR an, verknüpft ihn mit dem L7-Mandanten, weist Profile zu und erstellt das Benutzertoken (Erste Schritte). Verwenden Sie einen eigenen Integrationsbenutzer, der nur die für die Integration erforderlichen Rechte besitzt.
Bei SkyPlanner erfolgt die Authentifizierung an der REST API über ein API-Token, das im Header Authorization-Token gesendet wird. Sie erstellen es unter Einstellungen > API. Das Integrationstutorial führt Sie durch die ersten Aufrufe.
Änderungen erkennen: modifiedAfter
Die L7 REST API bietet keine Webhooks. Änderungen werden per Polling abgerufen:
- Aktivieren Sie in der L7-Dateipflege (Tiedostohuolto) die Änderungsprotokollierung (DBLOG) für die Tabellen, die die Integration ausliest, etwa Arbeitskarten und Teile.
- Rufen Sie die Leseendpunkte auf und setzen Sie
modifiedAfterauf den Zeitpunkt des letzten Durchlaufs. Gelöschte Datensätze werden als gelöscht gekennzeichnet zurückgegeben, sodass stornierte Arbeiten aus dem Plan entfernt werden. - Führen Sie das Polling alle paar Minuten aus. SkyPlanner sendet Webhooks, wenn sich der Status oder der Plan ändert. Das Zurückschreiben erfolgt daher ereignisgesteuert.
Datenzuordnung
| Visma L7-Objekt (Endpunkt) | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|
Tuote (GET /products/) | Produkte und Materialien | L7 → SkyPlanner | Erstimport, danach bei Änderungen |
Teile zu einer Auftragsnummer (GET /manufcomponents/) | Unterprodukte | L7 → SkyPlanner | Polling mit modifiedAfter |
Materialbedarfe (GET /manufmaterials/) | Materialbedarf je Arbeitsgang | L7 → SkyPlanner | Polling mit modifiedAfter |
Ressourcenbaum (KRYH) mit Maschinenanzahl (GET /manufresources/) | Arbeitsstationen und Arbeitsstationsgruppen | L7 → SkyPlanner | Erstimport, danach nur selten |
Arbeitskarte (TSUUNR) je Arbeitsgang (GET /manufphases/) | Arbeitsgänge (Prozessschritte) je Arbeitsstation | L7 → SkyPlanner | Polling alle paar Minuten |
Lagerbestände (GET /stockbalances/) | Lagerbestand | L7 → SkyPlanner | Polling |
Bestellpositionen (GET /purchaserows/) | Bestellungen mit Lieferterminen | L7 → SkyPlanner | Polling |
Verkaufsaufträge und -positionen (GET /salesorders/, GET /salesrows/) | Fälligkeitstermine, Kundenpriorität | L7 → SkyPlanner | Polling |
Produktionsereignisse (GET /manufevents/) | Fortschritt je Arbeitsgang | L7 → SkyPlanner | Polling |
Arbeitskarte: resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Geplante Arbeitsstation, Start, Reihenfolge und Stunden je Tag | SkyPlanner → L7 | Bei Planänderungen über SkyPlanner-Webhook |
Kapazität im Ressourcenkalender (POST /resourceupdates/) | Schichtkapazität | SkyPlanner → L7 | Bei Schichtänderungen |
| In SkyPlanner festgelegte Planungsregeln | Zulässige Arbeitsstationen, Rüstzeitmatrix, Werkzeuge, Personal | In SkyPlanner gepflegt | Einrichtung beim Onboarding |
Integrationsabläufe
1. Erstimport der Stammdaten. Lesen Sie den Ressourcenbaum ein und ordnen Sie jede Maschine einer eigenen SkyPlanner-Arbeitsstation zu. Umfasst eine L7-Ressource mehrere Maschinen, legen Sie pro Maschine eine Arbeitsstation und für die Ressource eine Arbeitsstationsgruppe an. Lesen Sie Produkte und Produktstrukturen samt Arbeitsgängen ein.
2. Auftragsnummern synchronisieren. Lesen Sie offene Arbeitskarten mit GET /manufphases/ ein und halten Sie sie anschließend mit modifiedAfter aktuell. Lesen Sie Teile und Materialbedarfe je Auftragsnummer sowie Lagerbestände und Bestellpositionen ein. So wartet ein Arbeitsgang auf den Liefertermin der zugehörigen Bestellposition.
3. Plan zurückschreiben. Für jeden Arbeitsgang, den die Planungsengine eingeplant oder verschoben hat, ruft SkyPlanner PUT /manufphases/ auf. Der Body enthält je Arbeitskarte einen workSheet-Eintrag mit:
numberfür die Arbeitskarte undresourcefür die ausgewählte RessourcestartDateundpriority, damit die L7-Arbeitsvorräte die Reihenfolge aus SkyPlanner anzeigenperson, wenn ein bestimmter Bediener eingeplant istschedulingDaysfür die geplanten Stunden je Datum
L7 übernimmt eine von einem externen System gesetzte Priorität unverändert (Quelle). Damit bleibt die Reihenfolge in den Arbeitsvorräten erhalten.
4. Kapazität synchronisieren. Wenn sich Schichten, Feiertage oder Überstunden in SkyPlanner ändern, schreibt POST /resourceupdates/ die neue Kapazität in den L7-Ressourcenkalender. Die Auslastungsansichten in L7 stimmen dann mit dem Plan überein.
5. Fertigungsfortschritt. Die Bediener buchen weiterhin in den L7-Arbeitsvorräten und in Visma LTR. SkyPlanner liest die Ereignisse mit GET /manufevents/ ein. Bediener können Arbeiten auch in SkyPlanner Mobile Confirmations rückmelden. Autopilot plant anhand der Rückmeldungen aus der jeweiligen Quelle neu; beim nächsten Zurückschreiben werden die neuen Zeiten übertragen.
6. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Produkte, Strukturen, Arbeitsgänge, Mengen, Status der Auftragsnummer | Visma L7 |
| Reihenfolge der Arbeitsgänge, Starttermine, Stunden je Tag, Ressourcenauswahl | SkyPlanner |
| Zulässige Arbeitsstationen, Rüstzeitmatrix, Werkzeuge, Personal | SkyPlanner |
| Schichten und Abwesenheiten | SkyPlanner, Übertragung in den L7-Ressourcenkalender |
| Produktionsereignisse und Lagerbuchungen | Visma L7-Arbeitsvorräte und LTR |
Die wichtigste Konfliktquelle ist die eigene Planung von L7. Bedarfsrechnung und Feinplanung können nicht gesperrte Arbeitsgänge erneut einplanen. Nutzen Sie diese Funktionen nur für Material und Reservierungen. Planen Sie Arbeitsgänge, für die SkyPlanner führend ist, nicht erneut ein.
Typischer Projektablauf
Die Implementierung ist normalerweise innerhalb von Wochen nach Beginn des Onboardings abgeschlossen. Davor nutzen Sie die kostenlose 30-tägige Testphase mit Ihren eigenen Daten aus einem Excel-Export von Auftragsnummern, Arbeitsgängen und Ressourcen.
- Anforderungsaufnahme. Legen Sie die Zuordnungstabelle, die Regeln zur Datenhoheit und das Polling-Intervall fest.
- Zugriff und Lizenzen. Lizenzieren Sie die vorgesehenen REST-Endpunkte. Der LTR-Administrator erstellt den API-Benutzer, hash und token, idealerweise zunächst in einem Testmandanten.
- Änderungsprotokollierung. Aktivieren Sie DBLOG für die Tabellen, die Sie auslesen.
- Erstimport. Ressourcen, Produkte, Strukturen und Arbeitsgänge.
- Auftragsnummern synchronisieren. Polling mit modifiedAfter, Löschungen und seitenweiser Abruf.
- Planungsrestriktionen in SkyPlanner einrichten. Zulässige Arbeitsstationen, Rüstzeitmatrix, Werkzeuge und Personal.
- Zurückschreiben.
PUT /manufphases/undPOST /resourceupdates/, im Testmandanten getestet. - Parallelbetrieb und Produktivstart. Vergleichen Sie die Ergebnisse mit dem aktuellen Plan, korrigieren Sie die Stammdaten und aktivieren Sie anschließend das Zurückschreiben im Produktivsystem.
Was Sie bei einer Visma-L7-Integration einplanen sollten
- Lizenzen je Endpunkt. Erfassen Sie frühzeitig alle Endpunkte und lizenzieren Sie diese vor den Tests.
- Maschinenanzahl. Bei einer Ressource mit mehreren Maschinen teilt L7 die Arbeit auf (Quelle). Bilden Sie diese in SkyPlanner als einzelne Arbeitsstationen ab und schreiben Sie die Ressource zurück, die L7 erwartet.
- Stunden pro Tag. L7 speichert den Plan als Stunden je Datum. SkyPlanner übermittelt
schedulingDays, deren Summe der Dauer des Arbeitsgangs entspricht. - Werkskalender. Halten Sie ihn lückenlos, denn Lücken verschieben Arbeitsgänge in die Vergangenheit (Quelle).
- Lageraufträge.
mainNumber,subNumber,rowNumberundnewQuantitydienen ausschließlich dazu, die Menge eines Lagerauftrags zu ändern. Lassen Sie diese Felder bei Kundenaufträgen weg. - Das nächste ERP. Visma hat die Weiterentwicklung von L7 eingestellt; die Nutzung des Produkts endet Ende 2028 (Mitteilung von Visma). Hinterlegen Sie die Planungsregeln in SkyPlanner statt in L7-Feldern, damit sie bei einem ERP-Wechsel erhalten bleiben.
Visma L7 Schnittstelle: Wer übernimmt Einrichtung und Support?
Zur Einrichtung gehört die Zuordnung zu Ihren Ressourcen und Arbeitsgängen unter Berücksichtigung Ihrer L7-Konfiguration. Hinzu kommen die Planungsregeln, die Sie in SkyPlanner hinterlegen: zulässige Arbeitsstationen, die Rüstzeitmatrix, Werkzeuge und Personal.
- Das SkyPlanner-Team richtet die Schnittstelle beim Onboarding ein und betreut sie nach dem Produktivstart. Jeder Betrieb nutzt L7 anders. Dieses Wissen fließt in die Einrichtung ein.
- Ihr Visma-Partner kann mitwirken. Er kennt Ihre L7- und LTR-Konfiguration und kann sich um den API-Benutzer, die Lizenzen und den Testmandanten kümmern. SkyPlanner stellt die REST API, die Swagger/OpenAPI-Dokumentation und Webhooks bereit.
- Auch 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. Das SkyPlanner-Team unterstützt Sie bei Bedarf.
Wenn Sie L7 ablösen, lässt sich dieselbe SkyPlanner-Konfiguration an das neue ERP anbinden. Weitere Informationen finden Sie auf den Seiten zu Business Central, Visma Net, Lemonsoft, Monitor ERP und Odoo.
SkyPlanner ist ab 199 € pro Monat erhältlich, inklusive 5 Arbeitsstationen und mit monatlicher Abrechnung. Für die Integration erhalten Sie vorab zusammen mit Ihrem Tarif ein Angebot, das auf Ihre Abläufe und Anforderungen abgestimmt ist. So kennen Sie die Gesamtkosten, bevor Sie starten.
Wie die eigene Planung von L7 im Vergleich abschneidet, erfahren Sie unter Bietet Visma L7 eine Feinplanung, die verfügbare Kapazitäten berücksichtigt? Einen Überblick finden Sie auf der Visma-L7-Seite, weitere Systeme in der Übersicht der ERP-Integrationen.
Erfahrungen von Fertigungsunternehmen mit SkyPlanner
Mehrere 1.000Fertigungsaufträge automatisch eingeplant
„Wir haben die Produktion ganz anders im Griff, und unser Verständnis der Kapazitäten liegt auf einem völlig neuen Niveau.“
Hannu Ryynänen, Geschäftsführer
Mamec · Industriemischer, Pumpen und Hightech-Auftragsfertigung
Tausende Fertigungsaufträge werden automatisch eingeplant. Das gesamte Unternehmen hat dabei einen Echtzeitüberblick über die Produktion.
98%Liefertreue, gestiegen von etwa 50%
„SkyPlanner spielt eine entscheidende Rolle dabei, unsere Liefertreue zu halten.“
Hannu Lahtinen, Geschäftsführer
KJH-Comp · Blechbearbeitung und Auftragsfertigung
Die Liefertreue stieg von rund 50% auf bis zu 98%. Für die Feinplanung wird heute nur noch eine Führungskraft statt zwei benötigt.
2 hZeitersparnis pro Woche
„Mit SkyPlanner haben wir den Schritt von Excel-Tabellen in der Produktionsplanung zur Produktionsoptimierung in Echtzeit geschafft.“
Kalle Kalliomäki, Supply-Chain-Spezialist
UTU · Stromverteiler 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äufig gestellte Fragen
Bietet Visma L7 eine API für Produktionsdaten?
Ja. Die Visma L7 REST API auf Visma LTR stellt Arbeitsgänge, Ressourcen, Teile, Materialien, Produktionsereignisse, Produkte, Lagerbestände, Verkaufspositionen und Einkaufspositionen bereit. Jeder Endpunkt wird separat lizenziert. Der LTR-Administrator legt den API-Benutzer und die Tokens an.
Wie wird der Plan nach Visma L7 zurückgeschrieben?
Über PUT /manufphases/ werden für jede Arbeitskarte die Ressource, das Startdatum, die Priorität, die Person und die geplanten Stunden je Datum aktualisiert. POST /resourceupdates/ schreibt die Kapazität in den Ressourcenkalender. L7 behält die externe Priorität bei, sodass die Auftragsreihenfolge in den Arbeitsvorräten der Reihenfolge von SkyPlanner entspricht.
Unterstützt Visma L7 Webhooks?
Es sind keine Webhooks dokumentiert. Aktivieren Sie die Änderungsprotokollierung für die betreffenden Tabellen und fragen Sie Änderungen regelmäßig mit modifiedAfter ab. Die eigenen Webhooks von SkyPlanner übertragen Planänderungen, sobald sie auftreten.
Welche Software für die Feinplanung lässt sich mit Visma L7 verbinden?
SkyPlanner APS lässt sich über die L7 REST API bidirektional mit Visma L7 verbinden. Visma führt Skycode mit SkyPlanner auf seiner Seite zu L7-Integrationen auf. Das SkyPlanner-Team richtet die Schnittstelle beim Onboarding ein.
Wer richtet die Visma L7 Schnittstelle ein?
Das SkyPlanner-Team richtet die bidirektionale Schnittstelle beim Onboarding passend zu Ihrer L7-Konfiguration ein und betreut sie nach dem Produktivstart. Auch Ihr Visma-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. In der kostenlosen 30-tägigen Testphase können Sie bis zu 20 Arbeitsstationen nutzen und Daten aus L7 per Excel oder CSV importieren. Eine Kreditkarte ist nicht erforderlich. Starten Sie die Testphase oder kontaktieren Sie den Vertrieb zur Anforderungsaufnahme für die Integration.
