Koppelingen / ERP / Comarch ERP XL
Handleiding voor de Comarch ERP XL koppeling voor productieplanning met SkyPlanner APS
Deze handleiding laat partners en IT-teams zien hoe ze Comarch ERP XL aan SkyPlanner APS koppelen. SkyPlanner wisselt gegevens in beide richtingen uit met Comarch ERP XL via de eigen interfaces van Comarch:
- Productieorders (zlecenia produkcyjne) met processen en bewerkingen, technologieën, werkcentra, productiemiddelen, artikelen, voorraad en inkooporders worden ingelezen.
- Geplande start- en eindtijden worden via de XL API teruggeschreven naar elke bewerking van de productieorder.
- Als u daarvoor kiest, worden tijdregistraties van operators teruggeschreven als realisaties van bewerkingen.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Het SkyPlanner-team stemt de koppeling tijdens de onboarding af op uw Comarch ERP XL-inrichting en biedt ook na de ingebruikname ondersteuning. Deze handleiding is bedoeld voor partners en ontwikkelaars die hieraan willen meewerken of zelf willen bouwen op de gedocumenteerde REST API van SkyPlanner (API-referentie).
Interfaces voor koppeling met Comarch ERP XL
Comarch noemt drie manieren om met ERP XL te communiceren: “DCOM, direct database connection (SQL Client), REST API” (DCOM, directe databaseverbinding (SQL Client), REST API) (Comarch, vertaald). Voor een planningssysteem zijn twee daarvan van belang:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Deze functies zijn gebundeld in de bibliotheek CDN_API.DLL, die samen met het volledige Comarch ERP XL-systeem wordt geïnstalleerd.) (Comarch-help, vertaald) Een extern programma meldt zich aan met XLLogin, roept functies aan die dezelfde sessie gebruiken en meldt zich af met XLLogout. Elke structuur heeft een veld Wersja waarmee de versie van de parameterset voor uw ERP XL-release wordt geselecteerd.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 biedt REST-microservices: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Elke RestAPI-microservice stelt zijn eigen interactieve documentatie beschikbaar via het endpoint /swagger.) (Comarch-help, vertaald)
De directe SQL Client-verbinding biedt leestoegang tot de ERP XL-database voor het ophalen van stamgegevens en orders, in overleg met uw IT-team en Comarch-partner.
XL API-functies voor productie
Comarch documenteert de volgende productiefuncties (XL128):
| Onderdeel | Functie | Werking |
|---|---|---|
| Technologieën | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Nieuwe technologie of bewerking aanmaken, een werkcentrum of materiaal of product aan een bewerking toevoegen |
| Productieorders | XLNoweZlecenieProd | Nieuwe productieorder aanmaken |
| Productieorders | XLZamknijZlecenieProd | Een productieorder plannen, opnieuw plannen, verrekenen of afsluiten, afhankelijk van de actiecode |
| Bewerkingen | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Een bewerking of productiemiddel aan een productieproces toevoegen |
| Planning | XLDodajTerminDoProcesuProd | Een datumbereik aan een bewerking toevoegen: IdCzynnosci, TerminOd, TerminDo |
| Realisatie | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Een realisatie van een bewerking aan de order toevoegen, de gerealiseerde hoeveelheid wijzigen |
| Documenten | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | RW- en PW-documenten voor productieobjecten aanmaken |
Authenticatie en toegang
- XL API. De koppeling meldt zich met XLLogin als ERP XL-operator aan bij een database en krijgt een sessie voor volgende aanroepen. De DLL draait op een Windows-host waarop ERP XL is geïnstalleerd. De service voor het terugschrijven draait dus binnen uw netwerk, naast ERP XL.
- REST API. De toegang wordt per ERP XL Web-installatie ingesteld. De Swagger-pagina van elke microservice documenteert de bijbehorende aanroepen.
- SQL-leestoegang. Een databaseaccount met alleen leesrechten, goedgekeurd door uw IT-team.
Aan de SkyPlanner-kant gebruikt de REST API voor authenticatie een API-token in de Authorization-Token-header (SkyPlanner Settings > API). De API is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding begeleidt u bij de eerste aanroepen.
Events en polling
In de geraadpleegde documentatie beschrijft Comarch ERP XL geen uitgaande webhooks. Het eigen APS van Comarch haalt gegevens op wanneer de planner op “Aktualizuj dane z ERP” (Gegevens uit ERP bijwerken) klikt (Comarch APS-help).
Gegevens uit ERP XL worden daarom via polling opgehaald. Door bij het uitlezen te filteren op openstaande productieorders en recente wijzigingen, wordt nieuw werk opgehaald. De frequentie wordt per fabriek ingesteld: van elke paar minuten voor productieorders tot elk uur voor voorraad.
SkyPlanner verstuurt webhooks wanneer de status of de planning verandert. Het terugschrijven wordt dus door events aangestuurd.
Datamapping
| Object in Comarch ERP XL (interface) | Object in SkyPlanner | Richting | Frequentie |
|---|---|---|---|
| Karty towarów, maateenheden (REST of SQL-leestoegang) | Producten en materialen | ERP XL → SkyPlanner | Eerste import, daarna via polling |
| Technologia: bewerkingen, materialen, halffabricaten en producten per bewerking | Productstructuur, deelproducten, materialen per processtap | ERP XL → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Bewerkingen in Technologia: werkcentra, productiemiddelen, tijden | Processtappen met bewerkingsduur, instel- en afbouwtijden | ERP XL → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Gniazda robocze en zasoby (machines, gereedschappen, medewerkers) | Werkcentra, werkcentrumgroepen, gereedschappen, personeel | ERP XL → SkyPlanner | Eerste import, daarna zelden |
| Kalendarze i okresy, przestoje i awarie | Ploegendiensten, niet-werktijd en stilstand | ERP XL → SkyPlanner | Dagelijks, of eigen ploegendiensten in SkyPlanner |
| Zlecenia produkcyjne (ZP) met processen, bewerkingen, materialen, leverdatum en prioriteit | Orders en taken met leverdatums en materiaalbehoeften | ERP XL → SkyPlanner | Polling om de paar minuten |
| Voorraad per magazijn | Voorraadsaldi | ERP XL → SkyPlanner | Polling, elk uur of bij het uitvoeren van de planning |
| Zamówienia zakupu (ZZ) met leverdatums | Inkooporders, inkomend materiaal per leverdatum | ERP XL → SkyPlanner | Polling, elk uur of bij het uitvoeren van de planning |
| Bewerkingstijden: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Geplande start- en eindtijd per taak | SkyPlanner → ERP XL | Bij wijzigingen in de planning, via een SkyPlanner-webhook |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Tijdregistraties en bevestigingen van operators | SkyPlanner → ERP XL | Per bevestiging of per ploegendienst, als u daarvoor kiest |
| Niet in ERP XL | Matrix voor omsteltijden, gereedschappen met beperkte beschikbaarheid, taken met meerdere operators, alternatieve machines en personeel | Beheerd in SkyPlanner | Ingesteld tijdens de onboarding |
Integratiepatronen
1. Eerste import van stamgegevens. Lees artikelen, technologieën, werkcentra, productiemiddelen en kalenders in. Maak bewuste keuzes bij het mappen van werkcentra naar SkyPlanner: een werkcentrum met vier machines wordt één werkcentrumgroep of vier werkcentra. Gereedschappen uit de productiemiddelen van ERP XL worden in SkyPlanner gereedschappen met beperkte beschikbaarheid. Medewerkers worden personeel met ploegendiensten.
2. Ordersynchronisatie. Lees productieorders met hun bewerkingen en materialen in, samen met openstaande inkooporders. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder de status Delivered krijgt.
3. Planning terugschrijven. Wanneer de planningsengine een bewerking inplant of verplaatst, activeert een SkyPlanner-webhook de terugschrijfservice. Deze roept XLDodajTerminDoProcesuProd aan met de TerminOd en TerminDo van de bewerking. Zo bevat elke ZP-bewerking de door SkyPlanner geplande start- en eindtijd.
4. Terugmeldingen van de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. De tijdregistraties houden de planning actueel. U kiest of de werkelijke tijden worden teruggeschreven. Zo ja, dan voegt de service realisaties toe met XLDodajRealizacjeOperacjiProd en volgen de RW- en PW-documenten uw regels in ERP XL. Gebruikt u op sommige werkcentra Comarch MES, houd dan per bewerking één bron voor terugmeldingen aan.
5. Regels voor gegevenseigenaarschap en conflicten. Leg deze vast vóór de ingebruikname:
| Gegevens | Eigenaar |
|---|---|
| Artikelen, productietechnologieën, aantallen, ZP-status, kostencalculatie | Comarch ERP XL |
| Volgorde van bewerkingen, start- en eindtijden, toewijzing van productiemiddelen | SkyPlanner |
| Omsteltijdenmatrix, vereisten voor gereedschappen en operators, alternatieve productiemiddelen | SkyPlanner |
| Ploegendiensten, kalenders en stilstand | Eén systeem, gekozen tijdens de scopebepaling |
| Realisaties, RW- en PW-documenten | Comarch ERP XL, met rechtstreekse invoer of terugmelding vanuit SkyPlanner-tijdregistraties |
Laat slechts één systeem de datums van bewerkingen vastleggen. Als de automatische herplanning van ERP XL of Comarch APS nog datums naar dezelfde productieorders schrijft, schakel dit dan uit voor orders die SkyPlanner plant.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Valideer de planning vooraf tijdens de gratis proefperiode van 30 dagen, met werkcentra, productietechnologieën en openstaande productieorders die u vanuit ERP XL als CSV of Excel exporteert.
- Gegevensmapping. Leg de mappingtabel, de regels voor gegevenseigenaarschap en de synchronisatiefrequenties vast. Bepaal ook of realisaties worden teruggeschreven.
- Toegang tot ERP XL. Maak het gebruikersaccount voor de koppeling aan, configureer de leesverbinding en installeer de terugschrijfservice op een host waarop ERP XL is geïnstalleerd. Test eerst in een kopie van de database.
- Eerste gegevensimport. Artikelen, productietechnologieën, werkcentra, productiemiddelen en kalenders.
- Productie- en inkooporders synchroniseren. Periodiek ophalen met filters en herhaalpogingen.
- Randvoorwaarden instellen in SkyPlanner. Omsteltijdenmatrix, gereedschappen, aantal operators per taak en alternatieve machines of medewerkers.
- Planning terugschrijven. Aanroepen van XLDodajTerminDoProcesuProd via SkyPlanner-webhooks, met realisaties als u daarvoor kiest.
- Parallel testen. Laat SkyPlanner naast de huidige planning draaien, vergelijk de datums en corrigeer de stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten bij een Comarch ERP XL koppeling
- Handmatig ingevoerde capaciteit. De capaciteit van een werkcentrum in ERP XL is een door de gebruiker ingesteld getal met een toegestaan belastingspercentage. SkyPlanner leidt de capaciteit juist af uit de daadwerkelijke ploegendiensten en productiemiddelen. Stel de ploegendiensten dus zorgvuldig in en laat het percentage los.
- Onbeperkte productiemiddelen. Voor productiemiddelen die als onbeperkt zijn gemarkeerd, slaat ERP XL de bezettingscontrole over. Bepaal per productiemiddel of het in SkyPlanner een werkcentrum met begrensde capaciteit wordt.
- Vrijgegeven orders. ERP XL neemt bewerkingen die zijn vrijgegeven voor productie niet mee in de herplanning, tenzij “Przesuń na zwolnionych” is aangevinkt. Spreek af hoe de door SkyPlanner geplande datums worden toegepast op vrijgegeven orders. Gebruik Running Time Lock om het werk voor de komende uren vast te zetten.
- Versies van datastructuren. De datastructuren van de XL API bevatten een veld Wersja. Stel dit in op uw ERP XL-versie en test opnieuw na elke jaarlijkse upgrade.
- Poolse eenheden en tijden. Bewerkingstijden en kalendereenheden moeten bij het importeren exact worden omgerekend, anders klopt geen enkele tijdsduur.
Wie configureert en ondersteunt de Comarch ERP XL koppeling?
- Het SkyPlanner-team configureert de koppeling tijdens de onboarding en ondersteunt deze na de ingebruikname. Dit omvat de afgesproken leesacties en XL API-aanroepen. Elke fabriek gebruikt Comarch ERP XL anders. Die praktijkkennis wordt hierin meegenomen.
- Uw Comarch-partner kan meewerken. De partner kent uw inrichting, licenties en XL API en kan samen met het SkyPlanner-team het gebruikersaccount, de leesverbinding en de host voor het terugschrijven instellen.
- Uw eigen ontwikkelaars kunnen hierop voortbouwen via de REST API van SkyPlanner met een API-token. Met een API-token kunnen ze direct aan de slag. Het SkyPlanner-team helpt waar nodig. De integratiedocumentatie vindt u in de SkyPlanner-documentatie voor koppelingen.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturering. U ontvangt vooraf een offerte voor de koppeling, afgestemd op uw proces en behoeften, samen met uw abonnement. Bekijk de prijzen, capaciteitsplanning met Comarch ERP XL, de Comarch ERP XL-pagina en het overzicht van ERP-koppelingen.
Ervaringen van productiebedrijven met SkyPlanner
2 hbespaard per week
“Dankzij SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelpanelen en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd en een nieuwe werklijst bereikt de productielijn binnen enkele seconden.
+90%productie-efficiëntie
“De efficiëntie in de productie is met 90% gestegen.”
Abdul Rucyinga, hoofd IT
Laboratory & Allied · Farmaceutische productie
De productie-efficiëntie is met 90% gestegen. Een geoptimaliseerde planning voor drie maanden voor alle werkcentra is in minder dan 30 minuten klaar.
6 maandenvooruit inzicht in vrije capaciteit voor verkoop
“SkyPlanner legt een betrouwbare basis voor onze volledige productieplanning.”
Anu Järvinen, productiemanager
Fredman Operations · Voedselveilig verpakkingspapier
Verkoop ziet de vrije capaciteit zes maanden vooruit. Verzoeken om de planning aan te passen die vroeger een uur of langer kostten, worden nu binnen enkele seconden beantwoord.
100%leverbetrouwbaarheid sinds 2021
“SkyPlanner geeft ons inzicht in de capaciteit en maakt de planning voorspelbaar.”
Dan Berglund, COO/CFO
Opes Corporation · Chemische productie en voedingsmiddelenproductie
Sinds de ingebruikname van SkyPlanner in 2021 is de leverbetrouwbaarheid de hele tijd 100% geweest.
Veelgestelde vragen
Heeft Comarch ERP XL een API voor productieorders?
Ja. De XL API (CDN_API.DLL) maakt productieorders aan, plant en herplant ze met XLZamknijZlecenieProd, voegt bewerkingsdatums toe met XLDodajTerminDoProcesuProd en boekt realisaties met XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web voegt REST-microservices toe die in Swagger zijn gedocumenteerd.
Hoe worden geplande datums teruggeschreven naar Comarch ERP XL?
Via XLDodajTerminDoProcesuProd, dat aan elke bewerking van een productieorder een datumbereik (TerminOd, TerminDo) toevoegt. Een SkyPlanner-webhook activeert de aanroep telkens wanneer de planning verandert.
Ondersteunt Comarch ERP XL webhooks?
Er zijn geen uitgaande webhooks gedocumenteerd. Daarom vraagt de koppeling ERP XL periodiek uit, volgens een schema dat per fabriek wordt ingesteld. De eigen webhooks van SkyPlanner sturen planningswijzigingen direct door.
Moet een Comarch-partner Comarch APS of SkyPlanner voorstellen?
SkyPlanner, als de klant binnen enkele weken een planning wil die rekening houdt met de werkelijke capaciteit en zichzelf actueel houdt. Comarch APS is een afzonderlijke applicatie met een eigen PostgreSQL-database, integrator en licentiesleutel. De synchronisatie start wanneer de planner klikt en de insteltijd is één vaste waarde per bewerking (Comarch APS-handleiding). SkyPlanner is cloudsoftware die automatisch herplant en omstellingen, gereedschappen, ploegen en materiaal inplant, vanaf 199 € per maand.
Kunnen we SkyPlanner testen voordat we de koppeling bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken met CSV- of Excel-imports vanuit ERP XL. Een creditcard is niet nodig. Start de proefperiode of neem contact op met verkoop om de scope van de koppeling te bepalen.
