Guida all’integrazione di Comarch ERP XL per la schedulazione della produzione con SkyPlanner APS

Comarch indica tre modalità di comunicazione con ERP XL: “DCOM, direct database connection (SQL Client), REST API” (DCOM, connessione diretta al database tramite SQL Client, REST API) (Comarch, traduzione). Per un sistema di schedulazione, due di queste gestiscono gli scambi di dati:

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.” (Queste funzioni sono raccolte nella libreria CDN_API.DLL, installata insieme all’intero sistema Comarch ERP XL.) (Guida Comarch, traduzione) Un programma esterno accede con XLLogin, richiama le funzioni che condividono la sessione e si disconnette con XLLogout. Ogni struttura ha un campo Wersja che seleziona la versione del set di parametri per la release di ERP XL in uso.
2. ERP XL Web REST API. Comarch ERP XL Web 2026.0 espone microservizi REST: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Ogni microservizio RestAPI espone la propria documentazione interattiva all’endpoint /swagger.) (Guida Comarch, traduzione)

La connessione diretta tramite SQL Client consente di accedere in lettura al database ERP XL per acquisire anagrafiche e ordini, secondo quanto concordato con il team IT e il partner Comarch.

Funzioni XL API per la produzione

Comarch documenta le seguenti funzioni per la produzione (XL128):

Nella documentazione consultata, Comarch ERP XL non prevede webhook in uscita. L’APS di Comarch acquisisce i dati quando il pianificatore preme “Aktualizuj dane z ERP” (Aggiorna i dati dall’ERP) (Guida di Comarch APS).

Il lato ERP XL viene quindi interrogato tramite polling. Le letture, filtrate sugli ordini di produzione aperti e sulle modifiche recenti, rilevano le nuove attività da schedulare. La frequenza viene definita per ogni stabilimento: da pochi minuti per gli ordini di produzione a un’ora per le giacenze.

SkyPlanner invia webhook quando cambia lo stato o la schedulazione: la riscrittura dei dati nell’ERP è quindi attivata dagli eventi.

1. Caricamento iniziale delle anagrafiche. Acquisire articoli, tecnologie, centri di lavoro, risorse produttive e calendari. La mappatura dei centri di lavoro in SkyPlanner va definita con attenzione: un centro di lavoro con quattro macchine diventa un gruppo di centri di lavoro oppure quattro centri di lavoro. Gli utensili presenti tra le risorse di ERP XL diventano utensili a capacità finita in SkyPlanner, mentre i dipendenti diventano personale con i relativi turni.

2. Sincronizzazione degli ordini. Acquisire gli ordini di produzione con le relative operazioni e i materiali, insieme agli ordini di acquisto aperti. SkyPlanner considera il materiale ordinato disponibile alla data di consegna dell’ordine di acquisto e aggiorna le giacenze quando l’ordine viene contrassegnato come Delivered.

3. Scrittura della schedulazione nell’ERP. Quando il motore colloca o sposta un’operazione, un webhook di SkyPlanner attiva il servizio di scrittura nell’ERP. Il servizio chiama XLDodajTerminDoProcesuProd con i valori TerminOd e TerminDo dell’operazione, così ogni operazione ZP riporta l’inizio e la fine pianificati da SkyPlanner.

4. Consuntivazione in reparto. Gli operatori registrano il lavoro con SkyPlanner Mobile Confirmations o Production Timer e le registrazioni dei tempi mantengono aggiornata la schedulazione. Scegli tu se inviare i tempi effettivi all’ERP. In caso affermativo, il servizio aggiunge le consuntivazioni tramite XLDodajRealizacjeOperacjiProd, mentre i documenti RW e PW seguono le regole del tuo ERP XL. Se utilizzi Comarch MES su alcune postazioni, mantieni un’unica fonte di consuntivazione per ogni operazione.

5. Responsabilità sui dati e regole per i conflitti. Mettile per iscritto prima dell’avvio in produzione:

Affida a un solo sistema la scrittura delle date delle operazioni. Se la ripianificazione automatica di ERP XL o Comarch APS continua a scrivere le date sugli stessi ordini di produzione, disattiva questa funzione per gli ordini schedulati da SkyPlanner.

• Capacità inserita manualmente. In ERP XL la capacità del centro di lavoro è un valore definito dall’utente, con una percentuale di carico ammessa. SkyPlanner ricava invece la capacità dai turni e dalle risorse produttive effettive: configura quindi i turni con attenzione e lascia da parte la percentuale.
• Risorse a capacità illimitata. In ERP XL le risorse contrassegnate come a capacità illimitata non sono sottoposte al controllo di occupazione. Decidi per ciascuna se deve diventare un centro di lavoro a capacità finita in SkyPlanner.
• Ordini rilasciati. ERP XL esclude dalla ripianificazione le operazioni rilasciate in produzione, a meno che non sia selezionata l’opzione “Przesuń na zwolnionych”. Concorda come applicare le date di SkyPlanner agli ordini rilasciati e usa Running Time Lock per bloccare la schedulazione delle prossime ore di produzione.
• Versioni delle strutture. Le strutture di XL API contengono un campo Wersja. Impostalo in modo che corrisponda alla versione di ERP XL in uso e ripeti i test dopo ogni aggiornamento annuale.
• Unità e tempi nel sistema polacco. I tempi delle operazioni e le unità dei calendari devono essere convertiti esattamente durante l’importazione, altrimenti tutte le durate risulteranno errate.