Liidestused / ERP / Visma Net ERP
Visma Neti integreerimise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See Visma Neti integreerimise juhend näitab partneritele ja IT-meeskondadele, kuidas ühendada Visma Net (Visma.net ERP) SkyPlanner APS-iga. SkyPlanner vahetab Visma Netiga andmeid mõlemas suunas Visma Net API kaudu:
- Sisse tuuakse laoartiklid, Kit specifications, müügitellimused, laoseisud ja ostutellimused.
- Ajakavasse lisatud töödest luuakse Kit assembly dokumendid, mis kinnitatakse töö valmimisel.
- Operaatorite töötunnid saadetakse tagasi Employee time card dokumentidena.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe, kui need toimuvad.
SkyPlanneri meeskond seadistab integratsiooni kasutuselevõtu käigus teie Visma Neti seadistuse järgi ja pakub tuge ka pärast käivitamist. Juhend on mõeldud partneritele ja arendajatele, kes soovivad selles osaleda või ise SkyPlanneri dokumenteeritud REST API abil lahendusi arendada (API viitedokumentatsioon).
Visma Neti integratsiooniliidesed
- Visma Net ERP API. REST-liides, mille OpenAPI spetsifikatsioon kannab endiselt nime “Visma.net ERP API v1” ning sisaldab v1 ja v2 teid. Baas-URL on
https://api.finance.visma.net. Vana domeeniintegration.visma.netläbilaskevõimet piiratakse alates 1. veebruarist 2026 ning domeen suletakse (teade). - SalesOrder service v3 aadressil
https://salesorder.visma.net. Müügitellimuste v1 ja v2 otspunktide elutsükkel on lõppenud. - Veebihaagid Visma Developer Portali kaudu.
- Background API. Päis
erp-api-backgroundsuunab pika kestusega päringud järjekorda, tagastab vastuse 202 koos töö ID-ga ja teavitab, kui tulemus on valmis. - Impordi- ja ekspordistsenaariumid Visma Netis võimaldavad põhiandmeid ühekordselt laadida CSV, Exceli või SQL-i andmeallikatest.
API-l puuduvad tootmistellimuste, tehnoloogiliste marsruutide ja töökeskuste otspunktid, sest Visma Netis selliseid objekte ei ole. Ajakava koostamiseks vajalikud andmed saadakse artiklitest, komplektidest, tellimustest ja laoseisudest:
GET /v1/inventory: lao- ja mittelaoartiklid, sealhulgas komplekti tunnus ja artikliklassGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: komponendiread versioonide kaupaGET /v1/kitassembly: olemasolevad koostedokumendid, mida saab filtreerida tüübi ja oleku järgi- SalesOrder service v3: nõudlus koos soovitud kuupäevade ja tellimusridadega
GET /v1/inventorysummary/{inventoryNumber}: laos olevad ja saadaolevad kogused ladude kaupaGET /v1/purchaseorderjaGET /v2/PurchaseReceipt: saabuv materjal ja vastuvõtud
Kõik loendiotspunktid toetavad parameetrit lastModifiedDateTime koos parameetriga lastModifiedDateTimeCondition ning parameetreid pageNumber ja pageSize. Nii saab igal sünkroonimisel üle kanda ainult muudatused.
Autentimine ja piirangud
Visma Net kasutab autentimiseks lahendust Visma Connect (OpenID Connect ja OAuth 2.0):
- Registreerige Visma Developer Portalis Service Integration.
- Integratsiooni kiidab heaks kliendi Visma Neti keskkonna administraator.
- Taotlege pääsutõendeid client credentials voo kaudu aadressilt
https://connect.visma.com/connect/token, edastadestenant_idja API juurdepääsuulatused, näiteksvisma_api:read. Pääsutõendid kehtivad 3 600 sekundit.
Päringupiirangud kehtivad ettevõtte ja kliendi kohta kindla tunnise ajavahemiku jooksul. Vastused sisaldavad päiseid X-RateLimit-Limit, X-RateLimit-Remaining ja X-RateLimit-Reset. Piirangu ületamisel tagastatakse 429 koos päisega Retry-After (päringupiirangud). Uuendusi kaitsevad ETag ja If-Match päised.
Partnerid saavad Visma tasuta Integrator Programme’i raames testida demoettevõttes. SkyPlanneri REST API kasutab autentimiseks API pääsutõendit (SkyPlanner Settings > API) ning on dokumenteeritud Swagger/OpenAPI vormingus. Integreerimise õpetus juhendab esimeste päringute tegemisel.
Sündmused, veebihaagid ja perioodilised päringud
Visma Developer Portali veebihaagid hõlmavad ajakava koostamiseks olulisi sündmusi:
- Inventory Item Created, Updated ja Changed
- Purchase Order Changed ja Status Changed
- Sales Order Changed ja Status Changed, mis viiakse üle avaldajale SalesOrderService
Kit assembly ja Kit specifications jaoks sündmusi ei ole. SkyPlanner pärib neid perioodiliselt lastModifiedDateTime filtritega. Laoseise päritakse ajakava koostamisel. Vastassuunas saadab SkyPlanner oleku või ajakava muutumisel veebihaake.
Andmete vastendamine
| Visma Neti objekt (otspunkt) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Laoartiklid, mittelaoartiklid (/v1/inventory) | Tooted ja materjalid | Visma Net → SkyPlanner | Esmane laadimine, seejärel veebihaak |
Kit specifications (/v1/KitSpecifications) | Toote struktuur, materjalid toodete kaupa | Visma Net → SkyPlanner | Esmane laadimine, seejärel perioodilised päringud |
| Müügitellimused (SalesOrder service v3) | Tellimused koos tähtaegade ja kliendi prioriteediga | Visma Net → SkyPlanner | Veebihaak |
Kit assembly olekus On hold (/v1/kitassembly), kui koostedokumendid luuakse Visma Netis | Tööd | Visma Net → SkyPlanner | Perioodilised päringud |
Laoseisu koondandmed (/v1/inventorysummary) | Laoseisud ladude kaupa | Visma Net → SkyPlanner | Päring ajakava koostamisel |
Ostutellimused, ostude vastuvõtud (/v1/purchaseorder, /v2/PurchaseReceipt) | Saabuv materjal koos tarnekuupäevaga; laoseis uueneb ostutellimuse tarnimisel | Visma Net → SkyPlanner | Veebihaak, seejärel andmete lugemine |
| Visma Netis puudub | Tööetapid, töökeskused, vahetused, seadistusaegade maatriks, tööriistad, alternatiivsed ressursid | Hallatakse SkyPlanneris | Seadistatakse kasutuselevõtu käigus |
Kit assembly loomine ja uuendamine (POST/PUT /v1/kitassembly) | Ajakavasse lisatud töö: komplektiartikkel, kogus, kavandatud lõppkuupäev | SkyPlanner → Visma Net | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
Kit assembly kinnitamine (/v1/kitassembly/{type}/{refNo}/action/release) | Lõpetatud töö: toodang ja komponentide kulu | SkyPlanner → Visma Net | Töö lõpetamisel |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, kinnitamine) | Toodang ja materjalikulu, kui komplekte ei kasutata | SkyPlanner → Visma Net | Töö lõpetamisel |
Employee time card (/v1/timeCard) | Registreeritud töötunnid operaatorite kaupa | SkyPlanner → Visma Net | Kord nädalas |
Integreerimismustrid
1. Põhiandmete esmane laadimine. Lugege sisse laoartiklid, artikliklassid ja iga komplekti uusim Kit specification versioon. Vastendage iga komponendirida SkyPlanneri materjaliga. Seejärel looge andmed, mida Visma Netis ei ole: töökeskused, vahetused, tööetapid koos seadistus- ja töötlusaegadega, seadistusaegade maatriks ning tööriistanõuded. Importige need CSV- või Exceli failina. See on projekti kõige mahukam osa.
2. Tellimuste sünkroonimine. Valige üks nõudlusmudel:
- Müügitellimustel põhinev. Komplektiartiklite avatud müügitellimusridadest luuakse SkyPlanneri tellimused, mille tähtajaks määratakse soovitud kuupäev.
- Koostedokumentidel põhinev. Visma Netis olekuga On hold loodud Kit assembly dokumentidest saavad SkyPlanneri tööd.
Avatud ostutellimused tuuakse sisse koos kuupäevadega. SkyPlanner loeb tellitud materjali kättesaadavaks ostutellimuse tarnekuupäeval ja uuendab laoseisu, kui ostutellimuse olekuks märgitakse Delivered. Koos laoseisu koondandmetega võimaldab see ajakava koostamisel kontrollida nii laos olevat kui ka saabuvat materjali.
3. Ajakava tagasikirjutamine. Müügitellimustel põhineva seadistuse korral loob SkyPlanner iga ajakavasse lisatud töö jaoks Kit assembly dokumendi tüübiga Production. SkyPlanner määrab komplektiartikli, versiooni, lao, koguse ja komponendid ning seob koostedokumendi müügitellimuse reaga. Koostedokumendi kuupäevaks saab kavandatud lõppkuupäev. Kui Autopilot töö ajakavas ümber tõstab, uuendatakse kuupäeva enne kinnitamist PUT-päringuga.
Kit assembly dokumendil on üks Date-väli, seega jäävad tööetappide ajad SkyPlannerisse ning Visma Net saab müügi ja lao jaoks olulise kuupäeva.
4. Tööde kinnitamine tootmises. Operaatorid registreerivad tööd Mobile Confirmationsi või Production Timeri abil ning ajakirjed hoiavad ajakava ajakohasena. Kui viimane etapp on valmis, käivitab SkyPlanner Kit assembly dokumendil kinnitamistoimingu. Kinnitamisel kirjendatakse toodang ja komponentide kulu ning seejärel luuakse pearaamatu kandepakett. Töötunnid koondatakse nädalapõhistesse Employee time card dokumentidesse või projektipõhise töö korral projektitehinguteks.
5. Vastutus andmete eest ja konfliktide lahendamise reeglid. Pange need enne kasutuselevõttu kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Kaubad, Kit specifications, müügitellimused, ostutellimused, laoseis, omahind | Visma Net |
| Tootmisetapid, töökeskused, vahetused, seadistused, tööriistad | SkyPlanner |
| Tööde järjekord, algus- ja lõpuajad, töökeskuste määramine | SkyPlanner |
| Kit assembly kuupäev enne kinnitamist | SkyPlanner |
| Kinnitatud Kit assemblies ja tööajatabelid | Visma Net, kanded SkyPlannerist |
Kit specification muutmisel tekib uus versioon. Lugege uusim versioon uuesti sisse ja tehke andmevastendused uuesti, sest tootmiseks saab kasutada ainult viimast versiooni. Koostedokumendi komponentides käsitsi tehtud muudatused jäävad Visma Netis kehtima, seega loeb SkyPlanner koostedokumendi enne kinnitamist uuesti sisse.
Projekti tavapärased etapid
Juurutamine saab tavaliselt valmis mõne nädala jooksul pärast kasutuselevõtuprotsessi algust. Enne seda saate 30-päevasel tasuta prooviperioodil kasutada oma andmeid, mis on Visma Neti ekspordistsenaariumiga välja võetud ja CSV- või Exceli failina imporditud.
- Ulatuse määramine. Leppige kokku nõudlusmudel, vastendustabel, vastutus andmete eest ja see, kuhu andmed tagasi kirjutatakse (Kit assembly või lao sissetulekud).
- Visma Connecti seadistamine. Registreerige Service Integration ja hankige rentniku administraatori heakskiit. Katsetage esmalt demoettevõttes.
- Tootmismudel. Töökeskused, vahetused, tootmisetapid, seadistused ja tööriistad SkyPlanneris.
- Esmane andmete laadimine. Laokaubad, kaubaklassid, Kit specifications, laod ja laoseis.
- Müügi- ja ostutellimuste sünkroonimine. Müügitellimuste, ostutellimuste ja kaupade jaoks kasutatakse veebihaake, komplektide ja laoseisu jaoks perioodilisi päringuid. Selles etapis lahendatakse ka tokenite uuendamine ja 429 vastuste käsitlemine.
- Tagasikirjutamine. Kit assembly loomine, uuendamine ja kinnitamine ning tööajatabelid.
- Paralleelne testimine. Kasutage SkyPlannerit senise plaani kõrval ja võrrelge kuupäevi.
- Kasutuselevõtt. Lülitage tagasikirjutamine sisse, kui andmed ühtivad.
Millega Visma Neti integratsioonis arvestada
- Imporditavaid tehnoloogilisi marsruute ei ole. Kõik tootmisetapid ning seadistus- ja tööajad luuakse SkyPlanneris. Planeerige selleks vajalik töömaht ja määrake vastutaja.
- Advanced logistics. Kit assembly kasutamiseks on vaja rühma Advanced logistics. Standard logistics puhul kajastage toodang dokumentidega Inventory receipt ja Inventory issue.
- Lukustatud versioonid. Kasutatud Kit specification versiooni ei saa muuta ja tootmiseks saab kasutada ainult uusimat versiooni.
- Mõõtühikud. Kit assembly dokumendil on oma mõõtühik. Viige see importimisel vastavusse SkyPlanneri kogustega.
- Perioodilised päringud sündmuste asemel. Komplektidel puuduvad veebihaagid. Et mitte ületada tunnist päringupiirangut, lugege
lastModifiedDateTimealusel sisse ainult muudatused, mitte kõiki andmeid uuesti. - Kehtivad lõpp-punktid. Kasutage arenduses ainult lõpp-punkti
api.finance.visma.netja teenust SalesOrder service v3. - Rentniku heakskiit. Kliendi identimisteabega autentimine ei toimi enne, kui rentniku administraator on rakenduse heaks kiitnud. Leppige selle etapi aeg varakult kokku.
- Nädalapõhised tööajatabelid. Tööajatabelid nõuavad paketti Advanced financials ja koostatakse nädala kaupa. Koondage operaatorite töötunnid nädalate lõikes või tehke kanded projektitehingutesse.
Kes Visma Neti integratsiooni seadistab ja toetab
- SkyPlanneri meeskond seadistab integratsiooni juurutamise käigus ja pakub tuge pärast kasutuselevõttu. See hõlmab integratsiooni SkyPlanneri osa, Visma Netis puuduvat tootmismudelit ja kokkulepitud Visma Neti API-kutseid. Iga tehas kasutab Visma Neti omal moel ning just seadistamisel rakendatakse neid teadmisi.
- Ka teie Visma Neti partner saab osaleda. Visma pakub Visma Neti koos Visma sertifitseeritud partneritega, kes tunnevad teie seadistust ning saavad andmevastendused ja Visma Connecti rakenduse üle vaadata. SkyPlanner pakub REST API liidest, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Integratsiooni võivad luua ka teie enda arendajad, kasutades sama dokumenteeritud REST API liidest ja API-tokenit. Alustamiseks piisab API-tokenist ning SkyPlanneri meeskond aitab vajaduse korral. Avaliku dokumentatsiooni leiate lehelt SkyPlanneri dokumentatsioon.
Pärast ühenduse loomist koostab Arcturus ajakava Visma Neti ajakohaste tellimuste põhjal ning valminud tööd jõuavad Visma Neti tagasi kinnitatud Kit assemblies kujul. Hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub kord kuus. Integratsiooni hinnapakkumine koostatakse teie protsessi ja vajaduste põhjal ette koos valitud paketiga, nii et kogukulu on teada juba enne alustamist.
Vaadake hindu ja lugege lehelt Visma Neti tootmise planeerimine, miks vajab Visma Net ajakava koostamise tööriista, mis arvestab masinate ja töötajate tegelikku võimekust. Ülevaate leiate Visma Neti lehelt ning teised ERP-süsteemid ERP-integratsioonide koondlehelt.
Tootmisettevõtete tagasiside SkyPlannerile
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.“
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja lülitusseadmed
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õlmiva optimeeritud plaani koostamine kolmeks kuuks võtab alla 30 minuti.
98%tarnekindlus, varem ligikaudu 50%
„SkyPlanneril on meie tarnekindluse hoidmisel otsustav roll.“
Hannu Lahtinen, tegevjuht
KJH-Comp · Lehtmetalli töötlemine ja lepinguline tootmine
Tarnekindlus tõusis ligikaudu 50% tasemelt koguni 98% tasemele ning ajakava koostamiseks on nüüd kahe töödejuhataja asemel vaja ühte.
6 kuudette näeb müügitiim vaba tootmisvõimsust
„SkyPlanner loob kogu tootmise planeerimisele kindla ja usaldusväärse aluse.“
Anu Järvinen, tootmisjuht
Fredman Operations · Toiduga kokkupuuteks sobivad pakkepaberid
Müügitiim näeb vaba tootmisvõimsust kuus kuud ette ning ajakava muutmise päringutele, millele vastamine võttis varem tunni või rohkem, vastatakse nüüd sekunditega.
Korduma kippuvad küsimused
Kas Visma Neti API-s on tootmistellimused?
Ei. Visma Netis puuduvad tootmistellimuste, tehnoloogiliste marsruutide ja töökeskuste objektid, seega pole neid ka API-s. Tootmisdokumendiks on Kit assembly lõpp-punktis /v1/kitassembly ning tehnoloogilisi marsruute ja töökeskusi hallatakse SkyPlanneris.
Millist autentimist integratsioon kasutab?
Integratsioon kasutab Visma Connecti ja OAuth 2.0 client credentials autentimisvoogu ning registreeritakse Visma Developer Portalis tüübiga Service Integration. Selle kiidab heaks rentniku administraator ning tokenid kehtivad ühe tunni.
Kas Visma Net saab muudatusi reaalajas edastada?
Kaupade, müügitellimuste ja ostutellimuste puhul küll, Visma Developer Portali veebihaakide kaudu. Kit assemblies ja Kit specifications ei väljasta sündmusi, mistõttu loetakse nende muudatused sisse perioodiliste muudatuspäringutega. SkyPlanneri enda veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
Kuidas valminud toodang Visma Neti tagasi kirjutatakse?
SkyPlanner loob iga ajakavasse planeeritud töö jaoks Kit assembly dokumendi, hoiab selle kuupäeva ajakohasena ja kutsub töö valmimisel välja toimingu release. See toiming teeb toodangu ja komponentide kulu kanded. Ilma komplektideta täidavad sama ülesannet Inventory receipt ja Inventory issue.
Kas saame SkyPlannerit enne integratsiooni loomist katsetada?
Jah. 30-päevasel tasuta prooviperioodil saate kasutada kuni 20 töökeskust ning importida Visma Netist andmeid CSV- või Exceli failidena. Krediitkaarti pole vaja. Alusta prooviperioodi või võta ühendust müügiga, et määrata integratsiooni ulatus.
