Integrációk / ERP / Visma Net ERP
Visma Net integrációs útmutató a SkyPlanner APS-sel végzett gyártásütemezéshez
Ez a Visma Net integrációs útmutató bemutatja a partnereknek és az informatikai csapatoknak, hogyan kapcsolható össze a Visma Net (Visma.net ERP) a SkyPlanner APS-sel. A SkyPlanner a Visma Net API-n keresztül kétirányú adatkapcsolatot biztosít a Visma Net rendszerrel:
- A SkyPlanner átveszi a raktári cikkeket, a Kit specifications adatait, a vevői rendeléseket, a készletszinteket és a beszerzési rendeléseket.
- Az ütemezett gyártási feladatokból Kit assembly bizonylatok készülnek, amelyeket a munka befejezésekor véglegesít a rendszer.
- A gépkezelők munkaórái Employee time card bizonylatokként kerülnek vissza.
- A SkyPlanner webhookjai azonnal továbbítják az ütemterv változásait.
A SkyPlanner csapata a bevezetés során az Ön Visma Net-konfigurációjához igazítja az integrációt, és az éles indulás után is támogatást nyújt hozzá. Ez az útmutató azoknak a partnereknek és fejlesztőknek szól, akik részt szeretnének venni ebben, vagy maguk fejlesztenének a SkyPlanner dokumentált REST API-jára építve (API-referencia).
A Visma Net integrációs interfészei
- Visma Net ERP API. REST-alapú interfész, amelynek OpenAPI-specifikációja továbbra is „Visma.net ERP API v1” néven szerepel, v1 és v2 útvonalakkal. Az alap-URL:
https://api.finance.visma.net. A régiintegration.visma.netdomain forgalmát 2026. február 1-től korlátozzák, és a domaint kivezetik (közlemény). - SalesOrder service v3, elérhetősége:
https://salesorder.visma.net. A vevői rendelések v1 és v2 végpontjai elérték életciklusuk végét. - Webhookok a Visma Developer Portal felületén keresztül.
- Background API. Az
erp-api-backgroundfejléc használatával a hosszú hívások várólistára kerülnek. A válasz 202-es kódot és feladatazonosítót tartalmaz, az eredmény elkészültéről pedig értesítés érkezik. - Importálási és exportálási forgatókönyvek a Visma Net rendszerben, CSV-, Excel- vagy SQL-adatszolgáltatókkal, a törzsadatok egyszeri betöltéséhez.
Az API-ban nincs végpont gyártási rendelésekhez, technológiai útvonalakhoz vagy munkaállomásokhoz, mert a Visma Net nem tartalmaz ilyen objektumokat. Az ütemezéshez szükséges adatok a cikkekből, a kitekből, a rendelésekből és a raktárkészletből származnak:
GET /v1/inventory: raktári és nem raktári cikkek, beleértve a kitként való megjelölést és a cikkosztálytGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: komponenssorok verziónkéntGET /v1/kitassembly: meglévő összeszerelési bizonylatok, típus és állapot szerint szűrhetők- SalesOrder service v3: igények a kért dátumokkal és rendelési sorokkal
GET /v1/inventorysummary/{inventoryNumber}: tényleges és szabad készlet raktárankéntGET /v1/purchaseorderésGET /v2/PurchaseReceipt: beérkező anyagok és bevételezések
Minden listázó végpont fogadja a lastModifiedDateTime paramétert a lastModifiedDateTimeCondition feltétellel, valamint a pageNumber és a pageSize paramétereket, így minden szinkronizálás lehet növekményes.
Hitelesítés és korlátok
A Visma Net a Visma Connect szolgáltatást használja (OpenID Connect és OAuth 2.0):
- Regisztráljon egy Service Integration típusú integrációt a Visma Developer Portal felületén.
- Az integrációt az ügyfél Visma Net-környezetének bérlői rendszergazdája hagyja jóvá.
- Kérjen tokeneket a client credentials folyamattal a
https://connect.visma.com/connect/tokencímen, atenant_idés az API-jogosultsági körök, például avisma_api:readmegadásával. A tokenek 3 600 másodpercig érvényesek.
A hívási korlátok vállalatonként és kliensenként rögzített, egyórás időablakra vonatkoznak. A válaszok tartalmazzák az X-RateLimit-Limit, az X-RateLimit-Remaining és az X-RateLimit-Reset fejlécet. A korlát túllépésekor 429-es válasz érkezik Retry-After fejléccel (hívási korlátok). A frissítéseket az ETag és az If-Match fejléc védi.
A partnerek a Visma ingyenes Integrator Programme programján keresztül egy demóvállalatban tesztelhetnek. A SkyPlanner oldalán a REST API API-tokennel hitelesít (SkyPlanner Settings > API), dokumentációja pedig Swagger/OpenAPI formátumú. Az integrációs oktatóanyag végigvezeti az első hívásokon.
Események, webhookok és időszakos lekérdezés
A Visma Developer Portal webhookjai lefedik az ütemezés szempontjából fontos eseményeket:
- Inventory Item Created, Updated és Changed
- Purchase Order Changed és Status Changed
- Sales Order Changed és Status Changed, amelyek átkerülnek a SalesOrderService közzétevőhöz
A Kit assembly és a Kit specifications objektumokhoz nincsenek események. Ezeket a SkyPlanner időszakosan kérdezi le, lastModifiedDateTime szűrőkkel. A készletegyenlegeket az ütemezés futtatásakor kérdezi le. A másik irányban a SkyPlanner webhookokat küld, ha változik az állapot vagy az ütemterv.
Adatmegfeleltetés
| Visma Net-objektum (végpont) | SkyPlanner-objektum | Irány | Gyakoriság |
|---|---|---|---|
Raktári és nem raktári cikkek (/v1/inventory) | Termékek és anyagok | Visma Net → SkyPlanner | Kezdeti betöltés, majd webhook |
Kit specifications (/v1/KitSpecifications) | Termékstruktúra, termékenkénti anyagok | Visma Net → SkyPlanner | Kezdeti betöltés, majd időszakos lekérdezés |
| Vevői rendelések (SalesOrder service v3) | Rendelések határidőkkel és ügyfélprioritással | Visma Net → SkyPlanner | Webhook |
Kit assembly, On hold állapotban (/v1/kitassembly), ha az összeszerelési bizonylatokat a Visma Net rendszerben hozzák létre | Gyártási feladatok | Visma Net → SkyPlanner | Időszakos lekérdezés |
Készletösszesítő (/v1/inventorysummary) | Készletegyenlegek raktáranként | Visma Net → SkyPlanner | Lekérdezés az ütemezés futtatásakor |
Beszerzési rendelések, beszerzési bevételezések (/v1/purchaseorder, /v2/PurchaseReceipt) | Beérkező anyagok szállítási dátummal; a készlet frissül a megrendelt anyag leszállításakor | Visma Net → SkyPlanner | Webhook, majd lekérdezés |
| Nincs a Visma Net rendszerben | Műveletek, munkaállomások, műszakok, átállásiidő-mátrix, szerszámok, alternatív erőforrások | Karbantartás a SkyPlanner rendszerben | Beállítás a bevezetés során |
Kit assembly létrehozása és frissítése (POST/PUT /v1/kitassembly) | Ütemezett gyártási feladat: kit típusú cikk, mennyiség, tervezett befejezési dátum | SkyPlanner → Visma Net | Az ütemterv változásakor, SkyPlanner-webhookon keresztül |
Kit assembly véglegesítése (/v1/kitassembly/{type}/{refNo}/action/release) | Befejezett gyártási feladat: gyártott mennyiség és komponensfelhasználás | SkyPlanner → Visma Net | Befejezéskor |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, véglegesítés) | Gyártott mennyiség és anyagfelhasználás, ha nem használnak kiteket | SkyPlanner → Visma Net | Befejezéskor |
Employee time card (/v1/timeCard) | Rögzített munkaórák gépkezelőnként | SkyPlanner → Visma Net | Hetente |
Integrációs minták
1. A törzsadatok kezdeti betöltése. Kérdezze le a raktári cikkeket, a cikkosztályokat és minden kit típusú cikk legfrissebb Kit specification verzióját. Minden komponenssort feleltessen meg egy SkyPlanner-anyagnak. Ezután hozza létre azt, amit a Visma Net nem tárol: a munkaállomásokat, a műszakokat, az előkészítési és megmunkálási időkkel ellátott műveleteket, az átállásiidő-mátrixot és a szerszámigényeket. Importálja őket CSV- vagy Excel-fájlból. Ez a projekt legnagyobb feladata.
2. Rendelések szinkronizálása. Válasszon egy igénymodellt:
- Vevői rendelés alapján. A kit típusú cikkek nyitott vevőirendelés-soraiból SkyPlanner-rendelések jönnek létre, amelyek határideje a kért dátum.
- Összeszerelési bizonylat alapján. A Visma Net rendszerben On hold állapotban létrehozott Kit assembly bizonylatokból SkyPlanner-gyártási feladatok jönnek létre.
A nyitott beszerzési rendelések a dátumaikkal együtt kerülnek át. A SkyPlanner a megrendelt anyagot a beszerzési rendelés szállítási dátumán tekinti elérhetőnek, és frissíti a készletet, amikor a rendelés Delivered állapotot kap. Az ütemezés a készletösszesítő adataival együtt így a raktárkészletet és a beérkező beszerzéseket is ellenőrzi.
3. Az ütemterv visszaírása. Vevői rendelésen alapuló konfigurációban a SkyPlanner minden ütemezett gyártási feladathoz létrehoz egy Production típusú Kit assembly bizonylatot. Beállítja a kit típusú cikket, a verziót, a raktárt, a mennyiséget és a komponenseket, majd a bizonylatot a vevői rendelés sorához kapcsolja. A bizonylat dátuma a tervezett befejezés dátuma. Amikor az Autopilot áthelyezi a gyártási feladatot, egy PUT hívás a véglegesítés előtt frissíti a dátumot.
A Kit assembly egyetlen Date mezőt tartalmaz, ezért a műveletszintű időpontok a SkyPlanner rendszerben maradnak, a Visma Net pedig az értékesítés és a készletkezelés szempontjából fontos dátumot kapja meg.
4. Üzemi visszajelentések. A gépkezelők a Mobile Confirmations vagy a Production Timer funkcióval rögzítik a munkát, az időbejegyzések pedig naprakészen tartják az ütemtervet. Az utolsó művelet befejezésekor a SkyPlanner meghívja a Kit assembly véglegesítési műveletét. A véglegesítés lekönyveli a gyártott mennyiséget és a komponensfelhasználást, majd létrejön a főkönyvi köteg. A munkaórák heti Employee time card bizonylatokba összesítve kerülnek át, projektalapú munka esetén pedig projekttranzakciókba.
5. Adatgazdák és ütközéskezelési szabályok. Rögzítse ezeket az éles indulás előtt:
| Adatok | Adatgazda |
|---|---|
| Cikkek, Kit specifications, vevői rendelések, beszerzési rendelések, készlet, költség | Visma Net |
| Műveletek, munkaállomások, műszakok, átállások, szerszámok | SkyPlanner |
| Gyártási feladatok sorrendje, kezdési és befejezési időpontok, munkaállomáshoz rendelés | SkyPlanner |
| A Kit assembly dátuma a véglegesítés előtt | SkyPlanner |
| Véglegesített Kit assemblies és munkaidő-kimutatások | Visma Net, a SkyPlannerből könyvelve |
A Kit specification módosításakor új revízió jön létre. Olvassa be újra a legfrissebb revíziót, és végezze el ismét az adatmegfeleltetést, mert gyártáshoz csak a legutolsó revízió használható. Az összeállításon kézzel végzett komponensmódosítások érvényben maradnak a Visma Net rendszerben, ezért a SkyPlanner a véglegesítés előtt visszaolvassa az összeállítást.
A projekt jellemző lépései
A bevezetés általában az indulásától számított néhány héten belül lezárul. Ezt megelőzően a 30 napos ingyenes próba során saját adataival dolgozhat: a Visma Net exportálási forgatókönyvével kinyert adatokat CSV- vagy Excel-fájlból importálhatja.
- Felmérés. Rögzítse az igénymodellt, az adatmegfeleltetési táblát, az adatgazdákra vonatkozó szabályokat és a visszaírás célját (Kit assembly vagy készletbevételezés).
- A Visma Connect beállítása. Regisztrálja a Service Integration szolgáltatást, és kérje a bérlő rendszergazdájának jóváhagyását. Először egy demócégben teszteljen.
- Gyártási modell. Munkaállomások, műszakok, műveletek, átállások és szerszámok beállítása a SkyPlannerben.
- Kezdeti adatbetöltés. Készletcikkek, cikkosztályok, Kit specifications, raktárak és készlet.
- Vevői és beszerzési rendelések szinkronizálása. Webhookok a vevői rendelésekhez, a beszerzési rendelésekhez és a cikkekhez; rendszeres lekérdezés a kitadatokhoz és a raktárkészlethez. A tokenek megújítását és a 429-es válaszok kezelését is ebben a lépésben kell megoldani.
- Visszaírás. Kit assembly létrehozása, frissítése és véglegesítése, valamint a munkaidő-kimutatások visszaírása.
- Párhuzamos tesztelés. Futtassa a SkyPlannert a jelenlegi terv mellett, és hasonlítsa össze a dátumokat.
- Éles indulás. Kapcsolja be a visszaírást, amint az adatok egyeznek.
Mire készüljön a Visma Net integrációjánál?
- Nincsenek importálható technológiai útvonalak. Minden műveletet, átállási és futási időt a SkyPlannerben kell létrehozni. Tervezze meg az ehhez szükséges munkát, és jelölje ki a felelősét.
- Advanced logistics. A Kit assembly használatához az Advanced logistics funkciócsoport szükséges. Standard logistics esetén az Inventory receipt és az Inventory issue segítségével könyvelje a gyártott mennyiséget.
- Zárolt revíziók. A Kit specification már használt revíziója nem szerkeszthető, és gyártáshoz csak a legfrissebb revízió használható.
- Mértékegységek. A Kit assembly saját mértékegységgel rendelkezik. Importáláskor hangolja ezt össze a SkyPlannerben használt mennyiségekkel.
- Lekérdezés események nélkül. A kit összeállításokhoz nincsenek webhookok. A teljes adathalmaz újratöltése helyett a
lastModifiedDateTimealapján kérdezze le a változásokat, hogy ne lépje túl az óránkénti híváskorlátot. - Aktuális végpontok. Kizárólag az
api.finance.visma.netés a SalesOrder service v3 használatára építsen. - A bérlő jóváhagyása. A client credentials alapú hitelesítés nem működik, amíg a bérlő rendszergazdája nem hagyja jóvá az alkalmazást. Ezt a lépést idejében ütemezze be.
- Heti munkaidő-kimutatások. A munkaidő-kimutatásokhoz Advanced financials szükséges, és a kimutatások heti bontásúak. A gépkezelők munkaóráit hetente összesítse, vagy projekttranzakcióként könyvelje.
Ki állítja be és támogatja a Visma Net integrációját?
- A SkyPlanner csapata a bevezetés során beállítja az integrációt, az éles indulás után pedig támogatást nyújt hozzá. Ez a SkyPlanner oldalára, a Visma Net rendszerből hiányzó gyártási modellre és a megállapodás szerinti Visma Net API-hívásokra terjed ki. Minden üzem másképp használja a Visma Net rendszert; ezt a helyi tudást itt építjük be a megoldásba.
- Visma Net-partnere is részt vehet a munkában. A Visma minősített partnerekkel együtt szállítja a Visma Net rendszert. Ezek a partnerek ismerik az Ön beállításait, és ellenőrizhetik az adatmegfeleltetést és a Visma Connect alkalmazást. A SkyPlanner biztosítja a REST API-t, a Swagger/OpenAPI dokumentációt és a webhookokat.
- Saját fejlesztői is elkészíthetik az integrációt ugyanazon a dokumentált REST API-n keresztül, API-token használatával. Az induláshoz elegendő egy API-token, és a SkyPlanner csapata szükség esetén segít. A nyilvános dokumentáció a SkyPlanner dokumentációs oldalán érhető el.
Az összekapcsolás után az Arcturus motor a Visma Net aktuális rendelései alapján ütemez, az elkészült munkák pedig véglegesített Kit assemblies formájában kerülnek vissza a Visma Net rendszerbe. A havidíj 199 €-tól indul, 5 munkaállomást tartalmaz, havi számlázással. Az integrációra az Ön folyamatai és igényei alapján előre adunk árajánlatot a választott csomaggal együtt, így már az indulás előtt látja a teljes költséget.
Tekintse meg árainkat. A Visma Net termelésütemezéséről szóló oldalon megtudhatja, miért van szükség külön ütemezőre. A Visma Net oldalán áttekintést talál, az ERP-integrációk gyűjtőoldalán pedig más ERP-rendszereket is megismerhet.
Gyártócégek véleménye a SkyPlannerről
2 hmegtakarítás hetente
„A SkyPlannerrel az Excel-táblázatokon alapuló gyártástervezésről áttértünk a termelés valós idejű optimalizálására.”
Kalle Kalliomäki, ellátásilánc-szakértő
UTU · Elektromos kapcsolótáblák és kapcsolóberendezések
A gyártástervezéssel hetente 2 óra munkaidőt takarítanak meg, az új feladatsor pedig másodpercek alatt eljut a gyártósorra.
+90%termelési hatékonyság
„A termelés hatékonysága 90%-kal nőtt.”
Abdul Rucyinga, informatikai vezető
Laboratory & Allied · Gyógyszergyártás
A termelés hatékonysága 90%-kal nőtt, és az összes munkaállomásra kiterjedő, három hónapra optimalizált terv kevesebb mint 30 perc alatt elkészül.
98%a szállítási határidők betartása, a korábbi mintegy 50% helyett
„A SkyPlanner döntő szerepet játszik abban, hogy tartani tudjuk a szállítási határidőket.”
Hannu Lahtinen, ügyvezető igazgató
KJH-Comp · Lemezmegmunkálás és bérgyártás
A szállítási határidők betartásának aránya mintegy 50%-ról akár 98%-ra emelkedett, az ütemezéshez pedig ma már két művezető helyett egy is elegendő.
6 hónapraelőre látja az értékesítés a szabad kapacitást
„A SkyPlanner biztosítja a teljes gyártástervezés alapját és megbízhatóságát.”
Anu Järvinen, termelési vezető
Fredman Operations · Élelmiszerrel érintkezésre alkalmas csomagolópapírok
Az értékesítés hat hónapra előre látja a szabad kapacitást, és az ütemezés módosítására irányuló kérésekre másodpercek alatt választ kapnak a korábbi egy óra vagy még hosszabb várakozás helyett.
Gyakori kérdések
Elérhetők gyártási rendelések a Visma Net API-jában?
Nem. A Visma Net rendszerben nincsenek olyan objektumok, amelyek gyártási rendeléseket, technológiai útvonalakat vagy munkaállomásokat képviselnének, ezért az API-ban sem érhetők el ilyenek. A gyártási bizonylat a /v1/kitassembly végponton elérhető Kit assembly, a technológiai útvonalakat és a munkaállomásokat pedig a SkyPlanner tárolja.
Milyen hitelesítést használ az integráció?
Az integráció a Visma Connect szolgáltatást és az OAuth 2.0 client credentials folyamatot használja. A Visma Developer Portal felületén Service Integration típusként van regisztrálva. A bérlő rendszergazdája hagyja jóvá, a tokenek pedig egy óráig érvényesek.
Képes a Visma Net valós időben továbbítani a változásokat?
A cikkek, vevői rendelések és beszerzési rendelések esetében igen, a Visma Developer Portal webhookjain keresztül. A Kit assemblies és Kit specifications objektumokhoz nem tartoznak események, ezért változásaikat növekményes lekérdezés gyűjti be. A SkyPlanner saját webhookjai az ütemezés változásait azonnal továbbítják.
Hogyan kerül vissza a gyártás teljesítése a Visma Net rendszerbe?
A SkyPlanner minden ütemezett gyártási feladathoz létrehoz egy Kit assembly objektumot, naprakészen tartja a dátumát, és a feladat elkészültekor meghívja a release műveletet. A véglegesítés könyveli a gyártott mennyiséget és a komponensfelhasználást. Kit összeállítások nélkül az Inventory receipt és az Inventory issue végzi ugyanezt.
Kipróbálhatjuk a SkyPlannert az integráció kiépítése előtt?
Igen. A 30 napos ingyenes próba legfeljebb 20 munkaállomást támogat, a Visma Net adatai pedig CSV- vagy Excel-fájlból importálhatók. Bankkártya nem szükséges. Indítsa el a próbát, vagy egyeztessen értékesítőinkkel az integráció felméréséről.
