Integrácie / ERP / Sage 200
Sprievodca integráciou Sage 200 na rozvrhovanie výroby so SkyPlanner APS
Tento sprievodca integráciou Sage 200 ukazuje obchodným partnerom a IT tímom, ako prepojiť Sage 200 Professional a jeho výrobný doplnok so SkyPlanner APS. Integrácia SkyPlanner so Sage 200 funguje obojsmerne:
- Produkty, skladové zásoby, nákupné a predajné objednávky sa načítavajú cez Sage 200 REST API.
- Výrobné príkazy, operácie, pracovníci a stroje sa načítavajú z vášho výrobného doplnku.
- Plánované termíny operácií sa zapisujú späť do výrobných príkazov.
- Časové záznamy operátorov sa prenášajú späť na vykázanie času pri jednotlivých operáciách.
Tím SkyPlanner počas zavádzania nakonfiguruje integráciu podľa vášho nastavenia Sage 200 a po spustení do ostrej prevádzky poskytuje podporu. Tento sprievodca je určený partnerom a vývojárom, ktorí sa chcú zapojiť alebo sami vyvíjať riešenia pomocou zdokumentovaného REST API SkyPlanner (referenčná dokumentácia API).
Dva zdroje v jednom systéme Sage 200
Nasadenie Sage 200 vo výrobnom podniku má dve vrstvy a integrácia načítava dáta z oboch.
1. Sage 200 REST API pre obchodné a skladové dáta. Podľa Sage rozhranie API „lets your application read and modify data in a Sage 200 site“ (umožňuje vašej aplikácii čítať a upravovať dáta v tomto prostredí). Zahŕňa to zákazníkov, dodávateľov, produkty, predajné a nákupné objednávky aj účty hlavnej knihy. Referenčná dokumentácia Sage 200 Professional (2025.02) zoskupuje zdroje do kategórií Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP a Stock. Pre rozvrhovanie sú dôležité tieto zdroje:
| Zdroj | Obsah |
|---|---|
products | Kód, názov, skladová jednotka, typ položky kusovníka, štandardné náklady |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Otvorené nákupné objednávky, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Zákaznícky dopyt, requested_delivery_date, promised_delivery_date |
warehouses, units | Prevádzky a merné jednotky |
2. Výrobný doplnok pre výrobné príkazy. Sage 200 API nemá koncové body pre výrobné príkazy, operácie ani zdroje. Výrobné príkazy sú uložené v Sicon Works Order Processing, Cim200 alebo v staršom module Sage 200 Manufacturing. Integrácia načítava výrobné príkazy, operácie a zdroje spôsobom, ktorý daný doplnok podporuje. Tento spôsob dohodneme s vami a vaším partnerom pre Sage 200 pri definovaní rozsahu.
Autentifikácia a prístup
Sage 200 API „uses OAuth 2.0 with OpenID Connect“ (používa OAuth s OpenID Connect), pričom využíva tok s autorizačným kódom. Prihlásenie prebieha cez Sage ID.
- Zapojte sa do Sage 200 API Developer Programme a požiadajte o prihlasovacie údaje.
- Priraďte Sage ID používateľovi Sage 200, ktorý má prístup k spoločnosti a funkciám potrebným pre používané koncové body.
- Vyžiadajte si rozsah oprávnení
offline_access, inak sa obnovovací token nevydá. - Pri každej požiadavke na databázu odosielajte
Authorization: Bearer <access_token>,X-SiteaX-Company. Obe ID získate z/sites.
Základná URL pre Sage 200 Professional: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Požiadavky používajú metódy GET, POST, PUT a DELETE a parametre dopytov OData $filter, $select, $top, $skip, $orderby a $expand.
V Sage 200 Professional povoľuje API poskytovateľ podpory zákazníka. V kontrolnom zozname Sage potvrdí, že „the API is enabled“ (API je povolené) a že „each required user has a Sage ID assigned.“ (každý používateľ, ktorý ho potrebuje, má priradené Sage ID). V Sage 200 Standard je API predvolene povolené.
Pri návrhu riešenia treba zohľadniť platnosť tokenov. Prístupové tokeny platia 8 hodín. Obnovovacie tokeny platia od 1 do 90 dní a „The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.“ (Obdobie na obnovenie sa počíta od prvého prihlásenia používateľa, nie od posledného obnovenia.) Sage uvádza, že opätovná autentifikácia „is unavoidable“ (je nevyhnutná). Naplánujte upozornenie na opätovné udelenie súhlasu ešte pred uplynutím tohto obdobia.
Na strane SkyPlanner sa prístup k REST API overuje pomocou API tokenu (SkyPlanner Settings > API). Rozhranie je zdokumentované vo Swagger/OpenAPI. Návod na integráciu vás prevedie prvými volaniami.
Zisťovanie zmien
Referenčná dokumentácia Sage 200 API neobsahuje zdroj pre webhooky ani odbery udalostí. Zmeny sa zisťujú pravidelným dopytovaním. Záznamy obsahujú polia date_time_created a date_time_updated. Pri každom dopyte sa preto dáta filtrujú pomocou $filter podľa date_time_updated a stránkujú pomocou $top a $skip.
Výrobné príkazy kontrolujte dopytovaním každých pár minút, skladové zásoby a riadky nákupných objednávok každú hodinu. SkyPlanner pri zmene rozvrhu odosiela webhooky, takže spätný zápis sa spúšťa na základe udalostí.
Mapovanie dát
| Objekt Sage 200 (zdroj) | Objekt SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
products, units (API) | Produkty a materiály | Sage 200 → SkyPlanner | Načítanie, potom pravidelné dopytovanie |
| Komponenty kusovníka (doplnok alebo modul BOM) | Štruktúra produktu, podprodukty, materiály na produkt | Sage 200 → SkyPlanner | Pri zmene |
| Pracovníci, stroje a skupiny zdrojov (doplnok) | Pracoviská, skupiny pracovísk, pracovníci | Sage 200 → SkyPlanner | Úvodné načítanie |
| Dostupnosť zdrojov: odstávky, údržba, dovolenky (doplnok) | Zmeny, neprítomnosti | Sage 200 → SkyPlanner | Denne |
| Výrobné príkazy a ich operácie, časy jednotlivých operácií (doplnok) | Zákazky a operácie s krokmi, trvaním a termínmi dokončenia | Sage 200 → SkyPlanner | Každých pár minút |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Termíny dodania zákazníkom | Sage 200 → SkyPlanner | Pravidelné dopytovanie |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Stavy zásob | Sage 200 → SkyPlanner | Každú hodinu |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Nákupné objednávky s očakávaným termínom dodania | Sage 200 → SkyPlanner | Každú hodinu |
| Plánovaný začiatok a koniec operácie výrobného príkazu, zdroj | Plánovaný začiatok, koniec a pracovisko pre každú operáciu | SkyPlanner → Sage 200 | Pri zmene cez webhook |
| Vykazovanie času operácie (doplnok) | Časové záznamy a potvrdenia operátorov | SkyPlanner → Sage 200 | Pri každom potvrdení alebo za každú zmenu |
| Dáta o obmedzeniach v SkyPlanner | Matica časov prestavenia, nástroje ako zdroje s obmedzenou kapacitou, alternatívne stroje a pracovníci | Spravované v SkyPlanner | Počas zavádzania |
Postupy integrácie
1. Úvodné načítanie kmeňových dát. Načítajte produkty a jednotky z API, potom zdroje, skupiny zdrojov a operácie kusovníka z doplnku. Skupinu zdrojov s tromi identickými strojmi môžete vytvoriť ako jednu skupinu pracovísk alebo ako tri pracoviská.
2. Synchronizácia príkazov. Z doplnku načítajte otvorené výrobné príkazy s ich operáciami a z API otvorené pop_order_lines a warehouse_holdings. Pri rozvrhovaní sa kontrolujú zásoby aj očakávané nákupné dodávky. MRP naďalej navrhuje výrobné príkazy v Sage 200 a SkyPlanner rozvrhuje tie, ktoré vytvoríte.
3. Spätný zápis rozvrhu. Pre každú operáciu, ktorú plánovací mechanizmus zaradil alebo presunul, SkyPlanner odošle plánovaný začiatok, koniec a zdroj späť do výrobného príkazu. Doplnok si naďalej spravuje vlastné množstvá, alokácie a kalkuláciu nákladov.
4. Potvrdzovanie práce v dielni. Operátori zaznamenávajú prácu pomocou SkyPlanner Mobile Confirmations alebo Production Timer a časové záznamy udržiavajú rozvrh aktuálny. Zaznamenaný čas sa prenáša späť ako čas vykázaný na operáciu výrobného príkazu, takže kalkulácia nákladov v Sage 200 pracuje so skutočne odpracovanými hodinami.
Ak už vo vašom závode vykazujete čas cez Sicon Shop Floor Data Capture alebo Cim200 Shop Floor Data Capture, zvoľte si jeden spôsob vykazovania.
5. Pravidlá správy dát a riešenia konfliktov. Spíšte ich pred spustením do ostrej prevádzky:
| Dáta | Zodpovedný systém |
|---|---|
| Produkty, kusovníky, množstvá vo výrobných príkazoch, alokácie, náklady | Sage 200 a doplnok |
| Poradie operácií, časy začiatku a ukončenia, priradenie pracoviska | SkyPlanner |
| Matica prípravných časov, požiadavky na nástroje a obsluhu, alternatívne zdroje | SkyPlanner |
| Vykazovanie času | Sage 200, s údajmi z časových záznamov v SkyPlanner |
Hlavným zdrojom konfliktov je kapacitný graf. Ak plánovači naďalej presúvajú výrobné príkazy alebo operácie v Sicon Rough Cut Capacity Planning alebo Cim200 Graphical Scheduler, termíny spravujú dva systémy. Ponechajte správu termínov operácií na SkyPlanner. S funkciou Autopilot SkyPlanner automaticky preplánuje rozvrh pri zmenách vo výrobe.
Typický priebeh projektu
Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku zavádzania. Ešte predtým si overte rozvrh počas 30-dňového bezplatného skúšobného obdobia pomocou exportu otvorených výrobných príkazov vo formáte CSV alebo Excel. Projekt potom prebieha takto:
- Definovanie rozsahu. Potvrďte doplnok a jeho verziu, spôsob načítania výrobných príkazov, spôsob spätného zápisu, frekvencie synchronizácie a kanál na vykazovanie času.
- Prístup k API. Poskytovateľ podpory povolí Sage 200 API, priradí Sage ID k používateľovi Sage 200 a nastaví prístup k spoločnostiam a funkciám.
- Úvodné načítanie. Produkty, jednotky, zdroje, skupiny zdrojov, operácie kusovníkov a dostupnosť.
- Synchronizácia príkazov a objednávok. Pravidelné načítavanie výrobných príkazov, riadkov nákupných objednávok a skladových zásob s upozornením na potrebu opätovného udelenia súhlasu.
- Nastavenie obmedzení v SkyPlanner. Matica prípravných časov, nástroje, počty pracovníkov obsluhy na operáciu a alternatívne stroje alebo pracovníci.
- Spätný zápis rozvrhu. Zápis plánovaných termínov operácií do výrobných príkazov; v tejto fáze sa pridáva aj vykazovanie času.
- Paralelné testovanie a spustenie ostrej prevádzky. Porovnajte termíny s aktuálnym plánom, opravte kmeňové dáta a potom zapnite spätný zápis.
Na čo myslieť pri integrácii so Sage 200
- Vyradený modul v novej verzii. Starší modul Sage 200 Manufacturing sa od verzie Sage 200 Professional 2025 R2 nedá používať. Skôr než začnete čokoľvek mapovať, potvrďte, ktoré výrobné riešenie sa bude používať pri spustení ostrej prevádzky.
- Časy operácií z nákladových údajov. Sicon MRP odhaduje pracovné a strojové časy z nákladových položiek kusovníkov v Sage 200. Najprv ich porovnajte so skutočnými časmi výroby.
- Nezhody v nákladových kategóriách. Sage upozorňuje, že hodnoty Nominal, Overhead Nominal a Overhead Recovery % sa musia zhodovať v operáciách kusovníkov aj v nákladových kategóriách, inak „there will be cost discrepancies.“ (vzniknú rozdiely v nákladoch).
- Lehota na obnovenie. Maximálna lehota 90 dní sa počíta od prvého prihlásenia. Integrácia, pri ktorej sa súhlas nikdy neudelí znova, prestane fungovať v rovnaký deň každého štvrťroka.
- Prostredie s viacerými spoločnosťami. Jedno prostredie môže obsahovať viacero spoločností, preto v každej požiadavke posielajte správnu hodnotu
X-Company.
Integrácia so Sage 200: kto ju nastavuje a zabezpečuje podporu
- Tím SkyPlanner ju nastaví počas zavádzania a zabezpečuje podporu aj po spustení ostrej prevádzky.
- Zapojiť sa môže aj váš obchodný partner pre Sage 200. Partner pozná váš doplnok a povolí API v Sage 200 Professional.
- Integráciu môžu rozvíjať aj vaši vlastní vývojári prostredníctvom rovnakého zdokumentovaného REST API s API tokenom. Na začiatok stačí API token a tím SkyPlanner vám v prípade potreby pomôže.
Po prepojení plánovací nástroj Arcturus zostavuje rozvrh z aktuálnych výrobných príkazov v Sage 200 a plánované termíny sa zapisujú do operácií výrobných príkazov. Cena SkyPlanner začína na 199 € mesačne, zahŕňa 5 pracovísk a fakturuje sa mesačne. Cenovú ponuku na integráciu pripravíme vopred podľa vašich procesov a potrieb spolu s cenou vášho programu, aby ste poznali celkové náklady ešte pred začiatkom. Pozrite si cenník, funkcie a porovnanie s vlastným plánovaním v Sage 200 v článku Plánovanie výroby v Sage 200 so zohľadnením reálnych kapacít strojov a pracovníkov. Prehľad nájdete na stránke Sage 200 a ďalšie ERP systémy v prehľade integrácií s ERP.
Ako výrobcovia hodnotia SkyPlanner
2 hušetrené každý týždeň
„Vďaka SkyPlanner sme pri plánovaní výroby prešli od excelových tabuliek k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista na dodávateľský reťazec
UTU · Elektrické rozvádzače a spínacie zariadenia
Plánovanie výroby šetrí každý týždeň 2 hodiny pracovného času a nový zoznam operácií sa dostane na linku v priebehu sekúnd.
1 000 a viacautomaticky rozvrhnutých výrobných príkazov
„Výrobu máme pod kontrolou inak než predtým a náš prehľad o kapacitách je na úplne inej úrovni.“
Hannu Ryynänen, generálny riaditeľ
Mamec · Priemyselné miešadlá, čerpadlá a technologicky náročná zákazková výroba
Tisíce výrobných príkazov sa rozvrhujú automaticky a celá organizácia má prehľad o výrobe v reálnom čase.
Často kladené otázky
Zahŕňa Sage 200 API aj výrobné príkazy?
Nie. Sage 200 Professional API pokrýva produkty, skladové zásoby, predajné a nákupné objednávky, financie a ďalšie oblasti, ale neobsahuje API zdroje pre výrobné príkazy ani operácie. Výrobné príkazy sa načítavajú z vášho výrobného doplnku, napríklad Sicon Works Order Processing alebo Cim200, spôsobom dohodnutým pri definovaní rozsahu.
Kto vytvára integráciu so Sage 200?
Tím SkyPlanner počas zavádzania nastaví obojsmernú integráciu podľa vášho prostredia Sage 200 a po spustení ostrej prevádzky zabezpečuje jej podporu. Váš obchodný partner pre Sage 200 povolí API a môže sa do projektu zapojiť. Aj vaši vlastní vývojári môžu vyvíjať riešenia pomocou zdokumentovaného REST API SkyPlanner. Na začiatok stačí API token.
Dokáže Sage 200 odosielať zmeny v reálnom čase?
Sage 200 API nepodporuje webhooky. Skladové zásoby a nákupné objednávky sa pravidelne načítavajú podľa date_time_updated a výrobné príkazy sa načítavajú z vášho doplnku každých niekoľko minút. V opačnom smere vlastné webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Môžeme si SkyPlanner otestovať pred vytvorením integrácie?
Áno. Počas 30-dňového bezplatného skúšobného obdobia môžete používať až 20 pracovísk a importovať výrobné príkazy vo formáte CSV alebo Excel. Platobná karta nie je potrebná. Vyskúšajte si SkyPlanner alebo kontaktujte obchodný tím a dohodnite si rozsah integrácie.
