Liidestused / ERP / Comarch ERP XL
Comarch ERP XL-i integreerimisjuhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See Comarch ERP XL-i integreerimisjuhend näitab partneritele ja IT-meeskondadele, kuidas ühendada Comarch ERP XL SkyPlanner APS-iga. SkyPlanner vahetab Comarch ERP XL-iga andmeid mõlemas suunas, kasutades Comarchi enda liideseid:
- SkyPlannerisse tuuakse tootmistellimused (zlecenia produkcyjne) koos protsesside ja operatsioonidega, tehnoloogiad, töökeskused, ressursid, artiklid, laoseisud ja ostutellimused.
- Planeeritud algus- ja lõppajad kirjutatakse XL API kaudu tagasi iga tootmistellimuse operatsiooni juurde.
- Soovi korral saadetakse operaatorite ajakirjed tagasi operatsioonide täitmisandmetena.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe, kui need toimuvad.
SkyPlanneri meeskond seadistab liidestuse kasutuselevõtu käigus teie Comarch ERP XL-i seadistusele vastavaks ja pakub tuge ka pärast käivitamist. See juhend on partneritele ja arendajatele, kes soovivad töös osaleda või ise SkyPlanneri dokumenteeritud REST API abil lahendusi luua (API dokumentatsioon).
Comarch ERP XL-i liidestusvõimalused
Comarch loetleb kolm võimalust ERP XL-iga suhtlemiseks: “DCOM, direct database connection (SQL Client), REST API” (DCOM, otseühendus andmebaasiga (SQL Client), REST API) (Comarch, tõlgitud). Ajakava koostamisel on neist kasutusel kaks:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Need funktsioonid on koondatud teeki CDN_API.DLL, mis paigaldatakse koos kogu Comarch ERP XL-i süsteemiga.) (Comarchi abimaterjal, tõlgitud) Väline programm logib sisse funktsiooniga XLLogin, kutsub välja sama seanssi kasutavaid funktsioone ja logib välja funktsiooniga XLLogout. Igal struktuuril on väli Wersja, millega valitakse teie ERP XL-i väljalaskele vastav parameetrikomplekti versioon.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 pakub REST-mikroteenuseid: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Iga RestAPI mikroteenuse interaktiivne dokumentatsioon asub selle /swagger-lõpp-punktis.) (Comarchi abimaterjal, tõlgitud)
Otsene SQL Client ühendus annab lugemisõiguse ERP XL-i andmebaasile, et lugeda põhiandmeid ja tellimusi vastavalt teie IT-meeskonna ning Comarchi partneriga kokkulepitule.
XL API tootmisfunktsioonid
Comarchi dokumentatsioonis on kirjeldatud järgmised tootmisfunktsioonid (XL128):
| Valdkond | Funktsioon | Mida see teeb |
|---|---|---|
| Tehnoloogiad | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Uue tehnoloogia või operatsiooni loomine, töökeskuse, materjali või toote lisamine operatsioonile |
| Tootmistellimused | XLNoweZlecenieProd | Uue tootmistellimuse loomine |
| Tootmistellimused | XLZamknijZlecenieProd | Planeerib, planeerib ümber, arveldab või sulgeb tootmistellimuse vastavalt valitud toimingukoodile |
| Operatsioonid | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Lisab tootmisprotsessile operatsiooni või ressursi |
| Ajakava | XLDodajTerminDoProcesuProd | Lisab operatsioonile ajavahemiku: IdCzynnosci, TerminOd, TerminDo |
| Täitmine | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Lisab tellimusele operatsiooni täitmisandmed, muudab tegelikult toodetud kogust |
| Dokumendid | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Loob tootmisobjektidele RW- ja PW-dokumendid |
Autentimine ja juurdepääs
- XL API. Liidestus logib funktsiooniga XLLogin andmebaasi sisse ERP XL-i operaatorina ja saab seansi järgmiste päringute jaoks. DLL töötab Windowsi hostis, kuhu on paigaldatud ERP XL, seega töötab tagasikirjutusteenus teie võrgus ERP XL-i kõrval.
- REST API. Juurdepääs seadistatakse iga ERP XL Webi paigalduse jaoks eraldi. Iga mikroteenuse päringuid kirjeldab selle Swaggeri leht.
- Andmete lugemine SQL-iga. Ainult lugemisõigusega andmebaasikonto, mille on heaks kiitnud teie IT-meeskond.
SkyPlanneri poolel kasutab REST API autentimiseks API tokenit päises Authorization-Token (SkyPlanner Settings > API). API on dokumenteeritud Swagger/OpenAPI abil. Liidestamise õpetus aitab teha esimesed päringud.
Sündmused ja perioodilised päringud
Läbivaadatud dokumentatsioonis ei ole Comarch ERP XL-i väljuvaid veebihaake kirjeldatud. Comarchi enda APS tõmbab andmed sisse, kui planeerija vajutab nuppu “Aktualizuj dane z ERP” (Comarch APS-i abimaterjal).
Seetõttu päritakse ERP XL-ist andmeid perioodiliselt. Uute tööde leidmiseks filtreeritakse päringud avatud tootmistellimuste ja hiljutiste muudatuste järgi. Sagedus määratakse iga tehase jaoks eraldi: tootmistellimusi päritakse iga mõne minuti järel, laoseise kord tunnis.
SkyPlanner saadab oleku või ajakava muutumisel veebihaake, seega on tagasikirjutus sündmuspõhine.
Andmete vastendamine
| Comarch ERP XL-i objekt (liides) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
| Karty towarów, mõõtühikud (REST või SQL-iga lugemine) | Tooted ja materjalid | ERP XL → SkyPlanner | Esmane laadimine, seejärel perioodilised päringud |
| Technologia: operatsioonid ning iga operatsiooni materjalid, pooltooted ja tooted | Tootestruktuur, alamtooted, iga protsessietapi materjalid | ERP XL → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
| Technologia operatsioonid: töökeskused, ressursid, ajad | Protsessietapid koos kestuse, seadistus- ja lõpetusaegadega | ERP XL → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
| Gniazda robocze ja zasoby (masinad, tööriistad, töötajad) | Töökeskused, töökeskuste rühmad, tööriistad, personal | ERP XL → SkyPlanner | Esmane laadimine, hiljem harva |
| Kalendarze i okresy, przestoje i awarie | Vahetused, tööväline aeg ja seisakud | ERP XL → SkyPlanner | Iga päev või hallatakse vahetusi SkyPlanneris |
| Zlecenia produkcyjne (ZP) koos protsesside, operatsioonide, materjalide, tähtaja ja prioriteediga | Tellimused ja tööd koos tähtaegade ning materjalivajadusega | ERP XL → SkyPlanner | Päringud iga mõne minuti järel |
| Laoseis ladude kaupa | Laosaldod | ERP XL → SkyPlanner | Päringud kord tunnis või ajakava koostamisel |
| Zamówienia zakupu (ZZ) koos tarnekuupäevadega | Ostutellimused, saabuvad materjalid tarnekuupäeva järgi | ERP XL → SkyPlanner | Päringud kord tunnis või ajakava koostamisel |
| Operatsiooni ajad: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Iga töö planeeritud algus ja lõpp | SkyPlanner → ERP XL | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Ajakirjed ja operaatorite kinnitused | SkyPlanner → ERP XL | Soovi korral iga kinnituse või vahetuse järel |
| ERP XL-is puudub | Seadistusaegade maatriks, piiratud saadavusega tööriistad, mitme operaatoriga tööd, alternatiivsed masinad ja töötajad | Hallatakse SkyPlanneris | Seadistatakse kasutuselevõtu käigus |
Liidestamise töövood
1. Põhiandmete esmane laadimine. Lugege sisse artiklid, tehnoloogiad, töökeskused, ressursid ja kalendrid. Mõelge läbi, kuidas töökeskused SkyPlanneris vastendada: nelja masinaga töökeskusest saab üks töökeskuste rühm või neli töökeskust. ERP XL-i ressursside hulka kuuluvatest tööriistadest saavad SkyPlanneris piiratud saadavusega tööriistad ning töötajatest vahetustega personal.
2. Tellimuste sünkroonimine. Lugege sisse tootmistellimused koos operatsioonide ja materjalidega ning avatud ostutellimused. SkyPlanner arvestab tellitud materjali kättesaadavaks ostutellimuse tarnekuupäeval ja uuendab laoseisu, kui ostutellimuse olekuks märgitakse Delivered.
3. Ajakava tagasikirjutamine. Kui mootor paigutab operatsiooni ajakavasse või muudab selle aega, käivitab SkyPlanneri veebikonks tagasikirjutusteenuse. Teenus kutsub välja XLDodajTerminDoProcesuProd, edastades operatsiooni TerminOd ja TerminDo väärtused. Nii on iga ZP operatsiooni juures SkyPlanneri kavandatud algus- ja lõpuaeg.
4. Tööde kinnitamine tootmises. Operaatorid registreerivad tööd SkyPlanner Mobile Confirmationsi või Production Timeri abil ning ajakirjed hoiavad ajakava ajakohasena. Teie otsustate, kas tegelikud ajad kirjutatakse tagasi. Kui jah, lisab teenus teostusandmed funktsiooniga XLDodajRealizacjeOperacjiProd ning RW- ja PW-dokumendid luuakse teie ERP XL-i reeglite järgi. Kui kasutate mõnes töökeskuses Comarch MES-i, jätke iga operatsiooni jaoks alles üks aruandlusallikas.
5. Andmete haldamise ja konfliktide lahendamise reeglid. Pange need enne kasutuselevõttu kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Artiklid, tehnoloogiad, kogused, ZP olek, kuluarvestus | Comarch ERP XL |
| Operatsioonide järjekord, algus- ja lõpuajad, ressursside määramine | SkyPlanner |
| Seadistusaegade maatriks, nõuded tööriistadele ja operaatoritele, alternatiivsed ressursid | SkyPlanner |
| Vahetused, kalendrid ja seisakud | Üks süsteem, mis valitakse ulatuse määramisel |
| Teostusandmed, RW- ja PW-dokumendid | Comarch ERP XL; andmed sisestatakse seal või edastatakse SkyPlanneri ajakirjetest |
Valige üks süsteem, mis määrab operatsioonide ajad. Kui ERP XL-i automaatne ümberplaneerimine või Comarch APS määrab endiselt samade tootmistellimuste operatsioonide aegu, lülitage see funktsioon SkyPlanneri ajastatavate tellimuste puhul välja.
Projekti tavapärased etapid
Juurutamine lõpeb tavaliselt mõne nädala jooksul pärast juurutustööde algust. Enne seda kontrollige ajakava sobivust 30-päevase tasuta prooviperioodi jooksul, kasutades ERP XL-ist CSV- või Exceli failina eksporditud töökeskusi, tehnoloogiaid ja avatud tootmistellimusi.
- Vastendamine. Leppige kokku vastendustabel, andmete haldamise reeglid, sünkroonimissagedused ja see, kas teostusandmed kirjutatakse tagasi.
- Juurdepääs ERP XL-ile. Looge integratsiooni kasutajakonto, seadistage lugemisühendus ja paigaldage tagasikirjutusteenus masinasse, kuhu on installitud ERP XL. Testige esmalt andmebaasi koopias.
- Esmane andmete laadimine. Artiklid, tehnoloogiad, töökeskused, ressursid ja kalendrid.
- Tootmis- ja ostutellimuste sünkroonimine. Perioodilised päringud koos filtrite ja korduskatsetega.
- Piirangute seadistamine SkyPlanneris. Seadistusaegade maatriks, tööriistad, operaatorite arv töö kohta ning alternatiivsed masinad või töötajad.
- Ajakava tagasikirjutamine. SkyPlanneri veebikonksude käivitatud XLDodajTerminDoProcesuProd väljakutsed ning soovi korral ka teostusandmete edastamine.
- Paralleelne testimine. Kasutage SkyPlannerit senise plaani kõrval, võrrelge kuupäevi ja parandage põhiandmeid.
- Kasutuselevõtt. Lülitage tagasikirjutamine sisse, kui andmed ühtivad.
Millega Comarch ERP XL-i integreerimisel arvestada
- Käsitsi sisestatud tootmisvõimsus. ERP XL-is määrab kasutaja töökeskuse tootmisvõimsuse arvuna koos lubatud koormuse protsendiga. SkyPlanner arvutab tootmisvõimsuse hoopis tegelike vahetuste ja ressursside põhjal, seega seadistage vahetused hoolikalt ning jätke protsent kõrvale.
- Piiramatu võimsusega ressursid. ERP XL ei kontrolli hõivatust ressurssidel, mille võimsus on märgitud piiramatuks. Otsustage iga ressursi puhul, kas sellest saab SkyPlanneris piiratud võimsusega töökeskus.
- Tootmisse lubatud tellimused. ERP XL jätab tootmisse lubatud operatsioonid ümberplaneerimisest välja, kui valik „Przesuń na zwolnionych” pole märgitud. Leppige kokku, kuidas SkyPlanneri kuupäevi tootmisse lubatud tellimustele rakendatakse, ning kasutage Running Time Locki, et lukustada järgmiste tundide tööd.
- Andmestruktuuride versioonid. XL API andmestruktuuridel on väli Wersja. Määrake selle väärtus vastavalt oma ERP XL-i versioonile ja testige pärast iga aastast versiooniuuendust uuesti.
- Poola ühikud ja ajad. Operatsioonide ajad ja kalendriühikud tuleb importimisel täpselt teisendada, muidu on kõik kestused valed.
Kes Comarch ERP XL-i integratsiooni seadistab ja toetab
- SkyPlanneri meeskond seadistab integratsiooni juurutamise käigus ja pakub tuge ka pärast kasutuselevõttu. Seadistus ja tugi hõlmavad kokkulepitud lugemispäringuid ja XL API väljakutseid. Iga tehas kasutab Comarch ERP XL-i omamoodi ning seadistamisel arvestatakse nende eripäradega.
- Teie Comarchi partner saab kaasa lüüa. Partner tunneb teie seadistust, litsentse ja XL API-t ning saab koos SkyPlanneri meeskonnaga seadistada kasutajakonto, lugemisühenduse ja tagasikirjutusteenuse hosti.
- Teie arendajad saavad lahendust edasi arendada, kasutades SkyPlanneri REST API-t ja API-pääsutõendit. Alustamiseks piisab API-pääsutõendist ning SkyPlanneri meeskond aitab vajaduse korral. Integratsiooni dokumentatsiooni leiate SkyPlanneri integratsioonijuhendist.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub iga kuu. Integratsiooni hinnapakkumine tehakse ette koos teie paketiga, lähtudes teie protsessist ja vajadustest. Vaadake hinnakirja, Comarch ERP XL-i tootmise planeerimist tegeliku võimsuse piires, Comarch ERP XL-i lehte ja ERP-integratsioonide ülevaadet.
Tootjate kogemused SkyPlanneriga
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.”
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel säästetakse igal nädalal 2 tundi tööaega ning uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmistõhusust
„Tootmise tõhusus on kasvanud 90%.”
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise tõhusus on kasvanud 90% ning kõiki töökeskusi hõlmiva optimeeritud kolmekuulise plaani koostamine võtab alla 30 minuti.
6 kuudette näeb müügimeeskond vaba tootmisvõimsust
„SkyPlanner loob kindla ja usaldusväärse aluse kogu tootmise planeerimisele.”
Anu Järvinen, tootmisjuht
Fredman Operations · Toiduga kokkupuuteks sobivad pakkepaberid
Müügimeeskond näeb vaba tootmisvõimsust kuus kuud ette ning ajakava muutmise päringutele, millele vastamine võttis varem tunni või rohkem, vastatakse nüüd sekunditega.
100%tarnekindlust alates 2021. aastast
„SkyPlanner annab meile ülevaate tootmisvõimsusest ja muudab planeerimise prognoositavaks.”
Dan Berglund, COO/CFO
Opes Corporation · Keemia- ja toiduainetööstus
Tarnekindlus on olnud 100% kogu SkyPlanneri kasutamise aja, alates 2021. aastast.
Korduma kippuvad küsimused
Kas Comarch ERP XL-il on tootmistellimuste API?
Jah. XL API (CDN_API.DLL) loob tootmistellimusi, planeerib ja planeerib neid ümber funktsiooniga XLZamknijZlecenieProd, lisab operatsioonide kuupäevi funktsiooniga XLDodajTerminDoProcesuProd ning edastab teostusandmeid funktsiooniga XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web lisab REST-mikroteenused, mis on dokumenteeritud Swaggeris.
Kuidas kavandatud kuupäevad Comarch ERP XL-i tagasi kirjutatakse?
Funktsiooniga XLDodajTerminDoProcesuProd, mis lisab igale tootmistellimuse operatsioonile ajavahemiku (TerminOd, TerminDo). SkyPlanneri veebikonks käivitab väljakutse iga kord, kui ajakava muutub.
Kas Comarch ERP XL toetab veebikonksusid?
Väljaminevaid veebikonksusid ei ole dokumenteeritud, seega teeb integratsioon ERP XL-i päringuid iga tehase jaoks määratud sagedusega. SkyPlanneri enda veebikonksud edastavad ajakava muudatused kohe nende tekkimisel.
Kas Comarchi partner peaks pakkuma Comarch APS-i või SkyPlannerit?
SkyPlannerit, kui klient soovib nädalatega kasutusele võtta ajakava, mis arvestab masinate ja töötajate tegelikku võimsust ning püsib ise ajakohasena. Comarch APS on eraldi rakendus oma PostgreSQL-i andmebaasi, integraatori ja litsentsivõtmega. Sünkroonimine toimub planeerija klõpsu peale ning seadistusaeg on iga operatsiooni kohta üks fikseeritud väärtus (Comarch APS-i abimaterjalid). SkyPlanner on pilvetarkvara, mis planeerib automaatselt ümber ning arvestab ümberseadistuste, tööriistade, meeskondade ja materjalidega. Hind algab 199 € kuus.
Kas saame SkyPlannerit enne integratsiooni loomist testida?
Jah. 30-päevase tasuta prooviperioodi jooksul saate kasutada kuni 20 töökeskust ja importida ERP XL-ist andmeid CSV- või Exceli failidena. Krediitkaarti pole vaja. Alusta prooviperioodi või võta ühendust müügimeeskonnaga, et määrata integratsiooni ulatus.
