Integraatiot / ERP / Visma L7
Visma L7:n APS-integraatio-opas tuotannonsuunnitteluun
Tässä Visma L7:n integraatio-oppaassa kerrotaan kumppaneille ja IT-tiimeille, miten Visma L7 yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Visma L7:n välinen integraatio toimii molempiin suuntiin Visma L7 REST API -rajapinnan kautta:
- SkyPlanneriin tuodaan työnumerot, työnvaiheet, resurssit, tuoterakenteet, osat, materiaalit, varastosaldot sekä myynti- ja ostorivit.
- Kunkin työkortin resurssi, aloituspäivä, prioriteetti, henkilö ja päiväkohtaiset tunnit kirjoitetaan takaisin kutsulla
PUT /manufphases/. - Resurssikalenterin kapasiteetti pidetään ajan tasalla kutsulla
POST /resourceupdates/. - L7:n työjonoihin kirjatut tuotantotapahtumat luetaan takaisin kutsulla
GET /manufevents/. - SkyPlannerin webhookit välittävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlannerin tiimi määrittää integraation L7-ympäristöösi sopivaksi käyttöönoton aikana ja tukee sitä tuotantokäytön alettua. Kumppanit ja kehittäjät voivat myös toteuttaa integraatioita SkyPlannerin dokumentoidun REST API -rajapinnan avulla (rajapintakuvaus).
Visma L7:n REST API
Rajapinnan nimi on Visma L7 – REST API. Se on dokumentoitu OpenAPI 3.0.3 -muodossa, ja dokumentaatio sisältää muutoshistorian (dokumentaatio). Rajapinta toimii Visma LTR:ssä.
- Peruspolku on
/ltrws/REST/L7omalla LTR-palvelimellasi joko paikallisessa ympäristössä tai Visman sovelluspalvelussa. - Lisensointi. Jokainen päätepiste lisensoidaan erikseen. Aikataulun kirjoittaminen kutsulla
PUT /manufphases/edellyttää L7RMFPP-lisenssiä ja kapasiteetin päivittäminen L7RMCAP-lisenssiä. Lukupäätepisteillä on omat lisenssinsä. - Sivutus. Listat sivutetaan parametreilla
pageSizejarecAfterja suodatetaan parametreillaqueryKey1,queryKey2jaqueryString.
Todennus
Jokaisen L7-kutsun mukana lähetetään kaksi tunnistetta:
- hash määrittää tietokannan ja yrityksen.
- token yksilöi API-käyttäjän.
LTR-pääkäyttäjä luo API-käyttäjän Visma LTR:ään, liittää sen L7-yritykseen, myöntää sille profiilit ja luo käyttäjän token-tunnisteen (aloitusohje). Käytä integraatiolle omaa käyttäjää, jolla on vain integraation tarvitsemat oikeudet.
SkyPlannerin REST API -rajapinnassa tunnistaudutaan API-tokenilla, joka lähetetään Authorization-Token-otsakkeessa. Luo token kohdassa Settings > API. Integraatio-ohje opastaa ensimmäisten kutsujen tekemisessä.
Muutosten tunnistaminen: modifiedAfter
L7 REST API ei tue webhookeja. Muutokset luetaan kyselemällä rajapintaa säännöllisesti:
- Ota muutosloki (DBLOG) käyttöön L7:n Tiedostohuollossa niille tauluille, joita integraatio lukee, kuten työkorteille ja osille.
- Kutsu lukupäätepisteitä ja aseta
modifiedAfter-parametrin arvoksi edellisen ajon ajankohta. Poistetut tietueet palautetaan poistetuiksi merkittyinä, joten perutut työt poistuvat aikataulusta. - Tee kyselyt muutaman minuutin välein. SkyPlanner lähettää webhookeja tilan tai aikataulun muuttuessa, joten takaisinkirjoitus toimii tapahtumapohjaisesti.
Tietojen vastaavuudet
| Visma L7:n objekti (päätepiste) | SkyPlanner-objekti | Suunta | Päivitystiheys |
|---|---|---|---|
Tuote (GET /products/) | Tuotteet ja materiaalit | L7 → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
Työnumeron osat (GET /manufcomponents/) | Alituotteet | L7 → SkyPlanner | Säännölliset kyselyt modifiedAfter-parametrilla |
Materiaalitarpeet (GET /manufmaterials/) | Työkohtaiset materiaalitarpeet | L7 → SkyPlanner | Säännölliset kyselyt modifiedAfter-parametrilla |
Resurssipuu (KRYH) konemäärineen (GET /manufresources/) | Työpisteet ja työpisteryhmät | L7 → SkyPlanner | Alkulataus, sen jälkeen harvoin |
Vaihekohtainen työkortti (TSUUNR) (GET /manufphases/) | Työpistekohtaiset työt (työvaiheet) | L7 → SkyPlanner | Kyselyt muutaman minuutin välein |
Varastosaldot (GET /stockbalances/) | Varasto | L7 → SkyPlanner | Säännölliset kyselyt |
Ostorivit (GET /purchaserows/) | Ostotilaukset toimituspäivineen | L7 → SkyPlanner | Säännölliset kyselyt |
Myyntitilaukset ja -rivit (GET /salesorders/, GET /salesrows/) | Määräpäivät, asiakkaan prioriteetti | L7 → SkyPlanner | Säännölliset kyselyt |
Tuotantotapahtumat (GET /manufevents/) | Työkohtainen eteneminen | L7 → SkyPlanner | Säännölliset kyselyt |
Työkortin resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Suunniteltu työpiste, aloitus, järjestys ja päiväkohtaiset tunnit | SkyPlanner → L7 | Aikataulun muuttuessa SkyPlannerin webhookin kautta |
Resurssikalenterin kapasiteetti (POST /resourceupdates/) | Vuorokapasiteetti | SkyPlanner → L7 | Vuorojen muuttuessa |
| SkyPlannerissa määritetyt suunnittelusäännöt | Sallitut työpisteet, asetusaikamatriisi, työkalut, henkilöt | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutusmallit
1. Perustietojen alkulataus. Lue resurssipuu ja kohdista jokainen kone omaan SkyPlanner-työpisteeseensä. Jos yhdellä L7-resurssilla on useita koneita, luo kullekin koneelle oma työpiste ja resurssille työpisteryhmä. Lue tuotteet ja tuoterakenteet työnvaiheineen.
2. Työnumeroiden synkronointi. Lue avoimet työkortit kutsulla GET /manufphases/ ja pidä ne sen jälkeen ajan tasalla modifiedAfter-parametrin avulla. Lue kunkin työnumeron osat ja materiaalitarpeet sekä varastosaldot ja ostorivit, jotta vaihe odottaa siihen liittyvän ostorivin toimituspäivää.
3. Aikataulun takaisinkirjoitus. SkyPlanner tekee PUT /manufphases/ -kutsun jokaiselle vaiheelle, jonka laskentamoottori on sijoittanut aikatauluun tai siirtänyt. Pyynnön rungossa on kutakin työkorttia kohti yksi workSheet-tietue, joka sisältää seuraavat tiedot:
numbereli työkortti jaresourceeli valittu resurssistartDatejapriority, jotta L7:n työjonot näyttävät SkyPlannerin määrittämän järjestyksenperson, kun työlle on suunniteltu nimetty työntekijäschedulingDayseli suunnitellut tunnit päivämääräkohtaisesti
L7 säilyttää ulkoisen järjestelmän asettaman prioriteetin sellaisenaan (lähde), joten järjestys säilyy työjonoissa.
4. Kapasiteetin synkronointi. Kun vuorot, lomat tai ylityöt muuttuvat SkyPlannerissa, POST /resourceupdates/ kirjoittaa uuden kapasiteetin L7:n resurssikalenteriin. Tällöin L7:n kuormitusnäkymät vastaavat suunnitelmaa.
5. Tuotannon eteneminen. Työntekijät jatkavat kirjaamista L7:n työjonoissa ja Visma LTR:ssä, ja SkyPlanner lukee tapahtumat kutsulla GET /manufevents/. Työntekijät voivat kuitata töitä myös SkyPlanner Mobile Confirmations -toiminnolla. Autopilot päivittää suunnitelman kummastakin lähteestä saatujen tietojen perusteella, ja seuraava takaisinkirjoitus välittää uudet ajat.
6. Tietojen omistajuus ja ristiriitojen ratkaisusäännöt. Kirjaa ne ennen tuotantokäyttöön siirtymistä:
| Tiedot | Omistaja |
|---|---|
| Tuotteet, rakenteet, työnvaiheet, määrät, työnumeron tila | Visma L7 |
| Vaiheiden järjestys, aloituspäivät, päiväkohtaiset tunnit, resurssin valinta | SkyPlanner |
| Sallitut työpisteet, asetusaikamatriisi, työkalut, henkilöt | SkyPlanner |
| Vuorot ja poissaolot | SkyPlanner, tiedot kirjoitetaan L7:n resurssikalenteriin |
| Tuotantotapahtumat ja varastokirjaukset | Visma L7:n työjonot ja LTR |
Suurin ristiriitojen aiheuttaja on L7:n oma suunnittelu. Tarvelaskenta ja hienosuunnittelu voivat sijoittaa lukitsemattomat vaiheet uudelleen aikatauluun. Aja niitä vain materiaaleja ja varauksia varten äläkä suunnittele uudelleen SkyPlannerin hallinnassa olevia vaiheita.
Projektin tyypilliset vaiheet
Toteutus valmistuu tavallisesti viikkojen kuluessa käyttöönoton aloittamisesta. Sitä ennen voit käyttää 30 päivän maksutonta kokeilua omilla tiedoillasi: työnumerot, vaiheet ja resurssit tuodaan Excel-viennistä.
- Määrittely. Sovi tietojen vastaavuustaulukosta, omistajuussäännöistä ja kyselyvälistä.
- Käyttöoikeudet ja lisenssit. Hanki lisenssit toteutukseen kuuluville REST-päätepisteille. LTR-pääkäyttäjä luo API-käyttäjän sekä hash- ja token-tunnisteet, mieluiten ensin testiyritykseen.
- Muutosloki. Ota DBLOG käyttöön luettaville tauluille.
- Alkulataus. Resurssit, tuotteet, rakenteet ja työnvaiheet.
- Työnumeroiden synkronointi. Säännölliset kyselyt modifiedAfter-parametrilla, poistot ja sivutus.
- Rajoitteiden määritys SkyPlannerissa. Sallitut työpisteet, asetusaikamatriisi, työkalut ja henkilöt.
- Takaisinkirjoitus.
PUT /manufphases/jaPOST /resourceupdates/testataan testiyrityksessä. - Rinnakkaiskäyttö ja tuotantoon siirtyminen. Vertaa tuloksia nykyiseen suunnitelmaan, korjaa perustiedot ja ota sitten takaisinkirjoitus käyttöön tuotantoympäristössä.
Mitä Visma L7 -integraatiossa kannattaa huomioida
- Päätepistekohtaiset lisenssit. Listaa kaikki päätepisteet jo alkuvaiheessa ja hanki niihin lisenssit ennen testausta.
- Koneiden määrä. Jos resurssilla on useita koneita, L7 jakaa työn niiden kesken (lähde). Jaa resurssi SkyPlannerissa työpisteiksi ja kirjoita takaisin L7:n odottama resurssi.
- Päiväkohtaiset tunnit. L7 tallentaa suunnitelman tunteina päivämäärää kohden. SkyPlanner lähettää
schedulingDays-tiedot, joiden tuntien summa vastaa vaiheen kestoa. - Tehdaskalenteri. Pidä kalenteri kattavana, sillä aukot siirtävät vaiheita menneisyyteen (lähde).
- Varastotilaukset. Kenttiä
mainNumber,subNumber,rowNumberjanewQuantitykäytetään vain varastotilauksen määrän muuttamiseen. Jätä ne pois asiakastöistä. - Seuraava ERP-järjestelmä. Visma on lopettanut L7:n uuskehityksen, ja tuotteen käyttö päättyy vuoden 2028 lopussa (Visman tiedote). Pidä tuotannonsuunnittelun säännöt SkyPlannerissa, älä L7:n kentissä, jotta ne säilyvät ERP-järjestelmää vaihtaessa.
Kuka määrittää Visma L7 -integraation ja vastaa sen tuesta?
Työhön kuuluu tietojen vastaavuuksien määrittely resurssienne, työvaiheidenne ja L7-asetustenne mukaisesti. Lisäksi määritellään SkyPlannerissa ylläpidettävät tuotannonsuunnittelun säännöt: sallitut työpisteet, asetusaikamatriisi, työkalut ja henkilöt.
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja vastaa sen tuesta tuotantoon siirtymisen jälkeen. Jokainen tehdas käyttää L7:ää omalla tavallaan, ja tämä käytännön tuntemus hyödynnetään määrityksissä.
- Visma-kumppaninne voi osallistua. Kumppani tuntee L7- ja LTR-ympäristönne ja voi hoitaa API-käyttäjän, lisenssit ja testiyrityksen. SkyPlanner tarjoaa REST API -rajapinnan, Swagger/OpenAPI-dokumentaation ja webhookit.
- Myös omat kehittäjänne voivat toteuttaa integraation saman dokumentoidun REST API -rajapinnan kautta API-tokenilla. Alkuun pääsee pelkällä API-tokenilla, ja SkyPlanner-tiimi auttaa tarvittaessa.
Kun korvaatte L7:n uudella ERP-järjestelmällä, samat SkyPlanner-määritykset voidaan liittää siihen. Tutustu sivuihin Business Central, Visma Net, Lemonsoft, Monitor ERP ja Odoo.
SkyPlanner maksaa alkaen 199 € kuukaudessa kuukausilaskutuksella, ja hintaan sisältyy 5 työpistettä. Saatte etukäteen tarjouksen sekä prosessinne ja tarpeenne huomioivasta integraatiosta että SkyPlanner-tilauksesta, joten kokonaiskustannukset ovat tiedossa ennen aloitusta.
Lue L7:n oman suunnittelun vertailu artikkelista Onko Visma L7:ssä hienokuormitus? Yleiskatsaus löytyy Visma L7 -sivulta ja muut järjestelmät ERP-integraatioiden koontisivulta.
Valmistavan teollisuuden kokemuksia SkyPlannerista
1 000:iaautomaattisesti suunniteltuja työtilauksia
”Tuotanto on aivan eri tavalla hallinnassa, ja ymmärryksemme kapasiteetista on täysin eri tasolla.”
Hannu Ryynänen, toimitusjohtaja
Mamec · Teollisuussekoittimet, pumput ja korkean teknologian sopimusvalmistus
Tuhansien työtilausten aikataulut suunnitellaan automaattisesti, ja koko organisaatiolla on reaaliaikainen näkymä tuotantoon.
98%toimitusvarmuus, lähtötaso noin 50%
”SkyPlannerilla on ratkaiseva rooli toimitusvarmuutemme ylläpitämisessä.”
Hannu Lahtinen, toimitusjohtaja
KJH-Comp · Ohutlevymekaniikka ja sopimusvalmistus
Toimitusvarmuus nousi noin 50%:sta jopa 98%:iin, ja tuotannonsuunnitteluun tarvitaan nyt kahden työnjohtajan sijaan yksi.
2 hsäästöä joka viikko
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kojeistot
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa joka viikko, ja uusi työjono saadaan linjalle sekunneissa.
+90%tuotannon tehokkuutta
”Tuotannon tehokkuus on kasvanut 90%.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkevalmistus
Tuotannon tehokkuus on kasvanut 90%, ja kaikki työpisteet kattavan optimoidun suunnitelman laatiminen kolmeksi kuukaudeksi vie alle 30 minuuttia.
Usein kysytyt kysymykset
Onko Visma L7:ssä API tuotantotiedoille?
Kyllä. Visma LTR:ssä toimiva Visma L7 REST API tarjoaa työvaiheet, resurssit, osat, materiaalit, tuotantotapahtumat, tuotteet, varastosaldot sekä myynti- ja ostorivit. Jokainen päätepiste lisensoidaan erikseen, ja LTR-pääkäyttäjä luo API-käyttäjän ja tokenit.
Miten tuotantosuunnitelma kirjoitetaan takaisin Visma L7:ään?
Kutsulla PUT /manufphases/, joka päivittää kunkin työkortin resurssin, aloituspäivän, prioriteetin, henkilön ja suunnitellut päiväkohtaiset tunnit. POST /resourceupdates/ kirjoittaa resurssikalenterin kapasiteetin. L7 säilyttää ulkoisen prioriteetin, joten työjonot noudattavat SkyPlannerin järjestystä.
Tukeeko Visma L7 webhookeja?
Webhookeja ei ole dokumentoitu. Ota muutosloki käyttöön integraatioon kuuluvissa tauluissa ja hae muutokset säännöllisesti modifiedAfter-parametrilla. SkyPlannerin omat webhookit lähettävät suunnitelman muutokset heti niiden tapahtuessa.
Mikä tuotannonsuunnitteluohjelmisto integroituu Visma L7:ään?
SkyPlanner APS integroituu Visma L7:ään kaksisuuntaisesti L7 REST API -rajapinnan kautta. Visma listaa Skycoden ja SkyPlannerin L7-integraatiosivullaan. SkyPlanner-tiimi määrittää integraation käyttöönoton aikana.
Kuka toteuttaa Visma L7 -integraation?
SkyPlanner-tiimi määrittää kaksisuuntaisen integraation L7-ympäristönne mukaiseksi käyttöönoton aikana ja vastaa sen tuesta tuotantoon siirtymisen jälkeen. Myös Visma-kumppaninne tai omat kehittäjänne voivat toteuttaa integraation SkyPlannerin dokumentoidun REST API -rajapinnan avulla. Alkuun pääsee pelkällä API-tokenilla.
Voimmeko kokeilla SkyPlanneria ennen integraation toteuttamista?
Kyllä. Ilmaisessa 30 päivän kokeilussa voi käyttää enintään 20 työpistettä ja tuoda tiedot L7:stä Excel- tai CSV-tiedostoina. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
