Integraatiot / ERP / Comarch ERP XL
Comarch ERP XL -integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Comarch ERP XL -integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten Comarch ERP XL yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Comarch ERP XL:n välinen integraatio toimii molempiin suuntiin Comarchin omien rajapintojen kautta:
- SkyPlanneriin tuodaan tuotantotilaukset (zlecenia produkcyjne) prosesseineen ja työvaiheineen sekä valmistusteknologiat, työpisteet, resurssit, nimikkeet, varastosaldot ja ostotilaukset.
- Suunnitellut alkamis- ja päättymisajat palautetaan tuotantotilausten kullekin työvaiheelle XL API -rajapinnan kautta.
- Halutessasi työntekijöiden aikakirjaukset palautetaan työvaiheiden toteumina.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlannerin tiimi määrittää integraation Comarch ERP XL -ympäristöösi sopivaksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa itse integraatioita SkyPlannerin dokumentoidun REST API -rajapinnan avulla (API-dokumentaatio).
Comarch ERP XL:n integraatiorajapinnat
Comarch luettelee kolme tapaa muodostaa yhteys ERP XL:ään: “DCOM, direct database connection (SQL Client), REST API” (DCOM, suora tietokantayhteys (SQL Client), REST API) (Comarch, käännetty). Suunnittelujärjestelmän integraatiossa päätyö tehdään kahdella niistä:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Nämä funktiot on koottu CDN_API.DLL-kirjastoon, joka asennetaan Comarch ERP XL -järjestelmän mukana.) (Comarchin ohje, käännetty) Ulkoinen ohjelma kirjautuu sisään XLLogin-funktiolla, kutsuu samaa istuntoa käyttäviä funktioita ja kirjautuu ulos XLLogout-funktiolla. Kussakin tietorakenteessa on Wersja-kenttä, jolla valitaan ERP XL -versiotasi vastaava parametriversio.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 tarjoaa REST-mikropalveluja: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Jokaisen RestAPI-mikropalvelun oma interaktiivinen dokumentaatio on saatavilla /swagger-päätepisteessä.) (Comarchin ohje, käännetty)
Suoralla SQL Client -yhteydellä voidaan lukea perustietoja ja tilauksia ERP XL:n tietokannasta IT-tiimisi ja Comarch-kumppanisi kanssa sovitulla tavalla.
XL API -rajapinnan tuotantofunktiot
Comarch dokumentoi seuraavat tuotantofunktiot (XL128):
| Osa-alue | Funktio | Toiminta |
|---|---|---|
| Valmistusteknologiat | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Luo valmistusteknologian tai työvaiheen, liittää työpisteen, materiaalin tai tuotteen työvaiheeseen |
| Tuotantotilaukset | XLNoweZlecenieProd | Luo tuotantotilauksen |
| Tuotantotilaukset | XLZamknijZlecenieProd | Suunnittelee, suunnittelee uudelleen, jälkilaskee tai sulkee tuotantotilauksen toimintokoodin mukaan |
| Työvaiheet | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Lisää työvaiheen tai resurssin tuotantoprosessiin |
| Aikataulu | XLDodajTerminDoProcesuProd | Lisää työvaiheelle aikavälin: IdCzynnosci, TerminOd, TerminDo |
| Toteuma | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Lisää tilaukselle työvaiheen toteuman, muuttaa toteutunutta määrää |
| Tositteet | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Luo RW- ja PW-tositteet tuotanto-objekteille |
Tunnistautuminen ja käyttöoikeudet
- XL API. Integraatio kirjautuu tietokantaan ERP XL -käyttäjänä XLLogin-funktiolla ja saa istunnon myöhempiä kutsuja varten. DLL suoritetaan Windows-koneella, johon ERP XL on asennettu. Siksi takaisinkirjoituspalvelu toimii omassa verkossasi ERP XL:n rinnalla.
- REST API. Käyttöoikeudet määritetään ERP XL Web -asennuskohtaisesti. Kunkin mikropalvelun kutsut on dokumentoitu sen Swagger-sivulla.
- SQL-luku. IT-tiimisi hyväksymä tietokantatunnus, jolla on vain lukuoikeus.
SkyPlannerin REST API -rajapinnassa tunnistaudutaan Authorization-Token-otsakkeessa välitettävällä API-tokenilla (SkyPlanner Settings > API). Rajapinta on dokumentoitu Swagger/OpenAPI-muodossa. Integraatio-ohje opastaa ensimmäisten kutsujen tekemisessä.
Tapahtumat ja jaksottainen tiedonhaku
Tarkastetussa dokumentaatiossa Comarch ERP XL:lle ei ole kuvattu lähteviä webhookeja. Comarchin oma APS hakee tiedot, kun suunnittelija painaa “Aktualizuj dane z ERP” -painiketta (päivitä tiedot ERP:stä) (Comarch APS:n ohje).
ERP XL:n tiedot haetaan siis jaksottaisesti. Uudet työt poimitaan hauilla, jotka rajataan avoimiin tuotantotilauksiin ja viimeaikaisiin muutoksiin. Hakutiheys määritetään tehdaskohtaisesti: tuotantotilaukset voidaan hakea muutaman minuutin välein ja varastosaldot tunnin välein.
SkyPlanner lähettää webhookeja tilan tai aikataulun muuttuessa, joten takaisinkirjoitus toimii tapahtumapohjaisesti.
Tietojen vastaavuudet
| Comarch ERP XL -objekti (rajapinta) | SkyPlanner-objekti | Suunta | Tiheys |
|---|---|---|---|
| Karty towarów, mittayksiköt (REST tai SQL-luku) | Tuotteet ja materiaalit | ERP XL → SkyPlanner | Alkulataus, sen jälkeen jaksottainen haku |
| Technologia: työvaiheet sekä työvaihekohtaiset materiaalit, puolivalmisteet ja tuotteet | Tuoterakenne, alituotteet, työvaihekohtaiset materiaalit | ERP XL → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
| Technologia-työvaiheet: työpisteet, resurssit ja ajat | Työvaiheet kestoineen sekä asetus- ja purkuaikoineen | ERP XL → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
| Gniazda robocze ja zasoby (koneet, työkalut, työntekijät) | Työpisteet, työpisteryhmät, työkalut, henkilöstö | ERP XL → SkyPlanner | Alkulataus, sen jälkeen harvoin |
| Kalendarze i okresy, przestoje i awarie | Työvuorot, työajan ulkopuoliset ajat ja seisokit | ERP XL → SkyPlanner | Päivittäin, tai työvuorot ylläpidetään SkyPlannerissa |
| Zlecenia produkcyjne (ZP) sekä prosessit, työvaiheet, materiaalit, määräpäivä ja prioriteetti | Tilaukset ja työt määräpäivineen ja materiaalitarpeineen | ERP XL → SkyPlanner | Haku muutaman minuutin välein |
| Varastokohtaiset saldot | Varastosaldot | ERP XL → SkyPlanner | Haku tunnin välein tai suunnitteluajon yhteydessä |
| Zamówienia zakupu (ZZ) toimituspäivineen | Ostotilaukset, saapuva materiaali toimituspäivän mukaan | ERP XL → SkyPlanner | Haku tunnin välein tai suunnitteluajon yhteydessä |
| Työvaiheen aikaväli: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Työkohtaiset suunnitellut alkamis- ja päättymisajat | SkyPlanner → ERP XL | Aikataulun muuttuessa SkyPlannerin webhookin kautta |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → ERP XL | Haluttaessa kuittaus- tai työvuorokohtaisesti |
| Ei ERP XL:ssä | Asetusaikamatriisi, työkalujen rajallinen saatavuus, usean työntekijän työt, vaihtoehtoiset koneet ja henkilöstö | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutusmallit
1. Perustietojen alkulataus. Lue nimikkeet, valmistusteknologiat, työpisteet, resurssit ja kalenterit. Määritä harkiten, miten työpisteet kuvataan SkyPlannerissa: neljän koneen työpisteestä muodostetaan yksi työpisteryhmä tai neljä työpistettä. ERP XL:n resursseihin kuuluvat työkalut mallinnetaan SkyPlannerissa työkaluiksi, joiden saatavuus on rajallinen, ja työntekijät henkilöstöksi työvuoroineen.
2. Tilausten synkronointi. Lue tuotantotilaukset työvaiheineen ja materiaaleineen sekä avoimet ostotilaukset. SkyPlanner katsoo tilatun materiaalin olevan saatavilla ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilauksen tilaksi merkitään Delivered.
3. Aikataulun kirjoitus takaisin. Kun laskentamoottori sijoittaa tai siirtää työvaiheen, SkyPlannerin webhook käynnistää takaisinkirjoituspalvelun. Palvelu kutsuu XLDodajTerminDoProcesuProd-funktiota työvaiheen TerminOd- ja TerminDo-arvoilla. Näin jokaisella ZP-työvaiheella on SkyPlannerin suunnittelema alku- ja loppuaika.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations -toiminnolla tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Päätät itse, siirretäänkö toteutuneet ajat takaisin. Jos siirretään, palvelu lisää toteumat XLDodajRealizacjeOperacjiProd-funktiolla, ja RW- ja PW-tositteet noudattavat ERP XL -sääntöjäsi. Jos joillakin työpisteillä on käytössä Comarch MES, käytä kullekin työvaiheelle vain yhtä raportointilähdettä.
5. Tietojen omistajuus ja ristiriitojen ratkaisu. Kirjatkaa säännöt ennen tuotantokäyttöön siirtymistä:
| Tiedot | Omistaja |
|---|---|
| Nimikkeet, valmistusmenetelmät, määrät, ZP-tila, kustannuslaskenta | Comarch ERP XL |
| Työvaiheiden järjestys, alku- ja loppuajat, resurssien kohdistus | SkyPlanner |
| Asetusaikamatriisi, työkalu- ja työntekijävaatimukset, vaihtoehtoiset resurssit | SkyPlanner |
| Työvuorot, kalenterit ja seisokit | Yksi määrittelyssä valittu järjestelmä |
| Toteumat sekä RW- ja PW-tositteet | Comarch ERP XL: tiedot kirjataan sinne tai siirretään SkyPlannerin aikakirjauksista |
Valitkaa yksi järjestelmä, joka kirjoittaa työvaiheiden ajankohdat. Jos ERP XL:n automaattinen uudelleensuunnittelu tai Comarch APS kirjoittaa edelleen ajankohtia samoille tuotantotilauksille, poistakaa tämä toiminto käytöstä niiltä tilauksilta, jotka SkyPlanner suunnittelee.
Projektin tyypilliset vaiheet
Toteutus valmistuu yleensä viikoissa käyttöönoton aloituksesta. Varmistakaa sitä ennen aikataulun toimivuus 30 päivän maksuttomassa kokeilussa. Käyttäkää ERP XL:stä CSV- tai Excel-muodossa vietyjä työpisteitä, valmistusmenetelmiä ja avoimia tuotantotilauksia.
- Tietojen vastaavuudet. Vahvistakaa vastaavuustaulukko, omistajuussäännöt, synkronointitiheydet ja se, siirretäänkö toteumat takaisin.
- ERP XL -yhteydet. Luokaa integraation käyttäjätunnus, määrittäkää lukuyhteys ja sijoittakaa takaisinkirjoituspalvelu koneelle, johon ERP XL on asennettu. Testatkaa ensin tietokannan kopiolla.
- Ensimmäinen tietojen lataus. Nimikkeet, valmistusmenetelmät, työpisteet, resurssit ja kalenterit.
- Tuotanto- ja ostotilausten synkronointi. Säännölliset kyselyt suodatuksineen ja uudelleenyrityksineen.
- Rajoitteiden määritys SkyPlannerissa. Asetusaikamatriisi, työkalut, työkohtaiset työntekijämäärät sekä vaihtoehtoiset koneet tai työntekijät.
- Aikataulun kirjoitus takaisin. SkyPlannerin webhookien käynnistämät XLDodajTerminDoProcesuProd-kutsut sekä toteumien siirto, jos se on valittu.
- Rinnakkaistestaus. Käyttäkää SkyPlanneria nykyisen suunnitelman rinnalla, verratkaa ajankohtia ja korjatkaa perustiedot.
- Tuotantokäyttöön siirtyminen. Ottakaa takaisinkirjoitus käyttöön, kun tiedot täsmäävät.
Mitä Comarch ERP XL -integraatiossa on huomioitava
- Käsin syötetty kapasiteetti. ERP XL:ssä työpisteen kapasiteetti on käyttäjän määrittämä luku, johon liittyy sallittu kuormitusprosentti. SkyPlanner laskee kapasiteetin todellisista työvuoroista ja resursseista. Määrittäkää siis työvuorot huolellisesti ja jättäkää prosenttiluku pois.
- Rajattomat resurssit. ERP XL ei tarkista varaustilannetta resursseilta, joiden kapasiteetti on merkitty rajattomaksi. Päättäkää kunkin resurssin kohdalla, mallinnetaanko se SkyPlannerissa työpisteeksi, jonka kapasiteetti on rajallinen.
- Tuotantoon vapautetut tilaukset. ERP XL jättää tuotantoon vapautetut työvaiheet uudelleensuunnittelun ulkopuolelle, ellei “Przesuń na zwolnionych” -valintaa ole valittu. Sopikaa, miten SkyPlannerin ajankohdat vaikuttavat vapautettuihin tilauksiin, ja lukitkaa seuraavien tuntien työt Running Time Lock -toiminnolla.
- Tietorakenteiden versiot. XL API -tietorakenteissa on Wersja-kenttä. Asettakaa sen arvo vastaamaan ERP XL -versiotanne ja testatkaa uudelleen jokaisen vuosipäivityksen jälkeen.
- Puolalaiset yksiköt ja ajat. Työvaiheiden aikojen ja kalenteriyksiköiden muunnosten on oltava tuonnissa täsmällisiä. Muuten jokainen kesto on väärin.
Kuka määrittää Comarch ERP XL -integraation ja vastaa tuesta
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja tukee sitä tuotantokäyttöön siirtymisen jälkeen. Vastuu kattaa sovitun tietojen lukemisen ja XL API -kutsut. Jokainen tehdas käyttää Comarch ERP XL:ää omalla tavallaan, ja tämä osaaminen hyödynnetään määrityksissä.
- Comarch-kumppaninne voi osallistua. Kumppani tuntee järjestelmänne määritykset, lisensoinnin ja XL API:n. Se voi määrittää käyttäjätunnuksen, lukuyhteyden ja takaisinkirjoituspalvelun isäntäkoneen yhdessä SkyPlanner-tiimin kanssa.
- Omat kehittäjänne voivat jatkokehittää integraatiota SkyPlannerin REST API -rajapinnan ja API-tokenin avulla. Alkuun pääsee API-tokenilla, ja SkyPlanner-tiimi auttaa tarvittaessa. Ohjeet löytyvät SkyPlannerin integraatiodokumentaatiosta.
SkyPlannerin hinta on alkaen 199 € kuukaudessa, ja se sisältää 5 työpistettä. Laskutus on kuukausittainen. Integraatiosta annetaan etukäteen prosessiinne ja tarpeisiinne perustuva tarjous yhdessä tilauksenne kanssa. Tutustu hinnastoon, Comarch ERP XL:n hienokuormitukseen, Comarch ERP XL -sivuun ja ERP-integraatioiden koontisivuun.
Valmistavan teollisuuden kokemuksia SkyPlannerista
2 hsäästöä joka viikko
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kojeistot
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa joka viikko, ja uusi työjono saadaan tuotantolinjalle sekunneissa.
+90 %tuotannon tehokkuutta
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkevalmistus
Tuotannon tehokkuus on kasvanut 90 %, ja kaikkien työpisteiden optimoitu suunnitelma kolmeksi kuukaudeksi syntyy alle 30 minuutissa.
6 kuukauttavapaata kapasiteettia myynnin näkyvissä
”SkyPlanner luo luotettavan pohjan koko tuotannonsuunnittelulle.”
Anu Järvinen, tuotantopäällikkö
Fredman Operations · Elintarvikekelpoiset pakkauspaperit
Myynti näkee vapaan kapasiteetin kuusi kuukautta eteenpäin. Aikataulun muutospyyntöihin, joiden selvittämiseen kului aiemmin tunti tai enemmän, vastataan nyt sekunneissa.
100 %toimitusvarmuus vuodesta 2021
”SkyPlanner antaa meille näkyvyyden kapasiteettiin ja tekee suunnittelusta ennakoitavaa.”
Dan Berglund, COO/CFO
Opes Corporation · Kemikaali- ja elintarviketuotanto
Toimitusvarmuus on ollut 100 % koko SkyPlannerin käytön ajan vuodesta 2021 lähtien.
Usein kysyttyä
Onko Comarch ERP XL:ssä rajapinta tuotantotilauksille?
Kyllä. XL API (CDN_API.DLL) luo tuotantotilauksia, suunnittelee niitä ja suunnittelee ne uudelleen XLZamknijZlecenieProd-funktiolla, lisää työvaiheiden ajankohdat XLDodajTerminDoProcesuProd-funktiolla ja kirjaa toteumat XLDodajRealizacjeOperacjiProd-funktiolla. Comarch ERP XL Web tarjoaa lisäksi REST-mikropalvelut, jotka on dokumentoitu Swaggerissa.
Miten suunnitellut ajankohdat kirjoitetaan takaisin Comarch ERP XL:ään?
XLDodajTerminDoProcesuProd-funktiolla, joka lisää aikavälin (TerminOd, TerminDo) jokaiselle tuotantotilauksen työvaiheelle. SkyPlannerin webhook käynnistää kutsun aina, kun aikataulu muuttuu.
Tukeeko Comarch ERP XL webhookeja?
Lähteviä webhookeja ei ole dokumentoitu, joten integraatio kyselee ERP XL:n tietoja tehdaskohtaisesti määritetyin väliajoin. SkyPlannerin omat webhookit välittävät aikataulumuutokset heti niiden tapahtuessa.
Kannattaako Comarch-kumppanin ehdottaa Comarch APS:ää vai SkyPlanneria?
SkyPlanneria, kun asiakas haluaa viikoissa käyttöön kapasiteetin huomioivan tuotantosuunnitelman, joka pysyy itsestään ajan tasalla. Comarch APS on erillinen sovellus, jolla on oma PostgreSQL-tietokanta, integraattori ja lisenssiavain. Se synkronoi tiedot suunnittelijan napsautuksesta, ja asetusaika on yksi kiinteä arvo kutakin työvaihetta kohti (Comarch APS:n ohje). SkyPlanner on pilviohjelmisto, joka suunnittelee tuotannon automaattisesti uudelleen ja huomioi tuotevaihdot, työkalut, työryhmät ja materiaalit. Hinta on alkaen 199 € kuukaudessa.
Voimmeko testata SkyPlanneria ennen integraation rakentamista?
Kyllä. Maksuton 30 päivän kokeilu tukee enintään 20 työpistettä ja tietojen tuontia ERP XL:stä CSV- tai Excel-muodossa. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
