Integrationer / ERP / Visma L7
Guide til Visma L7-integration med APS til produktionsplanlægning
Denne guide til Visma L7-integration viser partnere og IT-teams, hvordan de forbinder Visma L7 med SkyPlanner APS. SkyPlanner udveksler data med Visma L7 i begge retninger via Visma L7 REST API:
- Arbejdsnumre (työnumero), arbejdstrin (työnvaihe), ressourcer, produktstrukturer, komponenter, materialer, lagerbeholdninger, salgsordrelinjer og indkøbsordrelinjer læses ind.
- For hvert arbejdskort skrives ressource, startdato, prioritet, person og timer pr. dag tilbage med
PUT /manufphases/. - Kapaciteten i ressourcekalenderen holdes synkroniseret med
POST /resourceupdates/. - Produktionshændelser, der registreres i L7’s arbejdskøer, læses tilbage med
GET /manufevents/. - SkyPlanner sender planændringer via webhooks, så snart de sker.
SkyPlanner-teamet tilpasser integrationen til jeres L7-opsætning under opstarten og yder support efter idriftsættelsen. Partnere og udviklere kan også bygge videre på SkyPlanners dokumenterede REST API (API-reference).
Visma L7’s REST API
API’et hedder Visma L7 – REST API og er dokumenteret i OpenAPI 3.0.3 med en ændringslog (dokumentation). Det kører på Visma LTR.
- Basisstien er
/ltrws/REST/L7på jeres egen LTR-vært, enten lokalt eller i Vismas hostede applikationstjeneste. - Licenser. Hvert endpoint kræver sin egen licens. Tilbageskrivning af planen kræver licensen L7RMFPP til
PUT /manufphases/, og kapacitetsopdateringer kræver L7RMCAP. Læseendpoints har deres egne licenser. - Sideinddeling. Lister sideinddeles med
pageSizeogrecAfterog filtreres medqueryKey1,queryKey2ogqueryString.
Godkendelse
Der sendes to tokens med hvert L7-kald:
- hash vælger database og virksomhed.
- token identificerer API-brugeren.
Jeres LTR-administrator opretter API-brugeren i Visma LTR, knytter den til L7-virksomheden, tildeler profiler og opretter brugerens token (kom i gang). Brug en særskilt integrationsbruger, som kun har de rettigheder, integrationen behøver.
I SkyPlanner sker autentificering til REST API med et API-token, der sendes i headeren Authorization-Token. Det oprettes under Indstillinger > API. Integrationsvejledningen gennemgår de første kald.
Registrering af ændringer: modifiedAfter
L7 REST API har ingen webhooks. Ændringer læses ved polling:
- Aktivér ændringslogning (DBLOG) i L7’s filvedligeholdelse (Tiedostohuolto) for de tabeller, integrationen læser, f.eks. arbejdskort og komponenter.
- Kald læseendpoints med
modifiedAftersat til tidspunktet for sidste kørsel. Slettede poster returneres markeret som slettede, så annulleret arbejde fjernes fra planen. - Kør polling med få minutters mellemrum. SkyPlanner sender webhooks, når status eller planen ændres, så tilbageskrivningen er hændelsesstyret.
Datamapping
| Visma L7-objekt (endpoint) | Objekt i SkyPlanner | Retning | Hyppighed |
|---|---|---|---|
Tuote (GET /products/) | Produkter og materialer | L7 → SkyPlanner | Første indlæsning, derefter ved ændringer |
Komponenter til et arbejdsnummer (GET /manufcomponents/) | Underprodukter | L7 → SkyPlanner | Polling med modifiedAfter |
Materialebehov (GET /manufmaterials/) | Materialebehov pr. opgave | L7 → SkyPlanner | Polling med modifiedAfter |
Ressourcetræ (KRYH) med antal maskiner (GET /manufresources/) | Arbejdsstationer og grupper af arbejdsstationer | L7 → SkyPlanner | Første indlæsning, derefter sjældent |
Arbejdskort (TSUUNR) pr. trin (GET /manufphases/) | Opgaver (procestrin) pr. arbejdsstation | L7 → SkyPlanner | Polling med få minutters mellemrum |
Lagerbeholdninger (GET /stockbalances/) | Lagerbeholdning | L7 → SkyPlanner | Polling |
Indkøbsordrelinjer (GET /purchaserows/) | Indkøbsordrer med leveringsdatoer | L7 → SkyPlanner | Polling |
Salgsordrer og ordrelinjer (GET /salesorders/, GET /salesrows/) | Leveringsfrister, kundeprioritet | L7 → SkyPlanner | Polling |
Produktionshændelser (GET /manufevents/) | Fremdrift pr. opgave | L7 → SkyPlanner | Polling |
Arbejdskortets resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Planlagt arbejdsstation, start, rækkefølge og timer pr. dag | SkyPlanner → L7 | Ved planændringer via en SkyPlanner-webhook |
Kapacitet i ressourcekalenderen (POST /resourceupdates/) | Skiftkapacitet | SkyPlanner → L7 | Når skift ændres |
| Planlægningsregler fastlagt i SkyPlanner | Tilladte arbejdsstationer, matrix for omstillingstider, værktøjer, medarbejdere | Vedligeholdes i SkyPlanner | Opsættes under opstarten |
Integrationsmønstre
1. Første indlæsning af stamdata. Læs ressourcetræet, og knyt hver maskine til sin egen arbejdsstation i SkyPlanner. Hvis en L7-ressource omfatter flere maskiner, skal der oprettes én arbejdsstation pr. maskine og en gruppe af arbejdsstationer for ressourcen. Læs produkter og produktstrukturer med deres arbejdstrin.
2. Synkronisering af arbejdsnumre. Læs åbne arbejdskort med GET /manufphases/, og hold dem derefter opdateret med modifiedAfter. Læs komponenter og materialebehov for hvert arbejdsnummer samt lagerbeholdninger og indkøbsordrelinjer, så et trin afventer leveringsdatoen på den tilhørende indkøbsordrelinje.
3. Tilbageskrivning af planen. SkyPlanner kalder PUT /manufphases/ for hvert trin, som planlægningsmotoren har placeret eller flyttet. Kaldets body indeholder én workSheet-post pr. arbejdskort med:
number, arbejdskortet, ogresource, den valgte ressourcestartDateogpriority, så L7’s arbejdskøer viser rækkefølgen fra SkyPlannerperson, når der er planlagt en navngiven operatørschedulingDays, de planlagte timer pr. dato
L7 bevarer en prioritet, som er fastsat af et eksternt system, uændret (kilde), så rækkefølgen fastholdes i arbejdskøerne.
4. Synkronisering af kapacitet. Når skift, fridage eller overarbejde ændres i SkyPlanner, skriver POST /resourceupdates/ den nye kapacitet til L7’s ressourcekalender. L7’s belastningsvisninger stemmer derefter overens med planen.
5. Fremdrift i produktionen. Operatørerne fortsætter med at registrere i L7’s arbejdskøer og Visma LTR, og SkyPlanner læser hændelserne med GET /manufevents/. Operatørerne kan også bekræfte arbejde i SkyPlanner Mobile Confirmations. Autopilot omplanlægger ud fra begge kilder, og de nye tider sendes med ved næste tilbageskrivning.
6. Dataejerskab og konfliktregler. Skriv dem ned før idriftsættelsen:
| Data | Ejer |
|---|---|
| Produkter, strukturer, arbejdstrin, mængder, arbejdsnummerets status | Visma L7 |
| Trinnenes rækkefølge, startdatoer, timer pr. dag, valg af ressource | SkyPlanner |
| Tilladte arbejdsstationer, matrix for omstillingstider, værktøjer, medarbejdere | SkyPlanner |
| Skift og fravær | SkyPlanner, skrives til L7’s ressourcekalender |
| Produktionshændelser og lagerposteringer | Visma L7’s arbejdskøer og LTR |
Den primære kilde til konflikter er L7’s egen planlægning. Behovsberegning og finplanlægning kan placere ulåste trin på ny. Kør dem kun for materialer og reservationer, og undlad at omplanlægge de trin, SkyPlanner ejer.
Typiske projekttrin
Implementeringen er normalt afsluttet nogle uger efter opstart. Inden da kan I bruge den gratis prøveperiode på 30 dage med jeres egne data fra en Excel-eksport af arbejdsnumre, trin og ressourcer.
- Afklaring. Fastlæg mappingtabellen, reglerne for dataejerskab og pollingintervallet.
- Adgang og licenser. Sørg for licenser til de REST-endpoints, projektet omfatter. LTR-administratoren opretter API-brugeren, hash og token, helst først i en testvirksomhed.
- Ændringslogning. Aktivér DBLOG for de tabeller, I læser.
- Første indlæsning. Ressourcer, produkter, strukturer og arbejdstrin.
- Synkronisering af arbejdsnumre. Polling med modifiedAfter, sletninger og sideinddeling.
- Opsætning af begrænsninger i SkyPlanner. Tilladte arbejdsstationer, matrix for omstillingstider, værktøjer og medarbejdere.
- Tilbageskrivning.
PUT /manufphases/ogPOST /resourceupdates/, testet i testvirksomheden. - Paralleldrift og idriftsættelse. Sammenlign med den nuværende plan, ret stamdata, og aktivér derefter tilbageskrivning i produktionsmiljøet.
Det skal du tage højde for i en Visma L7-integration
- Licenser pr. endpoint. Lav tidligt en liste over alle endpoints, og sørg for licenser til dem, før testen begynder.
- Antal maskiner. En ressource med flere maskiner fordeler arbejdet i L7 (kilde). Opdel den i arbejdsstationer i SkyPlanner, og skriv den ressource tilbage, som L7 forventer.
- Timer pr. dag. L7 gemmer planen som timer pr. dato. SkyPlanner sender
schedulingDays, hvis timer tilsammen svarer til operationens varighed. - Fabrikskalender. Sørg for, at den er fuldt udfyldt, da huller flytter operationer til datoer i fortiden (kilde).
- Lagerordrer.
mainNumber,subNumber,rowNumberognewQuantitybruges kun til at ændre mængden på en lagerordre. Udelad dem ved kundeordrer. - Det næste ERP-system. Visma har stoppet videreudviklingen af L7, og brugen af produktet ophører ved udgangen af 2028 (meddelelse fra Visma). Behold planlægningsreglerne i SkyPlanner frem for i L7-felter, så de følger med, når du skifter ERP-system.
Visma L7-integrationen: Hvem konfigurerer den og yder support?
Arbejdet omfatter mapping til dine ressourcer, operationer og din L7-opsætning. Det omfatter også de planlægningsregler, du har i SkyPlanner: tilladte arbejdsstationer, matricen for omstillingstider, værktøjer og medarbejdere.
- SkyPlanner-teamet konfigurerer integrationen under opstarten og yder support efter idriftsættelsen. Hver fabrik bruger L7 på sin egen måde, og den viden indarbejdes her.
- Din Visma-partner kan deltage. Partneren kender din L7- og LTR-opsætning og kan håndtere API-brugeren, licenserne og testregnskabet. SkyPlanner stiller REST API, Swagger/OpenAPI-dokumentation og webhooks til rådighed.
- Dine egne udviklere kan bygge videre på integrationen via samme dokumenterede REST API med et API-token. Et API-token er nok til at komme i gang, og SkyPlanner-teamet hjælper efter behov.
Når du udskifter L7, forbindes den samme SkyPlanner-opsætning med det nye ERP-system. Se siderne om Business Central, Visma Net, Lemonsoft, Monitor ERP og Odoo.
SkyPlanner koster fra 199 € pr. måned med 5 arbejdsstationer inkluderet og månedlig fakturering. Du får på forhånd et tilbud på integrationen, der tager højde for dine processer og behov, sammen med dit abonnement, så du kender den samlede pris, før du går i gang.
Se, hvordan L7’s egen planlægning klarer sig i sammenligningen, i Har Visma L7 produktionsplanlægning, der tager højde for maskinernes og medarbejdernes faktiske kapacitet? Du finder overblikket på siden om Visma L7 og andre systemer i oversigten over ERP-integrationer.
Produktionsvirksomheders erfaringer med SkyPlanner
Flere 1.000produktionsordrer planlægges automatisk
“Vi har styr på produktionen på en helt anden måde, og vores forståelse af kapaciteten er på et helt andet niveau.”
Hannu Ryynänen, direktør
Mamec · Industrielle blandere, pumper og højteknologisk kontraktproduktion
Tusindvis af produktionsordrer planlægges automatisk, og hele organisationen har et overblik over produktionen i realtid.
98%leveringssikkerhed, op fra ca. 50%
“SkyPlanner spiller en afgørende rolle i at opretholde vores leveringssikkerhed.”
Hannu Lahtinen, administrerende direktør
KJH-Comp · Pladebearbejdning og kontraktproduktion
Leveringssikkerheden steg fra omkring 50% til helt op til 98%, og planlægningen kræver nu én arbejdsleder i stedet for to.
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-regneark til produktionsoptimering i realtid.”
Kalle Kalliomäki, forsyningskædespecialist
UTU · Eltavler og koblingsanlæg
Der spares 2 timers arbejdstid om ugen på produktionsplanlægning, og en ny opgavekø når ud til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at lave en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
Ofte stillede spørgsmål
Har Visma L7 et API til produktionsdata?
Ja. Visma L7 REST API på Visma LTR giver adgang til operationer, ressourcer, dele, materialer, produktionshændelser, produkter, lagerbeholdninger, salgsordrelinjer og indkøbsordrelinjer. Hvert endpoint kræver en separat licens, og LTR-administratoren opretter API-brugeren og tokens.
Hvordan skrives planen tilbage til Visma L7?
Med PUT /manufphases/, som opdaterer hvert arbejdskorts ressource, startdato, prioritet, medarbejder og planlagte timer pr. dato. POST /resourceupdates/ skriver kapacitet til ressourcekalenderen. L7 bevarer den eksterne prioritet, så opgavekøerne følger rækkefølgen i SkyPlanner.
Understøtter Visma L7 webhooks?
Der er ingen dokumenterede webhooks. Aktivér ændringslogning for de tabeller, der indgår i integrationen, og hent løbende ændringer med modifiedAfter. SkyPlanners egne webhooks sender ændringer i planen, så snart de sker.
Hvilken software til produktionsplanlægning kan integreres med Visma L7?
SkyPlanner APS integreres med Visma L7 i begge retninger via L7 REST API, og Visma har Skycode med SkyPlanner på sin side med L7-integrationer. SkyPlanner-teamet konfigurerer integrationen under opstarten.
Hvem bygger Visma L7-integrationen?
SkyPlanner-teamet tilpasser tovejsintegrationen til din L7-opsætning under opstarten og yder support efter idriftsættelsen. Din Visma-partner eller dine egne udviklere kan også bygge videre på SkyPlanners dokumenterede REST API, og et API-token er nok til at komme i gang.
Kan vi teste SkyPlanner, før vi bygger integrationen?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med import fra L7 via Excel eller CSV, og der kræves intet kreditkort. Start prøveperioden, eller kontakt salg for at afklare integrationens omfang.
