Průvodce integrací Sage 200 se SkyPlanner APS pro rozvrhování výroby
Tento průvodce integrací Sage 200 ukazuje obchodním partnerům a IT týmům, jak propojit Sage 200 Professional a jeho výrobní doplněk se SkyPlanner APS. Propojení SkyPlanner se Sage 200 funguje obousměrně:
- Produkty, skladové zásoby, nákupní a prodejní objednávky se načítají přes Sage 200 REST API.
- Výrobní příkazy, operace, pracovníci a stroje se načítají z vašeho výrobního doplňku.
- Plánované termíny operací se zapisují zpět do výrobních příkazů.
- Časové záznamy obsluhy se přenášejí zpět pro vykázání času u jednotlivých operací.
Tým SkyPlanner během zavádění nastaví integraci podle vaší konfigurace Sage 200 a poskytuje k ní podporu i po spuštění 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í s využitím zdokumentovaného REST API SkyPlanner (referenční dokumentace API).
Dva zdroje v jednom systému Sage 200
Nasazení Sage 200 ve výrobním podniku má dvě vrstvy a integrace čte data z obou.
1. Sage 200 REST API pro obchodní a skladová data. Podle Sage toto API „lets your application read and modify data in a Sage 200 site“ (umožňuje vaší aplikaci číst a upravovat data v dané instanci). Jde o zákazníky, dodavatele, produkty, prodejní a nákupní objednávky a účty hlavní knihy. Referenční dokumentace Sage 200 Professional (2025.02) člení zdroje do skupin Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP a Stock. Pro rozvrhování jsou důležité tyto zdroje:
| Zdroj API | Obsah |
|---|---|
products | Kód, název, skladová jednotka, typ položky BOM, standardní 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 | Otevřené nákupní objednávky, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Poptávka zákazníků, requested_delivery_date, promised_delivery_date |
warehouses, units | Provozovny a měrné jednotky |
2. Výrobní doplněk pro výrobní příkazy. Sage 200 API nemá endpointy pro výrobní příkazy, operace ani výrobní zdroje. Výrobní příkazy jsou uloženy v Sicon Works Order Processing, Cim200 nebo ve starším modulu Sage 200 Manufacturing. Integrace čte výrobní příkazy, operace a výrobní zdroje způsobem, který daný doplněk podporuje. Ten s vámi a vaším partnerem pro Sage 200 dohodneme při vymezení rozsahu.
Ověřování a přístup
Sage 200 API „uses OAuth 2.0 with OpenID Connect“ (využívá OAuth ve spojení s OpenID Connect), a to v autorizačním toku s autorizačním kódem. Přihlášení probíhá přes Sage ID.
- Zapojte se do Sage 200 API Developer Programme a požádejte o přístupové údaje.
- Propojte Sage ID s uživatelem Sage 200, který má přístup k firmě a funkcím potřebným pro používané endpointy.
- Vyžádejte si rozsah oprávnění
offline_access, jinak nebude vydán obnovovací token. - S každým požadavkem na databázi posílejte
Authorization: Bearer <access_token>,X-SiteaX-Company. Obě ID získáte z/sites.
Základní URL pro Sage 200 Professional: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Požadavky používají metody GET, POST, PUT a DELETE a parametry dotazů OData $filter, $select, $top, $skip, $orderby a $expand.
U Sage 200 Professional aktivuje API poskytovatel podpory zákazníka. V kontrolním seznamu Sage potvrzuje, že „the API is enabled“ (API je aktivováno) a že „each required user has a Sage ID assigned.“ (každý uživatel, který přístup potřebuje, má přiřazené Sage ID). Sage 200 Standard má API aktivované ve výchozím nastavení.
Při návrhu je nutné zohlednit platnost tokenů. Přístupové tokeny platí 8 hodin. Obnovovací tokeny platí 1 až 90 dní, přičemž „The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.“ (Lhůta pro obnovování se počítá od prvního přihlášení uživatele, nikoli od poslední obnovy.) Sage uvádí, že opětovné ověření „is unavoidable“ (je nevyhnutelné). Naplánujte upozornění na nutnost opětovného udělení souhlasu ještě před uplynutím této lhůty.
Přístup k REST API SkyPlanner se ověřuje pomocí API tokenu (SkyPlanner Settings > API). API je zdokumentováno ve Swagger/OpenAPI. Prvními voláními vás provede návod k integraci.
Zjišťování změn
Referenční dokumentace Sage 200 API neuvádí žádný zdroj pro webhooky ani odběr událostí. Změny se zjišťují pravidelným dotazováním. Záznamy obsahují date_time_created a date_time_updated, takže každý dotaz filtruje pomocí $filter podle date_time_updated a stránkuje pomocí $top a $skip.
Na výrobní příkazy se dotazujte každých několik minut, na zásoby a řádky nákupních objednávek každou hodinu. SkyPlanner při změně rozvrhu posílá webhooky, takže zpětný zápis je řízen událostmi.
Mapování dat
| Objekt Sage 200 (zdroj) | Objekt SkyPlanner | Směr | Četnost |
|---|---|---|---|
products, units (API) | Produkty a materiály | Sage 200 → SkyPlanner | Načtení, poté pravidelné dotazování |
| Komponenty kusovníku (doplněk nebo modul BOM) | Struktura produktu, dílčí produkty, materiály pro jednotlivé produkty | Sage 200 → SkyPlanner | Při změně |
| Pracovníci, stroje a skupiny výrobních zdrojů (doplněk) | Pracoviště, skupiny pracovišť, pracovníci | Sage 200 → SkyPlanner | Úvodní načtení |
| Dostupnost výrobních zdrojů: odstávky, údržba, dovolené (doplněk) | Směny, nepřítomnosti | Sage 200 → SkyPlanner | Denně |
| Výrobní příkazy a jejich operace, časy jednotlivých operací (doplněk) | Zakázky a operace včetně kroků, dob trvání a termínů dokončení | Sage 200 → SkyPlanner | Každých několik minut |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Termíny dodání zákazníkům | Sage 200 → SkyPlanner | Pravidelné dotazování |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Stavy zásob | Sage 200 → SkyPlanner | Každou hodinu |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Nákupní objednávky s očekávaným termínem dodání | Sage 200 → SkyPlanner | Každou hodinu |
| Plánovaný začátek a konec operace výrobního příkazu, výrobní zdroj | Plánovaný začátek, konec a pracoviště pro každou operaci | SkyPlanner → Sage 200 | Při změně přes webhook |
| Vykazování času operace (doplněk) | Časové záznamy a potvrzení obsluhy | SkyPlanner → Sage 200 | Při každém potvrzení nebo za směnu |
| Data o omezeních ve SkyPlanner | Matice časů seřízení, nástroje jako kapacitně omezené výrobní zdroje, alternativní stroje a pracovníci | Spravováno ve SkyPlanner | Při zavádění |
Postupy integrace
1. Úvodní načtení kmenových dat. Z API načtěte produkty a jednotky, poté z doplňku výrobní zdroje, jejich skupiny a operace kusovníků. Skupinu tří stejných strojů lze ve SkyPlanner reprezentovat jako jednu skupinu pracovišť nebo tři pracoviště.
2. Synchronizace příkazů a objednávek. Z doplňku načtěte otevřené výrobní příkazy s jejich operacemi a z API otevřené řádky pop_order_lines a warehouse_holdings. Při rozvrhování se kontrolují jak zásoby, tak očekávané nákupní dodávky. MRP nadále navrhuje výrobní příkazy v Sage 200 a SkyPlanner rozvrhuje ty, které vytvoříte.
3. Zpětný zápis rozvrhu. U každé operace, kterou plánovací jádro zařadilo nebo přesunulo, pošle SkyPlanner plánovaný začátek, konec a výrobní zdroj zpět do výrobního příkazu. Doplněk si nadále spravuje vlastní množství, rezervace a kalkulace nákladů.
4. Potvrzování ve výrobním provozu. Obsluha zaznamenává práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer a časové záznamy udržují rozvrh aktuální. Zaznamenaný čas se přenáší zpět jako čas vykázaný na operaci výrobního příkazu, takže kalkulace nákladů v Sage 200 pracuje se skutečně odpracovanými hodinami.
Pokud váš závod již vykazuje čas v Sicon Shop Floor Data Capture nebo Cim200 Shop Floor Data Capture, zvolte pro vykazování jediný kanál.
5. Pravidla odpovědnosti za data a řešení konfliktů. Písemně je stanovte před spuštěním ostrého provozu:
| Data | Odpovědný systém |
|---|---|
| Produkty, kusovníky, množství na výrobních příkazech, rezervace, náklady | Sage 200 a doplněk |
| Pořadí operací, časy zahájení a dokončení, přiřazení pracovišť | SkyPlanner |
| Matice časů seřízení, požadavky na nástroje a obsluhu, alternativní výrobní zdroje | SkyPlanner |
| Vykazování času | Sage 200 s údaji z časových záznamů SkyPlanner |
Hlavním zdrojem konfliktů je kapacitní graf. Pokud plánovači nadále přesouvají výrobní příkazy nebo operace v Sicon Rough Cut Capacity Planning či Cim200 Graphical Scheduler, termíny řídí dva systémy. Správu termínů operací ponechte systému SkyPlanner. S funkcí Autopilot SkyPlanner při změnách ve výrobě automaticky upravuje rozvrh.
Obvyklý postup projektu
Implementace je obvykle hotová během několika týdnů od zahájení úvodního nastavení. Ještě předtím si ověřte rozvrh během 30denního bezplatného zkušebního období pomocí exportu otevřených výrobních příkazů do CSV nebo Excelu. Projekt pak probíhá takto:
- Vymezení rozsahu. Potvrďte doplněk a jeho verzi, způsob čtení výrobních příkazů a zpětného zápisu, intervaly synchronizace a kanál vykazování času.
- Přístup k API. Poskytovatel podpory povolí Sage 200 API, přiřadí Sage ID k uživateli Sage 200 a nastaví přístup k firmám a funkcím.
- Úvodní načtení dat. Produkty, jednotky, výrobní zdroje, skupiny výrobních zdrojů, operace kusovníků a dostupnost.
- Synchronizace příkazů a objednávek. Pravidelné dotazování na výrobní příkazy, řádky nákupních objednávek a stav zásob, včetně upozornění na nutnost znovu udělit souhlas.
- Nastavení omezení v systému SkyPlanner. Matice časů seřízení, nástroje, počty pracovníků obsluhy na operaci a alternativní stroje nebo pracovníci.
- Zpětný zápis rozvrhu. Zápis plánovaných termínů operací do výrobních příkazů; v tomto kroku se přidává i vykazování času.
- Souběžné testování a spuštění ostrého provozu. Porovnejte termíny se stávajícím plánem, opravte kmenová data a poté zapněte zpětný zápis.
S čím počítat při integraci se Sage 200
- Ukončený modul v nové verzi. Starší modul Sage 200 Manufacturing nelze používat od verze Sage 200 Professional 2025 R2. Než začnete s mapováním, potvrďte, které řešení pro výrobu bude při spuštění ostrého provozu používáno.
- Časy operací z nákladových údajů. Sicon MRP odhaduje časy práce a strojní časy z nákladových položek kusovníků v Sage 200. Nejprve je porovnejte se skutečnými časy výroby.
- Nesoulad nákladových kategorií. Sage upozorňuje, že hodnoty Nominal, Overhead Nominal a Overhead Recovery % se musí shodovat u operací kusovníku a nákladových kategorií, jinak „there will be cost discrepancies.“ (vzniknou rozdíly v nákladech).
- Lhůta pro obnovení. Maximální lhůta 90 dnů se počítá od prvního přihlášení. Pokud pro integraci znovu neudělíte souhlas, přestane fungovat každý kvartál ve stejný den.
- Instance s více firmami. Jedna instance může obsahovat několik firem, proto v každém požadavku posílejte správnou hodnotu
X-Company.
Integrace se Sage 200: kdo ji nastavuje a zajišťuje podporu
- Tým SkyPlanner integraci nakonfiguruje během úvodního nastavení a po spuštění ostrého provozu zajišťuje podporu.
- Zapojit se může i váš obchodní partner pro Sage 200. Partner zná váš doplněk a povolí API v Sage 200 Professional.
- Na integraci mohou navázat i vaši vývojáři pomocí stejného zdokumentovaného REST API s API tokenem. Pro začátek stačí API token a tým SkyPlanner v případě potřeby pomůže.
Po propojení engine Arcturus vytváří rozvrh z aktuálních výrobních příkazů v Sage 200 a plánované termíny se zapisují do jejich operací. Cena SkyPlanner začíná na 199 € měsíčně a zahrnuje 5 pracovišť. Fakturace probíhá měsíčně. Cenovou nabídku integrace připravíme předem podle vašich procesů a potřeb společně s nabídkou tarifu, takže celkové náklady znáte ještě před zahájením. Prohlédněte si ceník a funkce. Srovnání s vlastním plánováním Sage 200 najdete na stránce Plánování výroby v Sage 200 s ohledem na skutečné kapacity strojů a pracovníků. Přehled najdete na stránce Sage 200 a další systémy ERP v přehledu integrací s ERP.
Jak výrobci hodnotí SkyPlanner
2 hušetřené každý týden
„SkyPlanner posunul naše plánování výroby od excelových tabulek k optimalizaci výroby v reálném čase.“
Kalle Kalliomäki, specialista dodavatelského řetězce
UTU · Elektrické rozvaděč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.
1 000 a víceautomaticky rozvržených výrobních příkazů
„Výrobu máme pod kontrolou jinak než dřív a kapacitám rozumíme na úplně jiné úrovni.“
Hannu Ryynänen, generální ředitel
Mamec · Průmyslová míchadla, čerpadla a technologicky náročná zakázková výroba
Tisíce výrobních příkazů se rozvrhují automaticky a celá organizace má přehled o výrobě v reálném čase.
Časté dotazy
Zahrnuje Sage 200 API výrobní příkazy?
Ne. Sage 200 Professional API pokrývá produkty, zásoby, prodejní a nákupní objednávky, finance a další oblasti, ale neposkytuje prostředky pro výrobní příkazy ani operace. Výrobní příkazy se získávají z vašeho výrobního doplňku, například Sicon Works Order Processing nebo Cim200, způsobem dohodnutým při vymezení rozsahu.
Kdo vytvoří integraci se Sage 200?
Tým SkyPlanner během úvodního nastavení nakonfiguruje obousměrnou integraci podle vašeho prostředí Sage 200 a po spuštění ostrého provozu zajišťuje podporu. Váš obchodní partner pro Sage 200 povolí API a může se do projektu zapojit. Na zdokumentovaném REST API systému SkyPlanner mohou stavět i vaši vývojáři. Pro začátek stačí API token.
Dokáže Sage 200 odesílat změny v reálném čase?
Sage 200 API nemá webhooky. Změny zásob a nákupních objednávek se zjišťují pravidelným dotazováním podle date_time_updated a výrobní příkazy se z vašeho doplňku načítají každých několik minut. V opačném směru vlastní webhooky systému SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Můžeme SkyPlanner otestovat před vytvořením integrace?
Ano. Během 30denního bezplatného zkušebního období můžete používat až 20 pracovišť a importovat výrobní příkazy z CSV nebo Excelu. Platební karta není potřeba. Vyzkoušejte SkyPlanner nebo kontaktujte obchodní tým a vymezte s ním rozsah integrace.
