Integracijos / ERP / Visma Net ERP
Visma Net integravimo vadovas: gamybos tvarkaraščių sudarymas su SkyPlanner APS
Šiame Visma Net integravimo vadove partneriams ir IT komandoms paaiškinama, kaip susieti Visma Net (Visma.net ERP) su SkyPlanner APS. SkyPlanner keičiasi duomenimis su Visma Net abiem kryptimis per Visma Net API:
- Į SkyPlanner perduodamos sandėliuojamos prekės, Kit specifications, pardavimo užsakymai, atsargų likučiai ir pirkimo užsakymai.
- Suplanuotos užduotys tampa Kit assemblies dokumentais, kurie registruojami apskaitoje užbaigus darbą.
- Operatorių darbo valandos grąžinamos kaip Employee time cards.
- SkyPlanner per webhook sąsajas iškart perduoda tvarkaraščio pakeitimus.
Diegdama sistemą SkyPlanner komanda pritaiko integraciją prie jūsų Visma Net konfigūracijos ir teikia palaikymą pradėjus ją naudoti. Šis vadovas skirtas partneriams ir programuotojams, norintiems prisidėti prie integravimo arba savarankiškai kurti sprendimus naudojant dokumentuotą SkyPlanner REST API (API dokumentacija).
Visma Net integravimo sąsajos
- Visma Net ERP API. REST sąsaja su OpenAPI specifikacija, kuri vis dar vadinama „Visma.net ERP API v1“ ir apima v1 bei v2 kelius. Bazinis URL yra
https://api.finance.visma.net. Nuo 2026 m. vasario 1 d. senojo domenointegration.visma.netužklausų srautas ribojamas, o pats domenas išjungiamas (pranešimas). - SalesOrder service v3 pasiekiama adresu
https://salesorder.visma.net. Pardavimo užsakymų v1 ir v2 galinių taškų palaikymas nutrauktas. - Įvykių pranešimai per Visma Developer Portal.
- Background API. Antraštė
erp-api-backgroundleidžia ilgas užklausas įtraukti į eilę. Grąžinamas kodas 202 su užduoties ID, o paruošus rezultatą siunčiamas pranešimas. - Importavimo ir eksportavimo scenarijai Visma Net sistemoje su CSV, Excel arba SQL duomenų teikėjais, skirti vienkartiniam pagrindinių duomenų įkėlimui.
API neturi gamybos užsakymų, technologinių maršrutų ar darbo centrų galinių taškų, nes tokių objektų Visma Net nėra. Duomenys tvarkaraščiui sudaryti gaunami iš prekių, rinkinių, užsakymų ir atsargų:
GET /v1/inventory: sandėliuojamos ir nesandėliuojamos prekės, įskaitant rinkinio požymį ir prekės klasęGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: konkrečios versijos komponentų eilutėsGET /v1/kitassembly: esami surinkimo dokumentai, kuriuos galima filtruoti pagal tipą ir būseną- SalesOrder service v3: paklausos duomenys – pageidaujamos datos ir užsakymų eilutės
GET /v1/inventorysummary/{inventoryNumber}: turimi ir prieinami kiekiai pagal sandėlįGET /v1/purchaseorderirGET /v2/PurchaseReceipt: atvykstančios medžiagos ir jų gavimo dokumentai
Visi sąrašų galiniai taškai priima lastModifiedDateTime su lastModifiedDateTimeCondition, taip pat pageNumber ir pageSize, todėl kaskart sinchronizuojant galima perduoti tik pokyčius.
Autentifikavimas ir ribojimai
Visma Net naudoja Visma Connect (OpenID Connect ir OAuth 2.0):
- Visma Developer Portal užregistruokite Service Integration.
- Integraciją patvirtina kliento Visma Net aplinkos administratorius.
- Prieigos žetonų prašykite taikydami kliento kredencialų srautą adresu
https://connect.visma.com/connect/token. Perduokitetenant_idir API prieigos sritis, pavyzdžiui,visma_api:read. Žetonai galioja 3 600 sekundžių.
Užklausų dažnio limitai taikomi kiekvienai įmonės ir kliento porai pagal fiksuotą valandos intervalą. Atsakymuose pateikiamos antraštės X-RateLimit-Limit, X-RateLimit-Remaining ir X-RateLimit-Reset. Viršijus limitą grąžinamas kodas 429 su Retry-After (užklausų dažnio limitai). ETag ir If-Match antraštės apsaugo duomenų atnaujinimus.
Partneriai testuoja demonstracinės įmonės aplinkoje naudodamiesi nemokama Visma Integrator Programme. SkyPlanner REST API autentifikavimui naudojamas API žetonas (SkyPlanner Settings > API), o dokumentacija pateikiama Swagger/OpenAPI formatu. Integravimo pamokoje nuosekliai paaiškinamos pirmosios užklausos.
Įvykiai, jų pranešimai ir periodinės užklausos
Visma Developer Portal įvykių pranešimai apima tvarkaraščių sudarymui svarbius įvykius:
- Inventory Item Created, Updated ir Changed
- Purchase Order Changed ir Status Changed
- Sales Order Changed ir Status Changed, kurių skelbimas perkeliamas į SalesOrderService
Kit assembly ir Kit specifications įvykių nėra. SkyPlanner periodiškai užklausia šių duomenų naudodama lastModifiedDateTime filtrus. Atsargų likučiai užklausiami sudarant tvarkaraštį. Priešinga kryptimi SkyPlanner siunčia įvykių pranešimus, kai pasikeičia būsena arba tvarkaraštis.
Duomenų susiejimas
| Visma Net objektas (galinis taškas) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
Stock items, Non-stock items (/v1/inventory) | Gaminiai ir medžiagos | Visma Net → SkyPlanner | Pradinis įkėlimas, vėliau – įvykių pranešimai |
Kit specifications (/v1/KitSpecifications) | Gaminio struktūra, kiekvienam gaminiui reikalingos medžiagos | Visma Net → SkyPlanner | Pradinis įkėlimas, vėliau – periodinės užklausos |
| Pardavimo užsakymai (SalesOrder service v3) | Užsakymai su įvykdymo terminais ir kliento prioritetu | Visma Net → SkyPlanner | Įvykio pranešimas |
Kit assembly, kurio būsena On hold (/v1/kitassembly), jei surinkimo dokumentai kuriami Visma Net sistemoje | Užduotys | Visma Net → SkyPlanner | Periodinės užklausos |
Inventory summary (/v1/inventorysummary) | Atsargų likučiai pagal sandėlį | Visma Net → SkyPlanner | Užklausiama sudarant tvarkaraštį |
Pirkimo užsakymai ir gavimo dokumentai (/v1/purchaseorder, /v2/PurchaseReceipt) | Atvykstančios medžiagos su pristatymo data; atsargos atnaujinamos pristačius pagal pirkimo užsakymą užsakytas medžiagas | Visma Net → SkyPlanner | Įvykio pranešimas, po jo – duomenų nuskaitymas |
| Visma Net sistemoje nėra | Proceso etapai, darbo centrai, pamainos, paruošimo laikų matrica, įrankiai, alternatyvūs ištekliai | Tvarkoma SkyPlanner sistemoje | Konfigūruojama diegimo metu |
Kit assembly kūrimas ir atnaujinimas (POST/PUT /v1/kitassembly) | Suplanuota užduotis: rinkinio prekė, kiekis, planuojama pabaigos data | SkyPlanner → Visma Net | Pasikeitus tvarkaraščiui, per SkyPlanner įvykio pranešimą |
Kit assembly registravimas apskaitoje (/v1/kitassembly/{type}/{refNo}/action/release) | Užbaigta užduotis: pagaminta produkcija ir sunaudoti komponentai | SkyPlanner → Visma Net | Užbaigus užduotį |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, registravimas apskaitoje) | Pagaminta produkcija ir sunaudotos medžiagos, kai rinkiniai nenaudojami | SkyPlanner → Visma Net | Užbaigus užduotį |
Employee time card (/v1/timeCard) | Kiekvieno operatoriaus užregistruotos darbo valandos | SkyPlanner → Visma Net | Kas savaitę |
Integravimo modeliai
1. Pradinis pagrindinių duomenų įkėlimas. Nuskaitykite sandėliuojamas prekes, prekių klases ir naujausią kiekvieno rinkinio Kit specification versiją. Kiekvieną komponento eilutę susiekite su SkyPlanner medžiaga. Tada parenkite duomenis, kurių Visma Net nesaugo: darbo centrus, pamainas, proceso etapus su paruošimo ir vykdymo trukmėmis, paruošimo laikų matricą ir įrankių reikalavimus. Importuokite juos CSV arba Excel formatu. Tai didžiausia projekto dalis.
2. Užsakymų sinchronizavimas. Pasirinkite vieną paklausos modelį:
- Pagal pardavimo užsakymus. Atviros pardavimo užsakymų eilutės su rinkinių prekėmis tampa SkyPlanner užsakymais, kurių įvykdymo terminas yra pageidaujama data.
- Pagal surinkimo dokumentus. Visma Net sistemoje sukurti Kit assemblies dokumentai, kurių būsena On hold, tampa SkyPlanner užduotimis.
Atviri pirkimo užsakymai perduodami kartu su jų datomis. SkyPlanner laiko užsakytas medžiagas prieinamomis nuo pirkimo užsakymo pristatymo datos, o atsargas atnaujina, kai užsakymui priskiriama būsena Delivered. Sudarant tvarkaraštį šie duomenys naudojami kartu su atsargų suvestine, kad būtų patikrinti ir turimi likučiai, ir numatomi pirkimai.
3. Tvarkaraščio duomenų įrašymas į Visma Net. Kai taikomas pardavimo užsakymais pagrįstas modelis, SkyPlanner kiekvienai suplanuotai užduočiai sukuria Production tipo Kit assembly dokumentą. Jame nustato rinkinio prekę, versiją, sandėlį, kiekį bei komponentus ir susieja dokumentą su pardavimo užsakymo eilute. Surinkimo dokumento data yra planuojama užduoties pabaiga. Kai Autopilot perkelia užduotį, PUT užklausa atnaujina datą prieš registruojant dokumentą apskaitoje.
Kit assembly turi vieną Date lauką, todėl atskirų operacijų laikai lieka SkyPlanner sistemoje, o į Visma Net perduodama pardavimams ir atsargoms svarbi data.
4. Darbų patvirtinimas gamyboje. Operatoriai registruoja darbą naudodami Mobile Confirmations arba Production Timer, o pagal laiko įrašus tvarkaraštis nuolat atnaujinamas. Užbaigus paskutinį etapą, SkyPlanner iškviečia Kit assembly registravimo apskaitoje veiksmą. Taip apskaitoje užregistruojama pagaminta produkcija ir sunaudoti komponentai, o po to suformuojamas didžiosios knygos įrašų paketas. Darbo valandos sumuojamos į savaitines Employee time cards, o vykdant projektinius darbus – į projektų operacijas.
5. Atsakomybės už duomenis ir konfliktų sprendimo taisyklės. Užrašykite jas prieš pradėdami eksploatuoti integraciją:
| Duomenys | Atsakinga sistema |
|---|---|
| Prekės, Kit specifications, pardavimo užsakymai, pirkimo užsakymai, atsargų likučiai, savikaina | Visma Net |
| Proceso etapai, darbo centrai, pamainos, paruošimo darbai, įrankiai | SkyPlanner |
| Užduočių seka, pradžios ir pabaigos laikas, priskyrimas darbo centrams | SkyPlanner |
| Kit assembly data prieš registruojant dokumentą apskaitoje | SkyPlanner |
| Apskaitoje užregistruoti Kit assemblies ir darbo laiko apskaitos kortelės | Visma Net, registruojama iš SkyPlanner |
Pakeitus Kit specification sukuriama nauja versija. Iš naujo nuskaitykite naujausią versiją ir atnaujinkite duomenų susiejimą, nes gamybai galima naudoti tik paskutinę versiją. Rankiniu būdu pakeisti surinkimo dokumento komponentai lieka galioti Visma Net sistemoje, todėl prieš registruodama dokumentą apskaitoje SkyPlanner jį nuskaito dar kartą.
Įprasti projekto etapai
Diegimas paprastai baigiamas per kelias savaites nuo įvadinių darbų pradžios. Prieš tai per 30 dienų nemokamą bandomąjį laikotarpį naudojami jūsų duomenys, eksportuoti pagal Visma Net eksporto scenarijų ir importuoti CSV arba Excel formatu.
- Apimties apibrėžimas. Nustatykite paklausos modelį, duomenų susiejimo lentelę, atsakomybės už duomenis taisykles ir objektus, į kuriuos bus įrašomi grąžinami duomenys (Kit assembly arba atsargų pajamavimo dokumentus).
- Visma Connect konfigūravimas. Užregistruokite Service Integration ir gaukite kliento aplinkos administratoriaus patvirtinimą. Pirmiausia išbandykite demonstracinėje įmonėje.
- Gamybos modelis. Darbo centrai, pamainos, proceso etapai, paruošimo darbai ir įrankiai SkyPlanner sistemoje.
- Pradinis duomenų įkėlimas. Sandėliuojamos prekės, prekių klasės, Kit specifications, sandėliai, atsargų likučiai.
- Pardavimo ir pirkimo užsakymų sinchronizavimas. Pardavimo užsakymams, pirkimo užsakymams ir prekėms naudojami įvykių pranešimai, o rinkinių ir atsargų duomenys periodiškai nuskaitomi užklausomis. Šiame etape taip pat pasirūpinama prieigos žetonų atnaujinimu ir 429 atsakymų apdorojimu.
- Duomenų grąžinimas. Kit assembly kūrimas, atnaujinimas ir registravimas apskaitoje, taip pat darbo laiko apskaitos kortelės.
- Lygiagretus testavimas. Naudokite SkyPlanner lygiagrečiai su esamu planu ir palyginkite datas.
- Eksploatacijos pradžia. Kai duomenys sutampa, įjunkite duomenų grąžinimą.
Į ką atsižvelgti planuojant Visma Net integraciją
- Nėra technologinių maršrutų, kuriuos būtų galima importuoti. Visi proceso etapai, paruošimo ir vykdymo trukmės nustatomi SkyPlanner sistemoje. Įvertinkite darbų apimtį ir paskirkite atsakingą asmenį.
- Advanced logistics. Norint naudoti Kit assembly, reikia Advanced logistics grupės. Naudojant Standard logistics, produkciją registruokite per Inventory receipt ir Inventory issue.
- Užrakintos redakcijos. Panaudotos Kit specification redakcijos redaguoti negalima, o gamybai galima naudoti tik naujausią redakciją.
- Matavimo vienetai. Kit assembly turi savo matavimo vienetą. Importuodami suderinkite jį su SkyPlanner kiekiais.
- Periodinės užklausos, kai nėra įvykių. Rinkiniams webhooks pranešimai nenumatyti. Kad neviršytumėte valandinio užklausų limito, pagal
lastModifiedDateTimenuskaitykite tik pakeitimus, o ne visus duomenis iš naujo. - Aktualūs API adresai. Integraciją kurkite tik naudodami
api.finance.visma.netir SalesOrder service v3. - Kliento aplinkos administratoriaus patvirtinimas. Autentifikavimas kliento kredencialais neveiks, kol kliento aplinkos administratorius nepatvirtins programos. Šį žingsnį suplanuokite iš anksto.
- Savaitinės darbo laiko apskaitos kortelės. Joms reikia Advanced financials, o apskaitos laikotarpis yra savaitė. Sumuokite operatorių darbo valandas pagal savaites arba registruokite jas kaip projektų operacijas.
Kas konfigūruoja ir prižiūri Visma Net integraciją
- SkyPlanner komanda sukonfigūruoja integraciją pradiniame diegimo etape ir teikia pagalbą pradėjus ją eksploatuoti. Tai apima SkyPlanner dalį, gamybos modelį, kurio nėra Visma Net, ir sutartus Visma Net API kvietimus. Kiekviena gamykla Visma Net naudoja savaip, todėl čia pritaikomos žinios apie jos darbo specifiką.
- Gali dalyvauti ir jūsų Visma Net partneris. Visma tiekia Visma Net kartu su Visma sertifikuotais partneriais, kurie išmano jūsų konfigūraciją ir gali peržiūrėti duomenų susiejimą bei Visma Connect programą. SkyPlanner suteikia REST API, Swagger/OpenAPI dokumentaciją ir webhooks pranešimus.
- Integraciją gali sukurti jūsų programuotojai, naudodami tą pačią dokumentuotą REST API ir API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Viešą dokumentaciją rasite SkyPlanner dokumentacijoje.
Sujungus sistemas, Arcturus variklis sudaro tvarkaraščius pagal aktualius Visma Net užsakymus, o atlikti darbai grąžinami į Visma Net kaip patvirtinti Kit assemblies. Kaina prasideda nuo 199 € per mėnesį, į ją įtraukti 5 darbo centrai, atsiskaitoma kas mėnesį. Integracijos kaina pagal jūsų procesą ir poreikius pateikiama iš anksto kartu su pasirinkto plano kaina, todėl visas išlaidas žinote dar prieš pradėdami.
Peržiūrėkite kainas, sužinokite, kodėl Visma Net reikia tvarkaraščių sudarymo įrankio, puslapyje Visma Net gamybos planavimas pagal realius įrenginių ir darbuotojų pajėgumus, skaitykite apžvalgą Visma Net puslapyje ir susipažinkite su kitomis ERP sistemomis ERP integracijų skiltyje.
Gamintojų atsiliepimai apie SkyPlanner
2 hsutaupoma kas savaitę
„Su SkyPlanner nuo gamybos planavimo Excel lentelėse perėjome prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros skydai ir skirstomieji įrenginiai
Planuojant gamybą kas savaitę sutaupoma 2 valandos darbo laiko, o nauja darbų eilė gamybos liniją pasiekia per kelias sekundes.
+90%gamybos efektyvumas
„Gamybos efektyvumas padidėjo 90%.“
Abdul Rucyinga, IT vadovas
Laboratory & Allied · Vaistų gamyba
Gamybos efektyvumas padidėjo 90%, o optimizuotas trijų mėnesių planas visiems darbo centrams sudaromas per mažiau nei 30 minučių.
98%pristatymo patikimumas, padidėjęs nuo maždaug 50%
„SkyPlanner atlieka lemiamą vaidmenį išlaikant mūsų pristatymo patikimumą.“
Hannu Lahtinen, generalinis direktorius
KJH-Comp · Lakštinio metalo gaminiai ir užsakomoji gamyba
Pristatymo patikimumas išaugo nuo maždaug 50% iki net 98%, o tvarkaraščiams sudaryti dabar pakanka vieno meistro vietoj dviejų.
6 mėnesiamsį priekį pardavimo komanda mato laisvus pajėgumus
„SkyPlanner suteikia pagrindą visam gamybos planavimui ir užtikrina jo patikimumą.“
Anu Järvinen, gamybos vadovė
Fredman Operations · Maistui pakuoti tinkamas popierius
Pardavimo komanda mato laisvus pajėgumus šešiems mėnesiams į priekį, o į prašymus pakeisti tvarkaraštį, kuriems anksčiau reikėdavo valandos ar daugiau, dabar atsakoma per kelias sekundes.
Dažniausiai užduodami klausimai
Ar Visma Net API turi gamybos užsakymų objektus?
Ne. Visma Net nėra gamybos užsakymų, technologinių maršrutų ar darbo centrų objektų, todėl jų nėra ir API. Gamybos dokumentas yra Kit assembly, pasiekiamas adresu /v1/kitassembly, o technologiniai maršrutai ir darbo centrai saugomi SkyPlanner sistemoje.
Koks autentifikavimas naudojamas integracijoje?
Naudojama Visma Connect su OAuth 2.0 client credentials eiga. Integracija registruojama kaip Service Integration portale Visma Developer Portal. Ją patvirtina kliento aplinkos administratorius, o prieigos raktai galioja vieną valandą.
Ar Visma Net gali siųsti pakeitimus realiuoju laiku?
Taip, prekių, pardavimo užsakymų ir pirkimo užsakymų pakeitimus galima gauti per Visma Developer Portal webhooks pranešimus. Kit assemblies ir Kit specifications įvykių neturi, todėl jų pakeitimai nuskaitomi periodinėmis užklausomis, gaunant tik pasikeitusius duomenis. SkyPlanner savo webhooks pranešimais perduoda tvarkaraščio pakeitimus vos jiems įvykus.
Kaip duomenys apie pagamintą produkciją grąžinami į Visma Net?
Kiekvienai suplanuotai užduočiai SkyPlanner sukuria Kit assembly, nuolat atnaujina jo datą ir, užbaigus užduotį, iškviečia release veiksmą. Šis veiksmas užregistruoja pagamintą produkciją ir komponentų sunaudojimą. Kai rinkiniai nenaudojami, tą patį atlieka Inventory receipt ir Inventory issue.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti Visma Net duomenis CSV arba Excel formatu. Kredito kortelės nereikia. Išbandykite nemokamai arba susisiekite su pardavimo komanda, kad apibrėžtumėte integracijos apimtį.
