Integracijos / ERP / Comarch ERP XL
Comarch ERP XL integravimo vadovas gamybos tvarkaraščiams sudaryti su SkyPlanner APS
Šiame Comarch ERP XL integravimo vadove partneriams ir IT komandoms paaiškinama, kaip sujungti Comarch ERP XL su SkyPlanner APS. SkyPlanner keičiasi duomenimis su Comarch ERP XL abiem kryptimis per pačios Comarch sąsajas:
- Į SkyPlanner perduodami gamybos užsakymai (zlecenia produkcyjne) su procesais ir operacijomis, technologijos, darbo centrai, ištekliai, prekės, atsargos ir pirkimo užsakymai.
- Per XL API į kiekvieną gamybos užsakymo operaciją grąžinamas suplanuotas pradžios ir pabaigos laikas.
- Jei pasirinksite, operatorių darbo laiko įrašai grąžinami kaip operacijų vykdymo įrašai.
- SkyPlanner siunčia pranešimus per webhook sąsajas vos pasikeitus tvarkaraščiui.
Diegimo metu SkyPlanner komanda pritaiko integraciją prie jūsų Comarch ERP XL konfigūracijos ir ją prižiūri pradėjus naudoti sistemą. Šis vadovas skirtas partneriams ir programuotojams, kurie nori prisidėti arba patys kurti integraciją naudodami dokumentuotą SkyPlanner REST API (API dokumentacija).
Comarch ERP XL integravimo sąsajos
Comarch nurodo tris būdus keistis duomenimis su ERP XL: „DCOM, direct database connection (SQL Client), REST API” (DCOM, tiesioginis ryšys su duomenų baze per SQL Client, REST API) (Comarch, išversta). Gamybos tvarkaraščių sudarymo sistemai svarbiausi du iš jų:
- XL API (CDN_API.DLL). „These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Šios funkcijos sutelktos CDN_API.DLL bibliotekoje, kuri įdiegiama kartu su visa Comarch ERP XL sistema.) (Comarch pagalba, išversta) Išorinė programa prisijungia per XLLogin, iškviečia funkcijas, naudojančias tą patį seansą, ir atsijungia per XLLogout. Kiekvienoje struktūroje yra laukas Wersja, kuriuo parenkama jūsų ERP XL laidai skirta parametrų rinkinio versija.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 teikia REST mikropaslaugas: „Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Kiekvienos RestAPI mikropaslaugos interaktyvi dokumentacija pasiekiama adresu /swagger.) (Comarch pagalba, išversta)
Tiesioginis SQL Client ryšys suteikia skaitymo prieigą prie ERP XL duomenų bazės pagrindiniams duomenims ir užsakymams nuskaityti, suderinus su jūsų IT komanda ir Comarch partneriu.
Gamybai skirtos XL API funkcijos
Comarch dokumentacijoje aprašytos šios gamybos funkcijos (XL128):
| Sritis | Funkcija | Paskirtis |
|---|---|---|
| Technologijos | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Sukuria technologiją, operaciją, operacijai priskiria darbo centrą, medžiagą arba gaminį |
| Gamybos užsakymai | XLNoweZlecenieProd | Sukuria gamybos užsakymą |
| Gamybos užsakymai | XLZamknijZlecenieProd | Pagal pasirinktą veiksmo kodą planuoja, perplanuoja, apskaito arba uždaro gamybos užsakymą |
| Operacijos | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Prideda operaciją arba išteklių prie gamybos proceso |
| Tvarkaraštis | XLDodajTerminDoProcesuProd | Prideda operacijos datų intervalą: IdCzynnosci, TerminOd, TerminDo |
| Vykdymas | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Prideda operacijos vykdymo įrašą prie užsakymo, keičia pagamintą kiekį |
| Dokumentai | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Sukuria RW ir PW dokumentus gamybos objektams |
Autentifikavimas ir prieiga
- XL API. Integracija per XLLogin prisijungia prie duomenų bazės ERP XL operatoriaus vardu ir gauna seansą tolesniems iškvietimams. DLL veikia Windows kompiuteryje, kuriame įdiegta ERP XL, todėl duomenų grąžinimo tarnyba veikia jūsų tinkle, šalia ERP XL.
- REST API. Prieiga konfigūruojama kiekvienai ERP XL Web diegčiai atskirai; kiekvienos mikropaslaugos iškvietimai aprašyti jos Swagger puslapyje.
- Skaitymas per SQL. Jūsų IT komandos patvirtinta duomenų bazės paskyra, turinti tik skaitymo teises.
SkyPlanner pusėje REST API autentifikavimui naudojamas API prieigos raktas, perduodamas Authorization-Token antraštėje (SkyPlanner Settings > API). API dokumentacija pateikta Swagger/OpenAPI formatu. Integravimo pamokoje paaiškinti pirmieji iškvietimai.
Įvykiai ir periodinės užklausos
Peržiūrėtoje Comarch ERP XL dokumentacijoje nenurodyta jokių siunčiamų webhook pranešimų. Pačios Comarch APS nuskaito duomenis, kai planuotojas paspaudžia „Aktualizuj dane z ERP“ (atnaujinti duomenis iš ERP) (Comarch APS pagalba).
Todėl ERP XL duomenys tikrinami periodinėmis užklausomis. Nauji darbai aptinkami nuskaitant tik neužbaigtus gamybos užsakymus ir naujausius pakeitimus. Dažnis nustatomas kiekvienai gamyklai: gamybos užsakymai gali būti nuskaitomi kas kelias minutes, o atsargos – kas valandą.
Pasikeitus būsenai ar tvarkaraščiui, SkyPlanner siunčia webhook pranešimus, todėl duomenų grąžinimą inicijuoja įvykiai.
Duomenų susiejimas
| Comarch ERP XL objektas (sąsaja) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
| Karty towarów, matavimo vienetai (skaitymas per REST arba SQL) | Gaminiai ir medžiagos | ERP XL → SkyPlanner | Pradinis įkėlimas, vėliau – periodinės užklausos |
| Technologia: operacijos, kiekvienai operacijai priskirtos medžiagos, pusgaminiai ir gaminiai | Gaminio struktūra, pusgaminiai, kiekvienam proceso žingsniui priskirtos medžiagos | ERP XL → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| Technologia operacijos: darbo centrai, ištekliai, laiko duomenys | Proceso žingsniai su trukme, paruošimo ir sutvarkymo po darbo laiku | ERP XL → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| Gniazda robocze ir zasoby (įrenginiai, įrankiai, darbuotojai) | Darbo centrai, darbo centrų grupės, įrankiai, personalas | ERP XL → SkyPlanner | Pradinis įkėlimas, vėliau – retai |
| Kalendarze i okresy, przestoje i awarie | Pamainos, nedarbo laikas ir prastovos | ERP XL → SkyPlanner | Kasdien arba pamainos tvarkomos pačioje SkyPlanner |
| Zlecenia produkcyjne (ZP) su procesais, operacijomis, medžiagomis, įvykdymo terminu ir prioritetu | Užsakymai ir užduotys su įvykdymo terminais ir medžiagų poreikiu | ERP XL → SkyPlanner | Periodinės užklausos kas kelias minutes |
| Atsargos pagal sandėlį | Atsargų likučiai | ERP XL → SkyPlanner | Užklausos kas valandą arba sudarant tvarkaraštį |
| Zamówienia zakupu (ZZ) su pristatymo datomis | Pirkimo užsakymai, gaunamos medžiagos pagal pristatymo datą | ERP XL → SkyPlanner | Užklausos kas valandą arba sudarant tvarkaraštį |
| Operacijų terminai: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Suplanuota kiekvienos užduoties pradžia ir pabaiga | SkyPlanner → ERP XL | Pasikeitus tvarkaraščiui, per SkyPlanner webhook pranešimą |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Darbo laiko įrašai ir operatorių patvirtinimai | SkyPlanner → ERP XL | Po kiekvieno patvirtinimo arba kas pamainą, jei pasirinkta |
| ERP XL nėra | Perėjimo tarp užduočių laiko matrica, įrankiai kaip riboti ištekliai, kelių operatorių užduotys, alternatyvūs įrenginiai ir darbuotojai | Tvarkoma SkyPlanner | Konfigūruojama diegimo metu |
Integravimo scenarijai
1. Pradinis pagrindinių duomenų įkėlimas. Nuskaitykite prekes, technologijas, darbo centrus, išteklius ir kalendorius. Apgalvotai susiekite darbo centrus su SkyPlanner: darbo centras su keturiais įrenginiais tampa viena darbo centrų grupe arba keturiais darbo centrais. ERP XL ištekliams priskirti įrankiai SkyPlanner sistemoje tampa riboto prieinamumo įrankiais, o darbuotojai – personalu su pamainomis.
2. Užsakymų sinchronizavimas. Nuskaitykite gamybos užsakymus su jų operacijomis ir medžiagomis, taip pat neįvykdytus pirkimo užsakymus. SkyPlanner laiko užsakytas medžiagas prieinamomis pirkimo užsakyme nurodytą pristatymo dieną ir atnaujina atsargų likučius, kai pirkimo užsakymas pažymimas būsena Delivered.
3. Tvarkaraščio grąžinimas į ERP. Kai planavimo variklis suplanuoja arba perkelia operaciją, SkyPlanner webhook pranešimas paleidžia duomenų grąžinimo tarnybą. Ji iškviečia XLDodajTerminDoProcesuProd su operacijos TerminOd ir TerminDo reikšmėmis, todėl kiekvienai ZP operacijai įrašoma SkyPlanner suplanuota pradžia ir pabaiga.
4. Darbų patvirtinimas ceche. Operatoriai registruoja darbą naudodami SkyPlanner Mobile Confirmations arba Production Timer, o pagal laiko įrašus tvarkaraštis nuolat atnaujinamas. Jūs pasirenkate, ar faktinis laikas perduodamas atgal. Jei taip, paslauga prideda operacijų vykdymo įrašus per XLDodajRealizacjeOperacjiProd, o RW ir PW dokumentai tvarkomi pagal jūsų ERP XL taisykles. Jei kai kuriuose darbo centruose naudojate Comarch MES, kiekvienai operacijai palikite tik vieną vykdymo duomenų šaltinį.
5. Atsakomybės už duomenis ir konfliktų sprendimo taisyklės. Užrašykite jas prieš pradėdami naudoti integraciją:
| Duomenys | Atsakinga sistema |
|---|---|
| Prekės, technologijos, kiekiai, ZP būsena, savikainos skaičiavimas | Comarch ERP XL |
| Operacijų seka, pradžios ir pabaigos laikas, išteklių priskyrimas | SkyPlanner |
| Perėjimo tarp užduočių laiko matrica, reikalavimai įrankiams ir operatoriams, alternatyvūs ištekliai | SkyPlanner |
| Pamainos, kalendoriai ir prastovos | Viena sistema, pasirinkta apibrėžiant apimtį |
| Operacijų vykdymo įrašai, RW ir PW dokumentai | Comarch ERP XL: duomenys įvedami tiesiogiai arba perduodami iš SkyPlanner laiko įrašų |
Pasirinkite vieną sistemą, kuri įrašo operacijų datas. Jei ERP XL automatinis perplanavimas arba Comarch APS vis dar įrašo terminus į tuos pačius gamybos užsakymus, išjunkite šią funkciją užsakymams, kuriuos planuoja SkyPlanner.
Įprasti projekto etapai
Pradėjus diegimo darbus, jie paprastai užbaigiami per kelias savaites. Prieš tai patikrinkite tvarkaraštį per 30 dienų nemokamą bandomąjį laikotarpį, naudodami iš ERP XL CSV arba Excel formatu eksportuotus darbo centrus, technologijas ir nebaigtus gamybos užsakymus.
- Duomenų susiejimas. Patvirtinkite susiejimo lentelę, atsakomybės už duomenis taisykles, sinchronizavimo dažnį ir tai, ar operacijų vykdymo įrašai bus perduodami atgal.
- Prieiga prie ERP XL. Sukurkite integracijai skirtą operatorių, sukonfigūruokite ryšį duomenims nuskaityti ir įdiekite duomenų grąžinimo tarnybą kompiuteryje, kuriame įdiegta ERP XL. Pirmiausia išbandykite duomenų bazės kopijoje.
- Pradinis duomenų įkėlimas. Prekės, technologijos, darbo centrai, ištekliai, kalendoriai.
- Gamybos ir pirkimo užsakymų sinchronizavimas. Periodinės užklausos su filtrais ir pakartotiniais bandymais.
- Apribojimų nustatymas SkyPlanner. Perėjimo tarp užduočių laiko matrica, įrankiai, operatorių skaičius kiekvienai užduočiai ir alternatyvios mašinos ar darbuotojai.
- Tvarkaraščio įrašymas atgal į ERP. XLDodajTerminDoProcesuProd iškvietimai pagal SkyPlanner „webhook“ pranešimus ir operacijų vykdymo įrašai, jei pasirinkta juos perduoti.
- Lygiagretus testavimas. Naudokite SkyPlanner kartu su esamu planu, palyginkite datas ir pataisykite pagrindinius duomenis.
- Naudojimo pradžia. Kai duomenys sutaps, įjunkite įrašymą atgal į ERP.
Į ką atsižvelgti planuojant Comarch ERP XL integraciją
- Rankiniu būdu įvestas pajėgumas. ERP XL darbo centro pajėgumas nurodomas naudotojo nustatytu skaičiumi ir leistinos apkrovos procentu. SkyPlanner pajėgumą nustato pagal faktines pamainas ir išteklius, todėl pamainas sukonfigūruokite atidžiai, o procentinės reikšmės nenaudokite.
- Neriboti ištekliai. ERP XL netikrina išteklių užimtumo, jei jų pajėgumas pažymėtas kaip neribotas. Kiekvienam tokiam ištekliui nuspręskite, ar SkyPlanner jis taps riboto pajėgumo darbo centru.
- Gamybai perduoti užsakymai. ERP XL neperplanuoja gamybai perduotų operacijų, nebent pažymėta parinktis „Przesuń na zwolnionych“. Sutarkite, kaip SkyPlanner datos bus taikomos gamybai perduotiems užsakymams, ir naudokite Running Time Lock, kad užfiksuotumėte artimiausių valandų darbus.
- Struktūrų versijos. XL API struktūrose yra laukas Wersja. Nustatykite jo reikšmę pagal savo ERP XL versiją ir pakartokite testavimą po kiekvieno metinio atnaujinimo.
- Lenkiški matavimo vienetai ir laiko reikšmės. Importuojant būtina tiksliai konvertuoti operacijų laiką ir kalendoriaus vienetus, kitaip visos trukmės bus klaidingos.
Kas konfigūruoja ir prižiūri Comarch ERP XL integraciją
- SkyPlanner komanda sukonfigūruoja integraciją diegimo metu ir prižiūri ją pradėjus naudoti. Ji rūpinasi sutartomis skaitymo operacijomis ir XL API iškvietimais. Kiekviena gamykla Comarch ERP XL naudoja savaip, todėl čia praverčia konkrečios gamyklos darbo išmanymas.
- Gali dalyvauti ir jūsų Comarch partneris. Partneris išmano jūsų konfigūraciją, licencijavimą ir XL API, todėl kartu su SkyPlanner komanda gali sukurti operatorių, nustatyti skaitymo ryšį ir paruošti kompiuterį duomenims įrašyti atgal.
- Jūsų programuotojai gali plėsti integraciją naudodami SkyPlanner REST API ir API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Dokumentaciją rasite skiltyje SkyPlanner integracijos dokumentacija.
SkyPlanner kaina prasideda nuo 199 € per mėnesį; į ją įtraukti 5 darbo centrai, mokama kas mėnesį. Integracijos kainos pasiūlymas parengiamas iš anksto pagal jūsų procesą ir poreikius, kartu su pasirinktu planu. Peržiūrėkite kainodarą, Comarch ERP XL gamybos planavimą pagal realų mašinų ir darbuotojų pajėgumą, Comarch ERP XL puslapį ir ERP integracijų apžvalgą.
Gamintojų atsiliepimai apie SkyPlanner
2 hsutaupoma kas savaitę
„Su SkyPlanner nuo gamybos planavimo Excel lentelėse perėjome prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros skydai ir skirstomieji įrenginiai
Planuojant gamybą kas savaitę sutaupomos 2 darbo valandos, o nauja darbų eilė gamybos liniją pasiekia per kelias sekundes.
+90%gamybos efektyvumas
„Gamybos efektyvumas padidėjo 90%.“
Abdul Rucyinga, IT vadovas
Laboratory & Allied · Vaistų gamyba
Gamybos efektyvumas padidėjo 90%, o optimizuotas trijų mėnesių planas visiems darbo centrams sudaromas per mažiau nei 30 minučių.
6 mėnesiamsį priekį pardavėjai mato laisvus pajėgumus
„SkyPlanner suteikia pagrindą visam gamybos planavimui ir užtikrina jo patikimumą.“
Anu Järvinen, gamybos vadovė
Fredman Operations · Su maistu liestis tinkamas pakavimo popierius
Pardavėjai mato laisvus pajėgumus šešiems mėnesiams į priekį, o į prašymus pakeisti tvarkaraštį, kuriems anksčiau reikėdavo valandos ar daugiau, dabar atsakoma per kelias sekundes.
100%pristatymo patikimumas nuo 2021 m.
„SkyPlanner leidžia matyti pajėgumus ir užtikrina planavimo nuspėjamumą.“
Dan Berglund, COO/CFO
Opes Corporation · Chemijos ir maisto produktų gamyba
Pristatymo patikimumas siekia 100% visą SkyPlanner naudojimo laikotarpį – nuo 2021 m.
Dažniausiai užduodami klausimai
Ar Comarch ERP XL turi gamybos užsakymams skirtą API?
Taip. XL API (CDN_API.DLL) leidžia kurti gamybos užsakymus, juos planuoti ir perplanuoti per XLZamknijZlecenieProd, pridėti operacijų datas per XLDodajTerminDoProcesuProd ir perduoti operacijų vykdymo įrašus per XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web papildomai teikia REST mikropaslaugas, aprašytas Swagger dokumentacijoje.
Kaip suplanuotos datos įrašomos atgal į Comarch ERP XL?
Per funkciją XLDodajTerminDoProcesuProd, kuri kiekvienai gamybos užsakymo operacijai prideda datų intervalą (TerminOd, TerminDo). Kaskart pasikeitus tvarkaraščiui, SkyPlanner „webhook“ pranešimas inicijuoja šį iškvietimą.
Ar Comarch ERP XL palaiko „webhook“ pranešimus?
Dokumentacijoje siunčiamų „webhook“ pranešimų nėra aprašyta, todėl integracija periodiškai užklausia ERP XL pagal kiekvienai gamyklai nustatytą grafiką. SkyPlanner „webhook“ pranešimai perduoda tvarkaraščio pakeitimus iškart jiems įvykus.
Ką Comarch partneriui siūlyti – Comarch APS ar SkyPlanner?
SkyPlanner, kai klientas nori per kelias savaites gauti tvarkaraštį, kuris atitiktų realų mašinų ir darbuotojų pajėgumą ir būtų nuolat automatiškai atnaujinamas. Comarch APS yra atskira programa su savo PostgreSQL duomenų baze, integravimo komponentu ir licencijos raktu. Ji sinchronizuojama planuotojui spustelėjus, o kiekvienai operacijai nustatoma viena fiksuota paruošimo laiko reikšmė (Comarch APS pagalba). SkyPlanner yra debesijos programinė įranga, kuri automatiškai perplanuoja gamybą ir planuoja perderinimus, įrankius, brigadas bei medžiagas. Kaina – nuo 199 € per mėnesį.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti ERP XL duomenis CSV arba Excel formatu. Kredito kortelės nereikia. Pradėkite bandomąjį laikotarpį arba susisiekite su pardavimų komanda, kad apibrėžtumėte integracijos apimtį.
