Průvodce integrací Katana se SkyPlanner APS pro rozvrhování výroby
Tento průvodce integrací Katana ukazuje konzultantům a IT týmům, jak propojit Katana Cloud Inventory (Katana MRP) se SkyPlanner APS. SkyPlanner se s Katana propojuje obousměrně přes veřejné Katana API:
- Do SkyPlanner se přenášejí výrobní příkazy, řádky operací, receptury výrobků, výrobní operace, výrobní zdroje, zásoby a nákupní objednávky.
- Naplánované pořadí se zapisuje zpět na kartu Schedule v Katana spolu s termínem dokončení výroby u každého výrobního příkazu.
- Stav operace a skutečný čas se zapisují zpět do řádků operací.
- Webhooky Katana hlásí změny do SkyPlanner a webhooky SkyPlanner odesílají změny rozvrhu, jakmile nastanou.
Tým SkyPlanner při zavádění nastaví integraci podle vaší konfigurace Katana a zajišťuje její podporu i po spuštění ostrého provozu. Tento průvodce je určen konzultantům a vývojářům, kteří se chtějí zapojit nebo sami vyvíjet řešení s využitím zdokumentovaného REST API SkyPlanner (referenční dokumentace API).
Katana API
Katana je jednotný cloudový produkt s architekturou pro více tenantů, takže všichni zákazníci používají stejné API. Jde o REST API ve verzi v1 na adrese https://api.katanamrp.com/v1. Specifikace OpenAPI 3.0 je dostupná na https://api.katanamrp.com/v1/openapi.json. Dokumentaci najdete v Katana Developer Hub.
Endpointy potřebné pro rozvrhování:
- Kmenová data:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Příkazy:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Pořadí:
/manufacturing_order_rerank. - Zásobování a poptávka:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Endpoint /resources neexistuje. Výrobní zdroje jsou uvedeny v polích resource_id a resource_name na řádcích operací výrobků a výrobních příkazů (MO).
Autentizace a limity
K autentizaci slouží API klíč použitý jako bearer token: Authorization: Bearer <api key>. Klíč vytvoříte v nabídce Settings > API > Add new API key. (zdroj)
Při návrhu synchronizace je nutné zohlednit tyto limity:
- Ve výchozím nastavení povoluje Katana API 60 požadavků za 60 sekund (zdroj)
- Při překročení limitu vrátí API kód 429 s hlavičkou
Retry-After. HlavičkaX-Ratelimit-Remainingudává zbývající počet povolených požadavků. - Endpointy pro výpisy stránkují výsledky a podporují filtry podle data aktualizace, takže objem přenášených změn zůstává malý.
REST API SkyPlanner používá k autentizaci API token (SkyPlanner Settings > API) a jeho dokumentace je ve formátu Swagger/OpenAPI. Integrační návod vás provede prvními voláními.
Webhooky
Webhook zaregistrujete voláním POST /webhooks, ve kterém zadáte HTTPS URL a požadované události. (zdroj) Pro rozvrhování jsou užitečné tyto události:
manufacturing_order.created,.updated,.deleted,.in_progress,.blocked,.donemanufacturing_order_operation_row.created,.updated,.in_progress,.paused,.completedcurrent_inventory.material_updated,.material_out_of_stockpurchase_order.*apurchase_order_row.*, včetně událostí received (příjem)product.*,product_recipe_row.*asales_order.*
Datový obsah je stručný: typ zdroje, akce a href. Příjemce načte celý objekt z adresy href. Každé doručení obsahuje hlavičku x-sha2-signature (HMAC SHA-256) pro ověření. Váš endpoint musí do 10 sekund odpovědět kódem 20X. Katana opakuje doručení třikrát: po 30 sekundách, 2 minutách a 15 minutách.
Mapování dat
| Objekt Katana (endpoint) | Objekt SkyPlanner | Směr | Četnost |
|---|---|---|---|
Výrobky, materiály, varianty (/products, /materials, /variants) | Výrobky a materiály | Katana → SkyPlanner | Počáteční načtení, poté při přijetí webhooku |
Receptura výrobku / BOM (/recipe_rows, /bom_rows) | Struktura výrobku, dílčí výrobky | Katana → SkyPlanner | Počáteční načtení, poté při přijetí webhooku |
Výrobní operace (/product_operation_rows): typ, výrobní zdroj, čas | Kroky postupu s dobou trvání a časy seřízení | Katana → SkyPlanner | Prvotní načtení, poté při změně |
Výrobní zdroje (resource_id, resource_name na řádcích operací) | Pracoviště, skupiny pracovišť | Katana → SkyPlanner | Počáteční načtení, při přidání nového výrobního zdroje |
Výrobní příkaz s řádky operací (/manufacturing_orders, /manufacturing_order_operation_rows) | Zakázky a operace | Katana → SkyPlanner | V reálném čase přes webhook |
Materiálové položky výrobního příkazu (/manufacturing_order_recipe_rows) | Materiály pro jednotlivé operace | Katana → SkyPlanner | V reálném čase přes webhook |
Zásoby, nákupní objednávky s termíny dodání (/inventory, /purchase_order_rows) | Skladové zásoby a očekávané dodávky materiálu | Katana → SkyPlanner | V reálném čase přes webhook |
Pole delivery_date prodejní objednávky (/sales_orders) | Termín zakázky, priorita zákazníka | Katana → SkyPlanner | V reálném čase přes webhook |
Pořadí výrobních příkazů (POST /manufacturing_order_rerank) | Pořadí otevřených výrobních příkazů v rozvrhu | SkyPlanner → Katana | Při změně rozvrhu |
Pole production_deadline_date výrobního příkazu (PATCH /manufacturing_orders/{id}) | Plánované dokončení | SkyPlanner → Katana | Při změně rozvrhu |
Pole status, total_actual_time řádku operace (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, časové záznamy | SkyPlanner → Katana | Při vykazování práce |
| V Katana nejsou k dispozici | Směny, nepřítomnosti, matice časů seřízení, nástroje, počty operátorů, alternativní pracoviště | Spravuje se ve SkyPlanner | Nastavení při zavádění |
Integrační postupy
1. Počáteční načtení kmenových dat. Postupně načtěte všechny stránky výrobků, materiálů, variant, řádků receptur a řádků operací výrobků. Rychlost volání omezte tak, abyste nepřekročili limit požadavků. Pro každý jedinečný výrobní zdroj uvedený na řádcích operací vytvořte pracoviště ve SkyPlanner a zachovejte přiřazení klíčů 1:1. Pro každé pracoviště nastavte ve SkyPlanner směny, dovolené a přesčasy, protože Katana nemá kalendář výrobních zdrojů.
2. Synchronizace příkazů. Přihlaste se k odběru událostí výrobních příkazů, řádků operací, zásob a nákupních objednávek. Při každé události načtěte objekt z jeho adresy href a aktualizujte operaci. SkyPlanner považuje objednaný materiál za dostupný k datu dodání nákupní objednávky a po jejím příjmu aktualizuje zásoby. Noční kontrola shody s filtry podle data aktualizace zachytí všechny zmeškané události.
3. Zpětný zápis rozvrhu. Plán se do Katana zapíše dvěma voláními:
- POST
/manufacturing_order_rerank„moves one or more manufacturing orders to an exact place in the production schedule“ (přesune jeden nebo více výrobních příkazů na přesně určené místo v rozvrhu výroby). Jeden požadavek pojme až 250 otevřených výrobních příkazů, které lze umístit na začátek, na konec nebo před či za daný výrobní příkaz. (zdroj) - PATCH
/manufacturing_orders/{id}nastavuje poleproduction_deadline_date. Katana tuto hodnotu přijme pouze tehdy, je-li pro danou výrobní lokalitu vypnutý automatický výpočet termínu dokončení. (zdroj)
Změna pořadí nemá vliv jen na seznam. V Katana platí, že „higher-priority MOs reserve required materials and subassemblies first“ (výrobní příkazy s vyšší prioritou rezervují potřebné materiály a podsestavy jako první). Pořadí ze SkyPlanner tedy také určuje, který výrobní příkaz získá zásoby v Katana.
4. Odvádění výroby ve výrobním provozu. Obsluha vykazuje práci pomocí SkyPlanner Mobile Confirmations, Production Timer nebo Quick Log Mode. SkyPlanner zapisuje stav a skutečný čas do řádku operace výrobního příkazu. Pokud závod místo toho nadále používá Katana Shop Floor App, SkyPlanner načítá události řádků operací. Pro každý závod zvolte jeden způsob vykazování.
5. Odpovědnost za data a pravidla řešení konfliktů. Sepište je před spuštěním ostrého provozu:
| Data | Odpovědný systém |
|---|---|
| Výrobky, receptury, výrobní operace, zásoby, nákup, prodejní objednávky | Katana |
| Pořadí operací, časy zahájení a dokončení, pracoviště pro každou operaci | SkyPlanner |
| Pořadí výrobních příkazů na kartě Schedule a termín dokončení výroby | SkyPlanner, se zápisem do Katana |
| Směny, nepřítomnosti, matice časů seřízení, nástroje, alternativní výrobní zdroje | SkyPlanner |
| Stav operace a vykázaný čas | Jeden kanál zvolený při vymezení rozsahu |
Obvyklý postup projektu
Implementace bývá dokončena během několika týdnů od zahájení zavádění. Ještě předtím si můžete SkyPlanner na 30 dní zdarma vyzkoušet s vlastními daty z CSV exportu ze systému Katana, například ze seznamu Tasks na obrazovce Make.
Samotný projekt zahrnuje:
- Tarif a klíč. Ověřte, že váš tarif Katana zahrnuje API a Manufacturing Management, a vytvořte klíč API.
- Režim termínů. Dohodněte se na vypnutí automatických termínů pro daný výrobní závod, aby výrobní termíny spravoval SkyPlanner.
- Mapování. Stanovte mapovací tabulku, klíče výrobních zdrojů, pravidla pro správu dat a kanál pro vykazování.
- Prvotní načtení. Produkty, varianty, receptury, výrobní operace a výrobní zdroje.
- Synchronizace událostí. Webhooky pro zakázky, operace, skladové zásoby a nákupní objednávky a k tomu noční kontrola a sladění dat.
- Nastavení omezení v systému SkyPlanner. Směny, matice seřizovacích časů, nástroje, počty operátorů a alternativní pracoviště.
- Zpětný zápis. Změna pořadí a termíny, poté stav operací a vykázaný čas.
- Souběžné testování a spuštění ostrého provozu. Porovnejte termíny ze systému SkyPlanner s aktuálními údaji na kartě Schedule, opravte kmenová data a poté zapněte zpětný zápis.
S čím počítat při integraci se systémem Katana
- Režim termínů přepisuje data. „Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.“ (Po zapnutí automatického režimu se všechny ručně nastavené termíny přepíší a nelze je obnovit.) Režim zvolte jednou, hned při zahájení projektu.
- Chybí kalendář výrobních zdrojů. Směny neodvozujte z jediné hodnoty Weekly throughput. Nastavte je v systému SkyPlanner pro každé pracoviště zvlášť.
- Výrobní zdroje jsou pouze na řádcích operací. Názvy výrobních zdrojů v systému Katana neměňte, protože slouží jako klíč k pracovištím v systému SkyPlanner.
- Časové jednotky.
planned_time_parameterje uveden v sekundách: u operací typu per-unit na jednotku, u typů process, setup a fixed jako celkový čas. Typ namapujte správně, jinak budou doby trvání chybné o násobek odpovídající množství. - Skupiny pro výrobu na zakázku. Při změně pořadí zůstávají výrobní příkazy (MO) navázané na stejnou prodejní objednávku pohromadě. Řaďte je proto jako skupinu.
- Změna chování při řazení. Od 7. října 2026 umisťují endpointy pro změnu pořadí zakázky přesně na požadovanou pozici. Integrace vytvořené pro původní chování je nutné znovu otestovat. (zdroj)
Integrace se systémem Katana: kdo ji nastavuje a zajišťuje podporu
Nastavení zahrnuje vaše výrobní zdroje, výrobní operace, tok zakázek a režim termínů. Doplňuje to, co Katana neeviduje: směny, matici seřizovacích časů, nástroje, počty operátorů a alternativní výrobní zdroje.
- Tým SkyPlanner integraci nastaví během zavádění a po spuštění ostrého provozu zajišťuje její podporu. Každý závod nastavuje výrobní zdroje a operace v systému Katana jinak. Právě při nastavení integrace se tyto znalosti uplatní.
- Integraci může vytvořit váš konzultant pro systém Katana nebo integrační partner. SkyPlanner poskytuje REST API, dokumentaci Swagger/OpenAPI a webhooky.
- Na integraci mohou navázat i vaši vlastní vývojáři s tokenem API. Pro začátek stačí token API a tým SkyPlanner v případě potřeby pomůže. Produktovou dokumentaci včetně nákupních objednávek a API pro produkty a materiály najdete v dokumentaci SkyPlanner.
Cena SkyPlanner začíná na 199 € měsíčně za 5 pracovišť s měsíční fakturací. Cenovou nabídku na integraci připravíme předem podle vašich procesů a potřeb společně s nabídkou tarifu, abyste znali celkové náklady ještě před zahájením. Podívejte se na ceník, funkce a srovnání s vlastním rozvrhováním systému Katana v článku Plánování výroby v systému Katana s ohledem na skutečné kapacity strojů a pracovníků. Přehled najdete na stránce systému Katana a další systémy ERP v přehledu integrací s ERP.
Jak výrobní firmy 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é 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 výrobní 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 tříměsíčního plánu pro všechna pracoviště trvá méně než 30 minut.
Méněprostojů kvůli nedostatku materiálu
„Přínos SkyPlanner pro nás spočívá v tom, že jde o nástroj, který funguje při každodenním používání, zejména při stanovování termínů dodání.“
Tommi Männistö, vedoucí plánování výroby
Eskomatic · Zakázkové obrábění
Automatické rozvrhování zatížení výrobních zdrojů zpřesňuje termíny dodání a prostoje ve výrobě způsobené nedostatkem materiálu výrazně poklesly.
1 000+automaticky rozvržených výrobních příkazů
„Výrobu máme pod kontrolou úplně jinak a náš přehled o kapacitách je na zcela 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
Má Katana API a jaký tarif potřebuji?
Ano. Katana nabízí veřejné REST API v1 se specifikací OpenAPI 3.0. Na stránce s cenami uvádí přístup k API u tarifů Free a Advantage. K autentizaci slouží API klíč ze Settings > API, který se používá jako bearer token.
Může SkyPlanner zapsat rozvrh zpět do systému Katana?
Ano. SkyPlanner prostřednictvím /manufacturing_order_rerank seřadí otevřené výrobní příkazy na kartě Schedule v systému Katana podle svého pořadí a u každého MO zapíše production_deadline_date. Stav operace a skutečný čas se zapisují do řádků operací daného MO. Časový rozvrh pro jednotlivá pracoviště zůstává v systému SkyPlanner, kde operátoři pracují podle své fronty operací.
Odesílá Katana změny v reálném čase?
Ano. Webhooky systému Katana pokrývají výrobní příkazy, řádky operací, skladové zásoby, nákupní objednávky a prodejní objednávky. SkyPlanner načítá každý změněný objekt a každou noc data kontroluje a slaďuje, takže ani zmeškaná událost nezanechá operaci neaktuální.
Jak se z výrobních zdrojů v systému Katana stanou pracoviště v systému SkyPlanner?
Každému odlišnému výrobnímu zdroji na řádcích operací v systému Katana odpovídá pracoviště v systému SkyPlanner s vazbou přes klíč 1:1. Směny, absence a alternativní pracoviště se pak nastavují v systému SkyPlanner.
Můžeme SkyPlanner otestovat ještě před vytvořením integrace?
Ano. Během 30denní zkušební verze zdarma můžete využít až 20 pracovišť s importem CSV ze systému Katana, bez platební karty. Vyzkoušejte SkyPlanner nebo kontaktujte obchodní tým a vymezte s ním rozsah integrace.
