Integrace / ERP / Comarch ERP XL
Průvodce integrací Comarch ERP XL pro plánování výroby se SkyPlanner APS
Tento průvodce integrací Comarch ERP XL ukazuje partnerům a IT týmům, jak propojit Comarch ERP XL se SkyPlanner APS. SkyPlanner se s Comarch ERP XL propojuje obousměrně prostřednictvím rozhraní společnosti Comarch:
- Do SkyPlanner se přenášejí výrobní příkazy (zlecenia produkcyjne) s procesy a operacemi, technologické postupy, pracoviště, výrobní zdroje, položky, skladové zásoby a nákupní objednávky.
- Plánované časy zahájení a dokončení se přes XL API zapisují zpět ke každé operaci výrobního příkazu.
- Pokud tuto možnost zvolíte, časové záznamy operátorů se zapisují zpět jako výkazy provedených operací.
- Webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Tým SkyPlanner během zavádění nakonfiguruje integraci podle vašeho nastavení Comarch ERP XL a poskytuje podporu i po spuštění do ostrého provozu. Tento průvodce je určen partnerům a vývojářům, kteří se chtějí do integrace zapojit nebo sami vyvíjet řešení nad zdokumentovaným REST API SkyPlanner (referenční dokumentace API).
Integrační rozhraní Comarch ERP XL
Comarch uvádí tři způsoby komunikace s ERP XL: „DCOM, direct database connection (SQL Client), REST API“ (DCOM, přímé připojení k databázi přes SQL Client, REST API) (Comarch, v překladu). Pro rozvrhování výroby se využívají především dva z nich:
- XL API (CDN_API.DLL). „These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.“ (Tyto funkce jsou součástí knihovny CDN_API.DLL, která se instaluje spolu s celým systémem Comarch ERP XL.) (Nápověda Comarch, v překladu) Externí program se přihlásí pomocí XLLogin, volá funkce sdílející stejnou relaci a odhlásí se pomocí XLLogout. Každá struktura obsahuje pole Wersja, které určuje verzi sady parametrů pro vaše vydání ERP XL.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 zpřístupňuje mikroslužby REST: „Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.“ (Každá mikroslužba RestAPI zpřístupňuje vlastní interaktivní dokumentaci na koncovém bodu /swagger.) (Nápověda Comarch, v překladu)
Přímé připojení přes SQL Client umožňuje číst kmenová data a příkazy z databáze ERP XL v rozsahu dohodnutém s vaším IT týmem a partnerem Comarch.
Funkce XL API pro výrobu
Comarch dokumentuje tyto výrobní funkce (XL128):
| Oblast | Funkce | Co dělá |
|---|---|---|
| Technologické postupy | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Vytvoří technologický postup či operaci nebo k operaci přidá pracoviště, materiál či výrobek |
| Výrobní příkazy | XLNoweZlecenieProd | Vytvoří výrobní příkaz |
| Výrobní příkazy | XLZamknijZlecenieProd | Podle kódu akce naplánuje, přeplánuje, vypořádá nebo uzavře výrobní příkaz |
| Operace | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Přidá operaci nebo výrobní zdroj do výrobního procesu |
| Rozvrh výroby | XLDodajTerminDoProcesuProd | Přidá k operaci časový interval: IdCzynnosci, TerminOd, TerminDo |
| Vykazování výroby | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Přidá k příkazu výkaz provedené operace, změní vykázané množství |
| Doklady | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Vytvoří doklady RW a PW pro výrobní objekty |
Autentizace a přístup
- XL API. Integrace se pomocí XLLogin přihlásí do databáze pod účtem operátora ERP XL a získá relaci pro další volání. Knihovna DLL běží na počítači s Windows a nainstalovaným ERP XL, takže služba pro zpětný zápis běží ve vaší síti vedle ERP XL.
- REST API. Přístup se nastavuje pro každou instalaci ERP XL Web zvlášť. Volání každé mikroslužby jsou popsána na její stránce Swagger.
- Čtení přes SQL. Databázový účet pouze pro čtení, schválený vaším IT týmem.
Na straně SkyPlanner používá REST API k autentizaci API token v hlavičce Authorization-Token (SkyPlanner Settings > API). Dokumentace je k dispozici ve Swagger/OpenAPI. Prvními voláními vás provede návod k integraci.
Události a pravidelné dotazování
V prověřené dokumentaci Comarch ERP XL nejsou uvedeny žádné odchozí webhooky. Vlastní APS společnosti Comarch načítá data, když plánovač stiskne „Aktualizuj dane z ERP“ (Nápověda Comarch APS).
Data z ERP XL se proto načítají pravidelným dotazováním. Nové výrobní úkoly se zachytí čtením omezeným na otevřené výrobní příkazy a poslední změny. Četnost se nastavuje pro každý závod zvlášť: od několika minut u výrobních příkazů po hodinu u skladových zásob.
SkyPlanner odesílá webhooky při změně stavu nebo rozvrhu výroby, takže zpětný zápis se řídí událostmi.
Mapování dat
| Objekt Comarch ERP XL (rozhraní) | Objekt SkyPlanner | Směr | Četnost |
|---|---|---|---|
| Karty towarów, měrné jednotky (REST nebo čtení přes SQL) | Výrobky a materiály | ERP XL → SkyPlanner | Úvodní načtení, poté pravidelné dotazování |
| Technologia: operace, materiály, polotovary a výrobky pro jednotlivé operace | Struktura výrobku, dílčí výrobky, materiály pro jednotlivé kroky procesu | ERP XL → SkyPlanner | Úvodní načtení, poté při změně |
| Operace v Technologia: pracoviště, výrobní zdroje, časy | Kroky procesu s dobou trvání, časy seřízení a časy na ukončení operace | ERP XL → SkyPlanner | Úvodní načtení, poté při změně |
| Gniazda robocze a zasoby (stroje, nástroje, zaměstnanci) | Pracoviště, skupiny pracovišť, nástroje, pracovníci | ERP XL → SkyPlanner | Úvodní načtení, poté jen výjimečně |
| Kalendarze i okresy, przestoje i awarie | Směny, nepracovní doba a prostoje | ERP XL → SkyPlanner | Denně, nebo vlastní směny ve SkyPlanner |
| Zlecenia produkcyjne (ZP) s procesy, operacemi, materiály, termínem dokončení a prioritou | Zakázky a operace s termíny dokončení a materiálovými požadavky | ERP XL → SkyPlanner | Dotazování každých několik minut |
| Zásoby v jednotlivých skladech | Skladové zůstatky | ERP XL → SkyPlanner | Dotazování každou hodinu nebo při spuštění rozvrhování |
| Zamówienia zakupu (ZZ) s termíny dodání | Nákupní objednávky, očekávaný příjem materiálu podle termínu dodání | ERP XL → SkyPlanner | Dotazování každou hodinu nebo při spuštění rozvrhování |
| Termíny operací: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Plánované zahájení a dokončení každé operace | SkyPlanner → ERP XL | Při změně rozvrhu prostřednictvím webhooku SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Časové záznamy a potvrzení operátorů | SkyPlanner → ERP XL | Při každém potvrzení nebo za směnu, pokud tuto možnost zvolíte |
| Není v ERP XL | Matice přípravných a přechodových časů, nástroje s omezenou dostupností, operace s více operátory, alternativní stroje a pracovníci | Spravuje se ve SkyPlanner | Nastavení během zavádění |
Integrační postupy
1. Úvodní načtení kmenových dat. Načtěte položky, technologické postupy, pracoviště, výrobní zdroje a kalendáře. Mapování pracovišť do SkyPlanner dobře zvažte: pracoviště se čtyřmi stroji převedete na jednu skupinu pracovišť nebo čtyři pracoviště. Nástroje evidované mezi výrobními zdroji ERP XL se ve SkyPlanner převedou na nástroje s omezenou dostupností a zaměstnanci na pracovníky s přiřazenými směnami.
2. Synchronizace příkazů a objednávek. Načtěte výrobní příkazy včetně operací a materiálů a také otevřené nákupní objednávky. SkyPlanner považuje objednaný materiál za dostupný k termínu dodání nákupní objednávky a aktualizuje zásoby, jakmile je objednávka označena jako dodaná.
3. Zpětný zápis plánu. Když plánovací jádro zařadí nebo přesune operaci, webhook SkyPlanner spustí službu pro zpětný zápis. Ta zavolá XLDodajTerminDoProcesuProd s hodnotami TerminOd a TerminDo dané operace. Každá operace ZP tak obsahuje začátek a konec naplánovaný ve SkyPlanner.
4. Odvádění výroby. Operátoři zaznamenávají práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer a časové záznamy udržují plán aktuální. Sami určíte, zda se mají skutečné časy zapisovat zpět. Pokud ano, služba přidává záznamy o provedení pomocí XLDodajRealizacjeOperacjiProd a doklady RW a PW se řídí vašimi pravidly v ERP XL. Pokud na některých pracovištích používáte Comarch MES, ponechte pro každou operaci jen jeden zdroj odvádění.
5. Pravidla pro správu dat a řešení konfliktů. Sepište je před spuštěním ostrého provozu:
| Data | Spravující systém |
|---|---|
| Položky, technologické postupy, množství, stav ZP, kalkulace nákladů | Comarch ERP XL |
| Pořadí operací, časy zahájení a ukončení, přiřazení výrobních zdrojů | SkyPlanner |
| Matice přípravných a přechodových časů, požadavky na nástroje a obsluhu, alternativní výrobní zdroje | SkyPlanner |
| Směny, kalendáře a odstávky | Jeden systém zvolený při vymezení rozsahu |
| Záznamy o provedení, doklady RW a PW | Comarch ERP XL; zadávají se přímo v něm nebo se přenášejí z časových záznamů SkyPlanner |
Určete jediný systém, který bude zapisovat termíny operací. Pokud automatické přeplánování v ERP XL nebo Comarch APS stále zapisuje termíny do stejných výrobních příkazů, vypněte tuto funkci u příkazů plánovaných ve SkyPlanner.
Obvyklý postup projektu
Implementace bývá hotová během několika týdnů od zahájení úvodního nastavení. Ještě předtím ověřte plán v rámci 30denní bezplatné zkušební verze s pracovišti, technologickými postupy a otevřenými výrobními příkazy exportovanými z ERP XL do CSV nebo Excelu.
- Mapování. Stanovte mapovací tabulku, pravidla pro správu dat, intervaly synchronizace a to, zda se budou záznamy o provedení zapisovat zpět.
- Přístup k ERP XL. Vytvořte účet operátora pro integraci, nastavte připojení pro čtení a nasaďte službu pro zpětný zápis na hostitele s nainstalovaným ERP XL. Nejprve vše otestujte na kopii databáze.
- Prvotní načtení. Položky, technologické postupy, pracoviště, výrobní zdroje, kalendáře.
- Synchronizace výrobních příkazů a nákupních objednávek. Pravidelné dotazování s filtry a opakováním neúspěšných pokusů.
- Nastavení omezení ve SkyPlanner. Matice přípravných a přechodových časů, nástroje, počty operátorů na operaci a alternativní stroje nebo pracovníci.
- Zpětný zápis plánu. Volání XLDodajTerminDoProcesuProd spouštěná webhooky SkyPlanner a případně také zápis záznamů o provedení, pokud jej zvolíte.
- Paralelní testování. Používejte SkyPlanner souběžně se stávajícím plánem, porovnávejte termíny a opravujte kmenová data.
- Ostrý provoz. Jakmile data souhlasí, zapněte zpětný zápis.
S čím počítat při integraci Comarch ERP XL
- Ručně zadaná kapacita. Kapacita pracoviště v ERP XL je číslo zadané uživatelem s povoleným zatížením v %. SkyPlanner místo toho odvozuje kapacitu ze skutečných směn a výrobních zdrojů. Směny proto nastavte pečlivě a procentuální zatížení ponechte stranou.
- Neomezené výrobní zdroje. U zdrojů označených jako kapacitně neomezené ERP XL nekontroluje obsazenost. U každého rozhodněte, zda se má ve SkyPlanner stát pracovištěm s omezenou kapacitou.
- Uvolněné příkazy. ERP XL nezahrnuje operace uvolněné do výroby do přeplánování, pokud není zaškrtnuta volba „Przesuń na zwolnionych“. Dohodněte se, jak se mají termíny ze SkyPlanner uplatnit u uvolněných příkazů, a pomocí Running Time Lock zafixujte práci na nejbližší hodiny.
- Verze struktur. Struktury XL API obsahují pole Wersja. Nastavte je podle používané verze ERP XL a po každém ročním upgradu znovu proveďte testy.
- Polské jednotky a časy. Časy operací a jednotky kalendářů se musí při importu převést přesně, jinak budou všechny doby trvání chybné.
Kdo nastavuje integraci Comarch ERP XL a zajišťuje její podporu
- Tým SkyPlanner integraci nastaví během úvodního zavedení a po spuštění ostrého provozu zajišťuje její podporu, a to v rozsahu dohodnutého čtení dat a volání XL API. Každý závod používá Comarch ERP XL jinak a právě při tomto nastavení se uplatní znalost jeho konkrétního provozu.
- Zapojit se může i váš partner Comarch. Zná vaše nastavení, licence i XL API a společně s týmem SkyPlanner může nastavit účet operátora, připojení pro čtení a hostitele pro zpětný zápis.
- Vaši vývojáři mohou integraci dále rozvíjet pomocí REST API SkyPlanner s API tokenem. Pro začátek stačí API token a tým SkyPlanner v případě potřeby pomůže. Podrobnosti najdete v dokumentaci integrací SkyPlanner.
SkyPlanner stojí od 199 € měsíčně včetně 5 pracovišť, s měsíční fakturací. Cenu integrace stanovíme předem podle vašich procesů a potřeb společně s cenou tarifu. Podívejte se na ceník, kapacitní plánování pro Comarch ERP XL, stránku Comarch ERP XL a přehled integrací ERP.
Jak SkyPlanner hodnotí výrobní firmy
2 hušetřené každý týden
„SkyPlanner nás při plánování výroby posunul od excelových tabulek k optimalizaci výroby v reálném čase.“
Kalle Kalliomäki, specialista dodavatelského řetězce
UTU · Elektrické rozváděče a spínací zařízení
Plánování výroby šetří každý týden 2 hodiny práce a nová fronta operací se na linku dostane během několika sekund.
+90 %efektivita výroby
„Efektivita výroby vzrostla o 90 %.“
Abdul Rucyinga, vedoucí IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby vzrostla o 90 % a vytvoření optimalizovaného plánu na tři měsíce pro všechna pracoviště trvá méně než 30 minut.
6 měsícůdopředu vidí obchodníci volnou kapacitu
„SkyPlanner poskytuje spolehlivý základ pro veškeré plánování výroby.“
Anu Järvinen, vedoucí výroby
Fredman Operations · Balicí papíry vhodné pro styk s potravinami
Obchodníci vidí volnou kapacitu na šest měsíců dopředu a na požadavky na změnu plánu, jejichž vyřízení dříve trvalo hodinu i déle, dostanou odpověď během několika sekund.
100 %včasnost dodávek od roku 2021
„SkyPlanner nám dává přehled o kapacitě a díky němu je plánování předvídatelné.“
Dan Berglund, COO/CFO
Opes Corporation · Chemická a potravinářská výroba
Včasnost dodávek dosahuje 100 % po celou dobu používání SkyPlanner, tedy od roku 2021.
Časté dotazy
Má Comarch ERP XL API pro výrobní příkazy?
Ano. XL API (CDN_API.DLL) vytváří výrobní příkazy, plánuje a přeplánovává je pomocí XLZamknijZlecenieProd, přidává termíny operací pomocí XLDodajTerminDoProcesuProd a zapisuje záznamy o provedení pomocí XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web navíc nabízí REST mikroslužby dokumentované v nástroji Swagger.
Jak se plánované termíny zapisují zpět do Comarch ERP XL?
Pomocí funkce XLDodajTerminDoProcesuProd, která ke každé operaci výrobního příkazu přidá časový interval (TerminOd, TerminDo). Webhook SkyPlanner spustí volání při každé změně plánu.
Podporuje Comarch ERP XL webhooky?
Odchozí webhooky nejsou zdokumentované, proto se integrace dotazuje ERP XL v intervalech nastavených pro daný závod. Vlastní webhooky SkyPlanner odesílají změny plánu ihned, jakmile nastanou.
Má partner Comarch doporučit Comarch APS, nebo SkyPlanner?
SkyPlanner, pokud chce zákazník během několika týdnů získat plán výroby, který respektuje skutečnou kapacitu a sám se průběžně aktualizuje. Comarch APS je samostatná aplikace s vlastní databází PostgreSQL, integrátorem a licenčním klíčem. Synchronizuje se po kliknutí plánovače a čas seřízení je v ní jedna pevná hodnota pro každou operaci (nápověda Comarch APS). SkyPlanner je cloudový software, který automaticky přeplánovává a plánuje přeseřízení, nástroje, pracovní týmy i materiál, a to od 199 € měsíčně.
Můžeme SkyPlanner vyzkoušet ještě před vytvořením integrace?
Ano. Bezplatná 30denní zkušební verze podporuje až 20 pracovišť s importem dat z ERP XL ve formátu CSV nebo Excel, bez nutnosti zadávat platební kartu. Vyzkoušejte ji nebo kontaktujte obchodní tým a vymezte s ním rozsah integrace.
