Integrasjoner / ERP / Visma L7
Guide til Visma L7-integrasjon med APS for produksjonsplanlegging
Denne guiden til Visma L7-integrasjon viser partnere og IT-team hvordan de kobler Visma L7 til SkyPlanner APS. SkyPlanner utveksler data med Visma L7 i begge retninger via Visma L7 REST API:
- Arbeidsnumre (työnumero), arbeidsoperasjoner (työnvaihe), ressurser, produktstrukturer, deler, materialer, lagerbeholdninger, salgsordrelinjer og innkjøpsordrelinjer hentes inn.
- Ressurs, startdato, prioritet, person og timer per dag skrives tilbake til hvert arbeidskort med
PUT /manufphases/. - Kapasiteten i ressurskalenderen holdes synkronisert med
POST /resourceupdates/. - Produksjonshendelser som registreres i arbeidskøene i L7, leses tilbake med
GET /manufevents/. - SkyPlanner sender planendringer via webhooks så snart de skjer.
SkyPlanner-teamet tilpasser integrasjonen til L7-oppsettet ditt under innføringen og gir støtte etter produksjonssetting. Partnere og utviklere kan også bygge løsninger med SkyPlanners dokumenterte REST API (API-referanse).
REST API i Visma L7
API-et heter Visma L7 – REST API og er dokumentert i OpenAPI 3.0.3 med en endringslogg (dokumentasjon). Det kjører på Visma LTR.
- Basisstien er
/ltrws/REST/L7på din egen LTR-server, enten lokalt eller i Vismas driftede applikasjonstjeneste. - Lisensiering. Hvert endepunkt krever en egen lisens. Tilbakeskriving av planen krever lisensen L7RMFPP for
PUT /manufphases/, og kapasitetsoppdateringer krever L7RMCAP. Leseendepunktene har egne lisenser. - Sideinndeling. Lister deles inn i sider med
pageSizeogrecAfter, og filtreres medqueryKey1,queryKey2ogqueryString.
Autentisering
To tokener sendes med hvert L7-kall:
- hash velger database og selskap.
- token identifiserer API-brukeren.
LTR-administratoren oppretter API-brukeren i Visma LTR, kobler den til L7-selskapet, tildeler profiler og oppretter brukertokenet (kom i gang). Bruk en egen integrasjonsbruker som bare har rettighetene integrasjonen trenger.
I SkyPlanner autentiseres REST API-kall med et API-token som sendes i Authorization-Token-headeren. Du oppretter tokenet under Settings > API. Integrasjonsveiledningen går gjennom de første kallene.
Oppdage endringer med modifiedAfter
L7 REST API har ingen webhooks. Endringer hentes ved polling:
- Slå på endringslogging (DBLOG) i filvedlikeholdet i L7 (Tiedostohuolto) for tabellene integrasjonen leser, for eksempel arbeidskort og deler.
- Kall leseendepunktene med
modifiedAftersatt til tidspunktet for forrige kjøring. Slettede poster returneres med slettemerking, slik at kansellerte jobber fjernes fra planen. - Kjør polling med noen minutters mellomrom. SkyPlanner sender webhooks når status eller planen endres, så tilbakeskrivingen er hendelsesstyrt.
Datakobling
| Visma L7-objekt (endepunkt) | Objekt i SkyPlanner | Retning | Hyppighet |
|---|---|---|---|
Tuote (GET /products/) | Produkter og materialer | L7 → SkyPlanner | Førstegangsinnlasting, deretter ved endringer |
Deler knyttet til et arbeidsnummer (GET /manufcomponents/) | Delprodukter | L7 → SkyPlanner | Polling med modifiedAfter |
Materialbehov (GET /manufmaterials/) | Materialbehov per jobb | L7 → SkyPlanner | Polling med modifiedAfter |
Ressurshierarki (KRYH) med antall maskiner (GET /manufresources/) | Arbeidsstasjoner og grupper av arbeidsstasjoner | L7 → SkyPlanner | Førstegangsimport, sjelden deretter |
Arbeidskort (TSUUNR) per operasjon (GET /manufphases/) | Jobber (prosesstrinn) per arbeidsstasjon | L7 → SkyPlanner | Polling med noen minutters mellomrom |
Lagerbeholdninger (GET /stockbalances/) | Lagerbeholdning | L7 → SkyPlanner | Polling |
Innkjøpsordrelinjer (GET /purchaserows/) | Innkjøpsordrer med leveringsdatoer | L7 → SkyPlanner | Polling |
Salgsordrer og ordrelinjer (GET /salesorders/, GET /salesrows/) | Leveringsfrister, kundeprioritet | L7 → SkyPlanner | Polling |
Produksjonshendelser (GET /manufevents/) | Fremdrift per jobb | L7 → SkyPlanner | Polling |
Arbeidskortets resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Planlagt arbeidsstasjon, start, rekkefølge og timer per dag | SkyPlanner → L7 | Ved endring i produksjonsplanen, via webhook fra SkyPlanner |
Kapasitet i ressurskalenderen (POST /resourceupdates/) | Skiftkapasitet | SkyPlanner → L7 | Når skiftene endres |
| Planleggingsregler angitt i SkyPlanner | Tillatte arbeidsstasjoner, matrise for omstillingstider, verktøy, personer | Vedlikeholdes i SkyPlanner | Settes opp under innføringen |
Integrasjonsmønstre
1. Førstegangsinnlasting av grunndata. Les inn ressurshierarkiet og koble hver maskin til en egen arbeidsstasjon i SkyPlanner. Hvis en L7-ressurs omfatter flere maskiner, oppretter du en arbeidsstasjon per maskin og en gruppe av arbeidsstasjoner for ressursen. Les inn produkter og produktstrukturer med tilhørende arbeidsoperasjoner.
2. Synkronisering av arbeidsnumre. Les åpne arbeidskort med GET /manufphases/, og hold dem deretter oppdatert med modifiedAfter. Les deler og materialbehov for hvert arbeidsnummer, samt lagerbeholdninger og innkjøpsordrelinjer, slik at en operasjon venter til leveringsdatoen på den tilhørende innkjøpsordrelinjen.
3. Tilbakeskriving av planen. SkyPlanner kaller PUT /manufphases/ for hver operasjon planleggingsmotoren har plassert eller flyttet. Forespørselskroppen inneholder én workSheet-oppføring per arbeidskort med:
number, arbeidskortet, ogresource, den valgte ressursenstartDateogpriority, slik at arbeidskøene i L7 viser rekkefølgen fra SkyPlannerperson, når en navngitt operatør er satt opp i planenschedulingDays, de planlagte timene per dato
L7 beholder en prioritet satt av et eksternt system uendret (kilde), slik at rekkefølgen opprettholdes i arbeidskøene.
4. Synkronisering av kapasitet. Når skift, fridager eller overtid endres i SkyPlanner, skriver POST /resourceupdates/ den nye kapasiteten til ressurskalenderen i L7. Da samsvarer belastningsvisningene i L7 med planen.
5. Fremdrift i produksjonen. Operatørene fortsetter å registrere i arbeidskøene i L7 og i Visma LTR, og SkyPlanner leser hendelsene med GET /manufevents/. Operatørene kan også bekrefte arbeid i SkyPlanner Mobile Confirmations. Autopilot oppdaterer planen basert på registreringer fra den ene eller den andre kilden, og de nye tidene overføres ved neste tilbakeskriving.
6. Dataeierskap og konfliktregler. Dokumenter disse før produksjonssetting:
| Data | Eier |
|---|---|
| Produkter, strukturer, arbeidsoperasjoner, mengder, status for arbeidsnummer | Visma L7 |
| Operasjonsrekkefølge, startdatoer, timer per dag, ressursvalg | SkyPlanner |
| Tillatte arbeidsstasjoner, matrise for omstillingstider, verktøy, personer | SkyPlanner |
| Skift og fravær | SkyPlanner, skrives til ressurskalenderen i L7 |
| Produksjonshendelser og lagerregistreringer | Arbeidskøene i Visma L7 og LTR |
Den viktigste kilden til konflikter er L7s egen planlegging. Behovsberegning og finplanlegging kan plassere ulåste operasjoner på nytt. Kjør disse bare for materialer og reservasjoner, og ikke planlegg operasjonene som SkyPlanner har ansvar for, på nytt.
Typiske prosjekttrinn
Implementeringen er normalt ferdig i løpet av noen uker etter at innføringen starter. Før det kan du bruke den gratis prøveperioden på 30 dager med egne data fra en Excel-eksport av arbeidsnumre, operasjoner og ressurser.
- Avklaring. Fastsett koblingstabellen, reglene for dataeierskap og pollingintervallet.
- Tilgang og lisenser. Skaff lisenser til REST-endepunktene som inngår. LTR-administratoren oppretter API-brukeren, hash og token, helst i et testselskap først.
- Endringslogging. Slå på DBLOG for tabellene du leser.
- Førstegangsinnlasting. Ressurser, produkter, strukturer og arbeidsoperasjoner.
- Synkronisering av arbeidsnumre. Polling med modifiedAfter, slettinger og sideinndeling.
- Oppsett av begrensninger i SkyPlanner. Tillatte arbeidsstasjoner, matrisen for omstillingstider, verktøy og personer.
- Tilbakeskriving.
PUT /manufphases/ogPOST /resourceupdates/, testet i testselskapet. - Parallell drift og produksjonssetting. Sammenlign med den gjeldende planen, rett opp grunndataene og aktiver deretter tilbakeskriving i produksjonsmiljøet.
Dette bør du planlegge for ved en Visma L7-integrasjon
- Lisens per endepunkt. Lag en oversikt over alle endepunktene tidlig, og skaff lisenser til dem før testing.
- Antall maskiner. En ressurs med flere maskiner fordeler arbeidet i L7 (kilde). Del ressursen opp i arbeidsstasjoner i SkyPlanner, og skriv tilbake ressursen som L7 forventer.
- Timer per dag. L7 lagrer planen som timer per dato. SkyPlanner sender
schedulingDayssom til sammen utgjør varigheten til arbeidsfasen. - Fabrikkalender. Sørg for at kalenderen er komplett, fordi hull fører til at arbeidsfaser legges i fortiden (kilde).
- Lagerordrer.
mainNumber,subNumber,rowNumberognewQuantitybrukes bare til å endre antallet i en lagerordre. Utelat dem ved produksjon på kundeordre. - Neste ERP-system. Visma har avsluttet videreutviklingen av L7, og bruken av produktet opphører ved utgangen av 2028 (melding fra Visma). Behold planleggingsreglene i SkyPlanner, ikke i L7-felter, slik at de blir med når du bytter ERP-system.
Visma L7-integrasjonen: Hvem konfigurerer den og gir brukerstøtte?
Arbeidet omfatter tilpasning til ressursene, arbeidsfasene og L7-oppsettet ditt. Det omfatter også planleggingsreglene du har i SkyPlanner: tillatte arbeidsstasjoner, matrisen for omstillingstid, verktøy og personell.
- SkyPlanner-teamet konfigurerer integrasjonen under innføringen og gir brukerstøtte etter produksjonssetting. Hver fabrikk bruker L7 på sin måte, og denne kunnskapen tas med i oppsettet.
- Visma-partneren din kan delta. Partneren kjenner L7- og LTR-oppsettet ditt og kan håndtere API-brukeren, lisensene og testfirmaet. SkyPlanner leverer REST API, Swagger/OpenAPI-dokumentasjon og webhooks.
- Dine egne utviklere kan bygge videre på løsningen med det samme dokumenterte REST API-et og et API-token. Et API-token er nok for å komme i gang, og SkyPlanner-teamet hjelper til ved behov.
Når du erstatter L7, kobles det samme SkyPlanner-oppsettet til det nye ERP-systemet. Se sidene for Business Central, Visma Net, Lemonsoft, Monitor ERP og Odoo.
SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og faktureres månedlig. Du får et pristilbud på integrasjonen tilpasset prosessene og behovene dine, sammen med abonnementet, slik at du kjenner hele kostnaden før du starter.
Se hvordan L7s egen planlegging står seg i Har Visma L7 produksjonsplanlegging som tar hensyn til faktisk maskin- og personellkapasitet? Du finner oversikten på Visma L7-siden og andre systemer i oversikten over ERP-integrasjoner.
Produksjonsbedrifters erfaringer med SkyPlanner
1 000-tallsarbeidsordrer planlagt automatisk
«Vi har kontroll på produksjonen på en annen måte, og forståelsen vår av kapasiteten er på et helt annet nivå.»
Hannu Ryynänen, administrerende direktør
Mamec · Industrielle miksere, pumper og høyteknologisk leieproduksjon
Tusenvis av arbeidsordrer planlegges automatisk, og hele organisasjonen har oversikt over produksjonen i sanntid.
98%leveringspålitelighet, opp fra omtrent 50%
«SkyPlanner spiller en avgjørende rolle i å opprettholde leveringspåliteligheten vår.»
Hannu Lahtinen, daglig leder
KJH-Comp · Platebearbeiding og leieproduksjon
Leveringspåliteligheten økte fra rundt 50% til hele 98%, og planleggingen krever nå én arbeidsleder i stedet for to.
2 hspart hver uke
«SkyPlanner har tatt produksjonsplanleggingen vår fra Excel-regneark til produksjonsoptimalisering i sanntid.»
Kalle Kalliomäki, spesialist på forsyningskjeder
UTU · Elektriske tavler og koblingsanlegg
Produksjonsplanleggingen sparer 2 arbeidstimer hver uke, og en ny arbeidskø når produksjonslinjen i løpet av sekunder.
+90%produksjonseffektivitet
«Effektiviteten i produksjonen har økt med 90%.»
Abdul Rucyinga, IT-sjef
Laboratory & Allied · Legemiddelproduksjon
Produksjonseffektiviteten har økt med 90%, og det tar under 30 minutter å lage en optimalisert plan for tre måneder på tvers av alle arbeidsstasjoner.
Vanlige spørsmål
Har Visma L7 et API for produksjonsdata?
Ja. Visma L7 REST API på Visma LTR gir tilgang til arbeidsfaser, ressurser, deler, materialer, produksjonshendelser, produkter, lagerbeholdninger, salgsordrelinjer og innkjøpsordrelinjer. Hvert endepunkt lisensieres separat, og LTR-administratoren oppretter API-brukeren og tokenene.
Hvordan skrives planen tilbake til Visma L7?
Med PUT /manufphases/, som oppdaterer ressurs, startdato, prioritet, person og planlagte timer per dato for hvert arbeidskort. POST /resourceupdates/ skriver kapasiteten i ressurskalenderen. L7 beholder den eksterne prioriteten, slik at arbeidskøene følger rekkefølgen fra SkyPlanner.
Støtter Visma L7 webhooks?
Ingen webhooks er dokumentert. Aktiver endringslogging for tabellene som inngår i integrasjonen, og hent endringer regelmessig med modifiedAfter. SkyPlanners egne webhooks sender planendringer etter hvert som de skjer.
Hvilken programvare for produksjonsplanlegging kan integreres med Visma L7?
SkyPlanner APS integreres med Visma L7 i begge retninger via L7 REST API, og Visma oppfører Skycode med SkyPlanner på sin side for L7-integrasjoner. SkyPlanner-teamet konfigurerer integrasjonen under innføringen.
Hvem bygger Visma L7-integrasjonen?
SkyPlanner-teamet konfigurerer toveisintegrasjonen til L7-oppsettet ditt under innføringen og gir brukerstøtte etter produksjonssetting. Visma-partneren din eller dine egne utviklere kan også bygge videre med SkyPlanners dokumenterte REST API. Et API-token er nok for å komme i gang.
Kan vi teste SkyPlanner før vi bygger integrasjonen?
Ja. Den gratis prøveperioden på 30 dager støtter opptil 20 arbeidsstasjoner med import fra L7 via Excel eller CSV. Du trenger ikke kredittkort. Start prøveperioden, eller kontakt salg for en avklaring av integrasjonens omfang.
