Integrationer / ERP / Comarch ERP XL
Guide till integration av Comarch ERP XL för produktionsplanering med SkyPlanner APS
Den här integrationsguiden visar partner och IT-team hur Comarch ERP XL kopplas till SkyPlanner APS. SkyPlanner integreras med Comarch ERP XL i båda riktningarna via Comarchs egna gränssnitt:
- Tillverkningsorder (zlecenia produkcyjne) med processer och operationer, tillverkningsberedningar, produktionsgrupper, resurser, artiklar, lagersaldon och inköpsorder läses in.
- Planerade start- och sluttider återförs till varje operation på tillverkningsordern via XL API.
- Operatörernas tidrapportering återförs som operationsutfall, om ni väljer det.
- SkyPlanners webhooks skickar planändringar direkt när de sker.
SkyPlanner-teamet anpassar integrationen till er Comarch ERP XL-miljö under införandet och ger support efter driftsättningen. Guiden riktar sig till partner och utvecklare som vill delta eller själva bygga vidare med SkyPlanners dokumenterade REST API (API-referens).
Integrationsgränssnitt i Comarch ERP XL
Comarch anger tre sätt att kommunicera med ERP XL: ”DCOM, direct database connection (SQL Client), REST API” (DCOM, direkt databasanslutning (SQL Client), REST API) (Comarch, översatt). För ett planeringssystem sker arbetet via två av 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.” (Funktionerna är samlade i biblioteket CDN_API.DLL, som installeras tillsammans med hela Comarch ERP XL-systemet.) (Comarchs hjälp, översatt) Ett externt program loggar in med XLLogin, anropar funktioner som delar sessionen och loggar ut med XLLogout. Varje struktur har ett fält, Wersja, som väljer den version av parameteruppsättningen som gäller för er ERP XL-version.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 tillhandahåller REST-mikrotjänster: ”Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Varje RestAPI-mikrotjänst tillhandahåller egen interaktiv dokumentation på ändpunkten /swagger.) (Comarchs hjälp, översatt)
Den direkta SQL Client-anslutningen ger läsåtkomst till grunddata och order i ERP XL-databasen, enligt överenskommelse med ert IT-team och er Comarch-partner.
Produktionsfunktioner i XL API
Comarch dokumenterar följande produktionsfunktioner (XL128):
| Område | Funktion | Beskrivning |
|---|---|---|
| Tillverkningsberedningar | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Skapar en tillverkningsberedning, en operation, en produktionsgrupp för en operation eller ett material eller en produkt för en operation |
| Tillverkningsorder | XLNoweZlecenieProd | Skapar en tillverkningsorder |
| Tillverkningsorder | XLZamknijZlecenieProd | Planerar, omplanerar, avräknar eller avslutar en tillverkningsorder utifrån en åtgärdskod |
| Operationer | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Lägger till en operation eller en resurs i en tillverkningsprocess |
| Tidsplan | XLDodajTerminDoProcesuProd | Lägger till ett tidsintervall för en operation: IdCzynnosci, TerminOd, TerminDo |
| Utfall | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Lägger till operationsutfall på ordern, ändrar rapporterad kvantitet |
| Dokument | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Skapar RW- och PW-dokument för produktionsobjekt |
Autentisering och åtkomst
- XL API. Integrationen loggar in i en databas som en ERP XL-operatör med XLLogin och får en session för efterföljande anrop. DLL-filen körs på en Windows-värd där ERP XL är installerat. Tjänsten för återföring körs därför i ert nätverk, nära ERP XL.
- REST API. Åtkomsten konfigureras för varje ERP XL Web-installation. Anropen dokumenteras på respektive mikrotjänsts Swagger-sida.
- SQL-läsning. Ett databaskonto med enbart läsbehörighet, godkänt av ert IT-team.
På SkyPlanner-sidan autentiseras anrop till REST API med en API-token i headern Authorization-Token (SkyPlanner Settings > API). API:et dokumenteras i Swagger/OpenAPI. Integrationshandledningen går igenom de första anropen.
Händelser och pollning
I den granskade dokumentationen anger Comarch ERP XL inga utgående webhooks. Comarchs eget APS hämtar data när planeraren trycker på ”Aktualizuj dane z ERP” (uppdatera data från ERP) (Comarch APS-hjälp).
Därför används pollning på ERP XL-sidan. Nya tillverkningsuppdrag hämtas genom läsningar som filtreras på öppna tillverkningsorder och de senaste ändringarna. Intervallet bestäms per fabrik, från några minuters mellanrum för tillverkningsorder till en gång i timmen för lagersaldon.
SkyPlanner skickar webhooks när status eller tidsplanen ändras. Återföringen är därför händelsestyrd.
Datamappning
| Objekt i Comarch ERP XL (gränssnitt) | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
| Karty towarów, måttenheter (REST eller SQL-läsning) | Produkter och material | ERP XL → SkyPlanner | Första inläsning, därefter pollning |
| Technologia: operationer, material, halvfabrikat och produkter per operation | Produktstruktur, delprodukter och material per processteg | ERP XL → SkyPlanner | Första inläsning, därefter vid ändring |
| Operationer i Technologia: produktionsgrupper, resurser och tider | Processteg med varaktighet, ställtider och avrustningstider | ERP XL → SkyPlanner | Första inläsning, därefter vid ändring |
| Gniazda robocze och zasoby (maskiner, verktyg och anställda) | Produktionsgrupper, grupper av produktionsgrupper, verktyg och personal | ERP XL → SkyPlanner | Första inläsning, därefter sällan |
| Kalendarze i okresy, przestoje i awarie | Skift, arbetsfri tid och driftstopp | ERP XL → SkyPlanner | Dagligen, alternativt egna skift i SkyPlanner |
| Zlecenia produkcyjne (ZP) med processer, operationer, material, leveransdatum och prioritet | Order och operationer med leveransdatum och materialbehov | ERP XL → SkyPlanner | Pollning med några minuters mellanrum |
| Lagersaldo per lager | Lagersaldon | ERP XL → SkyPlanner | Pollning varje timme eller vid planeringskörning |
| Zamówienia zakupu (ZZ) med leveransdatum | Inköpsorder, inkommande material per leveransdatum | ERP XL → SkyPlanner | Pollning varje timme eller vid planeringskörning |
| Operationstider: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Planerad start och sluttid per operation | SkyPlanner → ERP XL | Vid ändrad tidsplan, via en webhook från SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Tidrapportering och operatörskvitteringar | SkyPlanner → ERP XL | Per kvittering eller per skift, om ni väljer det |
| Finns inte i ERP XL | Ställtidsmatris, verktyg med begränsad tillgänglighet, operationer med flera operatörer samt alternativa maskiner och personal | Underhålls i SkyPlanner | Konfigureras under införandet |
Integrationsmönster
1. Första inläsning av grunddata. Läs in artiklar, tillverkningsberedningar, produktionsgrupper, resurser och kalendrar. Välj noggrant hur produktionsgrupperna ska mappas till SkyPlanner: en produktionsgrupp med fyra maskiner blir en grupp av produktionsgrupper eller fyra produktionsgrupper. Verktyg bland resurserna i ERP XL blir verktyg med begränsad tillgänglighet i SkyPlanner, och anställda blir personal med skift.
2. Ordersynkronisering. Läs in tillverkningsorder med tillhörande operationer och material samt öppna inköpsorder. SkyPlanner räknar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagersaldot när inköpsordern markeras som Delivered.
3. Återföring av planen. När planeringsmotorn placerar eller flyttar en operation aktiveras återföringstjänsten av en webhook från SkyPlanner. Tjänsten anropar XLDodajTerminDoProcesuProd med operationens TerminOd och TerminDo, så att varje ZP-operation får den start- och sluttid som SkyPlanner har planerat.
4. Återrapportering från produktionen. Operatörerna registrerar arbetet med SkyPlanner Mobile Confirmations eller Production Timer, och tidsregistreringarna håller planen aktuell. Du väljer om faktiska tider ska återföras. Om de ska det lägger tjänsten till utfallsrapporteringar med XLDodajRealizacjeOperacjiProd, och RW- och PW-dokument följer dina regler i ERP XL. Om du använder Comarch MES vid vissa stationer ska varje operation ha endast en rapporteringskälla.
5. Regler för dataägarskap och konflikter. Dokumentera dem före driftstart:
| Data | Ägare |
|---|---|
| Artiklar, tillverkningsberedningar, kvantiteter, ZP-status, kostnadskalkylering | Comarch ERP XL |
| Operationsföljd, start- och sluttider, resurstilldelning | SkyPlanner |
| Ställtidsmatris, krav på verktyg och operatörer, alternativa resurser | SkyPlanner |
| Skift, kalendrar och stopptider | Ett system, valt under kartläggningen |
| Utfallsrapporteringar, RW- och PW-dokument | Comarch ERP XL, med registrering där eller överföring från tidsregistreringar i SkyPlanner |
Låt endast ett system skriva operationernas datum. Om den automatiska omplaneringen i ERP XL eller Comarch APS fortfarande skriver tider till samma produktionsorder ska du stänga av det för de order som SkyPlanner planerar.
Vanliga projektsteg
Implementeringen slutförs normalt inom några veckor efter att introduktionen har börjat. Validera dessförinnan planen under den kostnadsfria provperioden på 30 dagar med produktionsgrupper, tillverkningsberedningar och öppna produktionsorder som exporterats från ERP XL som CSV eller Excel.
- Mappning. Fastställ mappningstabellen, reglerna för dataägarskap, synkroniseringsintervallen och om utfallsrapporteringar ska återföras.
- Åtkomst till ERP XL. Skapa integrationsoperatören, konfigurera läsanslutningen och installera återföringstjänsten på en värddator där ERP XL är installerat. Testa först i en kopia av databasen.
- Första inläsning. Artiklar, tillverkningsberedningar, produktionsgrupper, resurser och kalendrar.
- Synkronisering av produktionsorder och inköpsorder. Pollning med filter och återförsök.
- Konfigurera begränsningar i SkyPlanner. Ställtidsmatris, verktyg, antal operatörer per operation samt alternativa maskiner eller personal.
- Återföring av planen. Anrop till XLDodajTerminDoProcesuProd via webhooks från SkyPlanner, samt utfallsrapporteringar om det har valts.
- Parallelltestning. Kör SkyPlanner parallellt med den nuvarande planen, jämför datum och rätta grunddata.
- Driftstart. Aktivera återföringen när uppgifterna stämmer överens.
Att tänka på vid en integration med Comarch ERP XL
- Manuellt angiven kapacitet. Produktionsgruppens kapacitet i ERP XL är ett användardefinierat tal med en tillåten belastning i %. SkyPlanner beräknar i stället kapaciteten utifrån faktiska skift och resurser. Konfigurera därför skiften noggrant och lämna procentsatsen åt sidan.
- Obegränsade resurser. Resurser som är markerade med obegränsad kapacitet undantas från beläggningskontrollen i ERP XL. Bestäm för varje sådan resurs om den ska bli en produktionsgrupp med begränsad kapacitet i SkyPlanner.
- Frisläppta order. ERP XL undantar operationer som har frisläppts till produktion från omplanering, om inte ”Przesuń na zwolnionych” är markerat. Kom överens om hur tiderna från SkyPlanner ska tillämpas på frisläppta order, och använd Running Time Lock för att låsa de närmaste timmarnas arbete.
- Strukturversioner. Strukturerna i XL API har ett Wersja-fält. Ställ in det så att det motsvarar din version av ERP XL och testa på nytt efter varje årlig uppgradering.
- Polska enheter och tider. Operationstider och kalenderenheter måste konverteras exakt vid importen, annars blir alla varaktigheter fel.
Vem konfigurerar och ger support för integrationen med Comarch ERP XL?
- SkyPlanner-teamet konfigurerar integrationen under introduktionen och ger support efter driftstart för de överenskomna läsningarna och anropen till XL API. Varje fabrik använder Comarch ERP XL på sitt eget sätt, och den kunskapen tas till vara här.
- Din Comarch-partner kan delta. Partnern känner till din konfiguration, licensiering och XL API och kan tillsammans med SkyPlanner-teamet konfigurera operatören, läsanslutningen och värddatorn för återföringen.
- Dina egna utvecklare kan bygga vidare på integrationen via SkyPlanners REST API med en API-token. En API-token räcker för att komma igång, och SkyPlanner-teamet hjälper till vid behov. Dokumentationen finns i SkyPlanners integrationsdokumentation.
SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Du får en offert för integrationen i förväg, tillsammans med abonnemanget, utifrån din process och dina behov. Se priser, finplanering med Comarch ERP XL, sidan om Comarch ERP XL och översikten över ERP-integrationer.
Tillverkare om SkyPlanner
2 hsparade varje vecka
”SkyPlanner har tagit vår produktionsplanering från Excel-ark till produktionsoptimering i realtid.”
Kalle Kalliomäki, specialist inom försörjningskedjan
UTU · Elcentraler och ställverk
Produktionsplaneringen sparar 2 timmars arbetstid varje vecka, och en ny körplan når produktionslinjen på några sekunder.
+90%produktionseffektivitet
”Effektiviteten i produktionen har ökat med 90 %.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Läkemedelstillverkning
Produktionseffektiviteten har ökat med 90 %, och det tar under 30 minuter att skapa en optimerad plan för tre månader för alla produktionsgrupper.
6 månaderframåt ser säljarna ledig kapacitet
”SkyPlanner ger en stabil och tillförlitlig grund för all produktionsplanering.”
Anu Järvinen, produktionschef
Fredman Operations · Förpackningspapper för livsmedel
Säljarna ser ledig kapacitet sex månader framåt, och förfrågningar om planändringar som tidigare tog en timme eller mer besvaras på några sekunder.
100%leveransprecision sedan 2021
”SkyPlanner ger oss insyn i kapaciteten och gör planeringen förutsägbar.”
Dan Berglund, COO/CFO
Opes Corporation · Kemikalie- och livsmedelstillverkning
Leveransprecisionen har varit 100 % under hela den tid SkyPlanner har använts, sedan 2021.
Vanliga frågor
Har Comarch ERP XL ett API för produktionsorder?
Ja. XL API (CDN_API.DLL) skapar produktionsorder, planerar och omplanerar dem med XLZamknijZlecenieProd, lägger till datum för operationer med XLDodajTerminDoProcesuProd och registrerar produktionsutfall med XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web tillför REST-mikrotjänster som dokumenteras i Swagger.
Hur återförs planerade tider till Comarch ERP XL?
Via XLDodajTerminDoProcesuProd, som lägger till ett tidsintervall (TerminOd, TerminDo) för varje operation på produktionsordern. En webhook från SkyPlanner utlöser anropet varje gång planen ändras.
Har Comarch ERP XL stöd för webhooks?
Inga utgående webhooks finns dokumenterade, så integrationen pollar ERP XL med intervall som bestäms för varje fabrik. SkyPlanners egna webhooks skickar planändringar direkt när de sker.
Bör en Comarch-partner föreslå Comarch APS eller SkyPlanner?
SkyPlanner, när kunden vill få finplanering på plats inom några veckor med en plan som håller sig aktuell. Comarch APS är en separat applikation med en egen PostgreSQL-databas, integrator och licensnyckel. Synkroniseringen sker när planeraren klickar, och ställtiden är ett fast värde per operation (hjälp för Comarch APS). SkyPlanner är en molntjänst som omplanerar automatiskt och planerar omställningar, verktyg, arbetslag och material, från 199 € per månad.
Kan vi testa SkyPlanner innan vi bygger integrationen?
Ja. Under den kostnadsfria provperioden på 30 dagar kan du använda upp till 20 produktionsgrupper med CSV- eller Excel-importer från ERP XL. Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för att kartlägga integrationen.
