Integracije / ERP / Comarch ERP XL
Vodnik za povezavo Comarch ERP XL s SkyPlanner APS za terminiranje proizvodnje
Ta vodnik partnerjem in ekipam IT pojasnjuje, kako povezati Comarch ERP XL s SkyPlanner APS. SkyPlanner se s Comarch ERP XL povezuje dvosmerno prek vmesnikov Comarch:
- V SkyPlanner se prenašajo proizvodni nalogi (zlecenia produkcyjne) s procesi in operacijami, tehnologije, delovni centri, viri, artikli, zaloge in nabavna naročila.
- Planirani časi začetka in konca se prek XL API zapisujejo nazaj v posamezne operacije proizvodnih nalogov.
- Če tako izberete, se časovni zapisi operaterjev zapisujejo nazaj kot realizacije operacij.
- SkyPlanner pošilja obvestila webhook o spremembah terminskega plana takoj, ko se zgodijo.
Ekipa SkyPlanner med uvajanjem prilagodi integracijo vaši postavitvi Comarch ERP XL in zanjo zagotavlja podporo tudi po prehodu v produkcijo. Ta vodnik je namenjen partnerjem in razvijalcem, ki želijo sodelovati pri integraciji ali sami razvijati rešitve na podlagi dokumentiranega vmesnika REST API sistema SkyPlanner (dokumentacija API).
Integracijski vmesniki Comarch ERP XL
Comarch navaja tri načine komunikacije z ERP XL: “DCOM, direct database connection (SQL Client), REST API” (DCOM, neposredna povezava s podatkovno zbirko (SQL Client), REST API) (Comarch, prevedeno). Za sistem za terminiranje sta ključna dva:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Te funkcije so zbrane v knjižnici CDN_API.DLL, ki se namesti skupaj s celotnim sistemom Comarch ERP XL.) (Pomoč Comarch, prevedeno) Zunanji program se prijavi z XLLogin, kliče funkcije, ki uporabljajo isto sejo, in se odjavi z XLLogout. Vsaka struktura ima polje Wersja, s katerim izberete različico nabora parametrov za svojo izdajo ERP XL.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 ponuja mikrostoritve REST: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Vsaka mikrostoritev RestAPI ima svojo interaktivno dokumentacijo na končni točki /swagger.) (Pomoč Comarch, prevedeno)
Neposredna povezava SQL Client omogoča bralni dostop do podatkovne zbirke ERP XL za branje matičnih podatkov in nalogov po dogovoru z vašo ekipo IT in partnerjem Comarch.
Funkcije XL API za proizvodnjo
Comarch dokumentira naslednje proizvodne funkcije (XL128):
| Področje | Funkcija | Delovanje |
|---|---|---|
| Tehnologije | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Ustvari tehnologijo, operacijo, delovni center na operaciji ter material ali izdelek na operaciji |
| Proizvodni nalogi | XLNoweZlecenieProd | Ustvari proizvodni nalog |
| Proizvodni nalogi | XLZamknijZlecenieProd | Planira, ponovno planira, obračuna ali zapre proizvodni nalog glede na izbrano kodo dejanja |
| Operacije | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Doda operacijo ali vir v proizvodni proces |
| Terminski plan | XLDodajTerminDoProcesuProd | Doda časovni interval operaciji: IdCzynnosci, TerminOd, TerminDo |
| Realizacija | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Doda realizacijo operacije v nalog, spremeni realizirano količino |
| Dokumenti | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Ustvari dokumente RW in PW za proizvodne objekte |
Avtentikacija in dostop
- XL API. Integracija se z XLLogin prijavi v podatkovno zbirko kot operater ERP XL in pridobi sejo za nadaljnje klice. DLL se izvaja na gostitelju Windows z nameščenim ERP XL, zato storitev za povratni zapis deluje v vašem omrežju, ob sistemu ERP XL.
- REST API. Dostop se nastavi za vsako namestitev ERP XL Web posebej; klici posamezne mikrostoritve so dokumentirani na njeni strani Swagger.
- Branje prek SQL. Prijava v podatkovno zbirko samo za branje, ki jo odobri vaša ekipa IT.
Na strani SkyPlanner REST API za avtentikacijo uporablja žeton API v glavi Authorization-Token (SkyPlanner Settings > API), dokumentacija pa je na voljo v Swagger/OpenAPI. Vodič za integracijo vas popelje skozi prve klice.
Dogodki in periodično poizvedovanje
V pregledani dokumentaciji Comarch ERP XL ni navedenih izhodnih spletnih kavljev. Lastni sistem APS podjetja Comarch pridobi podatke, ko planer pritisne “Aktualizuj dane z ERP” (posodobi podatke iz ERP) (Pomoč za Comarch APS).
Zato se na strani ERP XL uporablja periodično poizvedovanje. Nova dela se zajamejo z branjem, omejenim na odprte proizvodne naloge in nedavne spremembe. Pogostost se določi za vsak obrat posebej: od vsakih nekaj minut za proizvodne naloge do enkrat na uro za zaloge.
SkyPlanner ob spremembi stanja ali terminskega plana pošlje spletni kavelj, zato povratni zapis temelji na dogodkih.
Preslikava podatkov
| Objekt Comarch ERP XL (vmesnik) | Objekt SkyPlanner | Smer | Pogostost |
|---|---|---|---|
| Karty towarów, merske enote (REST ali branje prek SQL) | Izdelki in materiali | ERP XL → SkyPlanner | Začetni uvoz, nato periodično poizvedovanje |
| Technologia: operacije, materiali, polizdelki, izdelki po operacijah | Struktura izdelka, podizdelki, materiali po korakih procesa | ERP XL → SkyPlanner | Začetni uvoz, nato ob spremembi |
| Operacije v Technologia: delovni centri, viri, časi | Koraki procesa s trajanjem ter pripravljalnimi in zaključnimi časi | ERP XL → SkyPlanner | Začetni uvoz, nato ob spremembi |
| Gniazda robocze in zasoby (stroji, orodja, zaposleni) | Delovni centri, skupine delovnih centrov, orodja, osebje | ERP XL → SkyPlanner | Začetni uvoz, pozneje redko |
| Kalendarze i okresy, przestoje i awarie | Izmene, nedelovni čas in zastoji | ERP XL → SkyPlanner | Dnevno ali lastne izmene v SkyPlanner |
| Zlecenia produkcyjne (ZP) s procesi, operacijami, materiali, rokom in prioriteto | Nalogi in operacije z roki in potrebami po materialu | ERP XL → SkyPlanner | Periodično poizvedovanje vsakih nekaj minut |
| Zaloge po skladiščih | Stanje zalog | ERP XL → SkyPlanner | Periodično poizvedovanje, vsako uro ali ob zagonu terminiranja |
| Zamówienia zakupu (ZZ) z datumi dobave | Nabavna naročila, pričakovani material po datumih dobave | ERP XL → SkyPlanner | Periodično poizvedovanje, vsako uro ali ob zagonu terminiranja |
| Termini operacij: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Planirani začetek in konec posamezne operacije | SkyPlanner → ERP XL | Ob spremembi terminskega plana prek spletnega kavlja SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Časovni zapisi in potrditve operaterjev | SkyPlanner → ERP XL | Ob vsaki potrditvi ali po izmenah, če tako izberete |
| Ni v ERP XL | Matrika časov prehodov med operacijami, orodja kot viri z omejeno razpoložljivostjo, operacije z več operaterji, alternativni stroji in osebje | Vzdrževanje v SkyPlanner | Nastavitev med uvajanjem |
Vzorci integracije
1. Začetni uvoz matičnih podatkov. Preberite artikle, tehnologije, delovne centre, vire in koledarje. Skrbno določite preslikavo delovnih centrov v SkyPlanner: delovni center s štirimi stroji postane ena skupina delovnih centrov ali štirje delovni centri. Orodja med viri ERP XL v SkyPlanner postanejo orodja z omejeno razpoložljivostjo, zaposleni pa osebje z izmenami.
2. Sinhronizacija nalogov in naročil. Preberite proizvodne naloge z operacijami in materiali ter odprta nabavna naročila. SkyPlanner obravnava naročeni material kot razpoložljiv na datum dobave nabavnega naročila in posodobi zalogo, ko je naročilo označeno s statusom Delivered.
3. Povratni zapis terminskega plana. Ko mehanizem razporedi ali premakne operacijo, spletni klic webhook iz sistema SkyPlanner sproži storitev za povratni zapis. Ta pokliče XLDodajTerminDoProcesuProd z vrednostma TerminOd in TerminDo za operacijo, tako da ima vsaka operacija ZP zapisana začetek in konec, ki ju je načrtoval SkyPlanner.
4. Potrjevanje dela v proizvodnji. Operaterji beležijo delo s SkyPlanner Mobile Confirmations ali Production Timer, zapisi časa pa ohranjajo terminski plan ažuren. Sami izberete, ali se dejanski časi zapisujejo nazaj. Če se, storitev doda realizacije s klicem XLDodajRealizacjeOperacjiProd, dokumenti RW in PW pa se obravnavajo po vaših pravilih v ERP XL. Če na nekaterih delovnih centrih uporabljate Comarch MES, za vsako operacijo ohranite le en vir poročanja.
5. Pravila o skrbništvu podatkov in razreševanju konfliktov. Zapišite jih pred prehodom v produkcijo:
| Podatki | Skrbnik |
|---|---|
| Artikli, tehnologije, količine, status ZP, kalkulacija stroškov | Comarch ERP XL |
| Zaporedje operacij, začetni in končni časi, dodelitev virov | SkyPlanner |
| Matrika časov menjav, zahteve glede orodij in operaterjev, alternativni viri | SkyPlanner |
| Izmene, koledarji in zastoji | En sistem, izbran pri opredelitvi obsega |
| Realizacije, dokumenti RW in PW | Comarch ERP XL; neposreden vnos ali prenos iz zapisov časa v sistemu SkyPlanner |
Določite en sistem za zapisovanje terminov operacij. Če samodejno ponovno planiranje v ERP XL ali Comarch APS še vedno zapisuje termine v iste proizvodne naloge, to izklopite za naloge, ki jih terminira SkyPlanner.
Običajni koraki projekta
Implementacija je običajno zaključena v nekaj tednih po začetku uvajanja. Pred tem v 30-dnevnem brezplačnem preizkusu preverite terminski plan z delovnimi centri, tehnologijami in odprtimi proizvodnimi nalogi, izvoženimi iz ERP XL v obliki CSV ali Excel.
- Preslikava. Določite tabelo preslikav, pravila o skrbništvu podatkov, pogostost sinhronizacije in ali se realizacije zapisujejo nazaj.
- Dostop do ERP XL. Ustvarite operaterski račun za integracijo, nastavite povezavo za branje in namestite storitev za povratni zapis na gostitelja z nameščenim ERP XL. Najprej opravite preizkus na kopiji podatkovne zbirke.
- Začetni uvoz. Artikli, tehnologije, delovni centri, viri, koledarji.
- Sinhronizacija proizvodnih nalogov in nabavnih naročil. Periodično poizvedovanje s filtri in ponovnimi poskusi.
- Nastavitev omejitev v sistemu SkyPlanner. Matrika časov menjav, orodja, število operaterjev na operacijo ter alternativni stroji ali osebje.
- Povratni zapis terminskega plana. Klici XLDodajTerminDoProcesuProd, ki jih sprožijo spletni klici webhook iz sistema SkyPlanner, ter realizacije, če ste se odločili zanje.
- Vzporedno testiranje. Uporabljajte SkyPlanner vzporedno z obstoječim planom, primerjajte termine in popravite matične podatke.
- Prehod v produkcijo. Ko se podatki ujemajo, vklopite povratni zapis.
Kaj upoštevati pri integraciji s Comarch ERP XL
- Ročno vnesena zmogljivost. Zmogljivost delovnega centra v ERP XL je število, ki ga določi uporabnik, z dovoljenim odstotkom obremenitve. SkyPlanner pa zmogljivost izračuna iz dejanskih izmen in virov, zato izmene skrbno nastavite, odstotka pa ne uporabljajte.
- Neomejeni viri. ERP XL pri virih, označenih z neomejeno zmogljivostjo, ne preverja zasedenosti. Za vsakega določite, ali bo v sistemu SkyPlanner postal delovni center z omejeno zmogljivostjo.
- Sproščeni nalogi. ERP XL pri ponovnem planiranju izpusti operacije, sproščene v proizvodnjo, razen če je označena možnost “Przesuń na zwolnionych”. Dogovorite se, kako bodo termini iz sistema SkyPlanner veljali za sproščene naloge, in s funkcijo Running Time Lock zaklenite razpored dela za naslednje ure.
- Različice struktur. Strukture XL API vsebujejo polje Wersja. Nastavite ga skladno s svojo različico ERP XL in po vsaki letni nadgradnji ponovite testiranje.
- Poljske enote in časi. Časi operacij in koledarske enote se morajo ob uvozu natančno pretvoriti, sicer bodo vsa trajanja napačna.
Kdo nastavi integracijo s Comarch ERP XL in zagotavlja podporo
- Ekipa SkyPlanner jo nastavi med uvajanjem in zagotavlja podporo po prehodu v produkcijo, in sicer za dogovorjena branja podatkov in klice XL API. Vsak obrat uporablja Comarch ERP XL drugače, ekipa pa pri nastavitvi upošteva te posebnosti.
- Sodeluje lahko tudi vaš partner Comarch. Partner pozna vaše nastavitve, licenciranje in XL API ter lahko skupaj z ekipo SkyPlanner nastavi operaterski račun, povezavo za branje in gostitelja za povratni zapis.
- Vaši razvijalci lahko integracijo nadgradijo prek REST API sistema SkyPlanner z žetonom API. Za začetek zadostuje žeton API, ekipa SkyPlanner pa po potrebi pomaga. Dokumentacijo najdete na strani Dokumentacija za integracijo SkyPlanner.
Cena sistema SkyPlanner se začne pri 199 € na mesec in vključuje 5 delovnih centrov, obračunavanje pa je mesečno. Ponudbo za integracijo pripravimo vnaprej glede na vaš proces in potrebe, skupaj z izbranim paketom. Oglejte si cenik, terminiranje proizvodnje z omejenimi zmogljivostmi za Comarch ERP XL, stran Comarch ERP XL in pregled integracij z ERP.
Mnenja proizvodnih podjetij o sistemu SkyPlanner
2 hprihranka vsak teden
»S sistemom SkyPlanner smo pri planiranju proizvodnje prešli iz Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, strokovnjak za oskrbovalno verigo
UTU · Električni razdelilniki in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri dela, novo zaporedje operacij pa na proizvodni liniji prejmejo v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost proizvodnje se je povečala za 90 %.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90 %, izdelava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
6 mesecevvnaprej prodaja vidi proste zmogljivosti
»SkyPlanner zagotavlja zanesljivo osnovo za celotno planiranje proizvodnje.«
Anu Järvinen, vodja proizvodnje
Fredman Operations · Embalažni papirji za stik z živili
Prodaja vidi proste zmogljivosti za šest mesecev vnaprej, na zahteve za spremembo terminskega plana, ki so prej vzele uro ali več, pa zdaj odgovorijo v nekaj sekundah.
100%zanesljivost dobav od leta 2021
»SkyPlanner nam omogoča vpogled v zmogljivosti in zagotavlja predvidljivost planiranja.«
Dan Berglund, COO/CFO
Opes Corporation · Kemična in živilska proizvodnja
Zanesljivost dobav je 100 % ves čas uporabe sistema SkyPlanner, od leta 2021.
Pogosta vprašanja
Ali ima Comarch ERP XL API za proizvodne naloge?
Da. XL API (CDN_API.DLL) ustvarja proizvodne naloge, jih planira in ponovno planira s klicem XLZamknijZlecenieProd, dodaja termine operacij s klicem XLDodajTerminDoProcesuProd in zapisuje realizacije s klicem XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web dodaja mikrostoritve REST, dokumentirane v orodju Swagger.
Kako se načrtovani termini zapisujejo nazaj v Comarch ERP XL?
Prek klica XLDodajTerminDoProcesuProd, ki vsaki operaciji proizvodnega naloga doda časovni razpon (TerminOd, TerminDo). Spletni klic webhook iz sistema SkyPlanner sproži ta klic ob vsaki spremembi terminskega plana.
Ali Comarch ERP XL podpira spletne klice webhook?
Izhodni spletni klici webhook niso dokumentirani, zato integracija periodično poizveduje v ERP XL po urniku, določenem za posamezen obrat. Lastni spletni klici webhook sistema SkyPlanner pošiljajo spremembe terminskega plana takoj, ko nastanejo.
Naj partner Comarch predlaga Comarch APS ali SkyPlanner?
SkyPlanner, kadar stranka želi v nekaj tednih dobiti terminski plan, ki upošteva omejene zmogljivosti in se samodejno posodablja. Comarch APS je ločena aplikacija z lastno podatkovno zbirko PostgreSQL, integratorjem in licenčnim ključem. Sinhronizacijo sproži planer s klikom, pripravljalni čas pa je ena fiksna vrednost za vsako operacijo (pomoč za Comarch APS). SkyPlanner je programska oprema v oblaku, ki samodejno ponovno planira ter načrtuje menjave, orodja, ekipe in material. Cena se začne pri 199 € na mesec.
Ali lahko SkyPlanner preizkusimo pred izdelavo integracije?
Da. 30-dnevni brezplačni preizkus podpira do 20 delovnih centrov z uvozom datotek CSV ali Excel iz ERP XL, brez kreditne kartice. Začnite preizkus ali stopite v stik s prodajo za opredelitev obsega integracije.
