Integrácie / ERP / Comarch ERP XL
Sprievodca integráciou Comarch ERP XL so SkyPlanner APS na rozvrhovanie výroby
Tento sprievodca integráciou Comarch ERP XL ukazuje partnerom a IT tímom, ako prepojiť Comarch ERP XL so SkyPlanner APS. SkyPlanner sa s Comarch ERP XL prepája obojsmerne prostredníctvom vlastných rozhraní spoločnosti Comarch:
- Do SkyPlanner prichádzajú výrobné zákazky (zlecenia produkcyjne) s procesmi a operáciami, technológie, pracoviská, zdroje, položky, zásoby a nákupné objednávky.
- Plánované časy začiatku a konca sa cez XL API zapisujú späť ku každej operácii výrobnej zákazky.
- Ak si túto možnosť zvolíte, časové záznamy operátorov sa zapisujú späť ako realizácie operácií.
- Webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Tím SkyPlanner počas úvodného nasadenia prispôsobí integráciu vašej konfigurácii Comarch ERP XL a po spustení ostrej prevádzky zabezpečuje jej podporu. Tento sprievodca je určený partnerom a vývojárom, ktorí sa chcú zapojiť alebo sami vytvoriť riešenie s využitím zdokumentovaného REST API systému SkyPlanner (referenčná dokumentácia API).
Integračné rozhrania Comarch ERP XL
Comarch uvádza tri spôsoby komunikácie s ERP XL: „DCOM, direct database connection (SQL Client), REST API“ (DCOM, priame pripojenie k databáze cez SQL Client, REST API) (Comarch, preklad). Pri rozvrhovaní sa využívajú najmä dva z nich:
- XL API (CDN_API.DLL). „These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.“ (Tieto funkcie sú súčasťou knižnice CDN_API.DLL, ktorá sa inštaluje spolu s celým systémom Comarch ERP XL.) (Pomocník Comarch, preklad) Externý program sa prihlási cez XLLogin, volá funkcie v rámci spoločnej relácie a odhlási sa cez XLLogout. Každá štruktúra má pole Wersja, ktoré určuje verziu sady parametrov pre vaše vydanie ERP XL.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 sprístupňuje mikroslužby REST: „Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.“ (Každá mikroslužba RestAPI sprístupňuje vlastnú interaktívnu dokumentáciu na koncovom bode /swagger.) (Pomocník Comarch, preklad)
Priame pripojenie cez SQL Client umožňuje čítať kmeňové dáta a zákazky z databázy ERP XL v rozsahu dohodnutom s vaším IT tímom a partnerom Comarch.
Funkcie XL API pre výrobu
Comarch dokumentuje tieto funkcie pre výrobu (XL128):
| Oblasť | Funkcia | Čo robí |
|---|---|---|
| Technológie | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Vytvorenie technológie, operácie, pracoviska priradeného k operácii, materiálu alebo výrobku priradeného k operácii |
| Výrobné zákazky | XLNoweZlecenieProd | Vytvorenie výrobnej zákazky |
| Výrobné zákazky | XLZamknijZlecenieProd | Naplánuje, preplánuje, vyúčtuje alebo uzavrie výrobnú zákazku podľa zvoleného kódu akcie |
| Operácie | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Pridá operáciu alebo zdroj do výrobného procesu |
| Rozvrh | XLDodajTerminDoProcesuProd | Pridá časový interval k operácii: IdCzynnosci, TerminOd, TerminDo |
| Realizácia | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Pridá realizáciu operácie k zákazke, zmení realizované množstvo |
| Doklady | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Vytvorí doklady RW a PW pre výrobné objekty |
Autentifikácia a prístup
- XL API. Integrácia sa cez XLLogin prihlási do databázy ako operátor ERP XL a získa reláciu pre ďalšie volania. Knižnica DLL beží na hostiteľskom počítači so systémom Windows a nainštalovaným ERP XL. Služba spätného zápisu preto beží vo vašej sieti, v rovnakom prostredí ako ERP XL.
- REST API. Prístup sa nastavuje pre každú inštaláciu ERP XL Web samostatne. Volania jednotlivých mikroslužieb sú zdokumentované na ich stránkach Swagger.
- Čítanie cez SQL. Databázový účet len na čítanie, schválený vaším IT tímom.
Na strane SkyPlanner sa prístup k REST API overuje tokenom API v hlavičke Authorization-Token (SkyPlanner Settings > API). Rozhranie je zdokumentované vo formáte Swagger/OpenAPI. Návod na integráciu vás prevedie prvými volaniami.
Udalosti a pravidelné načítavanie
V preverenej dokumentácii Comarch ERP XL nie sú uvedené žiadne odchádzajúce webhooky. Vlastný APS systém spoločnosti Comarch načíta dáta, keď plánovač stlačí „Aktualizuj dane z ERP“ (Aktualizovať dáta z ERP) (Pomocník Comarch APS).
Dáta z ERP XL sa preto načítavajú pravidelne. Nové výrobné úlohy sa zisťujú načítavaním otvorených výrobných zákaziek a najnovších zmien. Frekvencia sa nastavuje pre každý závod osobitne: výrobné zákazky sa načítavajú každých niekoľko minút, zásoby každú hodinu.
SkyPlanner odosiela webhooky pri zmene stavu alebo rozvrhu, takže spätný zápis sa spúšťa na základe udalostí.
Mapovanie dát
| Objekt Comarch ERP XL (rozhranie) | Objekt SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
| Karty towarów, merné jednotky (REST alebo čítanie cez SQL) | Výrobky a materiály | ERP XL → SkyPlanner | Úvodné načítanie, potom pravidelne |
| Technologia: operácie, materiály, polotovary a výrobky pre jednotlivé operácie | Štruktúra výrobku, čiastkové výrobky, materiály pre jednotlivé kroky procesu | ERP XL → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Operácie v Technologia: pracoviská, zdroje, časy | Kroky procesu s trvaním, časmi nastavenia a časmi demontáže | ERP XL → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Gniazda robocze a zasoby (stroje, nástroje, zamestnanci) | Pracoviská, skupiny pracovísk, nástroje, personál | ERP XL → SkyPlanner | Úvodné načítanie, potom zriedkavo |
| Kalendarze i okresy, przestoje i awarie | Zmeny, nepracovný čas a prestoje | ERP XL → SkyPlanner | Denne alebo vlastná správa zmien v SkyPlanner |
| Zlecenia produkcyjne (ZP) s procesmi, operáciami, materiálmi, termínom dokončenia a prioritou | Zákazky a operácie s termínmi dokončenia a materiálovými potrebami | ERP XL → SkyPlanner | Načítavanie každých niekoľko minút |
| Zásoby podľa skladov | Skladové zostatky | ERP XL → SkyPlanner | Načítavanie každú hodinu alebo pri spustení rozvrhovania |
| Zamówienia zakupu (ZZ) s termínmi dodania | Nákupné objednávky, očakávaný materiál podľa termínu dodania | ERP XL → SkyPlanner | Načítavanie každú hodinu alebo pri spustení rozvrhovania |
| Termíny operácií: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Plánovaný začiatok a koniec každej operácie | SkyPlanner → ERP XL | Pri zmene rozvrhu cez webhook SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Časové záznamy a potvrdenia operátorov | SkyPlanner → ERP XL | Pri každom potvrdení alebo za každú zmenu, ak si túto možnosť zvolíte |
| Nie je v ERP XL | Matica časov na prípravu a ukončenie operácií, nástroje ako zdroje s obmedzenou kapacitou, operácie s viacerými operátormi, alternatívne stroje a personál | Spravuje sa v SkyPlanner | Nastavuje sa počas úvodného nasadenia |
Integračné postupy
1. Úvodné načítanie kmeňových dát. Načítajte položky, technológie, pracoviská, zdroje a kalendáre. Dôkladne zvážte mapovanie pracovísk do SkyPlanner: pracovisko so štyrmi strojmi sa zmení na jednu skupinu pracovísk alebo štyri pracoviská. Nástroje evidované medzi zdrojmi ERP XL sa v SkyPlanner stanú nástrojmi s obmedzenou kapacitou a zamestnanci personálom s priradenými zmenami.
2. Synchronizácia zákaziek a objednávok. Načítajte výrobné zákazky s operáciami a materiálmi aj otvorené nákupné objednávky. SkyPlanner považuje objednaný materiál za dostupný v deň dodania uvedený v nákupnej objednávke a aktualizuje zásoby, keď je objednávka označená stavom Delivered.
3. Spätný zápis rozvrhu. Keď plánovací mechanizmus zaradí alebo presunie operáciu, webhook systému SkyPlanner spustí službu spätného zápisu. Tá zavolá XLDodajTerminDoProcesuProd s hodnotami TerminOd a TerminDo danej operácie. Každá operácia ZP tak obsahuje začiatok a koniec naplánovaný systémom SkyPlanner.
4. Odvádzanie výroby. Operátori zaznamenávajú prácu cez SkyPlanner Mobile Confirmations alebo Production Timer a časové záznamy udržiavajú rozvrh aktuálny. Sami rozhodnete, či sa majú skutočné časy zapisovať späť. Ak áno, služba pridáva záznamy realizácie cez XLDodajRealizacjeOperacjiProd a doklady RW a PW sa riadia vašimi pravidlami v ERP XL. Ak na niektorých pracoviskách používate Comarch MES, pre každú operáciu ponechajte len jeden zdroj hlásení.
5. Pravidlá vlastníctva dát a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:
| Dáta | Vlastník |
|---|---|
| Položky, technológie, množstvá, stav ZP, kalkulácia nákladov | Comarch ERP XL |
| Poradie operácií, časy začiatku a konca, priradenie zdrojov | SkyPlanner |
| Matica časov na prípravu a ukončenie operácií, požiadavky na nástroje a operátorov, alternatívne zdroje | SkyPlanner |
| Zmeny, kalendáre a prestoje | Jeden systém zvolený pri definovaní rozsahu |
| Záznamy realizácie, doklady RW a PW | Comarch ERP XL – zadávané priamo v ňom alebo prenášané z časových záznamov systému SkyPlanner |
Určte jeden systém, ktorý bude zapisovať termíny operácií. Ak automatické preplánovanie v ERP XL alebo Comarch APS naďalej zapisuje termíny do tých istých výrobných príkazov, vypnite túto funkciu pre príkazy rozvrhované systémom SkyPlanner.
Typický priebeh projektu
Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku zavádzania. Ešte predtým si overte rozvrh počas 30-dňovej bezplatnej skúšobnej verzie s pracoviskami, technológiami a otvorenými výrobnými príkazmi exportovanými z ERP XL vo formáte CSV alebo Excel.
- Mapovanie. Dohodnite mapovaciu tabuľku, pravidlá vlastníctva dát, frekvenciu synchronizácie a to, či sa budú záznamy realizácie zapisovať späť.
- Prístup k ERP XL. Vytvorte operátora pre integráciu, nastavte pripojenie na čítanie a službu spätného zápisu umiestnite na hostiteľský počítač s nainštalovaným ERP XL. Najprv všetko otestujte na kópii databázy.
- Úvodné načítanie. Položky, technológie, pracoviská, zdroje, kalendáre.
- Synchronizácia výrobných príkazov a nákupných objednávok. Pravidelné dopytovanie s filtrami a opakovanými pokusmi.
- Nastavenie obmedzení v systéme SkyPlanner. Matica časov na prípravu a ukončenie operácií, nástroje, počty operátorov na operáciu a alternatívne stroje alebo pracovníci.
- Spätný zápis rozvrhu. Volania XLDodajTerminDoProcesuProd spúšťané webhookmi systému SkyPlanner a podľa dohody aj zápis záznamov realizácie.
- Paralelné testovanie. Používajte SkyPlanner súbežne s aktuálnym plánom, porovnávajte termíny a opravujte kmeňové dáta.
- Spustenie ostrej prevádzky. Keď sa dáta zhodujú, zapnite spätný zápis.
S čím počítať pri integrácii s Comarch ERP XL
- Ručne zadaná kapacita. Kapacita pracoviska v ERP XL je používateľom zadané číslo s povoleným vyťažením v %. SkyPlanner namiesto toho odvodzuje kapacitu zo skutočných zmien a zdrojov. Zmeny preto nastavte dôsledne a percentuálne vyťaženie už nepoužívajte.
- Zdroje s neobmedzenou kapacitou. Pri zdrojoch označených ako zdroje s neobmedzenou kapacitou ERP XL nekontroluje obsadenosť. Pri každom rozhodnite, či bude v systéme SkyPlanner pracoviskom s obmedzenou kapacitou.
- Uvoľnené príkazy. ERP XL nezahŕňa operácie uvoľnené do výroby do preplánovania, pokiaľ nie je začiarknutá možnosť „Przesuń na zwolnionych“. Dohodnite sa, ako sa termíny zo systému SkyPlanner uplatnia na uvoľnené príkazy, a pomocou Running Time Lock uzamknite rozvrh práce na najbližšie hodiny.
- Verzie štruktúr. Štruktúry XL API obsahujú pole Wersja. Nastavte ho podľa verzie vášho ERP XL a po každej ročnej aktualizácii integráciu znova otestujte.
- Poľské jednotky a časy. Časy operácií a jednotky kalendára sa musia pri importe previesť presne, inak budú všetky časy trvania nesprávne.
Kto nastavuje integráciu s Comarch ERP XL a poskytuje jej podporu
- Tím SkyPlanner integráciu nastaví počas zavádzania a po spustení ostrej prevádzky poskytuje podporu, a to v rozsahu dohodnutého čítania dát a volaní XL API. Každý závod používa Comarch ERP XL inak a práve tu sa uplatnia znalosti jeho konkrétnej prevádzky.
- Zapojiť sa môže aj váš partner Comarch. Pozná vaše nastavenie, licencie aj XL API a spolu s tímom SkyPlanner môže nastaviť operátora, pripojenie na čítanie a hostiteľský počítač pre spätný zápis.
- Vaši vývojári môžu integráciu ďalej rozvíjať cez REST API systému SkyPlanner s použitím API tokenu. Na začiatok stačí API token a tím SkyPlanner vám v prípade potreby pomôže. Podrobnosti nájdete v dokumentácii integrácie SkyPlanner.
Cena systému SkyPlanner sa začína na 199 € mesačne za 5 pracovísk s mesačnou fakturáciou. Cenovú ponuku na integráciu dostanete vopred spolu s ponukou na váš program, podľa vašich procesov a potrieb. Pozrite si cenník, plánovanie výroby pre Comarch ERP XL so zohľadnením skutočnej kapacity strojov a pracovníkov, stránku Comarch ERP XL a prehľad integrácií s ERP.
Ako výrobcovia hodnotia SkyPlanner
2 hušetrené každý týždeň
„So systémom SkyPlanner sme pri plánovaní výroby prešli od excelových tabuliek k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista dodávateľského reťazca
UTU · Elektrické rozvádzače a spínacie zariadenia
Pri plánovaní výroby ušetria každý týždeň 2 hodiny práce a nový zoznam operácií sa na linku dostane za niekoľko sekúnd.
+90%efektívnosť výroby
„Efektívnosť výroby sa zvýšila o 90 %.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektívnosť výroby sa zvýšila o 90 % a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej ako 30 minút.
6 mesiacovdopredu vidí obchodný tím voľnú kapacitu
„SkyPlanner poskytuje spoľahlivý základ pre celé plánovanie výroby.“
Anu Järvinen, vedúca výroby
Fredman Operations · Baliace papiere vhodné na styk s potravinami
Obchodný tím vidí voľnú kapacitu na šesť mesiacov dopredu. Na požiadavky na zmenu rozvrhu, ktorých vybavenie trvalo hodinu alebo aj dlhšie, teraz dostáva odpovede za niekoľko sekúnd.
100%spoľahlivosť dodávok od roku 2021
„SkyPlanner nám dáva prehľad o kapacite a vďaka nemu je plánovanie predvídateľné.“
Dan Berglund, COO/CFO
Opes Corporation · Chemická a potravinárska výroba
Spoľahlivosť dodávok dosahuje 100 % počas celého obdobia používania systému SkyPlanner, teda od roku 2021.
Často kladené otázky
Má Comarch ERP XL API pre výrobné príkazy?
Áno. XL API (CDN_API.DLL) vytvára výrobné príkazy, plánuje a preplánováva ich cez XLZamknijZlecenieProd, pridáva termíny operácií cez XLDodajTerminDoProcesuProd a zapisuje záznamy realizácie cez XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web navyše poskytuje mikroslužby REST zdokumentované v nástroji Swagger.
Ako sa plánované termíny zapisujú späť do Comarch ERP XL?
Prostredníctvom volania XLDodajTerminDoProcesuProd, ktoré pridá časový interval (TerminOd, TerminDo) ku každej operácii výrobného príkazu. Volanie spustí webhook systému SkyPlanner pri každej zmene rozvrhu.
Podporuje Comarch ERP XL webhooky?
Odchádzajúce webhooky nie sú zdokumentované, preto integrácia pravidelne dopytuje ERP XL v intervaloch nastavených pre konkrétny závod. Vlastné webhooky systému SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Má partner Comarch odporučiť Comarch APS alebo SkyPlanner?
SkyPlanner, ak zákazník chce v priebehu niekoľkých týždňov získať rozvrh, ktorý rešpektuje skutočnú kapacitu strojov a pracovníkov a automaticky sa aktualizuje. Comarch APS je samostatná aplikácia s vlastnou databázou PostgreSQL, integrátorom a licenčným kľúčom. Synchronizuje sa po kliknutí plánovača a čas nastavenia je v nej jedna pevná hodnota pre každú operáciu (pomocník Comarch APS). SkyPlanner je cloudový softvér, ktorý automaticky preplánováva a plánuje prestavenia, nástroje, pracovné tímy aj materiál, už od 199 € mesačne.
Môžeme SkyPlanner otestovať ešte pred vytvorením integrácie?
Áno. Bezplatná 30-dňová skúšobná verzia podporuje až 20 pracovísk s importom dát z ERP XL cez CSV alebo Excel, bez potreby platobnej karty. Vyskúšajte ju alebo kontaktujte obchodný tím a dohodnite rozsah integrácie.
