Liidestused / ERP / Visma L7
Visma L7 ja APS-i liidestamise juhend tootmise ajakava koostamiseks
See Visma L7 liidestamise juhend näitab partneritele ja IT-meeskondadele, kuidas ühendada Visma L7 SkyPlanner APS-iga. SkyPlanner vahetab Visma L7-ga andmeid mõlemas suunas Visma L7 REST API kaudu:
- SkyPlannerisse tuuakse töönumbrid (työnumero), tööetapid (työnvaihe), ressursid, tootestruktuurid, komponendid, materjalid, laoseisud ning müügi- ja osturead.
- Iga töökaardi ressurss, alguskuupäev, prioriteet, töötaja ja päevade kaupa jaotatud töötunnid kirjutatakse tagasi päringuga
PUT /manufphases/. - Ressursikalendri võimsust hoitakse sünkroonis päringuga
POST /resourceupdates/. - L7 tööjärjekordades registreeritud tootmissündmused loetakse tagasi päringuga
GET /manufevents/. - SkyPlanneri veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
SkyPlanneri meeskond seadistab liidestuse juurutuse käigus teie L7 seadistuse järgi ja pakub tuge ka pärast kasutuselevõttu. Partnerid ja arendajad saavad liidestusi luua ka SkyPlanneri dokumenteeritud REST API abil (API teatmik).
Visma L7 REST API
Liidese nimi on Visma L7 – REST API. See on dokumenteeritud OpenAPI 3.0.3 vormingus koos muudatuste ajalooga (dokumentatsioon) ja töötab Visma LTR-is.
- Baastee on
/ltrws/REST/L7teie LTR-serveris, mis asub kas teie taristus või Visma majutatud rakendusteenuses. - Litsentsid. Iga lõpp-punkt vajab eraldi litsentsi. Ajakava kirjutamiseks päringuga
PUT /manufphases/on vaja litsentsi L7RMFPP ja võimsuse uuendamiseks litsentsi L7RMCAP. Ka lugemise lõpp-punktidel on oma litsentsid. - Lehekülgedeks jaotamine. Loendid jaotatakse lehekülgedeks parameetritega
pageSizejarecAfterning filtreeritakse parameetritegaqueryKey1,queryKey2jaqueryString.
Autentimine
Iga L7 päringuga saadetakse kaks tõendit:
- hash määrab andmebaasi ja ettevõtte.
- token tuvastab API kasutaja.
Teie LTR-i administraator loob Visma LTR-is API kasutaja, seob selle L7 ettevõttega, määrab profiilid ja loob kasutaja tõendi (alustamisjuhend). Kasutage liidestuse jaoks eraldi kasutajat, kellel on ainult liidestuseks vajalikud õigused.
SkyPlanneri REST API kasutab autentimiseks API tõendit, mis saadetakse päises Authorization-Token. Selle saate luua menüüs Settings > API. Liidestamise õpetus selgitab esimeste päringute tegemist.
Muudatuste tuvastamine: modifiedAfter
L7 REST API ei paku veebihaake. Muudatusi loetakse perioodiliste päringutega:
- Lülitage L7 failihalduses (Tiedostohuolto) sisse muudatuste logimine (DBLOG) nende tabelite jaoks, mida liidestus loeb, näiteks töökaartide ja komponentide tabelites.
- Kutsuge lugemise lõpp-punkte parameetriga
modifiedAfter, mille väärtuseks on viimase käivituse aeg. Kustutatud kirjed tagastatakse kustutamise märkega, nii et tühistatud tööd eemaldatakse ajakavast. - Tehke päringuid iga mõne minuti järel. SkyPlanner saadab oleku või ajakava muutumisel veebihaake, seega toimub tagasikirjutamine sündmuspõhiselt.
Andmete vastendamine
| Visma L7 objekt (lõpp-punkt) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Tuote (GET /products/) | Tooted ja materjalid | L7 → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
Töönumbri komponendid (GET /manufcomponents/) | Alamtooted | L7 → SkyPlanner | Perioodilised päringud parameetriga modifiedAfter |
Materjalivajadused (GET /manufmaterials/) | Materjalivajadus töö kaupa | L7 → SkyPlanner | Perioodilised päringud parameetriga modifiedAfter |
Ressursipuu (KRYH) koos masinate arvuga (GET /manufresources/) | Töökeskused ja töökeskuste rühmad | L7 → SkyPlanner | Esmane laadimine, hiljem harva |
Töökaart (TSUUNR) etapi kohta (GET /manufphases/) | Tööd (protsessietapid) töökeskuste kaupa | L7 → SkyPlanner | Päringud iga mõne minuti järel |
Laoseisud (GET /stockbalances/) | Laovaru | L7 → SkyPlanner | Perioodilised päringud |
Osturead (GET /purchaserows/) | Ostutellimused koos tarnekuupäevadega | L7 → SkyPlanner | Perioodilised päringud |
Müügitellimused ja müügiread (GET /salesorders/, GET /salesrows/) | Tähtajad, kliendi prioriteet | L7 → SkyPlanner | Perioodilised päringud |
Tootmissündmused (GET /manufevents/) | Edenemine töö kaupa | L7 → SkyPlanner | Perioodilised päringud |
Töökaardi väljad resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Planeeritud töökeskus, algus, järjekord ja päevased töötunnid | SkyPlanner → L7 | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
Ressursikalendri võimsus (POST /resourceupdates/) | Vahetuse võimsus | SkyPlanner → L7 | Vahetuste muutumisel |
| SkyPlanneris määratud ajakava koostamise reeglid | Lubatud töökeskused, seadistusaegade maatriks, tööriistad, töötajad | Hallatakse SkyPlanneris | Seadistatakse juurutuse käigus |
Integratsiooni teostus
1. Põhiandmete esmane laadimine. Lugege ressursipuu ja vastendage iga masin eraldi SkyPlanneri töökeskusega. Kui ühel L7 ressursil on mitu masinat, looge iga masina jaoks töökeskus ja ressursi jaoks töökeskuste rühm. Lugege tooted ja tootestruktuurid koos tööetappidega.
2. Töönumbrite sünkroonimine. Lugege avatud töökaardid päringuga GET /manufphases/ ja hoidke neid seejärel ajakohasena parameetriga modifiedAfter. Lugege iga töönumbri komponendid ja materjalivajadused ning laoseisud ja osturead, et tööetapp ei algaks enne vastava osturea tarnekuupäeva.
3. Ajakava tagasikirjutamine. SkyPlanner kutsub lõpp-punkti PUT /manufphases/ iga etapi kohta, mille planeerimismootor ajakavasse paigutas või ümber tõstis. Päringu keha sisaldab iga töökaardi kohta üht workSheet kirjet järgmiste väljadega:
numbertähistab töökaarti jaresourcevalitud ressurssistartDatejaprioritytagavad, et L7 tööjärjekorrad näitavad SkyPlanneri määratud järjekordaperson, kui tööle on planeeritud konkreetne operaatorschedulingDayssisaldab kuupäevade kaupa planeeritud töötunde
L7 jätab välise süsteemi määratud prioriteedi muutmata (allikas), nii et tööjärjekordades säilib määratud järjekord.
4. Võimsuse sünkroonimine. Kui SkyPlanneris muutuvad vahetused, puhkepäevad või ületunnid, kirjutatakse uus võimsus L7 ressursikalendrisse päringuga POST /resourceupdates/. L7 koormusvaated vastavad seejärel plaanile.
5. Tööde edenemine tootmises. Operaatorid jätkavad tööde registreerimist L7 tööjärjekordades ja Visma LTR-is ning SkyPlanner loeb sündmusi päringuga GET /manufevents/. Operaatorid saavad töid kinnitada ka rakenduses SkyPlanner Mobile Confirmations. Autopilot koostab ajakava ümber kummastki allikast saadud andmete põhjal ja järgmise tagasikirjutusega saadetakse uued ajad.
6. Andmete haldamise ja vastuolude lahendamise reeglid. Pange need enne kasutuselevõttu kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Tooted, struktuurid, tööetapid, kogused, töönumbri olek | Visma L7 |
| Etappide järjekord, alguskuupäevad, päevased töötunnid, ressursi valik | SkyPlanner |
| Lubatud töökeskused, seadistusaegade maatriks, tööriistad, töötajad | SkyPlanner |
| Vahetused ja puudumised | SkyPlanner, andmed kirjutatakse L7 ressursikalendrisse |
| Tootmissündmused ja laokanded | Visma L7 tööjärjekorrad ja LTR |
Peamine vastuolude allikas on L7 enda planeerimine. Vajaduste arvutus ja detailplaneerimine võivad lukustamata etapid uuesti ajakavasse paigutada. Käivitage neid ainult materjalide ja broneeringute jaoks ning ärge planeerige ümber etappe, mille ajakava haldab SkyPlanner.
Projekti tavapärased etapid
Lahendus saab tavaliselt kasutusvalmis nädalate jooksul pärast juurutuse algust. Enne seda saate 30-päevasel tasuta prooviperioodil kasutada oma andmeid: Excelisse eksporditud töönumbreid, etappe ja ressursse.
- Ulatuse määramine. Leppige kokku vastendustabel, andmete haldamise reeglid ja päringute intervall.
- Juurdepääs ja litsentsid. Hankige litsentsid projektiga hõlmatud REST-lõpp-punktidele. LTR-i administraator loob API kasutaja ning väärtused hash ja token, soovitatavalt esmalt testettevõttes.
- Muudatuste logimine. Lülitage DBLOG sisse tabelites, mida loete.
- Esmane laadimine. Ressursid, tooted, struktuurid ja tööetapid.
- Töönumbrite sünkroonimine. Perioodilised päringud parameetriga modifiedAfter, kustutamiste käsitlemine ja lehekülgedeks jaotamine.
- Piirangute seadistamine SkyPlanneris. Lubatud töökeskused, seadistusaegade maatriks, tööriistad ja töötajad.
- Tagasikirjutamine.
PUT /manufphases/jaPOST /resourceupdates/, testitud testettevõttes. - Paralleelne töö ja kasutuselevõtt. Võrrelge tulemust praeguse plaaniga, parandage põhiandmed ja lülitage seejärel tagasikirjutamine töökeskkonnas sisse.
Millega Visma L7 liidestamisel arvestada
- Iga lõpp-punkt vajab litsentsi. Pange kõik lõpp-punktid varakult kirja ja hankige neile litsentsid enne testimist.
- Masinate arv. Mitme masinaga ressurss jagab L7-s töö masinate vahel (allikas). Jagage see SkyPlanneris eraldi töökeskusteks ja kirjutage tagasi ressurss, mida L7 ootab.
- Tunnid päeva kohta. L7 salvestab plaanitud tunnid kuupäevade kaupa. SkyPlanner saadab
schedulingDaysandmed, mille tundide summa vastab tööetapi kestusele. - Tehase kalender. Täitke kalender lünkadeta, sest lüngad nihutavad tööetapid minevikku (allikas).
- Laotellimused. Välju
mainNumber,subNumber,rowNumberjanewQuantitykasutatakse ainult laotellimuse koguse muutmiseks. Klienditellimuste puhul jätke need välja. - Järgmine ERP. Visma on L7 edasiarenduse lõpetanud ja toote kasutamine lõpeb 2028. aasta lõpus (Visma teade). Hoidke ajakava koostamise reegleid SkyPlanneris, mitte L7 väljadel, et need säiliksid ka ERP vahetamisel.
Kes seadistab Visma L7 liidestuse ja pakub tuge?
Töö hõlmab vastendamist teie ressursside, tööetappide ja L7 seadistusega. Samuti hõlmab see SkyPlanneris hoitavaid ajakava koostamise reegleid: lubatud töökeskusi, seadistusaegade maatriksit, tööriistu ja inimesi.
- SkyPlanneri meeskond seadistab liidestuse kasutuselevõtu käigus ja pakub tuge ka pärast töösseviimist. Iga tehas kasutab L7-t omal moel ning seadistamisel rakendatakse just neid teadmisi.
- Teie Visma partner saab kaasa lüüa. Partner tunneb teie L7 ja LTR-i seadistust ning saab hoolitseda API kasutaja, litsentside ja testettevõtte eest. SkyPlanner pakub REST API-t, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Teie arendajad saavad luua lisalahendusi, kasutades sama dokumenteeritud REST API-t ja API tokenit. Alustamiseks piisab API tokenist ning SkyPlanneri meeskond aitab vajaduse korral.
Kui vahetate L7 välja, saab sama SkyPlanneri seadistuse ühendada uue ERP-ga. Vaadake lehti Business Central, Visma Net, Lemonsoft, Monitor ERP ja Odoo.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub iga kuu. Liidestuse hinnapakkumine koostatakse teie protsessi ja vajaduste järgi ette koos paketi pakkumisega, nii et kogukulu on teada juba enne alustamist.
L7 enda planeerimisvõimaluste võrdlust lugege artiklist Kas Visma L7 võimaldab tootmise planeerimist, mis arvestab masinate ja töötajate tegelikku võimsust? Ülevaate leiate Visma L7 lehelt ja teised süsteemid ERP-liidestuste koondlehelt.
Tootmisettevõtete kogemused SkyPlanneriga
1 000-tetöökäskude ajakava koostatakse automaatselt
„Tootmine on hoopis teistmoodi kontrolli all ja meie arusaam tootmisvõimsusest on täiesti uuel tasemel.”
Hannu Ryynänen, tegevjuht
Mamec · Tööstuslikud segistid, pumbad ja kõrgtehnoloogiline allhanketootmine
Tuhandete töökäskude ajakava koostatakse automaatselt ja kogu organisatsioonil on tootmisest reaalajas ülevaade.
98%tarnekindlus varasema ligikaudu 50% asemel
„SkyPlanneril on meie tarnekindluse hoidmisel otsustav roll.”
Hannu Lahtinen, tegevjuht
KJH-Comp · Lehtmetallitööd ja allhanketootmine
Tarnekindlus tõusis ligikaudu 50%-lt koguni 98%-ni ning ajakava koostamiseks on nüüd kahe tööjuhi asemel vaja üht.
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.”
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel säästetakse igal nädalal 2 tundi tööaega ning uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise efektiivsus
„Tootmise efektiivsus on kasvanud 90%.”
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise efektiivsus on kasvanud 90% ning kõiki töökeskusi hõlmava optimeeritud plaani koostamine kolmeks kuuks võtab alla 30 minuti.
Korduma kippuvad küsimused
Kas Visma L7-l on tootmisandmete jaoks API?
Jah. Visma LTR-is töötava Visma L7 REST API kaudu on kättesaadavad tööetapid, ressursid, detailid, materjalid, tootmissündmused, tooted, laoseisud ning müügi- ja osturead. Iga lõpp-punkt vajab eraldi litsentsi ning LTR-i administraator loob API kasutaja ja tokenid.
Kuidas ajakava Visma L7-sse tagasi kirjutatakse?
Päringuga PUT /manufphases/, mis uuendab iga töökaardi ressurssi, alguskuupäeva, prioriteeti, isikut ja kuupäevade kaupa planeeritud tunde. POST /resourceupdates/ kirjutab ressursi kalendrisse tootmisvõimsuse andmed. L7 säilitab välise prioriteedi, nii et tööjärjekorrad järgivad SkyPlanneri määratud järjestust.
Kas Visma L7 toetab veebihaake?
Veebihaake pole dokumenteeritud. Lülitage liidestusega hõlmatud tabelites sisse muudatuste logimine ja pärige muudatusi regulaarselt parameetriga modifiedAfter. SkyPlanneri enda veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
Milline tootmise ajakava koostamise tarkvara liidestub Visma L7-ga?
SkyPlanner APS liidestub Visma L7-ga kahesuunaliselt L7 REST API kaudu ning Visma toob Skycode’i ja SkyPlanneri välja oma L7 liidestuste lehel. SkyPlanneri meeskond seadistab liidestuse kasutuselevõtu käigus.
Kes loob Visma L7 liidestuse?
SkyPlanneri meeskond seadistab kahesuunalise liidestuse kasutuselevõtu käigus teie L7 seadistuse järgi ning pakub tuge ka pärast töösseviimist. Teie Visma partner või teie enda arendajad saavad samuti luua lahendusi SkyPlanneri dokumenteeritud REST API abil. Alustamiseks piisab API tokenist.
Kas saame SkyPlannerit enne liidestuse loomist katsetada?
Jah. 30-päevasel tasuta prooviperioodil saate kasutada kuni 20 töökeskust ning importida L7-st andmeid Exceli või CSV kujul. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga, et määrata liidestuse ulatus.
