Integrări / ERP / Comarch ERP XL
Ghid de integrare Comarch ERP XL pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare Comarch ERP XL le arată partenerilor și echipelor IT cum să conecteze Comarch ERP XL la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu Comarch ERP XL, folosind interfețele proprii Comarch:
- În SkyPlanner sunt preluate comenzile de producție (zlecenia produkcyjne), cu procesele și operațiile aferente, tehnologiile, centrele de lucru, resursele, articolele, stocurile și comenzile de achiziție.
- Momentele planificate de început și de sfârșit sunt transmise înapoi, prin XL API, pentru fiecare operație a comenzii de producție.
- Dacă alegeți această opțiune, înregistrările de timp ale operatorilor sunt transmise înapoi ca realizări ale operațiilor.
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
Echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră Comarch ERP XL în etapa de implementare și asigură asistență după punerea în funcțiune. Acest ghid se adresează partenerilor și dezvoltatorilor care vor să participe sau să dezvolte singuri soluții folosind REST API documentat al SkyPlanner (documentația API).
Interfețele de integrare Comarch ERP XL
Comarch enumeră trei modalități de comunicare cu ERP XL: “DCOM, direct database connection (SQL Client), REST API” (DCOM, conexiune directă la baza de date prin SQL Client, REST API) (Comarch, traducere). Pentru un sistem de programare a producției, două dintre acestea asigură funcțiile necesare:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Aceste funcții sunt reunite în biblioteca CDN_API.DLL, instalată împreună cu întregul sistem Comarch ERP XL.) (Documentația de asistență Comarch, traducere) Un program extern se autentifică prin XLLogin, apelează funcții care folosesc aceeași sesiune și se deconectează prin XLLogout. Fiecare structură are un câmp Wersja care selectează versiunea setului de parametri pentru versiunea ERP XL utilizată.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 expune microservicii REST: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Fiecare microserviciu RestAPI își expune propria documentație interactivă la endpointul /swagger.) (Documentația de asistență Comarch, traducere)
Conexiunea directă prin SQL Client oferă acces de citire la baza de date ERP XL pentru preluarea nomenclatoarelor și a comenzilor, conform celor convenite cu echipa IT și partenerul Comarch.
Funcțiile XL API pentru producție
Comarch documentează următoarele funcții pentru producție (XL128):
| Domeniu | Funcție | Rol |
|---|---|---|
| Tehnologii | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Creează o tehnologie, o operație, un centru de lucru asociat unei operații sau un material ori produs asociat unei operații |
| Comenzi de producție | XLNoweZlecenieProd | Creează o comandă de producție |
| Comenzi de producție | XLZamknijZlecenieProd | Planifică, replanifică, decontează sau închide o comandă de producție, în funcție de codul de acțiune ales |
| Operații | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Adaugă o operație sau o resursă la un proces de producție |
| Program de producție | XLDodajTerminDoProcesuProd | Adaugă un interval de timp unei operații: IdCzynnosci, TerminOd, TerminDo |
| Realizare | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Adaugă realizarea unei operații la comandă, modifică cantitatea realizată |
| Documente | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Generează documente RW și PW pentru obiectele de producție |
Autentificare și acces
- XL API. Integrarea se autentifică la o bază de date ca operator ERP XL prin XLLogin și primește o sesiune pentru apelurile ulterioare. Biblioteca DLL rulează pe o gazdă Windows pe care este instalat ERP XL, astfel că serviciul de scriere înapoi în ERP rulează în rețeaua dumneavoastră, alături de ERP XL.
- REST API. Accesul se configurează pentru fiecare instalare ERP XL Web; pagina Swagger a fiecărui microserviciu documentează apelurile disponibile.
- Citire SQL. Un cont de acces la baza de date cu drepturi doar de citire, aprobat de echipa IT.
În SkyPlanner, autentificarea pentru REST API se face cu un token API în antetul Authorization-Token (SkyPlanner Settings > API), iar documentația este disponibilă în Swagger/OpenAPI. Tutorialul de integrare vă ghidează prin primele apeluri.
Evenimente și interogare periodică
Documentația consultată pentru Comarch ERP XL nu prezintă webhookuri de ieșire. Sistemul APS propriu Comarch preia datele când planificatorul apasă pe „Aktualizuj dane z ERP” (Actualizează datele din ERP) (Documentația de asistență Comarch APS).
Prin urmare, datele din ERP XL se preiau prin interogare periodică. Citirile filtrate după comenzile de producție deschise și modificările recente identifică noile lucrări de executat. Frecvența se stabilește pentru fiecare fabrică: de la câteva minute pentru comenzile de producție până la o oră pentru stocuri.
SkyPlanner trimite webhookuri când se modifică starea sau programul de producție, astfel că scrierea înapoi în ERP este declanșată de evenimente.
Maparea datelor
| Obiect Comarch ERP XL (interfață) | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
| Karty towarów, unități de măsură (REST sau citire SQL) | Produse și materiale | ERP XL → SkyPlanner | Încărcare inițială, apoi interogare periodică |
| Technologia: operații, materiale, semifabricate și produse pentru fiecare operație | Structura produsului, subproduse, materiale pentru fiecare etapă de proces | ERP XL → SkyPlanner | Încărcare inițială, apoi la modificare |
| Operațiile din Technologia: centre de lucru, resurse, timpi | Etape de proces cu durate, timpi de reglaj și timpi de demontare | ERP XL → SkyPlanner | Încărcare inițială, apoi la modificare |
| Gniazda robocze și zasoby (utilaje, scule, angajați) | Centre de lucru, grupuri de centre de lucru, scule, personal | ERP XL → SkyPlanner | Încărcare inițială, apoi rar |
| Kalendarze i okresy, przestoje i awarie | Schimburi, perioade nelucrătoare și timpi de oprire | ERP XL → SkyPlanner | Zilnic sau schimburi gestionate direct în SkyPlanner |
| Zlecenia produkcyjne (ZP) cu procese, operații, materiale, termen de finalizare și prioritate | Comenzi și operații cu termene de finalizare și necesar de materiale | ERP XL → SkyPlanner | Interogare la fiecare câteva minute |
| Stoc pe depozit | Solduri de stoc | ERP XL → SkyPlanner | Interogare la fiecare oră sau la rularea programării |
| Zamówienia zakupu (ZZ) cu date de livrare | Comenzi de achiziție, materiale de primit în funcție de data livrării | ERP XL → SkyPlanner | Interogare la fiecare oră sau la rularea programării |
| Intervalele operației: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Începutul și sfârșitul planificate pentru fiecare operație | SkyPlanner → ERP XL | La modificarea programului de producție, prin webhook SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Înregistrări de timp și confirmări ale operatorilor | SkyPlanner → ERP XL | La fiecare confirmare sau schimb, dacă se alege această opțiune |
| Nu există în ERP XL | Matricea timpilor de pregătire și tranziție, scule cu disponibilitate limitată, operații cu mai mulți operatori, utilaje alternative și personal de înlocuire | Gestionate în SkyPlanner | Configurate în etapa de implementare |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Preluați articolele, tehnologiile, centrele de lucru, resursele și calendarele. Stabiliți cu atenție corespondența centrelor de lucru în SkyPlanner: un centru de lucru cu patru utilaje devine un grup de centre de lucru sau patru centre de lucru. Sculele din resursele ERP XL devin scule cu disponibilitate limitată în SkyPlanner, iar angajații devin personal cu schimburi de lucru.
2. Sincronizarea comenzilor. Preluați comenzile de producție împreună cu operațiile și materialele aferente, precum și comenzile de achiziție deschise. SkyPlanner consideră materialul comandat disponibil la data de livrare din comanda de achiziție și actualizează stocul când aceasta este marcată cu starea Delivered.
3. Retransmiterea programului în ERP. Când motorul programează sau mută o operație, un webhook SkyPlanner declanșează serviciul de retransmitere. Acesta apelează XLDodajTerminDoProcesuProd cu valorile TerminOd și TerminDo ale operației, astfel încât fiecare operație ZP să aibă începutul și sfârșitul planificate de SkyPlanner.
4. Confirmări din producție. Operatorii înregistrează activitatea cu SkyPlanner Mobile Confirmations sau Production Timer, iar înregistrările de timp mențin programul actualizat. Dumneavoastră decideți dacă timpii efectivi sunt retransmiși în ERP. Dacă da, serviciul adaugă realizările prin XLDodajRealizacjeOperacjiProd, iar documentele RW și PW urmează regulile dumneavoastră din ERP XL. Dacă folosiți Comarch MES la unele posturi, păstrați o singură sursă de raportare pentru fiecare operație.
5. Responsabilitatea pentru date și regulile de soluționare a conflictelor. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Articole, tehnologii, cantități, starea ZP, calculul costurilor | Comarch ERP XL |
| Succesiunea operațiilor, momentele de început și de sfârșit, alocarea resurselor | SkyPlanner |
| Matricea timpilor de pregătire și tranziție, cerințele privind sculele și operatorii, resursele alternative | SkyPlanner |
| Schimburi, calendare și perioade de oprire | Un singur sistem, ales la definirea domeniului proiectului |
| Realizări, documente RW și PW | Comarch ERP XL, cu introducere directă sau transmitere din înregistrările de timp SkyPlanner |
Alegeți un singur sistem care să scrie datele operațiilor. Dacă replanificarea automată din ERP XL sau Comarch APS continuă să scrie termene în aceleași comenzi de producție, dezactivați această funcție pentru comenzile programate de SkyPlanner.
Etapele obișnuite ale proiectului
Implementarea se încheie, de regulă, în câteva săptămâni de la începerea procesului de configurare inițială. Înainte de această etapă, validați programul în perioada de testare gratuită de 30 de zile, folosind centre de lucru, tehnologii și comenzi de producție deschise, exportate din ERP XL în format CSV sau Excel.
- Mapare. Stabiliți tabelul de mapare, regulile privind responsabilitatea pentru date, frecvențele de sincronizare și dacă realizările vor fi retransmise în ERP.
- Acces la ERP XL. Creați operatorul pentru integrare, configurați conexiunea de citire și instalați serviciul de retransmitere pe o gazdă pe care este instalat ERP XL. Testați mai întâi pe o copie a bazei de date.
- Încărcare inițială. Articole, tehnologii, centre de lucru, resurse, calendare.
- Sincronizarea comenzilor de producție și de achiziție. Interogare periodică, cu filtre și reîncercări.
- Configurarea constrângerilor în SkyPlanner. Matricea timpilor de pregătire și tranziție, scule, numărul de operatori pentru fiecare operație și utilaje alternative sau personal de înlocuire.
- Retransmiterea programului în ERP. Apeluri XLDodajTerminDoProcesuProd declanșate de webhook-uri SkyPlanner, plus realizările, dacă ați ales această opțiune.
- Testare în paralel. Rulați SkyPlanner în paralel cu planul actual, comparați datele și corectați nomenclatoarele.
- Punere în funcțiune. Activați retransmiterea în ERP după ce datele corespund.
Ce trebuie să aveți în vedere la integrarea cu Comarch ERP XL
- Capacitate introdusă manual. În ERP XL, capacitatea centrului de lucru este o valoare definită de utilizator, cu un grad de încărcare permis exprimat în %. SkyPlanner determină în schimb capacitatea pe baza schimburilor și resurselor reale, așa că definiți cu atenție schimburile și nu mai folosiți procentul.
- Resurse nelimitate. Pentru resursele marcate ca având capacitate nelimitată, ERP XL nu verifică gradul de ocupare. Decideți pentru fiecare dacă va deveni un centru de lucru cu capacitate finită în SkyPlanner.
- Comenzi lansate. ERP XL exclude de la replanificare operațiile lansate în producție, cu excepția cazului în care este bifată opțiunea “Przesuń na zwolnionych”. Stabiliți de comun acord cum se aplică datele SkyPlanner comenzilor lansate și folosiți Running Time Lock pentru a fixa programul de lucru pentru următoarele ore.
- Versiunile structurilor. Structurile XL API conțin un câmp Wersja. Setați-l astfel încât să corespundă versiunii dumneavoastră de ERP XL și repetați testele după fiecare actualizare anuală.
- Unități și timpi în sistemul polonez. Timpii operațiilor și unitățile calendarului trebuie convertite exact la import; în caz contrar, toate duratele vor fi greșite.
Cine configurează integrarea cu Comarch ERP XL și asigură suportul
- Echipa SkyPlanner configurează integrarea în etapa inițială și asigură suportul după punerea în funcțiune, pentru citirile și apelurile XL API convenite. Fiecare fabrică folosește Comarch ERP XL în mod diferit, iar aici își găsesc aplicarea cunoștințele despre aceste particularități.
- Partenerul dumneavoastră Comarch poate participa. Acesta cunoaște configurația, licențierea și XL API și poate configura operatorul, conexiunea de citire și serverul pentru scrierea datelor înapoi în ERP împreună cu echipa SkyPlanner.
- Dezvoltatorii dumneavoastră pot extinde integrarea folosind REST API din SkyPlanner și un token API. Un token API este suficient pentru a începe, iar echipa SkyPlanner oferă asistență la nevoie. Consultați documentația de integrare SkyPlanner.
SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Primiți în avans o ofertă pentru integrare, adaptată procesului și nevoilor dumneavoastră, împreună cu abonamentul. Consultați prețurile, programarea cu capacitate finită pentru Comarch ERP XL, pagina Comarch ERP XL și centrul de integrări ERP.
Ce spun producătorii despre SkyPlanner
2 heconomisite în fiecare săptămână
„Cu SkyPlanner, am trecut de la planificarea producției în foi de calcul Excel la optimizarea producției în timp real.”
Kalle Kalliomäki, specialist în lanțul de aprovizionare
UTU · Tablouri electrice și aparataj de comutație
Planificarea producției economisește 2 ore de lucru în fiecare săptămână, iar o nouă listă de operații ajunge la linia de producție în câteva secunde.
+90%eficiență în producție
„Eficiența în producție a crescut cu 90%.”
Abdul Rucyinga, director IT
Laboratory & Allied · Producție farmaceutică
Eficiența în producție a crescut cu 90%, iar crearea unui plan optimizat pentru trei luni, care acoperă toate centrele de lucru, durează mai puțin de 30 de minute.
6 lunipentru care echipa de vânzări vede capacitatea disponibilă
„SkyPlanner oferă o bază solidă și siguranță întregii activități de planificare a producției.”
Anu Järvinen, manager de producție
Fredman Operations · Hârtie de ambalat pentru contact alimentar
Echipa de vânzări vede capacitatea disponibilă cu șase luni în avans, iar solicitările de modificare a programului, care necesitau o oră sau mai mult, primesc răspuns în câteva secunde.
100%respectarea termenelor de livrare din 2021
„SkyPlanner ne oferă vizibilitate asupra capacității și face planificarea predictibilă.”
Dan Berglund, COO/CFO
Opes Corporation · Producție chimică și alimentară
Termenele de livrare au fost respectate în proporție de 100% pe întreaga perioadă de utilizare a SkyPlanner, din 2021.
Întrebări frecvente
Comarch ERP XL are un API pentru comenzile de producție?
Da. XL API (CDN_API.DLL) creează comenzi de producție, le planifică și le replanifică prin XLZamknijZlecenieProd, adaugă datele operațiilor prin XLDodajTerminDoProcesuProd și înregistrează execuția operațiilor prin XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web adaugă microservicii REST documentate în Swagger.
Cum sunt retransmise datele planificate în Comarch ERP XL?
Prin XLDodajTerminDoProcesuProd, care adaugă un interval (TerminOd, TerminDo) fiecărei operații din comanda de producție. Un webhook SkyPlanner declanșează apelul la fiecare modificare a programului.
Comarch ERP XL acceptă webhook-uri?
Nu sunt documentate webhook-uri de ieșire, așa că integrarea interoghează periodic ERP XL, la intervale stabilite pentru fiecare fabrică. Webhook-urile proprii SkyPlanner transmit modificările programului pe măsură ce apar.
Un partener Comarch ar trebui să propună Comarch APS sau SkyPlanner?
SkyPlanner, când clientul dorește să obțină în câteva săptămâni un program cu capacitate finită, care se menține singur actualizat. Comarch APS este o aplicație separată, cu propria bază de date PostgreSQL, propriul integrator și propria cheie de licență. Sincronizarea se face când planificatorul dă clic, iar timpul de reglaj are o singură valoare fixă pentru fiecare operație (documentația de ajutor Comarch APS). SkyPlanner este un software în cloud care replanifică automat și planifică schimbările de fabricație, sculele, echipele și materialele, de la 199 € pe lună.
Putem testa SkyPlanner înainte de a realiza integrarea?
Da. Perioada de testare gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru, cu importuri CSV sau Excel din ERP XL, fără card de credit. Începeți testarea sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
