Integrációk / ERP / Visma L7
Visma L7–APS integrációs útmutató a gyártásütemezéshez
Ez az integrációs útmutató bemutatja a partnereknek és az informatikai csapatoknak, hogyan kapcsolható össze a Visma L7 a SkyPlanner APS rendszerrel. A SkyPlanner a Visma L7 REST API segítségével kétirányú adatkapcsolatot tart fenn a Visma L7 rendszerrel:
- A SkyPlanner átveszi a munkaszámokat (työnumero), a munkafázisokat (työnvaihe), az erőforrásokat, a termékstruktúrákat, az alkatrészeket, az anyagokat, a készletegyenlegeket, valamint a vevői és beszerzési rendelések sorait.
- A
PUT /manufphases/hívással minden munkalaphoz visszaírja az erőforrást, a kezdési dátumot, a prioritást, a személyt és a napi bontású óraszámokat. - Az erőforrásnaptár kapacitását a
POST /resourceupdates/hívás tartja szinkronban. - Az L7 munkasoraiban rögzített termelési eseményeket a
GET /manufevents/hívással olvassa vissza. - A SkyPlanner webhookjai azonnal továbbítják az ütemterv változásait.
A SkyPlanner csapata a bevezetés során az Ön L7-környezetéhez igazítja az integrációt, és az éles indulás után is támogatást nyújt hozzá. A partnerek és fejlesztők a SkyPlanner dokumentált REST API felületére építve is fejleszthetnek (API-referencia).
A Visma L7 REST API felülete
Az API neve Visma L7 – REST API. Dokumentációja az OpenAPI 3.0.3 szabványt követi, és változásnaplót is tartalmaz (dokumentáció). Az API a Visma LTR-en fut.
- Az alapútvonal az Ön saját LTR-kiszolgálóján:
/ltrws/REST/L7. A kiszolgáló helyben vagy a Visma hosztolt alkalmazásszolgáltatásában működhet. - Licencelés. Minden végponthoz külön licenc szükséges. Az ütemezés visszaírásához, a
PUT /manufphases/használatához L7RMFPP licenc kell, a kapacitás frissítéséhez pedig L7RMCAP. Az olvasási végpontokhoz szintén külön licencek tartoznak. - Lapozás. A listák a
pageSizeés arecAfterparaméterrel lapozhatók, szűrésükhöz pedig aqueryKey1, aqueryKey2és aqueryStringhasználható.
Hitelesítés
Minden L7-híváshoz két tokent kell küldeni:
- A hash választja ki az adatbázist és a vállalatot.
- A token azonosítja az API-felhasználót.
Az LTR-rendszergazda létrehozza az API-felhasználót a Visma LTR-ben, hozzárendeli az L7-vállalathoz, profilokat rendel hozzá, és létrehozza a felhasználói tokent (első lépések). Használjon külön integrációs felhasználót, kizárólag az integrációhoz szükséges jogosultságokkal.
A SkyPlanner oldalán a REST API hitelesítése az Authorization-Token fejlécben küldött API-tokennel történik. Ezt a Settings > API menüpontban hozhatja létre. Az integrációs oktatóanyag végigvezeti az első hívásokon.
Változások észlelése: modifiedAfter
Az L7 REST API nem támogat webhookokat. A változások rendszeres lekérdezéssel olvashatók be:
- Az L7 fájlkarbantartási moduljában (Tiedostohuolto) kapcsolja be a változásnaplózást (DBLOG) az integráció által olvasott táblákhoz, például a munkalapokhoz és az alkatrészekhez.
- Hívja meg az olvasási végpontokat úgy, hogy a
modifiedAfterértéke az utolsó futás időpontja legyen. A törölt rekordok töröltként megjelölve érkeznek vissza, így a visszavont gyártási feladatok kikerülnek az ütemezésből. - Néhány percenként végezzen lekérdezést. A SkyPlanner webhookot küld, ha az állapot vagy az ütemezés megváltozik, így a visszaírás eseményvezérelt.
Adatmegfeleltetés
| Visma L7-objektum (végpont) | SkyPlanner-objektum | Irány | Gyakoriság |
|---|---|---|---|
Tuote (GET /products/) | Termékek és anyagok | L7 → SkyPlanner | Kezdeti betöltés, majd változáskor |
A munkaszámhoz tartozó alkatrészek (GET /manufcomponents/) | Résztermékek | L7 → SkyPlanner | Rendszeres lekérdezés a modifiedAfter paraméterrel |
Anyagigények (GET /manufmaterials/) | Anyagszükséglet gyártási feladatonként | L7 → SkyPlanner | Rendszeres lekérdezés a modifiedAfter paraméterrel |
Erőforrásfa (KRYH) gépszámmal (GET /manufresources/) | Munkaállomások és munkaállomás-csoportok | L7 → SkyPlanner | Kezdeti betöltés, utána ritkán |
Munkalap (TSUUNR) munkafázisonként (GET /manufphases/) | Gyártási feladatok (műveleti lépések) munkaállomásonként | L7 → SkyPlanner | Lekérdezés néhány percenként |
Készletegyenlegek (GET /stockbalances/) | Készlet | L7 → SkyPlanner | Rendszeres lekérdezés |
Beszerzési rendelések sorai (GET /purchaserows/) | Beszerzési rendelések szállítási dátumokkal | L7 → SkyPlanner | Rendszeres lekérdezés |
Vevői rendelések és soraik (GET /salesorders/, GET /salesrows/) | Határidők, vevői prioritás | L7 → SkyPlanner | Rendszeres lekérdezés |
Termelési események (GET /manufevents/) | Előrehaladás gyártási feladatonként | L7 → SkyPlanner | Rendszeres lekérdezés |
A munkalap resource, startDate, priority, person, schedulingDays mezői (PUT /manufphases/) | Tervezett munkaállomás, kezdés, sorrend és napi óraszámok | SkyPlanner → L7 | Az ütemterv változásakor, SkyPlanner-webhookon keresztül |
Az erőforrásnaptár kapacitása (POST /resourceupdates/) | Műszakkapacitás | SkyPlanner → L7 | A műszakok változásakor |
| A SkyPlannerben beállított ütemezési szabályok | Engedélyezett munkaállomások, átállásiidő-mátrix, szerszámok, dolgozók | A SkyPlannerben karbantartva | Beállítás a bevezetés során |
Integrációs minták
1. A törzsadatok kezdeti betöltése. Olvassa be az erőforrásfát, és minden géphez rendeljen külön SkyPlanner-munkaállomást. Ha egy L7-erőforráshoz több gép tartozik, hozzon létre gépenként egy munkaállomást, az erőforráshoz pedig egy munkaállomás-csoportot. Olvassa be a termékeket és a termékstruktúrákat a hozzájuk tartozó munkafázisokkal együtt.
2. Munkaszámok szinkronizálása. Olvassa be a nyitott munkalapokat a GET /manufphases/ hívással, majd tartsa őket naprakészen a modifiedAfter paraméterrel. Olvassa be az egyes munkaszámokhoz tartozó alkatrészeket és anyagigényeket, valamint a készletegyenlegeket és a beszerzési rendelések sorait, hogy a munkafázis megvárja a hozzá tartozó beszerzési sor szállítási dátumát.
3. Az ütemezés visszaírása. A SkyPlanner minden olyan munkafázisnál meghívja a PUT /manufphases/ végpontot, amelyet az ütemezőmotor elhelyezett vagy áthelyezett. A kérés törzse munkalaponként egy workSheet bejegyzést tartalmaz a következőkkel:
number: a munkalap;resource: a kiválasztott erőforrásstartDateéspriority, hogy az L7 munkasorai a SkyPlanner sorrendjét mutassákperson, ha a terv név szerint kijelölt gépkezelőt tartalmazschedulingDays: a tervezett óraszámok dátumonként
Az L7 változatlanul megtartja a külső rendszer által beállított prioritást (forrás), így a sorrend a munkasorokban is megmarad.
4. Kapacitás szinkronizálása. Ha a SkyPlannerben módosulnak a műszakok, a szabadnapok vagy a túlórák, a POST /resourceupdates/ hívás beírja az új kapacitást az L7 erőforrásnaptárába. Az L7 terhelési nézetei így összhangba kerülnek a tervvel.
5. Üzemi előrehaladás. A gépkezelők továbbra is az L7 munkasoraiban és a Visma LTR-ben rögzítik az adatokat, a SkyPlanner pedig a GET /manufevents/ hívással olvassa be az eseményeket. A gépkezelők a SkyPlanner Mobile Confirmations felületén is visszaigazolhatják a munkát. Az Autopilot mindkét forrás adatai alapján újraütemez, és a következő visszaírás már az új időpontokat továbbítja.
6. Adatgazdai és ütközéskezelési szabályok. Rögzítse őket az éles indulás előtt:
| Adatok | Adatgazda |
|---|---|
| Termékek, termékstruktúrák, munkafázisok, mennyiségek, a munkaszám állapota | Visma L7 |
| A munkafázisok sorrendje, kezdési dátumok, napi óraszámok, erőforrás kiválasztása | SkyPlanner |
| Engedélyezett munkaállomások, átállásiidő-mátrix, szerszámok, dolgozók | SkyPlanner |
| Műszakok és távollétek | SkyPlanner, az L7 erőforrásnaptárába visszaírva |
| Termelési események és készletkönyvelések | A Visma L7 munkasorai és az LTR |
Az ütközések fő forrása az L7 saját tervezése. A szükségletszámítás és a finomtervezés újra elhelyezheti a nem zárolt munkafázisokat. Ezeket csak az anyagok és a foglalások kezelésére futtassa, és ne ütemezze újra a SkyPlanner által kezelt munkafázisokat.
A projekt szokásos lépései
A megvalósítás általában a bevezetés megkezdésétől számított néhány héten belül befejeződik. Ezt megelőzően a 30 napos ingyenes próba során saját adatait használhatja, a munkaszámok, munkafázisok és erőforrások Excel-exportja alapján.
- Felmérés. Véglegesítse az adatmegfeleltetési táblát, az adatgazdai szabályokat és a lekérdezések gyakoriságát.
- Hozzáférés és licencek. Szerezze be az érintett REST-végpontok licenceit. Az LTR-rendszergazda létrehozza az API-felhasználót, valamint a hash és token értékeket, lehetőleg először egy tesztvállalatban.
- Változásnaplózás. Kapcsolja be a DBLOG funkciót az olvasott táblákhoz.
- Kezdeti betöltés. Erőforrások, termékek, termékstruktúrák és munkafázisok.
- Munkaszámok szinkronizálása. Rendszeres lekérdezés a modifiedAfter paraméterrel, a törlések és a lapozás kezelése.
- Korlátok beállítása a SkyPlannerben. Engedélyezett munkaállomások, átállásiidő-mátrix, szerszámok és dolgozók.
- Visszaírás. A
PUT /manufphases/és aPOST /resourceupdates/tesztelése a tesztvállalatban. - Párhuzamos működés és éles indulás. Hasonlítsa össze az eredményt a jelenlegi tervvel, javítsa a törzsadatokat, majd kapcsolja be a visszaírást az éles környezetben.
Mire érdemes felkészülni a Visma L7 integrációjánál?
- Végpontonkénti licencek. Már a projekt elején vegye számba az összes végpontot, és a tesztelés előtt szerezze be a hozzájuk szükséges licenceket.
- Gépek száma. Az L7 a több gépet tartalmazó erőforrásnál megosztja a munkát a gépek között (forrás). A SkyPlannerben bontsa ezt külön munkaállomásokra, visszaíráskor pedig az L7 által várt erőforrást adja meg.
- Napi óraszámok. Az L7 dátumonként, órákban tárolja az ütemtervet. A SkyPlanner által küldött
schedulingDaysadatok összege megegyezik a művelet időtartamával. - Üzemi naptár. Gondoskodjon a hiánytalan kitöltéséről, mert a hiányzó adatok miatt a műveletek a múltba kerülnek (forrás).
- Készletre gyártási rendelések. A
mainNumber,subNumber,rowNumberésnewQuantitymezők kizárólag a készletre gyártási rendelés mennyiségének módosítására szolgálnak. Vevői megrendelésre végzett munkáknál hagyja ki őket. - A következő ERP. A Visma leállította az L7 továbbfejlesztését, a termék használata pedig 2028 végén megszűnik (a Visma közleménye). Az ütemezési szabályokat a SkyPlannerben tartsa, ne az L7 mezőiben, így ERP-váltáskor is megmaradnak.
Ki állítja be és támogatja a Visma L7 integrációját?
A munka során az adatok megfeleltetését az Ön erőforrásaihoz, munkafázisaihoz és L7-beállításaihoz igazítjuk. A munka a SkyPlannerben tárolt ütemezési szabályokra is kiterjed: az engedélyezett munkaállomásokra, az átállásiidő-mátrixra, a szerszámokra és a dolgozókra.
- 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á. Minden üzemben másképp használják az L7-et; a beállításoknál ezt a helyi tudást vesszük alapul.
- Visma-partnere is részt vehet a munkában. A partner ismeri az Ön L7- és LTR-beállításait, és gondoskodhat az API-felhasználóról, a licencekről és a tesztcégről. A SkyPlanner biztosítja a REST API-t, a Swagger/OpenAPI dokumentációt és a webhookokat.
- Saját fejlesztői is építhetnek rá ugyanazon a dokumentált REST API-n keresztül, API-token használatával. Az induláshoz elég egy API-token, a SkyPlanner csapata pedig szükség esetén segít.
Ha lecseréli az L7-et, a SkyPlanner a meglévő beállításokkal csatlakozik az új ERP-hez. Tekintse meg a Business Central, a Visma Net, a Lemonsoft, a Monitor ERP és az Odoo oldalát.
A SkyPlanner havi 199 €-tól érhető el, 5 munkaállomással, havi számlázással. Az integrációra az Ön folyamatai és igényei alapján, az előfizetési csomaggal együtt előzetes árajánlatot adunk, így már az indulás előtt látja a teljes költséget.
Az L7 saját tervezési lehetőségeit a Támogatja a Visma L7 a termelésütemezést? című cikkben hasonlítjuk össze. Áttekintést a Visma L7 oldalán talál, a többi rendszerről pedig az ERP-integrációk gyűjtőoldalán olvashat.
Gyártóvállalatok véleménye a SkyPlannerről
1 000-es nagyságrendbenautomatikusan ütemezett gyártási rendelések
„Egészen másképp tartjuk kézben a gyártást, és teljesen más szinten látjuk át a kapacitásainkat.”
Hannu Ryynänen, vezérigazgató
Mamec · Ipari keverők, szivattyúk és csúcstechnológiás bérgyártás
Gyártási rendelések ezreit ütemezik automatikusan, miközben a teljes szervezet valós időben követheti a gyártást.
98%a szállítási határidők betartásának aránya a korábbi mintegy 50% helyett
„A SkyPlanner meghatározó 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, és az ütemezéshez ma már két művezető helyett egy is elegendő.
2 hmegtakarítás hetente
„A SkyPlannerrel az Excel-táblázatokra épülő gyártástervezésről áttértünk a gyártás valós idejű optimalizálására.”
Kalle Kalliomäki, ellátásilánc-szakértő
UTU · Villamos kapcsolótáblák és kapcsolóberendezések
A gyártástervezés hetente 2 munkaórát takarít meg, az új munkasorrend pedig másodpercek alatt eljut a gyártósorra.
+90%gyártási hatékonyság
„A gyártás hatékonysága 90%-kal nőtt.”
Abdul Rucyinga, informatikai vezető
Laboratory & Allied · Gyógyszergyártás
A gyártás hatékonysága 90%-kal nőtt, és kevesebb mint 30 perc alatt elkészül az összes munkaállomásra kiterjedő, három hónapra optimalizált terv.
Gyakori kérdések
Van a Visma L7-nek API-ja a gyártási adatok eléréséhez?
Igen. A Visma LTR-en elérhető Visma L7 REST API hozzáférést biztosít a munkaműveletekhez, erőforrásokhoz, alkatrészekhez, anyagokhoz, gyártási eseményekhez, termékekhez, készletegyenlegekhez, valamint az értékesítési és beszerzési sorokhoz. Minden végponthoz külön licenc szükséges, az API-felhasználót és a tokeneket pedig az LTR rendszergazdája hozza létre.
Hogyan kerül vissza az ütemterv a Visma L7-be?
A PUT /manufphases/ hívással, amely minden munkalapnál frissíti az erőforrást, a kezdési dátumot, a prioritást, a személyt és a dátumonként tervezett óraszámot. A POST /resourceupdates/ az erőforrásnaptár kapacitását írja vissza. Az L7 megőrzi a külső prioritást, így a munkasorok a SkyPlannerben meghatározott sorrendet követik.
Támogatja a Visma L7 a webhookokat?
A dokumentáció nem említ webhookokat. Kapcsolja be a változásnaplózást az érintett táblákhoz, és a modifiedAfter használatával kérdezze le rendszeresen a változásokat. A SkyPlanner saját webhookjai azonnal továbbítják az ütemterv változásait.
Milyen ütemezőszoftver integrálható a Visma L7-tel?
A SkyPlanner APS az L7 REST API-n keresztül kétirányú kapcsolatot biztosít a Visma L7-tel, a Visma pedig feltünteti a Skycode-ot és a SkyPlannert az L7-integrációkat bemutató oldalán. Az integrációt a SkyPlanner csapata állítja be a bevezetés során.
Ki készíti el a Visma L7 integrációját?
A SkyPlanner csapata a bevezetés során az Ön L7-beállításaihoz igazítja a kétirányú integrációt, az éles indulás után pedig támogatást nyújt hozzá. Visma-partnere vagy saját fejlesztői is építhetnek a SkyPlanner dokumentált REST API-jára; az induláshoz elég egy API-token.
Kipróbálhatjuk a SkyPlannert az integráció elkészítése előtt?
Igen. A 30 napos ingyenes próba során akár 20 munkaállomást is használhat az L7-ből Excel- vagy CSV-fájllal importált adatokkal, bankkártya nélkül. Indítsa el a próbát, vagy vegye fel a kapcsolatot értékesítőinkkel az integráció felméréséhez.
