Integrasjoner / ERP / Comarch ERP XL
Guide til integrasjon av Comarch ERP XL for produksjonsplanlegging med SkyPlanner APS
Denne guiden viser partnere og IT-team hvordan Comarch ERP XL kobles til SkyPlanner APS. SkyPlanner integreres med Comarch ERP XL i begge retninger via Comarchs egne grensesnitt:
- Produksjonsordrer (zlecenia produkcyjne) med prosesser og operasjoner, teknologier, arbeidssentre, ressurser, varer, lagerbeholdning og innkjøpsordrer hentes inn.
- Planlagte start- og sluttidspunkter skrives tilbake til hver operasjon på produksjonsordren via XL API.
- Operatørenes tidsregistreringer kan skrives tilbake som utførte operasjoner hvis dere ønsker det.
- SkyPlanners webhooks sender planendringer fortløpende.
SkyPlanner-teamet tilpasser integrasjonen til deres Comarch ERP XL-oppsett under innføringen og gir støtte etter driftsstart. Denne guiden er for partnere og utviklere som vil delta i arbeidet eller selv bygge videre på SkyPlanners dokumenterte REST API (API-referanse).
Integrasjonsgrensesnitt i Comarch ERP XL
Comarch oppgir tre måter å kommunisere med ERP XL på: «DCOM, direct database connection (SQL Client), REST API» (DCOM, direkte databasetilkobling (SQL Client), REST API) (Comarch, oversatt). For et planleggingssystem er det to av disse som brukes:
- XL API (CDN_API.DLL). «These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.» (Disse funksjonene er samlet i biblioteket CDN_API.DLL, som installeres sammen med hele Comarch ERP XL-systemet.) (Comarchs hjelpedokumentasjon, oversatt) Et eksternt program logger på med XLLogin, kaller funksjoner som deler samme sesjon, og logger av med XLLogout. Hver struktur har et Wersja-felt som velger versjonen av parametersettet for deres ERP XL-versjon.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 tilbyr REST-mikrotjenester: «Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.» (Hver RestAPI-mikrotjeneste gjør sin egen interaktive dokumentasjon tilgjengelig på endepunktet /swagger.) (Comarchs hjelpedokumentasjon, oversatt)
En direkte SQL Client-tilkobling gir lesetilgang til grunndata og ordrer i ERP XL-databasen, etter avtale med IT-teamet og Comarch-partneren deres.
Produksjonsfunksjoner i XL API
Comarch dokumenterer disse produksjonsfunksjonene (XL128):
| Område | Funksjon | Hva den gjør |
|---|---|---|
| Teknologier | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Oppretter en teknologi eller operasjon, eller knytter et arbeidssenter, materiale eller produkt til en operasjon |
| Produksjonsordrer | XLNoweZlecenieProd | Oppretter en produksjonsordre |
| Produksjonsordrer | XLZamknijZlecenieProd | Planlegger, omplanlegger, avregner eller lukker en produksjonsordre, avhengig av handlingskoden |
| Operasjoner | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Legger til en operasjon eller ressurs i en produksjonsprosess |
| Tidsplan | XLDodajTerminDoProcesuProd | Legger til et tidsintervall for en operasjon: IdCzynnosci, TerminOd, TerminDo |
| Utførelse | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Registrerer en utført operasjon på ordren, endrer utført mengde |
| Dokumenter | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Oppretter RW- og PW-dokumenter for produksjonsobjekter |
Autentisering og tilgang
- XL API. Integrasjonen logger på en database som ERP XL-operatør med XLLogin og får en sesjon for videre kall. DLL-en kjører på en Windows-maskin med ERP XL installert. Tjenesten som skriver data tilbake, kjører derfor i deres nettverk, sammen med ERP XL.
- REST API. Tilgang settes opp for hver ERP XL Web-installasjon. Kallene er dokumentert på Swagger-siden til hver mikrotjeneste.
- SQL-lesetilgang. En databasebruker med kun lesetilgang, godkjent av IT-teamet deres.
Hos SkyPlanner autentiseres REST API med et API-token i Authorization-Token-headeren (SkyPlanner Settings > API). API-et er dokumentert i Swagger/OpenAPI. Integrasjonsveiledningen tar dere gjennom de første kallene.
Hendelser og polling
Dokumentasjonen vi har gjennomgått for Comarch ERP XL, beskriver ingen utgående webhooks. Comarchs eget APS henter data når planleggeren trykker på «Aktualizuj dane z ERP» (Oppdater data fra ERP) (Comarch APS-hjelp).
Data fra ERP XL hentes derfor med polling. Nye oppdrag fanges opp ved å filtrere på åpne produksjonsordrer og nylige endringer når data leses. Frekvensen settes for hver fabrikk: Produksjonsordrer hentes med noen minutters mellomrom, mens lagerbeholdning hentes hver time.
SkyPlanner sender webhooks når tilstanden eller tidsplanen endres, slik at tilbakeskrivingen er hendelsesstyrt.
Datakobling
| Objekt i Comarch ERP XL (grensesnitt) | Objekt i SkyPlanner | Retning | Frekvens |
|---|---|---|---|
| Karty towarów, måleenheter (REST eller SQL-lesing) | Produkter og materialer | ERP XL → SkyPlanner | Førstegangsinnlasting, deretter polling |
| Technologia: operasjoner, materialer, halvfabrikata og produkter per operasjon | Produktstruktur, delprodukter og materialer per prosesstrinn | ERP XL → SkyPlanner | Førstegangsinnlasting, deretter ved endringer |
| Operasjoner i Technologia: arbeidssentre, ressurser og tider | Prosesstrinn med varighet, omstillings- og nedriggingstider | ERP XL → SkyPlanner | Førstegangsinnlasting, deretter ved endringer |
| Gniazda robocze og zasoby (maskiner, verktøy, ansatte) | Arbeidsstasjoner, grupper av arbeidsstasjoner, verktøy og personell | ERP XL → SkyPlanner | Førstegangsinnlasting, deretter sjelden |
| Kalendarze i okresy, przestoje i awarie | Skift, tid utenfor arbeidstid og driftsstans | ERP XL → SkyPlanner | Daglig, eller egne skift i SkyPlanner |
| Zlecenia produkcyjne (ZP) med prosesser, operasjoner, materialer, leveringsfrist og prioritet | Ordrer og jobber med leveringsfrister og materialbehov | ERP XL → SkyPlanner | Polling med noen minutters mellomrom |
| Beholdning per lager | Lagerbeholdninger | ERP XL → SkyPlanner | Polling hver time eller ved plankjøring |
| Zamówienia zakupu (ZZ) med leveringsdatoer | Innkjøpsordrer, innkommende materialer etter leveringsdato | ERP XL → SkyPlanner | Polling hver time eller ved plankjøring |
| Tidspunkter for operasjoner: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Planlagt start og slutt per jobb | SkyPlanner → ERP XL | Ved endring av tidsplanen, via en webhook fra SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Tidsregistreringer og operatørbekreftelser | SkyPlanner → ERP XL | Per bekreftelse eller per skift, hvis ønskelig |
| Finnes ikke i ERP XL | Omstillingsmatrise, verktøy med begrenset kapasitet, jobber med flere operatører, alternative maskiner og personell | Vedlikeholdes i SkyPlanner | Settes opp under innføringen |
Integrasjonsmønstre
1. Førstegangsinnlasting av grunndata. Les inn varer, teknologier, arbeidssentre, ressurser og kalendere. Velg bevisst hvordan arbeidssentrene skal modelleres i SkyPlanner: Et arbeidssenter med fire maskiner blir én gruppe av arbeidsstasjoner eller fire arbeidsstasjoner. Verktøy blant ressursene i ERP XL blir verktøy med begrenset kapasitet i SkyPlanner, og ansatte blir personell med skift.
2. Ordresynkronisering. Les inn produksjonsordrer med tilhørende operasjoner og materialer, samt åpne innkjøpsordrer. SkyPlanner regner bestilt materiale som tilgjengelig på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Delivered.
3. Tilbakeskriving av planen. Når planleggingsmotoren plasserer eller flytter en operasjon, utløser en webhook fra SkyPlanner tjenesten for tilbakeskriving. Den kaller XLDodajTerminDoProcesuProd med operasjonens TerminOd og TerminDo, slik at hver ZP-operasjon får planlagt start og slutt fra SkyPlanner.
4. Registreringer fra produksjonen. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringene holder planen oppdatert. Dere velger om faktiske tider skal skrives tilbake. I så fall legger tjenesten til utførelsesregistreringer med XLDodajRealizacjeOperacjiProd, og RW- og PW-dokumentene følger reglene deres i ERP XL. Bruker dere Comarch MES på enkelte stasjoner, må hver operasjon ha én rapporteringskilde.
5. Regler for dataeierskap og konflikter. Dokumenter dem før produksjonssetting:
| Data | Eier |
|---|---|
| Artikler, produksjonsteknologier, mengder, ZP-status, kostnadsberegning | Comarch ERP XL |
| Operasjonsrekkefølge, start- og sluttider, ressurstildeling | SkyPlanner |
| Matrise for omstillingstider, krav til verktøy og operatører, alternative ressurser | SkyPlanner |
| Skift, kalendere og nedetid | Ett system, valgt under avklaringen |
| Utførelsesregistreringer, RW- og PW-dokumenter | Comarch ERP XL, registrert der eller overført fra tidsregistreringene i SkyPlanner |
La bare ett system skrive operasjonenes datoer. Hvis automatisk omplanlegging i ERP XL eller Comarch APS fortsatt skriver tidspunkter til de samme produksjonsordrene, må dere slå dette av for ordrer som planlegges i SkyPlanner.
Typiske prosjekttrinn
Implementeringen fullføres normalt i løpet av noen uker etter at innføringen starter. Før det kan dere validere planen i den gratis prøveperioden på 30 dager med arbeidssentre, produksjonsteknologier og åpne produksjonsordrer eksportert fra ERP XL som CSV eller Excel.
- Datakobling. Fastsett koblingstabellen, reglene for dataeierskap, synkroniseringsfrekvensene og om utførelsesregistreringer skal skrives tilbake.
- Tilgang til ERP XL. Opprett integrasjonsbrukeren, sett opp leseforbindelsen og installer tjenesten for tilbakeskriving på en vertsmaskin der ERP XL er installert. Test først i en kopi av databasen.
- Førstegangsinnlasting. Artikler, produksjonsteknologier, arbeidssentre, ressurser og kalendere.
- Synkronisering av ordrer og innkjøpsordrer. Periodisk avspørring med filtre og nye forsøk ved feil.
- Oppsett av begrensninger i SkyPlanner. Matrise for omstillingstider, verktøy, antall operatører per jobb og alternative maskiner eller personell.
- Tilbakeskriving av planen. Kall til XLDodajTerminDoProcesuProd utløst av webhooks fra SkyPlanner, samt utførelsesregistreringer hvis dere har valgt det.
- Parallelltesting. Kjør SkyPlanner parallelt med gjeldende plan, sammenlign datoer og korriger grunndata.
- Produksjonssetting. Slå på tilbakeskriving når dataene stemmer overens.
Dette må dere ta høyde for i en integrasjon med Comarch ERP XL
- Manuelt angitt kapasitet. Kapasiteten til et arbeidssenter i ERP XL er et brukerdefinert tall med en tillatt belastning i %. SkyPlanner beregner i stedet kapasiteten ut fra faktiske skift og ressurser. Sett derfor opp skiftene nøye, og se bort fra prosentsatsen.
- Ubegrensede ressurser. For ressurser merket med ubegrenset kapasitet hopper ERP XL over kontrollen av om ressursen er opptatt. Avgjør for hver ressurs om den skal bli en arbeidsstasjon med begrenset kapasitet i SkyPlanner.
- Frigitte ordrer. ERP XL utelater operasjoner som er frigitt til produksjon fra omplanlegging, med mindre «Przesuń na zwolnionych» er krysset av. Avtal hvordan datoene fra SkyPlanner skal gjelde for frigitte ordrer, og bruk Running Time Lock til å låse de neste timenes arbeid.
- Versjoner av datastrukturer. Datastrukturene i XL API har et Wersja-felt. Sett det til å samsvare med ERP XL-versjonen deres, og test på nytt etter hver årlige oppgradering.
- Polske enheter og tider. Operasjonstider og kalenderenheter må konverteres nøyaktig ved import, ellers blir alle varigheter feil.
Hvem setter opp og støtter integrasjonen med Comarch ERP XL?
- SkyPlanner-teamet setter opp integrasjonen under innføringen og gir støtte etter produksjonssetting, for de avtalte leseoperasjonene og XL API-kallene. Hver fabrikk bruker Comarch ERP XL på sin måte, og denne kunnskapen ligger til grunn for arbeidet.
- Comarch-partneren deres kan delta. Partneren kjenner oppsettet, lisensene og XL API og kan sette opp brukeren, leseforbindelsen og vertsmaskinen for tilbakeskriving sammen med SkyPlanner-teamet.
- Deres egne utviklere kan bygge videre på integrasjonen med SkyPlanners REST API og et API-token. Et API-token er nok for å komme i gang, og SkyPlanner-teamet hjelper til ved behov. Integrasjonsdokumentasjonen finner dere i SkyPlanners integrasjonsdokumentasjon.
SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og månedlig fakturering. Dere får et pristilbud på integrasjonen på forhånd, tilpasset prosessene og behovene deres, sammen med abonnementet. Se priser, produksjonsplanlegging med Comarch ERP XL innenfor faktisk maskin- og bemanningskapasitet, siden om Comarch ERP XL og oversikten over ERP-integrasjoner.
Produsentenes erfaringer med SkyPlanner
2 hspart hver uke
«SkyPlanner har tatt produksjonsplanleggingen vår fra Excel-regneark til produksjonsoptimalisering i sanntid.»
Kalle Kalliomäki, spesialist på forsyningskjeder
UTU · Elektriske tavler og koblingsanlegg
Produksjonsplanleggingen sparer 2 timers arbeidstid hver uke, og en ny jobbkø når produksjonslinjen på sekunder.
+90%produksjonseffektivitet
«Effektiviteten i produksjonen har økt med 90%.»
Abdul Rucyinga, IT-sjef
Laboratory & Allied · Legemiddelproduksjon
Produksjonseffektiviteten har økt med 90%, og det tar under 30 minutter å lage en optimalisert plan for tre måneder på tvers av alle arbeidsstasjoner.
6 månederfrem i tid ser salgsavdelingen ledig kapasitet
«SkyPlanner gir et pålitelig grunnlag for all produksjonsplanlegging.»
Anu Järvinen, produksjonssjef
Fredman Operations · Emballasjepapir for kontakt med mat
Salgsavdelingen ser ledig kapasitet seks måneder frem i tid, og forespørsler om planendringer som før tok en time eller mer, besvares på sekunder.
100%leveringspålitelighet siden 2021
«SkyPlanner gir oss oversikt over kapasiteten og gjør planleggingen forutsigbar.»
Dan Berglund, COO/CFO
Opes Corporation · Kjemikalie- og næringsmiddelproduksjon
Leveringspåliteligheten har vært 100% hele tiden SkyPlanner har vært i bruk, siden 2021.
Ofte stilte spørsmål
Har Comarch ERP XL et API for produksjonsordrer?
Ja. XL API (CDN_API.DLL) oppretter produksjonsordrer, planlegger og omplanlegger dem med XLZamknijZlecenieProd, legger til operasjonsdatoer med XLDodajTerminDoProcesuProd og overfører utførelsesregistreringer med XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web tilbyr i tillegg REST-mikrotjenester dokumentert i Swagger.
Hvordan skrives planlagte datoer tilbake til Comarch ERP XL?
Via XLDodajTerminDoProcesuProd, som legger til et tidsintervall (TerminOd, TerminDo) på hver operasjon i produksjonsordren. En webhook fra SkyPlanner utløser kallet hver gang planen endres.
Støtter Comarch ERP XL webhooks?
Ingen utgående webhooks er dokumentert. Derfor spør integrasjonen ERP XL med faste intervaller som avtales for hver fabrikk. SkyPlanners egne webhooks sender planendringer etter hvert som de skjer.
Bør en Comarch-partner foreslå Comarch APS eller SkyPlanner?
SkyPlanner, når kunden vil ha produksjonsplanlegging som tar hensyn til faktisk maskin- og bemanningskapasitet, er på plass i løpet av noen uker og holder seg oppdatert automatisk. Comarch APS er en separat applikasjon med egen PostgreSQL-database, integrator og lisensnøkkel. Den synkroniserer når planleggeren klikker, og omstillingstiden er én fast verdi per operasjon (hjelp for Comarch APS). SkyPlanner er skybasert programvare som omplanlegger automatisk og planlegger omstillinger, verktøy, arbeidslag og materialer, fra 199 € per måned.
Kan vi teste SkyPlanner før vi bygger integrasjonen?
Ja. Den gratis prøveperioden på 30 dager støtter opptil 20 arbeidsstasjoner med CSV- eller Excel-import fra ERP XL, uten krav om kredittkort. Start prøveperioden, eller snakk med salg for å avklare omfanget av integrasjonen.
