Integrációk / ERP / Acumatica Cloud ERP
Acumatica-integrációs útmutató a SkyPlanner APS gyártásütemezéséhez
Ez az Acumatica-integrációs útmutató bemutatja a partnereknek és az informatikai csapatoknak, hogyan kapcsolhatják össze az Acumatica Cloud ERP (Manufacturing Edition) rendszert a SkyPlanner APS-sel. A SkyPlanner és az Acumatica között kétirányú az adatkapcsolat:
- A SkyPlanner átveszi a gyártási rendeléseket a műveleteikkel együtt, valamint a munkaállomásokat, gépeket, szerszámokat, műszakokat, készletcikkeket és beszerzési rendeléseket.
- A tervezett kezdési és befejezési dátumok visszaíródnak a gyártási rendelés műveleteihez, a rendelés pedig rögzítetté válik.
- A gépkezelők időráfordításai munkaidő- és mozgásbizonylatokként kerülnek vissza az Acumatica rendszerbe.
- A SkyPlanner webhookjai azonnal továbbítják az ütemterv változásait.
A SkyPlanner csapata a bevezetés során az Ön Acumatica-környezetéhez igazítja az integrációt, és az éles indulás után is támogatja azt. Ez az útmutató azoknak a partnereknek és fejlesztőknek szól, akik részt szeretnének venni a munkában, vagy maguk szeretnének fejleszteni a SkyPlanner dokumentált REST API-jára építve (API-referencia).
Az Acumatica integrációs felületei
Az integráció az Acumatica beépített interfészeit használja. Az Acumatica-példányra semmit sem kell telepíteni.
- Szerződésalapú REST API. A végpontok verziózottak, és követik a kiadásokat. A Manufacturing végpont (például a 2026 R2 kiadáshoz tartozó 26.200.001) a következő entitásokat teszi elérhetővé:
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryésMaterialEntry. A Default végponton aStockItem, aPurchaseOrderés aSalesOrderérhető el. Az URL-ek felépítése:{instance}/entity/{Endpoint}/{version}/{Entity}. - Ugyanezen a végponton elérhető műveletek. A
FirmProductionOrder, azUndoFirmProductionOrder, aReleaseLaborEntry, aReleaseMoveEntryés aReleaseMaterialEntryugyanazt a logikát futtatja, mint a képernyőkön található gombok. - OData. Bármely Generic Inquiry (SM208000) elérhetővé tehető OData-kapcsolaton keresztül. A tömeges kiolvasás leggyorsabb módja egy olyan Generic Inquiry, amely a nyitott gyártási műveleteket a dátumaikkal együtt tartalmazza.
- Push értesítések (SM302000). Generic Inquiry vagy beépített lekérdezés alapján működnek, és a beszúrt, illetve törölt sorokat az Ön által beállított URL-re küldik.
- Importálási és exportálási forgatókönyvek CSV- és Excel-adatszolgáltatókkal a tömeges adatbetöltéshez.
Az entitások és a műveletek a Web Service Endpoints (SM207000) képernyőn, valamint az Acumatica REST-kliensének kódtárában találhatók.
Hitelesítés és korlátok
Az Acumatica OAuth 2.0 és OpenID Connect alapú hitelesítést használ a Connected Applications (SM303010) képernyőn regisztrált kliensalkalmazásokon keresztül. A dokumentált folyamatok: Authorization Code, Implicit, Resource Owner Password Credentials és Hybrid. Szerveroldali integrációhoz regisztráljon egy külön integrációs felhasználót a lehető legszűkebb jogosultságú szerepkörökkel, és használja az Authorization Code folyamatot frissítési tokennel, vagy a Resource Owner Password Credentials folyamatot.
A felső határt a licenc szabja meg: a License Monitoring Console (SM604000) megmutatja a percenként engedélyezett API-kérések számát és az engedélyezett API-felhasználók számát.
A SkyPlanner oldalán a REST API API-tokennel hitelesít (SkyPlanner Settings > API), dokumentációja Swagger/OpenAPI formátumban érhető el. Az integrációs oktatóanyag végigvezeti az első hívásokon.
Adatmegfeleltetés
| Acumatica-objektum (végpont / űrlap) | SkyPlanner-objektum | Irány | Gyakoriság |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Termékek és anyagok | Acumatica → SkyPlanner | Kezdeti betöltés, majd csak a változások |
BillOfMaterial (AM208000): anyagok, műveletek | Termékszerkezet, résztermékek, termékenkénti anyagok | Acumatica → SkyPlanner | Kezdeti betöltés, majd változáskor |
| BOM-műveletek: Setup, Run, Machine, Queue, Finish, Move Time | Folyamatlépések időtartammal, előkészítési és lezárási időkkel | Acumatica → SkyPlanner | Kezdeti betöltés, majd változáskor |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Munkaállomások, munkaállomás-csoportok, hatékonysági értékek, alternatív munkaállomások | Acumatica → SkyPlanner | Kezdeti betöltés, utána ritkán |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Műszakok és személyzeti kapacitás | Acumatica → SkyPlanner | Naponta, vagy a műszakok kezelése a SkyPlannerben |
Tool (AM205500) | Szerszámok mint korlátozott kapacitású erőforrások | Acumatica → SkyPlanner | Kezdeti betöltés |
ProductionOrder az OrderOperationDetail adataival (Planned, Released, In Process) | Rendelések és munkák határidőkkel, indítási prioritással és anyagszükséglettel | Acumatica → SkyPlanner | Push értesítés vagy néhány percenkénti lekérdezés |
PurchaseOrder tételei (Default) | Beszerzési rendelések várható szállítási dátummal | Acumatica → SkyPlanner | Lekérdezés óránként vagy az ütemezés futtatásakor |
| Cikkek raktárankénti mennyisége | Készletegyenlegek | Acumatica → SkyPlanner | Lekérdezés óránként vagy az ütemezés futtatásakor |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Tervezett kezdés, befejezés és munkaállomás műveletenként | SkyPlanner → Acumatica | Az ütemterv változásakor, SkyPlanner-webhookon keresztül |
FirmProductionOrder művelet | Megvédi a visszaírt dátumokat az Acumatica APS módosításaitól | SkyPlanner → Acumatica | Minden visszaírás után |
LaborEntry, MoveEntry a hozzájuk tartozó véglegesítési műveletekkel | Időráfordítások, elkészült mennyiségek, gépkezelői visszajelentések | SkyPlanner → Acumatica | Visszajelentésenként vagy műszakonként |
| Nincs az Acumatica rendszerben | Átállásiidő-mátrix, név szerint megadott gépkezelők, több gépkezelőt igénylő munkák | A SkyPlannerben kezelve | Beállítás a bevezetés során |
Integrációs minták
1. A törzsadatok kezdeti betöltése. Először a munkaállomásokat, gépeket, szerszámokat, műszakokat és naptárakat olvassa ki. Ezután következzenek a készletcikkek és a darabjegyzékek. Döntse el, hogyan képez le egy több gépből álló munkaállomást: egy munkaállomás-csoportként, amelynek gépei külön munkaállomások, vagy egyetlen munkaállomásként. Az Acumatica Basis for Capacity beállítása megmutatja, melyik szemléletet követi az üzem.
2. Rendelések szinkronizálása. A gyártási rendeléseket a műveleteikkel együtt a rendelésből olvassa ki, ne a BOM-ból. A műveletek a rendelésre másolódnak, és a tervezők ott módosítják őket. Állítson be push értesítést a nyitott rendeléseket és műveleteket tartalmazó Generic Inquiry lekérdezéshez, vagy kérdezze le azt rendszeresen. A nyitott beszerzési rendelések tételeit is olvassa ki. A SkyPlanner a megrendelt anyagot a beszerzési rendelés szállítási dátumától tekinti elérhetőnek, és frissíti a készletet, amikor a beszerzési rendelés Delivered állapotba kerül.
3. Az ütemterv visszaírása. A SkyPlanner minden olyan műveletnél, amelyet az ütemezőmotor elhelyezett vagy áthelyezett, visszaírja a StartDate és EndDate értékét az OrderOperationDetail objektumba. Ha a munka alternatív munkaállomásra került, azt is visszaírja. Ezután meghívja a FirmProductionOrder műveletet. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (A gyártási rendelések valós kapacitást figyelembe vevő termelésütemezésekor a rendszer nem ütemezi újra a rögzített gyártási rendeléseket.) (forrás)
4. Üzemi visszajelentések. A gépkezelők a SkyPlanner Mobile Confirmations vagy a Production Timer segítségével rögzítik a munkát. Az időráfordításokból LaborEntry bizonylatok (műveletenkénti idő és elkészült mennyiség) vagy MoveEntry bizonylatok (csak mennyiség) készülnek, amelyeket a megfelelő művelettel véglegesítenek. Ha az üzem már az Acumatica rendszerben jelent vissza a Labor (AM301000) vagy a Shop Floor Kiosk használatával, az előrehaladási adatok az ellenkező irányba áramlanak. Egyetlen csatornát válasszon, soha ne mindkettőt.
5. Adatgazdák és ütközéskezelési szabályok. Rögzítse őket az éles indulás előtt:
| Adatok | Adatgazda |
|---|---|
| Készletcikkek, darabjegyzékek, mennyiségek, rendelésállapot, költségszámítás | Acumatica |
| Műveleti sorrend, kezdési és befejezési időpontok, munkaállomás-hozzárendelés | SkyPlanner |
| Átállásiidő-mátrix, szerszámok, gépkezelői követelmények, alternatívák | SkyPlanner |
| Műszakok és távollétek | Egyetlen, a felmérés során kiválasztott rendszer |
| Munkaidő- és mozgástranzakciók | Acumatica, a SkyPlanner időráfordításaiból könyvelve vagy az üzemben rögzítve |
Az ütközések fő forrása az Acumatica saját APS rendszere. A Rough Cut Planning vagy az APS Maintenance Process újraszámíthatja a SkyPlanner által ütemezett rendelések dátumait. Ez megelőzhető, ha minden visszaírt rendelést rögzítetté tesznek. Az ütemezett rendeléseket az APS-futtatásokból is ki kell zárni.
A projekt szokásos lépései
A bevezetés az indulástól számítva általában néhány héten belül lezárul. Ezt megelőzően a 30 napos ingyenes próba során saját adataival tesztelheti a rendszert. Exportálja a munkaállomásokat és a nyitott gyártási rendeléseket a műveleteikkel együtt egy Generic Inquiry lekérdezésből Excelbe, importálja őket, majd ellenőrizze az ütemtervet.
- Adatmegfeleltetés. Véglegesítse a megfeleltetési táblát, az adatok kezeléséért felelős rendszerekre vonatkozó szabályokat, a szinkronizálás gyakoriságát és a munkaidő-adatok könyvelési csatornáját.
- Hozzáférés. Regisztrálja a csatlakoztatott alkalmazást, hozza létre az integrációs felhasználót és a szerepköröket, majd ellenőrizze a végpont verzióját a Web Service Endpoints felületen. Először tesztkörnyezetben dolgozzon.
- Kezdeti adatbetöltés. Munkaállomások, gépek, szerszámok, műszakok, készletcikkek és darabjegyzékek.
- Rendelések szinkronizálása. Gyártási rendelések, műveletek és beszerzési rendelések átvitele push értesítésekkel vagy rendszeres lekérdezéssel.
- Korlátok beállítása a SkyPlanner rendszerben. Átállásiidő-mátrix, név szerint megadott gépkezelők, több kezelőt igénylő munkák és alternatívák.
- Visszaírás. Műveleti dátumok, rendelések rögzítetté tétele, valamint munkaidő- vagy műveletközi mozgáskönyvelések.
- Párhuzamos működés. Hasonlítsa össze a SkyPlanner által meghatározott dátumokat az aktuális tervvel, és javítsa a törzsadatokat.
- Éles indulás. Ha az adatok egyeznek, kapcsolja be a visszaírást.
Mire kell felkészülni az Acumatica integrációjánál?
- Ellenőrizze, melyik APS-motor aktív. A Classic és az Optimized külön tárolja a beállításokat, és egyszerre csak az egyik engedélyezhető. Az első visszaírás előtt ellenőrizze az Enable/Disable Features (CS100000) felületet.
- Rögzítse a végpont verzióját. A verzió az URL része. Új kiadásra frissítéskor új végpontverzió válik elérhetővé, ezért minden frissítéskor teszteljen újra.
- Műveletek frissítése. Egyes műveleti mezők REST-en keresztül csak olvashatók, és a rendelés állapota is számít. Tesztkörnyezetben tesztelje a visszaírás lépéseit Released és In Process állapotú rendelésekkel.
- Egységek és időmezők. A futási idő a Run Units, a gépidő a Machine Units szerinti mennyiségre vonatkozik. A várakozási és a mozgatási idő hatása: “affect the calculated schedule but do not occupy work center capacity.” (Befolyásolják a kiszámított ütemtervet, de nem foglalják le a munkaállomás kapacitását.) Importáláskor ügyeljen a pontos átszámításra.
- Anyagellátottság megítélése. A Classic APS megköveteli, hogy minden anyag teljes mennyiségben rendelkezésre álljon. A SkyPlanner a készletet és a beérkező beszerzési rendeléseket dátum szerint veszi figyelembe a tervezésnél. Állapodjanak meg abban, melyik rendszer eredménye alapján dolgoznak a tervezők.
- API-korlátok. A percenkénti kérések számát a licenc határozza meg. Teljes újratöltés helyett csak a változásokat kérdezze le, és használjon push értesítéseket.
Ki állítja be és támogatja az Acumatica integrációját?
- A SkyPlanner csapata a bevezetés során beállítja az integrációt, és az éles indulás után is támogatja. Minden üzem másképp használja az Acumatica rendszerét; ezt a tapasztalatot a beállításoknál hasznosítjuk.
- Az Ön Acumatica-partnere is részt vehet a munkában. A partner ismeri az egyedi módosításokat, a Generic Inquiries lekérdezéseket és a szerepköröket. 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 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 Laboratory & Allied ezt az utat választotta az SAP Business One esetében: belső informatikai csapatuk nagyrészt önállóan, a SkyPlanner segítségével készítette el az integrációt.
A SkyPlanner havi 199 €-tól érhető el, 5 munkaállomással, havi számlázással. Az integrációra a folyamatai és igényei alapján előre adunk árajánlatot, az előfizetési csomaggal együtt, így már az indulás előtt látja a teljes költséget. Az Acumatica saját APS rendszerével való összehasonlítást az Acumatica termelésütemezéséről szóló oldalon, az áttekintést az Acumatica oldalán, a többi rendszert pedig az ERP-integrációk gyűjtőoldalán találja.
Gyártóvállalatok véleménye a SkyPlanner rendszeréről
2 hmegtakarítás hetente
„A SkyPlanner segítségével az Excel-táblázatokra épülő 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 · Villamos kapcsolótáblák és kapcsolóberendezések
A gyártástervezéssel hetente 2 óra munkaidőt takarítanak meg, és az új munkasorrend 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, az összes munkaállomásra kiterjedő, három hónapos optimalizált terv pedig kevesebb mint 30 perc alatt elkészül.
Több 1 000automatikusan ütemezett munkarendelés
„Egészen másképp tartjuk kézben a termelést, és teljesen más szinten látjuk át a kapacitásunkat.”
Hannu Ryynänen, vezérigazgató
Mamec · Ipari keverők, szivattyúk és csúcstechnológiás bérgyártás
Munkarendelések ezreit ütemezik automatikusan, miközben az egész szervezet valós időben látja a termelés állapotát.
99,2%szállítási határidők betartása
„A SkyPlanner átláthatóvá tette, hol vannak a szűk keresztmetszetek, és egyértelműbbé tette a termelésirányítást.”
Toni Tuori, termelési vezető
Piristeel · Tetőbiztonsági és esővíz-elvezető rendszerek
A szállítási határidők betartásának aránya idén elérte a 99,2%-ot, az ütemezéssel pedig naponta akár négy óra munkaidőt takarítanak meg.
Gyakori kérdések
Elérhetők a gyártási rendelések az Acumatica API-ján keresztül?
Igen. A szerződésalapú REST API Manufacturing végpontja elérhetővé teszi a ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine és Tool objektumokat, valamint a munkaidő- és műveletközi mozgáskönyveléseket. Emellett olyan műveletek is elérhetők, mint a FirmProductionOrder.
Ki készíti el az Acumatica integrációját?
A SkyPlanner csapata a bevezetés során az Ön Acumatica-konfigurációjához igazítja a kétirányú integrációt, és az éles indulás után is támogatja. Az Ön Acumatica-partnere vagy saját fejlesztői is építhetnek a SkyPlanner dokumentált REST API-jára; az induláshoz elegendő egy API-token.
Szükség van az Acumatica APS rendszerére ehhez az integrációhoz?
Nem. Az Acumatica saját, véges kapacitással számoló ütemezése a Rough Cut Planning űrlapon futtatható, a Classic APS pedig a 120 napon túl befejeződő rendeléseket végtelen kapacitással tervezi (forrás). A SkyPlanner maga készíti el a részletes, tényleges kapacitáshoz igazodó ütemtervet a gyártási rendelések, műveletek, munkaállomások, gépek és szerszámok alapján. Az integráció tehát attól függetlenül működik, hogy engedélyezve van-e az APS, amely az Acumatica megfogalmazása szerint „is subject to licensing” (licenchez kötött). Az Autopilot naprakészen tartja az ütemtervet, a dolgozók pedig a Mobile Confirmations segítségével rögzítik a munkát.
Hogyan akadályozhatjuk meg, hogy az Acumatica APS felülírja a SkyPlanner dátumait?
A SkyPlanner minden gyártási rendelést véglegesít a műveleti dátumok visszaírása után. Az Acumatica termelésütemezése nem ütemezi újra a véglegesített rendeléseket.
Képes az Acumatica valós időben továbbítani a változásokat?
Igen. A Generic Inquiry lekérdezéshez beállított Push notifications (SM302000) a módosulás pillanatában elküldi a megváltozott sorokat egy URL-re. A SkyPlanner saját webhookjai az ellenkező irányba továbbítják az ütemterv változásait.
Milyen hitelesítést használjon az integráció?
OAuth 2.0 hitelesítést, a Connected Applications (SM303010) felületen regisztrált klienssel, külön integrációs felhasználóval és a szükséges legkisebb jogosultságot biztosító szerepkörökkel. Az Ön rendszerpéldányához illő hitelesítési folyamatot a felmérés során véglegesítjük.
Kipróbálhatjuk a SkyPlanner rendszerét az integráció elkészítése előtt?
Igen. A 30 napos ingyenes próba legfeljebb 20 munkaállomást támogat, az adatokat pedig egy Acumatica Generic Inquiry lekérdezésből Excel- vagy CSV-fájlon keresztül importálhatja. 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.
