Integraatiot / ERP / Visma Net ERP
Visma Net -integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Visma Net -integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten Visma Net (Visma.net ERP) yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Visma Netin välinen integraatio toimii molempiin suuntiin Visma Net API:n kautta:
- SkyPlanneriin tuodaan varastonimikkeet, Kit specifications -tiedot, myyntitilaukset, varastosaldot ja ostotilaukset.
- Suunnitelluista töistä muodostetaan Kit assemblies -tietueet, jotka vapautetaan työn valmistuttua.
- Työntekijöiden tunnit palautetaan Employee time cards -tietueina.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlannerin tiimi määrittää integraation Visma Net -ympäristöönne sopivaksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on tarkoitettu kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa itse SkyPlannerin dokumentoidun REST API:n varaan (API-viite).
Visma Netin integraatiorajapinnat
- Visma Net ERP API. REST-rajapinta, jonka OpenAPI-kuvauksen nimi on edelleen “Visma.net ERP API v1” ja jossa on v1- ja v2-polkuja. Perusosoite on
https://api.finance.visma.net. Vanhanintegration.visma.net-verkkotunnuksen liikennettä rajoitetaan 1. helmikuuta 2026 alkaen, ja verkkotunnus poistuu käytöstä (tiedote). - SalesOrder service v3 osoitteessa
https://salesorder.visma.net. Myyntitilausten v1- ja v2-päätepisteet ovat elinkaarensa lopussa. - Webhookit Visma Developer Portalin kautta.
- Background API.
erp-api-background-otsake siirtää pitkät kutsut jonoon. Vastauksena saadaan tilakoodi 202 ja työn tunniste sekä ilmoitus, kun tulos on valmis. - Tuonti- ja vientiskenaariot Visma Netissä. CSV-, Excel- tai SQL-tietolähteitä voi käyttää perustietojen kertaluonteiseen tuontiin.
API:ssa ei ole päätepisteitä tuotantotilauksille, reitityksille tai työpisteille, koska Visma Netissä ei ole näitä objekteja. Suunnittelussa tarvittavat tiedot saadaan nimikkeistä, kiteistä, tilauksista ja varastotiedoista:
GET /v1/inventory: varastoitavat ja ei-varastoitavat nimikkeet sekä kit-merkintä ja nimikeluokkaGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: komponenttirivit revisioittainGET /v1/kitassembly: olemassa olevat kokoonpanot, joita voi suodattaa tyypin ja tilan mukaan- SalesOrder service v3: kysyntä sekä pyydetyt päivämäärät ja tilausrivit
GET /v1/inventorysummary/{inventoryNumber}: varastossa olevat ja käytettävissä olevat määrät varastoittainGET /v1/purchaseorderjaGET /v2/PurchaseReceipt: saapuvat materiaalit ja vastaanotot
Kaikki listauspäätepisteet hyväksyvät parametrit lastModifiedDateTime ja lastModifiedDateTimeCondition sekä pageNumber ja pageSize. Näin jokaisella synkronointikerralla voidaan siirtää vain muutokset.
Todennus ja rajoitukset
Visma Net käyttää Visma Connect -palvelua (OpenID Connect ja OAuth 2.0):
- Rekisteröi Service Integration Visma Developer Portalissa.
- Asiakkaan Visma Net -ympäristön pääkäyttäjä hyväksyy integraation.
- Pyydä käyttöoikeustunnisteet client credentials -menetelmällä osoitteesta
https://connect.visma.com/connect/token. Välitä mukanatenant_idja API-käyttöoikeusalueet, kutenvisma_api:read. Tunnisteet ovat voimassa 3 600 sekuntia.
Kutsurajat lasketaan kiinteissä tunnin jaksoissa yritys- ja asiakassovelluskohtaisesti. Vastaukset sisältävät otsakkeet X-RateLimit-Limit, X-RateLimit-Remaining ja X-RateLimit-Reset. Kun raja ylittyy, vastauksena saadaan tilakoodi 429 ja Retry-After-otsake (kutsurajat). ETag- ja If-Match-otsakkeet suojaavat päivityksiä.
Kumppanit voivat testata demoyrityksellä Visman maksuttomassa Integrator Programme -ohjelmassa. SkyPlannerin REST API käyttää todennukseen API-tokenia (SkyPlanner Settings > API), ja sen dokumentaatio on Swagger/OpenAPI-muodossa. Integraatio-ohje opastaa ensimmäisten kutsujen tekemisessä.
Tapahtumat, webhookit ja kyselyt
Visma Developer Portalin webhookit kattavat suunnittelun kannalta olennaiset tapahtumat:
- Inventory Item Created, Updated ja Changed
- Purchase Order Changed ja Status Changed
- Sales Order Changed ja Status Changed, jotka siirtyvät SalesOrderService-julkaisijalle
Kit assembly -objekteille ja Kit specifications -objekteille ei ole tapahtumia. SkyPlanner hakee niiden muutokset säännöllisillä kyselyillä käyttäen lastModifiedDateTime-suodattimia. Varastosaldot kysellään suunnitteluajojen yhteydessä. Toiseen suuntaan SkyPlanner lähettää webhookeja, kun tila tai aikataulu muuttuu.
Tietojen vastaavuudet
| Visma Net -objekti (päätepiste) | SkyPlanner-objekti | Suunta | Siirtotiheys |
|---|---|---|---|
Stock items, Non-stock items (/v1/inventory) | Tuotteet ja materiaalit | Visma Net → SkyPlanner | Alkutuonti, sen jälkeen webhook |
Kit specifications (/v1/KitSpecifications) | Tuoterakenne, tuotekohtaiset materiaalit | Visma Net → SkyPlanner | Alkutuonti, sen jälkeen säännölliset kyselyt |
| Myyntitilaukset (SalesOrder service v3) | Tilaukset toimituspäivineen ja asiakasprioriteetteineen | Visma Net → SkyPlanner | Webhook |
Kit assembly tilassa On hold (/v1/kitassembly), jos kokoonpanot luodaan Visma Netissä | Työt | Visma Net → SkyPlanner | Säännölliset kyselyt |
Inventory summary (/v1/inventorysummary) | Varastokohtaiset saldot | Visma Net → SkyPlanner | Kysely suunnitteluajon yhteydessä |
Ostotilaukset ja ostojen vastaanotot (/v1/purchaseorder, /v2/PurchaseReceipt) | Saapuvat materiaalit toimituspäivineen; varastosaldot päivittyvät, kun ostotilaus toimitetaan | Visma Net → SkyPlanner | Webhook, jonka jälkeen tietojen luku |
| Ei Visma Netissä | Työvaiheet, työpisteet, työvuorot, asetusaikamatriisi, työkalut, vaihtoehtoiset resurssit | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Kit assembly -tietueen luonti ja päivitys (POST/PUT /v1/kitassembly) | Suunniteltu työ: kit-nimike, määrä, suunniteltu valmistumispäivä | SkyPlanner → Visma Net | Aikataulun muuttuessa SkyPlannerin webhookin kautta |
Kit assembly -tietueen vapautus (/v1/kitassembly/{type}/{refNo}/action/release) | Valmis työ: valmistunut määrä ja komponenttien kulutus | SkyPlanner → Visma Net | Työn valmistuessa |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, vapautus) | Valmistunut määrä ja materiaalien kulutus, kun kittejä ei käytetä | SkyPlanner → Visma Net | Työn valmistuessa |
Employee time card (/v1/timeCard) | Työntekijäkohtaiset kirjatut tunnit | SkyPlanner → Visma Net | Viikoittain |
Integraation toteutusmallit
1. Perustietojen alkutuonti. Lue varastonimikkeet, nimikeluokat ja jokaisen kitin uusin Kit specification -revisio. Kohdista jokainen komponenttirivi SkyPlannerin materiaaliin. Luo sitten tiedot, joita Visma Netissä ei ole: työpisteet, työvuorot, työvaiheet asetus- ja suoritusaikoineen, asetusaikamatriisi ja työkaluvaatimukset. Tuo ne CSV- tai Excel-tiedostoina. Tämä on projektin suurin työvaihe.
2. Tilausten synkronointi. Valitse yksi kysyntämalli:
- Myyntitilausohjautuva. Kit-nimikkeiden avoimista myyntitilausriveistä muodostetaan SkyPlanner-tilaukset, joiden toimituspäiväksi asetetaan pyydetty päivämäärä.
- Kokoonpano-ohjautuva. Visma Netissä tilaan On hold luoduista Kit assemblies -tietueista muodostetaan SkyPlannerin työt.
Avoimet ostotilaukset tuodaan päivämäärineen. SkyPlanner käsittelee tilattua materiaalia saatavilla olevana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilaus merkitään tilaan Delivered. Näiden tietojen ja varastoyhteenvedon avulla suunnittelussa tarkistetaan sekä varastossa olevat että saapuvat materiaalit.
3. Suunnitelman takaisinkirjaus. Myyntitilausohjautuvassa mallissa SkyPlanner luo jokaisesta suunnitellusta työstä Kit assembly -tietueen, jonka tyyppi on Production. Se asettaa kit-nimikkeen, revision, varaston, määrän ja komponentit sekä linkittää kokoonpanon myyntitilausriviin. Kokoonpanon päivämääräksi asetetaan suunniteltu valmistumispäivä. Kun Autopilot siirtää työtä, päivämäärä päivitetään PUT-kutsulla ennen vapautusta.
Kit assembly -tietueessa on yksi Date-kenttä, joten työvaihekohtaiset ajat säilyvät SkyPlannerissa. Visma Netiin siirretään myynnin ja varaston kannalta olennainen päivämäärä.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä Mobile Confirmations -toiminnolla tai Production Timer -toiminnolla, ja aikakirjaukset pitävät suunnitelman ajan tasalla. Kun viimeinen vaihe on valmis, SkyPlanner kutsuu Kit assembly -dokumentin release-toimintoa. Se kirjaa valmistuneen tuotannon ja komponenttien kulutuksen, minkä jälkeen muodostuu pääkirjan kirjauserä. Työtunnit kootaan viikoittaisille Employee time cards -tuntikorteille tai projektilähtöisessä työssä projektitapahtumiksi.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäyttöön siirtymistä:
| Tiedot | Omistaja |
|---|---|
| Nimikkeet, Kit specifications, myyntitilaukset, ostotilaukset, varastosaldot, kustannukset | Visma Net |
| Työvaiheet, työpisteet, työvuorot, asetukset, työkalut | SkyPlanner |
| Töiden järjestys, alkamis- ja päättymisajat, töiden kohdistus työpisteille | SkyPlanner |
| Kit assembly -dokumentin päivämäärä ennen vapautusta | SkyPlanner |
| Vapautetut Kit assemblies -dokumentit ja tuntikortit | Visma Net, kirjaukset SkyPlannerista |
Kit specification -määrityksen muutos luo uuden revision. Lue uusin revisio uudelleen ja päivitä sen tietovastaavuudet, sillä valmistukseen voi käyttää vain uusinta revisiota. Kokoonpanon komponentteihin käsin tehdyt muutokset pysyvät voimassa Visma Netissä, joten SkyPlanner lukee kokoonpanon tiedot uudelleen ennen vapautusta.
Projektin tyypilliset vaiheet
Toteutus valmistuu yleensä muutamassa viikossa käyttöönottoprojektin alkamisesta. Sitä ennen voit käyttää 30 päivän maksutonta kokeilua omilla tiedoillasi, jotka viedään Visma Netin vientiskenaariolla ja tuodaan CSV- tai Excel-muodossa.
- Määrittely. Sovi kysyntämalli, tietovastaavuustaulukko, omistajuussäännöt ja takaisin kirjattavien tietojen kohde (Kit assembly tai varastovastaanotot).
- Visma Connectin määritys. Rekisteröi Service Integration ja hanki sille asiakkaan Visma Net -ympäristön pääkäyttäjän hyväksyntä. Testaa ensin demoyrityksessä.
- Tuotantomalli. Määritä työpisteet, työvuorot, työvaiheet, asetukset ja työkalut SkyPlanneriin.
- Ensimmäinen tiedonsiirto. Siirrä varastonimikkeet, nimikeluokat, Kit specifications -määritykset, varastot ja varastosaldot.
- Myynti- ja ostotilausten synkronointi. Käytä myyntitilauksille, ostotilauksille ja nimikkeille webhookeja sekä kiteille ja varastosaldoille säännöllisiä kyselyjä. Tähän vaiheeseen kuuluvat myös tokenien uusiminen ja 429-vastausten käsittely.
- Takaisinkirjaus. Toteuta Kit assembly -dokumenttien luonti, päivitys ja vapautus sekä tuntikorttien kirjaus.
- Rinnakkaistestaus. Käytä SkyPlanneria nykyisen suunnitelman rinnalla ja vertaa päivämääriä.
- Tuotantokäyttöön siirtyminen. Ota takaisinkirjaus käyttöön, kun tiedot täsmäävät.
Mitä Visma Net -integraatiossa on huomioitava
- Tuotavia reitityksiä ei ole. Kaikki työvaiheet sekä asetus- ja ajoajat määritetään aluksi SkyPlannerissa. Varaa tähän työaikaa ja nimeä vastuuhenkilö.
- Advanced logistics. Kit assembly edellyttää Advanced logistics -ryhmää. Jos käytössä on Standard logistics, kirjaa valmistunut tuotanto Inventory receipt- ja Inventory issue -toiminnoilla.
- Lukitut revisiot. Käytettyä Kit specification -revisiota ei voi muokata, ja valmistukseen voi käyttää vain uusinta revisiota.
- Mittayksiköt. Kit assembly -dokumentilla on oma mittayksikkönsä. Varmista tuonnin yhteydessä, että se vastaa SkyPlannerin määriä.
- Kyselyt ilman tapahtumailmoituksia. Kiteille ei ole webhookeja. Nouda vain
lastModifiedDateTime-kentän perusteella muuttuneet tiedot kaikkien tietojen uudelleenlatauksen sijaan, jotta tuntikohtainen kutsuraja ei ylity. - Nykyiset päätepisteet. Käytä toteutuksessa vain osoitetta
api.finance.visma.netja SalesOrder service v3 -palvelua. - Vuokraajan hyväksyntä. Client credentials -todennus ei toimi, ennen kuin vuokraajan pääkäyttäjä on hyväksynyt sovelluksen. Sovi hyväksynnästä hyvissä ajoin.
- Viikoittaiset tuntikortit. Tuntikortit edellyttävät Advanced financials -moduulia, ja ne laaditaan viikoittain. Kokoa työntekijöiden tunnit viikoittain tai kirjaa ne projektitapahtumiksi.
Kuka määrittää Visma Net -integraation ja vastaa sen tuesta
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja tukee sitä tuotantokäyttöön siirtymisen jälkeen. Tähän kuuluvat SkyPlannerin osuus, Visma Netistä puuttuva tuotantomalli ja sovitut Visma Net API -kutsut. Jokainen tehdas käyttää Visma Netiä omalla tavallaan, ja tämä käytännön tuntemus hyödynnetään määrityksissä.
- Visma Net -kumppanisi voi osallistua. Visma toimittaa Visma Netin yhdessä Visman sertifioimien kumppanien kanssa. Ne tuntevat ympäristösi ja voivat tarkistaa tietovastaavuudet sekä Visma Connect -sovelluksen. SkyPlanner tarjoaa REST API -rajapinnan, Swagger/OpenAPI-dokumentaation ja webhookit.
- Omat kehittäjänne voivat toteuttaa integraation samalla dokumentoidulla REST API -rajapinnalla ja API-tokenilla. Alkuun pääsee pelkällä API-tokenilla, ja SkyPlanner-tiimi auttaa tarvittaessa. Julkiset ohjeet löytyvät SkyPlannerin dokumentaatiosta.
Kun yhteys on käytössä, Arcturus-moottori suunnittelee työt Visma Netin ajantasaisten tilausten perusteella. Valmistuneet työt palautuvat Visma Netiin vapautettuina Kit assemblies -dokumentteina. Hinta on alkaen 199 € kuukaudessa ja sisältää 5 työpistettä. Laskutus on kuukausittainen. Saat etukäteen tarjouksen prosessisi ja tarpeidesi mukaisesta integraatiosta sekä tilauksestasi, joten näet kokonaiskustannukset ennen aloittamista.
Tutustu hinnoitteluun ja lue Visma Netin hienokuormitusta käsittelevästä artikkelista, miksi Visma Net tarvitsee tuotannonsuunnitteluohjelmiston. Yleiskuvan löydät Visma Net -sivulta ja muut ERP-järjestelmät ERP-integraatioiden koontisivulta.
Valmistavan teollisuuden kokemuksia SkyPlannerista
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 siirtyy tuotantolinjalle sekunneissa.
+90 %tuotannon tehokkuutta
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkkeiden valmistus
Tuotannon tehokkuus on kasvanut 90 %, ja kaikkien työpisteiden optimoidun suunnitelman laatiminen kolmeksi kuukaudeksi vie alle 30 minuuttia.
98 %toimitusvarmuus, aiemmin noin 50 %
”SkyPlannerilla on ratkaiseva rooli toimitusvarmuutemme ylläpitämisessä.”
Hannu Lahtinen, toimitusjohtaja
KJH-Comp · Ohutlevymekaniikka ja sopimusvalmistus
Toimitusvarmuus nousi noin 50 %:sta parhaimmillaan 98 %:iin, ja tuotannonsuunnitteluun tarvitaan nyt yksi työnjohtaja kahden sijaan.
6 kuukauttavapaata kapasiteettia myynnin nähtävissä
”SkyPlanner luo luotettavan perustan kaikelle tuotannonsuunnittelulle.”
Anu Järvinen, tuotantopäällikkö
Fredman Operations · Elintarvikekelpoiset pakkauspaperit
Myynti näkee vapaan kapasiteetin kuusi kuukautta eteenpäin. Aikataulumuutospyyntöihin vastataan sekunneissa, kun aiemmin vastaamiseen kului tunti tai enemmän.
Usein kysytyt kysymykset
Onko Visma Netin API-rajapinnassa tuotantotilauksia?
Ei. Visma Netissä ei ole tuotantotilaus-, reititys- eikä työpisteobjekteja, joten niitä ei ole myöskään API-rajapinnassa. Tuotannon dokumenttina toimii Kit assembly päätepisteessä /v1/kitassembly, ja reitityksiä sekä työpisteitä ylläpidetään SkyPlannerissa.
Mitä todennusta integraatio käyttää?
Integraatio käyttää Visma Connectia ja OAuth 2.0 client credentials -todennusta, ja se rekisteröidään Service Integration -tyyppisenä Visma Developer Portalissa. Vuokraajan pääkäyttäjä hyväksyy integraation, ja tokenit ovat voimassa yhden tunnin.
Voiko Visma Net lähettää muutokset reaaliajassa?
Nimikkeiden, myyntitilausten ja ostotilausten osalta kyllä, Visma Developer Portalin webhookien kautta. Kit assemblies- ja Kit specifications -objekteilla ei ole tapahtumailmoituksia, joten niiden muutokset haetaan inkrementaalisilla kyselyillä. SkyPlannerin omat webhookit lähettävät suunnitelman muutokset heti niiden tapahtuessa.
Miten valmistunut tuotanto kirjataan takaisin Visma Netiin?
SkyPlanner luo jokaiselle suunnitellulle työlle Kit assembly -dokumentin, pitää sen päivämäärän ajan tasalla ja kutsuu release-toimintoa työn valmistuttua. Vapautus kirjaa valmistuneen tuotannon ja komponenttien kulutuksen. Ilman kittejä sama tehdään Inventory receipt- ja Inventory issue -toiminnoilla.
Voimmeko testata SkyPlanneria ennen integraation rakentamista?
Kyllä. Maksuton 30 päivän kokeilu tukee enintään 20 työpistettä, ja tiedot voi tuoda Visma Netistä CSV- tai Excel-muodossa. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
