Integrációk / ERP / Comarch ERP XL
Comarch ERP XL integrációs útmutató a SkyPlanner APS-sel végzett gyártásütemezéshez
Ez az integrációs útmutató bemutatja a partnereknek és az informatikai csapatoknak, hogyan kapcsolható össze a Comarch ERP XL a SkyPlanner APS-sel. A SkyPlanner kétirányú integrációt biztosít a Comarch ERP XL rendszerrel, a Comarch saját interfészein keresztül:
- A SkyPlanner átveszi a gyártási rendeléseket (zlecenia produkcyjne) a hozzájuk tartozó folyamatokkal és műveletekkel, valamint a technológiákat, munkaállomásokat, erőforrásokat, cikkeket, készleteket és beszerzési rendeléseket.
- A tervezett kezdési és befejezési időpontok az XL API-n keresztül visszakerülnek a gyártási rendelések egyes műveleteihez.
- Igény esetén a kezelők időnaplói is visszakerülnek a rendszerbe, műveleti teljesítésként.
- A SkyPlanner webhookjai azonnal továbbítják az ütemterv változásait.
A SkyPlanner csapata a bevezetés során az Ön Comarch ERP XL 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 kívánnak venni ebben a munkában, vagy maguk szeretnének fejleszteni a SkyPlanner dokumentált REST API-jára építve (API-referencia).
A Comarch ERP XL integrációs interfészei
A Comarch három lehetőséget sorol fel az ERP XL-lel való kommunikációra: “DCOM, direct database connection (SQL Client), REST API” (DCOM, közvetlen adatbázis-kapcsolat SQL Client használatával, REST API) (Comarch, fordítás). Az ütemezőrendszer integrációja elsősorban ezek közül kettőt használ:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Ezek a függvények a teljes Comarch ERP XL rendszerrel együtt telepített CDN_API.DLL könyvtárban találhatók.) (Comarch súgó, fordítás) A külső program az XLLogin függvénnyel jelentkezik be, közös munkamenetet használó függvényeket hív meg, majd az XLLogout függvénnyel jelentkezik ki. Minden struktúrában található egy Wersja mező, amely az adott ERP XL kiadáshoz tartozó paraméterkészlet verzióját választja ki.
- ERP XL Web REST API. A Comarch ERP XL Web 2026.0 REST-mikroszolgáltatásokat tesz elérhetővé: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Minden RestAPI mikroszolgáltatás a /swagger végponton teszi elérhetővé saját interaktív dokumentációját.) (Comarch súgó, fordítás)
A közvetlen SQL Client kapcsolat olvasási hozzáférést biztosít az ERP XL adatbázisához a törzsadatok és rendelések lekérdezéséhez, az Ön informatikai csapatával és Comarch-partnerével egyeztetett módon.
Az XL API gyártási függvényei
A Comarch az alábbi gyártási függvényeket dokumentálja (XL128):
| Terület | Függvény | Feladat |
|---|---|---|
| Technológiák | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Új technológia vagy művelet létrehozása, munkaállomás, anyag vagy termék hozzárendelése a művelethez |
| Gyártási rendelések | XLNoweZlecenieProd | Új gyártási rendelés létrehozása |
| Gyártási rendelések | XLZamknijZlecenieProd | Gyártási rendelés tervezése, újratervezése, elszámolása vagy lezárása a műveletkód szerint |
| Műveletek | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Művelet vagy erőforrás hozzáadása egy gyártási folyamathoz |
| Ütemezés | XLDodajTerminDoProcesuProd | Időintervallum hozzáadása egy művelethez: IdCzynnosci, TerminOd, TerminDo |
| Teljesítés | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Műveleti teljesítés hozzáadása a rendeléshez, a teljesített mennyiség módosítása |
| Bizonylatok | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | RW és PW bizonylatok létrehozása gyártási objektumokhoz |
Hitelesítés és hozzáférés
- XL API. Az integráció ERP XL felhasználóként jelentkezik be az adatbázisba az XLLogin függvénnyel, és munkamenetet kap a későbbi hívásokhoz. A DLL olyan Windows-gépen fut, amelyre az ERP XL is telepítve van, így a visszaíró szolgáltatás az Ön hálózatán, az ERP XL mellett működik.
- REST API. A hozzáférést ERP XL Web telepítésenként kell beállítani; az egyes mikroszolgáltatások hívásait a saját Swagger-oldaluk dokumentálja.
- SQL-olvasás. Az informatikai csapat által jóváhagyott, kizárólag olvasásra jogosító adatbázis-hozzáférés.
A SkyPlanner oldalán a REST API hitelesítése az Authorization-Token fejlécben megadott API-tokennel történik (SkyPlanner Settings > API); a dokumentáció Swagger/OpenAPI formátumban érhető el. Az integrációs útmutató lépésről lépésre bemutatja az első hívásokat.
Események és rendszeres lekérdezés
Az átvizsgált dokumentációban a Comarch ERP XL-hez nem szerepelnek kimenő webhookok. A Comarch saját APS rendszere akkor kéri le az adatokat, amikor a tervező megnyomja az „Aktualizuj dane z ERP” gombot (Comarch APS súgó).
Ezért az ERP XL adatait rendszeres lekérdezéssel vesszük át. Az új gyártási igényeket a nyitott gyártási rendelésekre és a legutóbbi változásokra szűrt lekérdezések tárják fel. A gyakoriságot üzemenként állítjuk be: a gyártási rendeléseket néhány percenként, a készleteket óránként kérdezzük le.
A SkyPlanner webhookot küld az állapot vagy az ütemterv változásakor, így a visszaírás eseményvezérelt.
Adatmegfeleltetés
| Comarch ERP XL objektum (interfész) | SkyPlanner-objektum | Irány | Gyakoriság |
|---|---|---|---|
| Karty towarów, mértékegységek (REST vagy SQL-lekérdezés) | Termékek és anyagok | ERP XL → SkyPlanner | Kezdeti betöltés, majd rendszeres lekérdezés |
| Technologia: műveletek, valamint műveletenként az anyagok, félkész termékek és termékek | Termékstruktúra, résztermékek, anyagok folyamatlépésenként | ERP XL → SkyPlanner | Kezdeti betöltés, majd változáskor |
| A Technologia műveletei: munkaállomások, erőforrások, idők | Folyamatlépések időtartammal, átállási és leszerelési időkkel | ERP XL → SkyPlanner | Kezdeti betöltés, majd változáskor |
| Gniazda robocze és zasoby (gépek, szerszámok, dolgozók) | Munkaállomások, munkaállomás-csoportok, szerszámok, személyzet | ERP XL → SkyPlanner | Kezdeti betöltés, utána ritkán |
| Kalendarze i okresy, przestoje i awarie | Műszakok, munkaidőn kívüli időszakok és állásidők | ERP XL → SkyPlanner | Naponta, vagy saját műszakok kezelése a SkyPlannerben |
| Zlecenia produkcyjne (ZP) a hozzájuk tartozó folyamatokkal, műveletekkel, anyagokkal, határidővel és prioritással | Rendelések és gyártási feladatok határidőkkel és anyagszükségletekkel | ERP XL → SkyPlanner | Lekérdezés néhány percenként |
| Készlet raktáranként | Készletegyenlegek | ERP XL → SkyPlanner | Lekérdezés óránként vagy az ütemezés futtatásakor |
| Zamówienia zakupu (ZZ) szállítási időpontokkal | Beszerzési rendelések, beérkező anyagok szállítási időpont szerint | ERP XL → SkyPlanner | Lekérdezés óránként vagy az ütemezés futtatásakor |
| Műveleti időpontok: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Tervezett kezdés és befejezés gyártási feladatonként | SkyPlanner → ERP XL | Az ütemterv változásakor, SkyPlanner-webhookon keresztül |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Időnaplók és kezelői visszajelentések | SkyPlanner → ERP XL | Igény esetén visszajelentésenként vagy műszakonként |
| Nem az ERP XL-ben | Átállásiidő-mátrix, szerszámok korlátozott kapacitású erőforrásként, több kezelőt igénylő gyártási feladatok, alternatív gépek és személyzet | 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 a cikkeket, technológiákat, munkaállomásokat, erőforrásokat és naptárakat. A munkaállomások SkyPlanner-megfeleltetését tudatosan alakítsa ki: egy négy gépből álló munkaállomásból egy munkaállomás-csoport vagy négy munkaállomás lesz. Az ERP XL erőforrásai között szereplő szerszámok a SkyPlannerben korlátozott kapacitású szerszámként jelennek meg, a dolgozók pedig műszakokhoz rendelt személyzetként.
2. Rendelések szinkronizálása. Olvassa be a gyártási rendeléseket a műveleteikkel és anyagaikkal együtt, valamint a nyitott beszerzési rendeléseket. A SkyPlanner a megrendelt anyagot a beszerzési rendelés szállítási időpontjától tekinti elérhetőnek, a készletet pedig akkor frissíti, amikor a beszerzési rendelés Delivered állapotot kap.
3. Az ütemterv visszaírása. Amikor az ütemezőmotor elhelyez vagy áthelyez egy műveletet, a SkyPlanner webhookja elindítja a visszaíró szolgáltatást. Ez meghívja az XLDodajTerminDoProcesuProd függvényt a művelet TerminOd és TerminDo értékével, így minden ZP-művelethez bekerül a SkyPlanner által tervezett kezdési és befejezési időpont.
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őbejegyzések pedig naprakészen tartják az ütemtervet. Ön dönti el, hogy a tényleges idők visszakerüljenek-e az ERP-be. Ha igen, a szolgáltatás az XLDodajRealizacjeOperacjiProd függvénnyel rögzíti a teljesítéseket, az RW- és PW-bizonylatok pedig az Ön ERP XL-szabályai szerint készülnek. Ha egyes állomásokon Comarch MES működik, műveletenként csak egy visszajelentési forrást használjon.
5. Adatgazdák és ütközéskezelési szabályok. Ezeket még az éles indulás előtt rögzítse:
| Adatok | Adatgazda |
|---|---|
| Cikkek, technológiák, mennyiségek, ZP-állapot, költségszámítás | Comarch ERP XL |
| Műveleti sorrend, kezdési és befejezési időpontok, erőforrás-hozzárendelés | SkyPlanner |
| Átállásiidő-mátrix, szerszám- és gépkezelői igények, alternatív erőforrások | SkyPlanner |
| Műszakok, naptárak és állásidők | A felmérés során kiválasztott egyetlen rendszer |
| Teljesítések, RW- és PW-bizonylatok | Comarch ERP XL; az adatok közvetlenül ott rögzíthetők, vagy a SkyPlanner időbejegyzéseiből adhatók át |
Csak egy rendszer írja a műveletek időpontjait. Ha az ERP XL automatikus újratervezése vagy a Comarch APS még ugyanazokra a gyártási rendelésekre ír időpontokat, kapcsolja ki ezt a SkyPlanner által ütemezett rendeléseknél.
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. Előtte ellenőrizze az ütemtervet a 30 napos ingyenes próbaidőszakban, az ERP XL-ből CSV- vagy Excel-formátumban exportált munkaállomásokkal, technológiákkal és nyitott gyártási rendelésekkel.
- Adatmegfeleltetés. Véglegesítse a megfeleltetési táblát, az adatgazdákra vonatkozó szabályokat és a szinkronizálás gyakoriságát, és döntse el, hogy a teljesítések visszakerüljenek-e az ERP-be.
- ERP XL-hozzáférés. Hozza létre az integrációs felhasználót, állítsa be az olvasási kapcsolatot, és telepítse a visszaíró szolgáltatást olyan gépre, amelyen az ERP XL is telepítve van. Először az adatbázis másolatán teszteljen.
- Kezdeti adatbetöltés. Cikkek, technológiák, munkaállomások, erőforrások, naptárak.
- Gyártási és beszerzési rendelések szinkronizálása. Időszakos lekérdezés szűrőkkel és újrapróbálkozásokkal.
- Korlátok beállítása a SkyPlanner rendszerben. Átállásiidő-mátrix, szerszámok, gyártási feladatonként szükséges gépkezelői létszám, valamint alternatív gépek vagy munkatársak.
- Az ütemterv visszaírása. A SkyPlanner webhookjai által indított XLDodajTerminDoProcesuProd hívások, valamint a teljesítések átadása, ha ezt választotta.
- Párhuzamos tesztelés. Futtassa a SkyPlanner rendszert a jelenlegi terv mellett, hasonlítsa össze az időpontokat, és javítsa a törzsadatokat.
- Éles indulás. Ha az adatok egyeznek, kapcsolja be a visszaírást.
Mire kell felkészülni a Comarch ERP XL integrációjánál?
- Kézzel megadott kapacitás. Az ERP XL-ben a munkaállomás kapacitása egy felhasználó által megadott szám, amelyhez megengedett terhelési % tartozik. A SkyPlanner ehelyett a tényleges műszakokból és erőforrásokból számítja a kapacitást, ezért gondosan állítsa be a műszakokat, a százalékos értéket pedig ne vigye tovább.
- Korlátlan erőforrások. Az ERP XL nem ellenőrzi a korlátlan kapacitásúként megjelölt erőforrások foglaltságát. Mindegyiknél döntse el, hogy a SkyPlanner rendszerben korlátozott kapacitású munkaállomásként szerepeljen-e.
- Gyártásba adott rendelések. Az ERP XL kihagyja az újratervezésből a gyártásba adott műveleteket, kivéve, ha a „Przesuń na zwolnionych” jelölőnégyzet be van jelölve. Egyeztessék, hogyan érvényesüljenek a SkyPlanner időpontjai a gyártásba adott rendeléseknél, és a Running Time Lock funkcióval rögzítsék a következő órákra ütemezett munkát.
- Adatstruktúrák verziói. Az XL API adatstruktúrái Wersja mezőt tartalmaznak. Ezt az ERP XL használt kiadásának megfelelően állítsa be, és minden éves verziófrissítés után teszteljen újra.
- Lengyel mértékegységek és időadatok. Importáláskor pontosan kell átváltani a műveleti időket és a naptári egységeket, különben minden időtartam hibás lesz.
Ki állítja be és támogatja a Comarch ERP XL 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. Ez a megállapodás szerinti adatolvasásokra és XL API-hívásokra terjed ki. Minden üzem másként használja a Comarch ERP XL rendszert; a beállításhoz és a támogatáshoz ezeknek a sajátosságoknak az ismeretére van szükség.
- Az Ön Comarch-partnere is részt vehet a munkában. A partner ismeri az Ön beállításait, licencelését és az XL API-t, így a SkyPlanner csapatával együtt beállíthatja az integrációs felhasználót, az olvasási kapcsolatot és a visszaíró szolgáltatást futtató gépet.
- Saját fejlesztői is továbbfejleszthetik az integrációt a SkyPlanner REST API használatával, API-tokenes hozzáféréssel. Az induláshoz elegendő egy API-token, és a SkyPlanner csapata szükség esetén segít. A leírás a SkyPlanner integrációs dokumentációjában található.
A SkyPlanner havonta 199 €-tól érhető el, 5 munkaállomással, havi számlázással. Az integrációra előzetes árajánlatot adunk a választott csomaggal együtt, az Ön folyamataihoz és igényeihez igazítva. Tekintse meg az árakat, a Comarch ERP XL melletti termelésütemezést bemutató oldalt, a Comarch ERP XL oldalát és az ERP-integrációk áttekintését.
Gyártóvállalatok véleménye a SkyPlanner rendszerről
2 hmegtakarítás hetente
„A SkyPlanner segítségével az Excel-táblázatok helyett ma már valós időben optimalizáljuk a gyártást.”
Kalle Kalliomäki, ellátásilánc-szakértő
UTU · Elektromos kapcsolótáblák és kapcsolóberendezések
A gyártástervezés hetente 2 óra munkaidőt takarít meg, az új feladatsor 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ónapos optimalizált terv.
6 hónapraelőre látja a szabad kapacitást az értékesítés
„A SkyPlanner megbízható alapot ad a teljes gyártástervezéshez.”
Anu Järvinen, termelési vezető
Fredman Operations · Élelmiszerek csomagolására alkalmas papírok
Az értékesítés hat hónapra előre látja a szabad kapacitást, és másodpercek alatt választ kap azokra az ütemterv-módosítási kérésekre, amelyek korábban egy órát vagy még többet vettek igénybe.
100%a szállítási határidők betartása 2021 óta
„A SkyPlanner átláthatóvá teszi a kapacitásunkat és kiszámíthatóvá a tervezést.”
Dan Berglund, COO/CFO
Opes Corporation · Vegyipari és élelmiszeripari gyártás
A SkyPlanner használatának kezdete, 2021 óta a szállítási határidők betartása végig 100%-os volt.
Gyakori kérdések
Van a Comarch ERP XL rendszernek API-ja a gyártási rendelésekhez?
Igen. Az XL API (CDN_API.DLL) létrehozza a gyártási rendeléseket, az XLZamknijZlecenieProd függvénnyel megtervezi és újratervezi őket, az XLDodajTerminDoProcesuProd függvénnyel műveleti időpontokat ad hozzájuk, az XLDodajRealizacjeOperacjiProd függvénnyel pedig teljesítéseket rögzít. A Comarch ERP XL Web emellett Swagger felületen dokumentált REST-mikroszolgáltatásokat is kínál.
Hogyan kerülnek vissza a tervezett időpontok a Comarch ERP XL rendszerbe?
Az XLDodajTerminDoProcesuProd függvénnyel, amely minden gyártási rendelés műveletéhez hozzáad egy időintervallumot (TerminOd, TerminDo). A hívást a SkyPlanner webhookja indítja el, valahányszor módosul az ütemterv.
Támogatja a Comarch ERP XL a webhookokat?
Kimenő webhookok nincsenek dokumentálva, ezért az integráció üzemenként beállított gyakorisággal kérdezi le az ERP XL adatait. A SkyPlanner saját webhookjai azonnal továbbítják az ütemterv változásait.
A Comarch APS vagy a SkyPlanner rendszert érdemes ajánlania egy Comarch-partnernek?
A SkyPlanner rendszert, ha az ügyfél heteken belül olyan ütemtervet szeretne, amely figyelembe veszi a tényleges kapacitáskorlátokat, és automatikusan naprakész marad. A Comarch APS külön alkalmazás, saját PostgreSQL-adatbázissal, integrátorral és licenckulccsal. Akkor szinkronizál, amikor a tervező kattint, az átállási idő pedig műveletenként egyetlen rögzített érték (Comarch APS súgó). A SkyPlanner havonta 199 €-tól elérhető felhőalapú szoftver, amely automatikusan újratervez, és megtervezi az átállásokat, valamint a szerszámok, a munkacsoportok és az anyagok felhasználását.
Kipróbálhatjuk a SkyPlanner rendszert az integráció kiépítése előtt?
Igen. A 30 napos ingyenes próba legfeljebb 20 munkaállomást támogat, az ERP XL-ből származó CSV- vagy Excel-adatok importálásával, bankkártya nélkül. Indítsa el a próbát, vagy egyeztessen értékesítőinkkel az integráció felméréséről.
