Leitfaden zur Comarch ERP XL Schnittstelle für die Feinplanung mit SkyPlanner APS

Comarch nennt drei Wege zur Kommunikation mit ERP XL: „DCOM, direct database connection (SQL Client), REST API“ (DCOM, direkte Datenbankverbindung über SQL Client, REST API) (Comarch, übersetzt). Für die Feinplanung werden vor allem zwei davon genutzt:

1. XL API (CDN_API.DLL). „These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.“ (Diese Funktionen sind in der Bibliothek CDN_API.DLL zusammengefasst, die zusammen mit dem gesamten System Comarch ERP XL installiert wird.) (Comarch-Hilfe, übersetzt) Ein externes Programm meldet sich mit XLLogin an, ruft Funktionen innerhalb derselben Sitzung auf und meldet sich mit XLLogout ab. Jede Struktur enthält ein Feld Wersja, das die Version des Parametersatzes für Ihre Version von ERP XL festlegt.
2. ERP XL Web REST API. Comarch ERP XL Web 2026.0 stellt REST-Microservices bereit: „Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.“ (Jeder RestAPI-Microservice stellt unter dem Endpunkt /swagger eine eigene interaktive Dokumentation bereit.) (Comarch-Hilfe, übersetzt)

Die direkte Verbindung über SQL Client ermöglicht es, Stamm- und Auftragsdaten aus der Datenbank von ERP XL zu lesen – in Abstimmung mit Ihrem IT-Team und Ihrem Comarch-Partner.

Funktionen der XL API für die Produktion

Comarch dokumentiert folgende Produktionsfunktionen (XL128):

In der geprüften Dokumentation zu Comarch ERP XL sind keine ausgehenden Webhooks aufgeführt. Das eigene APS von Comarch ruft Daten ab, wenn der Planer auf „Aktualizuj dane z ERP“ (Daten aus ERP aktualisieren) klickt (Comarch APS Hilfe).

Deshalb werden die Daten aus ERP XL per Polling abgefragt. Die Abfragen sind auf offene Produktionsaufträge und jüngste Änderungen beschränkt und erfassen so neue Aufträge. Das Intervall wird je Werk festgelegt: alle paar Minuten für Produktionsaufträge bis hin zu stündlichen Abfragen für Lagerbestände.

SkyPlanner sendet Webhooks, sobald sich der Status oder der Plan ändert. Das Rückschreiben erfolgt somit ereignisgesteuert.

1. Erstimport der Stammdaten. Lesen Sie Artikel, Technologien, Arbeitsstationen, Ressourcen und Kalender ein. Legen Sie die Zuordnung der Arbeitsstationen zu SkyPlanner bewusst fest: Eine Arbeitsstation mit vier Maschinen wird zu einer Arbeitsstationsgruppe oder zu vier Arbeitsstationen. Werkzeuge aus den Ressourcen von ERP XL werden in SkyPlanner als begrenzt verfügbare Werkzeuge abgebildet, Mitarbeiter als Personal mit Schichten.

2. Auftragssynchronisierung. Lesen Sie Produktionsaufträge mit ihren Arbeitsgängen und Materialien sowie offene Bestellungen ein. SkyPlanner betrachtet bestelltes Material ab dem Liefertermin der Bestellung als verfügbar und aktualisiert den Lagerbestand, sobald die Bestellung als Delivered markiert wird.

3. Plantermine zurückschreiben. Wenn die Planungsengine einen Arbeitsgang einplant oder verschiebt, löst ein SkyPlanner-Webhook den Rückschreibdienst aus. Dieser ruft XLDodajTerminDoProcesuProd mit TerminOd und TerminDo des Arbeitsgangs auf. So enthält jeder ZP-Arbeitsgang den von SkyPlanner geplanten Start- und Endtermin.

4. Rückmeldungen aus der Fertigung. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Die Zeiteinträge halten den Plan aktuell. Sie entscheiden, ob Ist-Zeiten zurückgeschrieben werden. Falls ja, legt der Dienst mit XLDodajRealizacjeOperacjiProd Ausführungsrückmeldungen an; für RW- und PW-Belege gelten Ihre Regeln in ERP XL. Wenn Sie an einigen Stationen Comarch MES einsetzen, verwenden Sie pro Arbeitsgang nur eine Rückmeldequelle.

5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:

Legen Sie genau ein System fest, das die Termine der Arbeitsgänge schreibt. Wenn die automatische Neuplanung in ERP XL oder Comarch APS weiterhin Termine in dieselben Fertigungsaufträge schreibt, deaktivieren Sie dies für die von SkyPlanner geplanten Aufträge.

• Manuell eingegebene Kapazität. Die Kapazität einer Arbeitsstation in ERP XL ist eine benutzerdefinierte Zahl mit einer zulässigen Auslastung in %. SkyPlanner ermittelt die Kapazität stattdessen aus den tatsächlichen Schichten und Ressourcen. Richten Sie die Schichten daher sorgfältig ein und verzichten Sie auf den Prozentwert.
• Unbegrenzte Ressourcen. Bei Ressourcen, die als unbegrenzt gekennzeichnet sind, überspringt ERP XL die Belegungsprüfung. Entscheiden Sie für jede Ressource, ob sie in SkyPlanner als Arbeitsstation mit begrenzter Kapazität abgebildet wird.
• Freigegebene Aufträge. ERP XL nimmt zur Produktion freigegebene Arbeitsgänge von der Neuplanung aus, sofern „Przesuń na zwolnionych“ nicht aktiviert ist. Vereinbaren Sie, wie die SkyPlanner-Termine für freigegebene Aufträge gelten sollen. Nutzen Sie Running Time Lock, um die Arbeitsgänge der nächsten Stunden zu fixieren.
• Strukturversionen. Die Datenstrukturen der XL API enthalten das Feld Wersja. Setzen Sie es passend zu Ihrer ERP XL-Version und testen Sie nach jedem jährlichen Upgrade erneut.
• Polnische Einheiten und Zeitangaben. Arbeitsgangzeiten und Kalendereinheiten müssen beim Import exakt umgerechnet werden. Andernfalls sind sämtliche Dauern falsch.