Integrationer / ERP / Comarch ERP XL
Guide til Comarch ERP XL-integration til produktionsplanlægning med SkyPlanner APS
Denne guide til Comarch ERP XL-integration viser partnere og IT-teams, hvordan de forbinder Comarch ERP XL med SkyPlanner APS. SkyPlanner udveksler data med Comarch ERP XL i begge retninger via Comarchs egne grænseflader:
- Produktionsordrer (zlecenia produkcyjne) med processer og operationer samt teknologier, arbejdscentre, ressourcer, varer, lagerbeholdninger og indkøbsordrer overføres til SkyPlanner.
- Planlagte start- og sluttidspunkter skrives tilbage til hver operation på produktionsordren via XL API.
- Operatørernes tidsregistreringer kan efter ønske skrives tilbage som tilbagemeldinger på operationer.
- SkyPlanner-webhooks sender ændringer i planen, så snart de sker.
SkyPlanner-teamet tilpasser integrationen til jeres Comarch ERP XL-opsætning under opstarten og yder support efter idriftsættelsen. Denne guide er til partnere og udviklere, som vil deltage i arbejdet eller selv bygge videre på SkyPlanners dokumenterede REST API (API-reference).
Grænseflader til integration med Comarch ERP XL
Comarch angiver tre måder at kommunikere med ERP XL på: “DCOM, direct database connection (SQL Client), REST API” (DCOM, direkte databaseforbindelse (SQL Client), REST API) (Comarch, oversat). Til et planlægningssystem bruges to af dem:
- 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 funktioner er samlet i biblioteket CDN_API.DLL, som installeres sammen med hele Comarch ERP XL-systemet.) (Comarchs hjælp, oversat) Et eksternt program logger på med XLLogin, kalder funktioner, der deler sessionen, og logger af med XLLogout. Hver struktur har et felt, Wersja, som vælger den version af parametersættet, der passer til jeres ERP XL-version.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 stiller REST-mikrotjenester til rådighed: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Hver RestAPI-mikrotjeneste stiller sin egen interaktive dokumentation til rådighed på endpointet /swagger.) (Comarchs hjælp, oversat)
Den direkte SQL Client-forbindelse giver læseadgang til stamdata og ordrer i ERP XL-databasen efter aftale med jeres IT-team og Comarch-partner.
XL API-funktioner til produktion
Comarch dokumenterer disse produktionsfunktioner (XL128):
| Område | Funktion | Hvad funktionen gør |
|---|---|---|
| Teknologier | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Opretter en teknologi, en operation, et arbejdscenter på en operation eller et materiale eller produkt på en operation |
| Produktionsordrer | XLNoweZlecenieProd | Opretter en produktionsordre |
| Produktionsordrer | XLZamknijZlecenieProd | Planlægger, omplanlægger, afregner eller lukker en produktionsordre afhængigt af den valgte handlingskode |
| Operationer | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Føjer en operation eller en ressource til en produktionsproces |
| Tidsplan | XLDodajTerminDoProcesuProd | Føjer et tidsinterval til en operation: IdCzynnosci, TerminOd, TerminDo |
| Tilbagemelding | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Føjer en operationstilbagemelding til ordren eller ændrer den udførte mængde |
| Dokumenter | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Opretter RW- og PW-dokumenter til produktionsobjekter |
Godkendelse og adgang
- XL API. Integrationen logger på en database som ERP XL-operatør med XLLogin og får en session til de efterfølgende kald. DLL’en kører på en Windows-vært med ERP XL installeret. Tjenesten til tilbageskrivning kører derfor i jeres netværk sammen med ERP XL.
- REST API. Adgang sættes op for hver ERP XL Web-installation. Kald er dokumenteret på den enkelte mikrotjenestes Swagger-side.
- SQL-læsning. Et databaselogin med kun læseadgang, godkendt af jeres IT-team.
Hos SkyPlanner bruger REST API’et et API-token i headeren Authorization-Token til godkendelse (SkyPlanner Settings > API). API’et er dokumenteret i Swagger/OpenAPI. Integrationsvejledningen gennemgår de første kald.
Hændelser og polling
Den gennemgåede dokumentation for Comarch ERP XL beskriver ingen udgående webhooks. Comarchs eget APS henter data, når planlæggeren trykker på “Aktualizuj dane z ERP” (opdater data fra ERP) (Comarch APS-hjælp).
Derfor hentes data fra ERP XL ved polling. Ved at begrænse læsningen til åbne produktionsordrer og de seneste ændringer hentes nyt arbejde. Hyppigheden fastlægges for hver fabrik: Produktionsordrer hentes med få minutters mellemrum og lagerbeholdninger hver time.
SkyPlanner sender webhooks, når status eller tidsplanen ændres, så tilbageskrivningen er hændelsesstyret.
Datamapping
| Objekt i Comarch ERP XL (grænseflade) | Objekt i SkyPlanner | Retning | Hyppighed |
|---|---|---|---|
| Karty towarów, måleenheder (REST eller SQL-læsning) | Produkter og materialer | ERP XL → SkyPlanner | Indledende indlæsning, derefter polling |
| Technologia: operationer, materialer, halvfabrikata og produkter pr. operation | Produktstruktur, delprodukter og materialer pr. procestrin | ERP XL → SkyPlanner | Indledende indlæsning, derefter ved ændringer |
| Operationer i Technologia: arbejdscentre, ressourcer og tider | Procestrin med varighed, omstillingstid og nedtagningstid | ERP XL → SkyPlanner | Indledende indlæsning, derefter ved ændringer |
| Gniazda robocze og zasoby (maskiner, værktøjer, medarbejdere) | Arbejdsstationer, arbejdsstationsgrupper, værktøjer og personale | ERP XL → SkyPlanner | Indledende indlæsning, derefter sjældent |
| Kalendarze i okresy, przestoje i awarie | Skiftehold, arbejdsfri tid og driftsstop | ERP XL → SkyPlanner | Dagligt, eller egne skiftehold i SkyPlanner |
| Zlecenia produkcyjne (ZP) med processer, operationer, materialer, leveringsfrist og prioritet | Ordrer og opgaver med leveringsfrister og materialebehov | ERP XL → SkyPlanner | Polling med få minutters mellemrum |
| Beholdning pr. lager | Lagerbeholdninger | ERP XL → SkyPlanner | Polling hver time eller ved planlægningskørsel |
| Zamówienia zakupu (ZZ) med leveringsdatoer | Indkøbsordrer og indgående materialer efter leveringsdato | ERP XL → SkyPlanner | Polling hver time eller ved planlægningskørsel |
| Operationens tidsinterval: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Planlagt start og slut pr. opgave | SkyPlanner → ERP XL | Ved ændringer i tidsplanen via en SkyPlanner-webhook |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Tidsregistreringer og operatørtilbagemeldinger | SkyPlanner → ERP XL | Pr. tilbagemelding eller skiftehold, hvis det vælges |
| Findes ikke i ERP XL | Omstillingstidsmatrix, værktøjer med begrænset kapacitet, opgaver med flere operatører samt alternative maskiner og medarbejdere | Vedligeholdes i SkyPlanner | Sættes op under opstarten |
Integrationsmønstre
1. Indledende indlæsning af stamdata. Indlæs varer, teknologier, arbejdscentre, ressourcer og kalendere. Tag aktivt stilling til, hvordan arbejdscentrene skal repræsenteres i SkyPlanner: Et arbejdscenter med fire maskiner bliver til én arbejdsstationsgruppe eller fire arbejdsstationer. Værktøjer fra ERP XL’s ressourcer oprettes som værktøjer med begrænset kapacitet i SkyPlanner, og medarbejdere oprettes som personale med skiftehold.
2. Ordresynkronisering. Indlæs produktionsordrer med tilhørende operationer og materialer samt åbne indkøbsordrer. SkyPlanner regner bestilte materialer som tilgængelige på indkøbsordrens leveringsdato og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered.
3. Tilbageskrivning af planen. Når planlægningsmotoren placerer eller flytter en operation, sætter en SkyPlanner-webhook tjenesten til tilbageskrivning i gang. Tjenesten kalder XLDodajTerminDoProcesuProd med operationens TerminOd og TerminDo, så hver ZP-operation får de start- og sluttidspunkter, som SkyPlanner har planlagt.
4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringerne holder planen ajour. I vælger selv, om de faktiske tider skal skrives tilbage. Hvis ja, tilføjer tjenesten udførelsesregistreringer med XLDodajRealizacjeOperacjiProd, og RW- og PW-dokumenter følger jeres regler i ERP XL. Hvis I bruger Comarch MES på nogle stationer, skal hver operation kun have én kilde til tilbagemeldinger.
5. Regler for dataejerskab og konflikter. Skriv dem ned før idriftsættelsen:
| Data | Dataejer |
|---|---|
| Varer, teknologier, mængder, ZP-status, omkostningsberegning | Comarch ERP XL |
| Operationsrækkefølge, start- og sluttidspunkter, ressourcetildeling | SkyPlanner |
| Matrix for omstillingstider, krav til værktøj og operatører, alternative ressourcer | SkyPlanner |
| Skiftehold, kalendere og nedetid | Ét system, valgt under afklaringen |
| Udførelsesregistreringer, RW- og PW-dokumenter | Comarch ERP XL, registreret direkte dér eller overført fra SkyPlanners tidsregistreringer |
Vælg ét system til at skrive operationernes datoer. Hvis automatisk omplanlægning i ERP XL eller Comarch APS stadig skriver tidspunkter på de samme produktionsordrer, skal I slå det fra for de ordrer, SkyPlanner planlægger.
Typiske trin i projektet
Implementeringen afsluttes normalt i løbet af uger efter opstarten. Inden da skal I validere planen i den gratis prøveperiode på 30 dage med arbejdscentre, teknologier og åbne produktionsordrer eksporteret fra ERP XL som CSV eller Excel.
- Mapping. Fastlæg mappingtabellen, reglerne for dataejerskab, synkroniseringsintervallerne, og om udførelsesregistreringer skal skrives tilbage.
- Adgang til ERP XL. Opret integrationsbrugeren, opsæt læseforbindelsen, og placér tjenesten til tilbageskrivning på en vært med ERP XL installeret. Test først i en kopi af databasen.
- Første indlæsning. Varer, teknologier, arbejdscentre, ressourcer og kalendere.
- Synkronisering af produktions- og indkøbsordrer. Polling med filtre og genforsøg.
- Opsætning af begrænsninger i SkyPlanner. Matrix for omstillingstider, værktøjer, antal operatører pr. opgave samt alternative maskiner eller medarbejdere.
- Tilbageskrivning af planen. Kald til XLDodajTerminDoProcesuProd udløst af SkyPlanner-webhooks samt udførelsesregistreringer, hvis det er valgt.
- Parallel test. Kør SkyPlanner sideløbende med den nuværende plan, sammenlign datoer, og ret stamdata.
- Idriftsættelse. Slå tilbageskrivning til, når data stemmer overens.
Det skal I tage højde for i en Comarch ERP XL-integration
- Manuelt angivet kapacitet. Arbejdscentrets kapacitet i ERP XL er et brugerdefineret tal med en tilladt belastning i %. SkyPlanner beregner i stedet kapaciteten ud fra faktiske skiftehold og ressourcer. Opsæt derfor skifteholdene omhyggeligt, og lad procentsatsen ligge.
- Ubegrænsede ressourcer. ERP XL springer belægningskontrollen over for ressourcer, der er markeret med ubegrænset kapacitet. Beslut for hver enkelt, om den skal oprettes som en arbejdsstation med begrænset kapacitet i SkyPlanner.
- Frigivne ordrer. ERP XL udelader operationer, der er frigivet til produktion, fra omplanlægning, medmindre “Przesuń na zwolnionych” er markeret. Aftal, hvordan SkyPlanners datoer skal anvendes på frigivne ordrer, og brug Running Time Lock til at fastlåse arbejdet i de kommende timer.
- Versioner af datastrukturer. XL API-strukturer har et Wersja-felt. Indstil det, så det matcher jeres ERP XL-version, og test igen efter hver årlig opgradering.
- Polske enheder og tider. Operationstider og kalenderenheder skal omregnes præcist ved import, ellers bliver alle varigheder forkerte.
Hvem opsætter og supporterer Comarch ERP XL-integrationen?
- SkyPlanner-teamet opsætter integrationen under onboarding og yder support efter idriftsættelsen. Det gælder de aftalte dataudlæsninger og XL API-kald. Hver fabrik bruger Comarch ERP XL forskelligt, og den viden indgår i opsætningen.
- Jeres Comarch-partner kan deltage. Partneren kender jeres opsætning, licensforhold og XL API og kan opsætte brugeren, læseforbindelsen og værten til tilbageskrivning sammen med SkyPlanner-teamet.
- Jeres egne udviklere kan bygge videre på integrationen via SkyPlanners REST API med et API-token. Et API-token er nok til at komme i gang, og SkyPlanner-teamet hjælper efter behov. I finder integrationsdokumentationen i SkyPlanners integrationsvejledning.
SkyPlanner koster fra 199 € pr. måned med 5 arbejdsstationer inkluderet og månedlig fakturering. I får på forhånd et tilbud på integrationen sammen med jeres abonnement, tilpasset jeres proces og behov. Se priser, produktionsplanlægning med Comarch ERP XL under hensyn til den faktiske kapacitet, siden om Comarch ERP XL og oversigten over ERP-integrationer.
Producenternes erfaringer med SkyPlanner
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-regneark til optimering af produktionen i realtid.”
Kalle Kalliomäki, forsyningskædespecialist
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 timers arbejdstid hver uge, og en ny opgavekø når ud til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at udarbejde en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
6 månederfrem kan salgsafdelingen se ledig kapacitet
“SkyPlanner giver et pålideligt grundlag for al produktionsplanlægning.”
Anu Järvinen, produktionschef
Fredman Operations · Emballagepapir egnet til fødevarekontakt
Salgsafdelingen kan se ledig kapacitet seks måneder frem, og forespørgsler om planændringer, der før tog en time eller mere, bliver besvaret på få sekunder.
100%leveringssikkerhed siden 2021
“SkyPlanner giver os overblik over kapaciteten og gør planlægningen forudsigelig.”
Dan Berglund, COO/CFO
Opes Corporation · Kemikalie- og fødevareproduktion
Leveringssikkerheden har været 100% i hele den periode, SkyPlanner har været i brug, siden 2021.
Ofte stillede spørgsmål
Har Comarch ERP XL et API til produktionsordrer?
Ja. XL API (CDN_API.DLL) opretter produktionsordrer, planlægger og omplanlægger dem med XLZamknijZlecenieProd, tilføjer operationsdatoer med XLDodajTerminDoProcesuProd og overfører udførelsesregistreringer med XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web tilføjer REST-mikrotjenester, som er dokumenteret i Swagger.
Hvordan skrives planlagte datoer tilbage til Comarch ERP XL?
Via XLDodajTerminDoProcesuProd, som tilføjer et datointerval (TerminOd, TerminDo) til hver operation på produktionsordren. En SkyPlanner-webhook udløser kaldet, hver gang planen ændres.
Understøtter Comarch ERP XL webhooks?
Der er ikke dokumenteret nogen udgående webhooks, så integrationen forespørger ERP XL med et interval, der fastlægges for den enkelte fabrik. SkyPlanners egne webhooks sender planændringer, så snart de sker.
Bør en Comarch-partner foreslå Comarch APS eller SkyPlanner?
SkyPlanner, når kunden ønsker at få en produktionsplan på plads inden for få uger, som tager højde for den faktiske maskin- og personalekapacitet og holder sig selv ajour. Comarch APS er en separat applikation med sin egen PostgreSQL-database, integrator og licensnøgle. Den synkroniserer, når planlæggeren klikker, og omstillingstiden er én fast værdi pr. operation (hjælp til Comarch APS). SkyPlanner er cloudsoftware, som omplanlægger automatisk og planlægger omstillinger, værktøjer, bemanding og materialer. Prisen starter ved 199 € pr. måned.
Kan vi teste SkyPlanner, før vi bygger integrationen?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med CSV- eller Excel-import fra ERP XL, og I behøver ikke et kreditkort. Start prøveperioden, eller tal med salgsafdelingen for at afklare integrationens omfang.
