Integrationer / ERP / Visma L7
Guide till APS-integration med Visma L7 för produktionsplanering
Den här integrationsguiden visar partner och IT-team hur Visma L7 ansluts till SkyPlanner APS. SkyPlanner integreras med Visma L7 i båda riktningarna via Visma L7 REST API:
- Arbetsnummer (työnumero), arbetssteg (työnvaihe), resurser, produktstrukturer, komponenter, material, lagersaldon, försäljningsrader och inköpsrader läses in.
- För varje arbetskort återförs resurs, startdatum, prioritet, person och timmar per dag med
PUT /manufphases/. - Kapaciteten i resurskalendern hålls synkroniserad med
POST /resourceupdates/. - Produktionshändelser som registreras i arbetsköerna i L7 läses tillbaka med
GET /manufevents/. - SkyPlanners webhooks skickar ändringar i planen så snart de sker.
SkyPlanner-teamet anpassar integrationen till er L7-konfiguration under införandet och ger support efter driftsättningen. Partner och utvecklare kan också bygga egna lösningar med SkyPlanners dokumenterade REST API (API-referens).
REST API i Visma L7
API:et heter Visma L7 – REST API och är dokumenterat enligt OpenAPI 3.0.3 med en ändringslogg (dokumentation). Det körs på Visma LTR.
- Bassökvägen är
/ltrws/REST/L7på er egen LTR-server, lokalt eller i Vismas applikationstjänst. - Licenser. Varje endpoint licensieras separat. För att skriva tillbaka planen krävs licensen L7RMFPP för
PUT /manufphases/, och kapacitetsuppdateringar kräver L7RMCAP. Även läs-endpoints har egna licenser. - Sidindelning. Listor delas upp i sidor med
pageSizeochrecAfteroch filtreras medqueryKey1,queryKey2ochqueryString.
Autentisering
Två token skickas med varje anrop till L7:
- hash anger databas och företag.
- token identifierar API-användaren.
Er LTR-administratör skapar API-användaren i Visma LTR, kopplar den till L7-företaget, tilldelar profiler och skapar användarens token (kom igång). Använd en separat integrationsanvändare med enbart de behörigheter som integrationen behöver.
På SkyPlanner-sidan sker autentiseringen för REST API med en API-token som skickas i headern Authorization-Token. Den skapar ni under Settings > API. Integrationsguiden går igenom de första anropen.
Hitta ändringar med modifiedAfter
L7 REST API har inga webhooks. Ändringar läses genom pollning:
- Aktivera ändringsloggning (DBLOG) i filunderhållet i L7 (Tiedostohuolto) för de tabeller som integrationen läser, till exempel arbetskort och komponenter.
- Anropa läs-endpoints med
modifiedAftersatt till tidpunkten för den senaste körningen. Borttagna poster returneras med en markering om att de har tagits bort, så att avbrutna arbeten försvinner ur planen. - Polla med några minuters mellanrum. SkyPlanner skickar webhooks när status eller planen ändras, så återföringen är händelsestyrd.
Datamappning
| Objekt i Visma L7 (endpoint) | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
Tuote (GET /products/) | Produkter och material | L7 → SkyPlanner | Första inläsning, därefter vid ändring |
Komponenter för ett arbetsnummer (GET /manufcomponents/) | Delprodukter | L7 → SkyPlanner | Pollning med modifiedAfter |
Materialbehov (GET /manufmaterials/) | Materialbehov per operation | L7 → SkyPlanner | Pollning med modifiedAfter |
Resursträd (KRYH) med antal maskiner (GET /manufresources/) | Produktionsgrupper och grupperingar av dessa | L7 → SkyPlanner | Första inläsning, därefter sällan |
Arbetskort (TSUUNR) per arbetssteg (GET /manufphases/) | Operationer (processteg) per produktionsgrupp | L7 → SkyPlanner | Pollning med några minuters mellanrum |
Lagersaldon (GET /stockbalances/) | Lager | L7 → SkyPlanner | Pollning |
Inköpsrader (GET /purchaserows/) | Inköpsorder med leveransdatum | L7 → SkyPlanner | Pollning |
Försäljningsorder och orderrader (GET /salesorders/, GET /salesrows/) | Leveransdatum, kundprioritet | L7 → SkyPlanner | Pollning |
Produktionshändelser (GET /manufevents/) | Upparbetat per operation | L7 → SkyPlanner | Pollning |
Arbetskortets resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Planerad produktionsgrupp, start, ordningsföljd och timmar per dag | SkyPlanner → L7 | När planen ändras, via webhook från SkyPlanner |
Kapacitet i resurskalendern (POST /resourceupdates/) | Skiftkapacitet | SkyPlanner → L7 | När skiften ändras |
| Planeringsregler som anges i SkyPlanner | Tillåtna produktionsgrupper, ställtidsmatris, verktyg, personal | Underhålls i SkyPlanner | Konfigureras under införandet |
Integrationsmönster
1. Första inläsning av grunddata. Läs in resursträdet och mappa varje maskin till en egen produktionsgrupp i SkyPlanner. Om en resurs i L7 omfattar flera maskiner skapar ni en produktionsgrupp per maskin och samlar dem i en grupp för resursen. Läs in produkter och produktstrukturer med tillhörande arbetssteg.
2. Synkronisering av arbetsnummer. Läs in öppna arbetskort med GET /manufphases/ och håll dem sedan uppdaterade med modifiedAfter. Läs in komponenter och materialbehov för varje arbetsnummer samt lagersaldon och inköpsrader, så att arbetssteget väntar till inköpsradens leveransdatum.
3. Återföring av planen. SkyPlanner anropar PUT /manufphases/ för varje arbetssteg som planeringsmotorn har lagt in eller flyttat. Anropets body innehåller en workSheet-post per arbetskort med:
numberför arbetskortet ochresourceför den valda resursenstartDateochpriority, så att arbetsköerna i L7 visar SkyPlanners ordningsföljdperson, när en namngiven operatör har planerats inschedulingDaysför planerade timmar per datum
L7 behåller en prioritet som har satts av ett externt system oförändrad (källa), så ordningsföljden ligger kvar i arbetsköerna.
4. Synkronisering av kapacitet. När skift, ledigheter eller övertid ändras i SkyPlanner skriver POST /resourceupdates/ den nya kapaciteten till resurskalendern i L7. Belastningsvyerna i L7 stämmer då med planen.
5. Återrapportering från produktionen. Operatörerna fortsätter att rapportera i arbetsköerna i L7 och i Visma LTR, och SkyPlanner läser händelserna med GET /manufevents/. Operatörerna kan också kvittera arbete i SkyPlanner Mobile Confirmations. Autopilot planerar om utifrån båda källorna, och de nya tiderna följer med vid nästa återföring.
6. Regler för dataägarskap och konflikter. Dokumentera dem före driftsättningen:
| Data | Ägare |
|---|---|
| Produkter, strukturer, arbetssteg, kvantiteter, status för arbetsnummer | Visma L7 |
| Arbetsstegens ordningsföljd, startdatum, timmar per dag, val av resurs | SkyPlanner |
| Tillåtna produktionsgrupper, ställtidsmatris, verktyg, personal | SkyPlanner |
| Skift och frånvaro | SkyPlanner, skrivs till resurskalendern i L7 |
| Produktionshändelser och lagertransaktioner | Arbetsköerna i Visma L7 och LTR |
Den främsta källan till konflikter är L7:s egen planering. Behovsberäkning och finplanering kan planera in olåsta arbetssteg på nytt. Kör dem enbart för material och reservationer, och planera inte om de arbetssteg som SkyPlanner ansvarar för.
Typiska projektsteg
Implementeringen är normalt klar inom några veckor från att införandet startar. Innan dess kan ni använda den kostnadsfria provperioden på 30 dagar med era egna data från en Excel-export av arbetsnummer, arbetssteg och resurser.
- Kartläggning. Fastställ mappningstabell, regler för dataägarskap och pollningsintervall.
- Åtkomst och licenser. Skaffa licenser för de REST-endpoints som ingår. LTR-administratören skapar API-användare, hash och token, helst i ett testföretag först.
- Ändringsloggning. Aktivera DBLOG för de tabeller ni läser.
- Första inläsning. Resurser, produkter, strukturer och arbetssteg.
- Synkronisering av arbetsnummer. Pollning med modifiedAfter, borttagningar och sidindelning.
- Konfigurera begränsningar i SkyPlanner. Tillåtna produktionsgrupper, ställtidsmatris, verktyg och personal.
- Återföring.
PUT /manufphases/ochPOST /resourceupdates/, testade i testföretaget. - Parallelldrift och driftstart. Jämför med den nuvarande planen, rätta till grunddata och aktivera sedan återskrivningen i produktionsmiljön.
Att planera för vid en integration med Visma L7
- Licens per endpoint. Lista alla endpoints tidigt och ordna licenserna innan testningen börjar.
- Antal maskiner. En resurs med flera maskiner fördelar arbetet i L7 (källa). Dela upp den i produktionsgrupper i SkyPlanner och skriv tillbaka den resurs som L7 förväntar sig.
- Timmar per dag. L7 lagrar planen som timmar per datum. SkyPlanner skickar
schedulingDaysvars summa motsvarar arbetsstegets varaktighet. - Fabrikskalender. Se till att den är komplett, eftersom luckor gör att arbetssteg hamnar i det förflutna (källa).
- Lagerorder.
mainNumber,subNumber,rowNumberochnewQuantityanvänds bara för att ändra kvantiteten på en lagerorder. Utelämna dem för kundorder. - Nästa ERP-system. Visma har avslutat nyutvecklingen av L7, och användningen av produkten upphör i slutet av 2028 (Vismas meddelande). Behåll planeringsreglerna i SkyPlanner, inte i L7-fält, så att de följer med när ni byter ERP-system.
Integrationen med Visma L7: vem konfigurerar och ger support?
Arbetet omfattar mappning mot era resurser, arbetssteg och er L7-konfiguration. Det omfattar också planeringsreglerna som ni har i SkyPlanner: tillåtna produktionsgrupper, ställtidsmatris, verktyg och personal.
- SkyPlanner-teamet konfigurerar integrationen under införandet och ger support efter driftstart. Varje fabrik använder L7 på sitt sätt, och den kunskapen ligger till grund för konfigurationen.
- Er Visma-partner kan medverka. Partnern känner till er konfiguration av L7 och LTR och kan hantera API-användaren, licenserna och testföretaget. SkyPlanner tillhandahåller REST API, dokumentation i Swagger/OpenAPI och webhooks.
- Era egna utvecklare kan bygga vidare på integrationen via samma dokumenterade REST API med en API-token. En API-token räcker för att komma igång, och SkyPlanner-teamet hjälper till vid behov.
När ni ersätter L7 ansluts samma SkyPlanner-konfiguration till det nya ERP-systemet. Se sidorna för Business Central, Visma Net, Lemonsoft, Monitor ERP och Odoo.
SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Ni får en offert på integrationen utifrån era processer och behov, tillsammans med abonnemanget, så att ni ser hela kostnaden innan ni börjar.
Se hur L7:s egen planering står sig i jämförelse i Har Visma L7 finplanering? En översikt finns på sidan om Visma L7, och andra system finns i översikten över ERP-integrationer.
Tillverkningsföretagens omdömen om SkyPlanner
1 000-talsarbetsorder planeras automatiskt
”Vi har kontroll över produktionen på ett annat sätt, och vår förståelse för kapaciteten är på en helt annan nivå.”
Hannu Ryynänen, vd
Mamec · Industriella omrörare, pumpar och högteknologisk kontraktstillverkning
Tusentals arbetsorder planeras automatiskt, och hela organisationen får en realtidsbild av produktionen.
98%leveransprecision, upp från cirka 50%
”SkyPlanner spelar en avgörande roll för att upprätthålla vår leveransprecision.”
Hannu Lahtinen, vd
KJH-Comp · Plåtmekanik och kontraktstillverkning
Leveransprecisionen steg från cirka 50% till hela 98%, och planeringen kräver nu en arbetsledare i stället för två.
2 hsparas varje vecka
”SkyPlanner har tagit vår produktionsplanering från Excel-kalkylblad till produktionsoptimering i realtid.”
Kalle Kalliomäki, specialist inom försörjningskedjan
UTU · Elcentraler och ställverk
Produktionsplaneringen sparar 2 timmars arbetstid varje vecka, och en ny arbetskö når produktionslinjen på några sekunder.
+90%produktionseffektivitet
”Effektiviteten i produktionen har ökat med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Läkemedelstillverkning
Produktionseffektiviteten har ökat med 90%, och det tar under 30 minuter att skapa en optimerad plan för tre månader för alla produktionsgrupper.
Vanliga frågor
Har Visma L7 ett API för produktionsdata?
Ja. Visma L7 REST API på Visma LTR ger tillgång till arbetssteg, resurser, delar, material, produktionshändelser, produkter, lagersaldon, försäljningsrader och inköpsrader. Varje endpoint licensieras separat, och LTR-administratören skapar API-användaren och token.
Hur skrivs produktionsplanen tillbaka till Visma L7?
Med PUT /manufphases/, som uppdaterar varje arbetskorts resurs, startdatum, prioritet, person och planerade timmar per datum. POST /resourceupdates/ skriver kapaciteten i resurskalendern. L7 behåller den externa prioriteten, så att arbetsköerna följer ordningen i SkyPlanner.
Har Visma L7 stöd för webhooks?
Inga webhooks finns dokumenterade. Aktivera ändringsloggning för de tabeller som ingår och hämta ändringar genom pollning med modifiedAfter. SkyPlanners egna webhooks skickar ändringar i produktionsplanen så snart de sker.
Vilken programvara för produktionsplanering kan integreras med Visma L7?
SkyPlanner APS integreras med Visma L7 i båda riktningarna via L7 REST API, och Visma listar Skycode med SkyPlanner på sin sida för L7-integrationer. SkyPlanner-teamet konfigurerar integrationen under införandet.
Vem bygger integrationen med Visma L7?
SkyPlanner-teamet anpassar tvåvägsintegrationen till er L7-konfiguration under införandet och ger support efter driftstart. Er Visma-partner eller era egna utvecklare kan också bygga vidare via SkyPlanners dokumenterade REST API, och en API-token räcker för att komma igång.
Kan vi testa SkyPlanner innan vi bygger integrationen?
Ja. Under den kostnadsfria provperioden på 30 dagar kan ni använda upp till 20 produktionsgrupper med import från L7 via Excel eller CSV. Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för en kartläggning av integrationen.
