Integrácie / ERP / Katana
Sprievodca integráciou Katana na rozvrhovanie výroby so SkyPlanner APS
Tento sprievodca integráciou Katana ukazuje konzultantom a IT tímom, ako prepojiť Katana Cloud Inventory (Katana MRP) so SkyPlanner APS. SkyPlanner sa so systémom Katana integruje obojsmerne cez verejné Katana API:
- Do SkyPlanner sa prenášajú výrobné príkazy, riadky operácií, receptúry výrobkov, výrobné operácie, zdroje, skladové zásoby a nákupné objednávky.
- Poradie z rozvrhu sa prenáša späť na kartu Schedule v systéme Katana spolu s termínom dokončenia výroby pre každý výrobný príkaz.
- Stav operácie a skutočný čas sa zapisujú späť do riadkov operácií.
- Webhooky Katana oznamujú zmeny na vstupe a webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Tím SkyPlanner počas úvodného nasadenia nakonfiguruje integráciu podľa vášho nastavenia systému Katana a poskytuje jej podporu aj po spustení ostrej prevádzky. Tento sprievodca je určený konzultantom a vývojárom, ktorí sa chcú zapojiť alebo sami vytvoriť riešenie s využitím zdokumentovaného REST API SkyPlanner (referenčná dokumentácia API).
Katana API
Katana je jednotný cloudový produkt s architektúrou multi-tenant, takže všetci zákazníci používajú rovnaké API. Ide o REST API vo verzii v1 na adrese https://api.katanamrp.com/v1. Jeho špecifikácia OpenAPI 3.0 je dostupná na adrese https://api.katanamrp.com/v1/openapi.json. Dokumentáciu nájdete v Katana Developer Hub.
Koncové body potrebné na rozvrhovanie:
- Kmeňové dáta:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Príkazy:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Poradie:
/manufacturing_order_rerank. - Ponuka a dopyt:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Koncový bod /resources neexistuje. Zdroje sú uvedené v poliach resource_id a resource_name v riadkoch operácií výrobkov a v riadkoch operácií výrobných príkazov.
Autentifikácia a limity
Na autentifikáciu sa používa API kľúč ako bearer token: Authorization: Bearer <api key>. Kľúč vytvoríte v časti Settings > API > Add new API key. (zdroj)
Pri návrhu synchronizácie treba zohľadniť tieto limity:
- API systému Katana predvolene povoľuje 60 požiadaviek za 60 sekúnd (zdroj)
- Po prekročení limitu API vráti kód 429 s hlavičkou
Retry-After. HlavičkaX-Ratelimit-Remaininguvádza, koľko požiadaviek ešte zostáva do vyčerpania limitu. - Koncové body pre zoznamy stránkujú výsledky a podporujú filtre podľa dátumu aktualizácie, takže objem prenášaných zmien zostáva malý.
Na strane SkyPlanner sa volania REST API autentifikujú pomocou API tokenu (SkyPlanner Settings > API). Rozhranie je zdokumentované v Swagger/OpenAPI. Návod na integráciu vás prevedie prvými volaniami.
Webhooky
Webhook zaregistrujete volaním POST /webhooks, v ktorom uvediete HTTPS URL a požadované udalosti. (zdroj) Na rozvrhovanie sú užitočné tieto udalosti:
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.*vrátane udalostí receivedproduct.*,product_recipe_row.*asales_order.*
Dátový obsah je stručný: typ objektu, akcia a href. Prijímateľ načíta celý objekt z adresy href. Každé doručenie obsahuje hlavičku x-sha2-signature (HMAC SHA-256) na overenie. Váš koncový bod musí do 10 sekúnd odpovedať kódom 20X. Katana opakuje doručenie trikrát: po 30 sekundách, 2 minútach a 15 minútach.
Mapovanie dát
| Objekt Katana (koncový bod) | Objekt v SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
Výrobky, materiály, varianty (/products, /materials, /variants) | Produkty a materiály | Katana → SkyPlanner | Úvodné načítanie, potom pri prijatí webhooku |
Receptúra výrobku / BOM (/recipe_rows, /bom_rows) | Štruktúra výrobku, podvýrobky | Katana → SkyPlanner | Úvodné načítanie, potom pri prijatí webhooku |
Výrobné operácie (/product_operation_rows): typ, zdroj, čas | Kroky postupu s trvaním a časmi prípravy | Katana → SkyPlanner | Úvodné načítanie, potom pri zmene |
Zdroje (resource_id, resource_name v riadkoch operácií) | Pracoviská, skupiny pracovísk | Katana → SkyPlanner | Úvodné načítanie, pri pridaní nového zdroja |
Výrobný príkaz s riadkami operácií (/manufacturing_orders, /manufacturing_order_operation_rows) | Zákazky a operácie | Katana → SkyPlanner | V reálnom čase cez webhook |
Materiálové položky výrobného príkazu (/manufacturing_order_recipe_rows) | Materiály pre jednotlivé operácie | Katana → SkyPlanner | V reálnom čase cez webhook |
Skladové zásoby, nákupné objednávky s termínmi dodania (/inventory, /purchase_order_rows) | Zásoby a očakávaný príjem materiálu | Katana → SkyPlanner | V reálnom čase cez webhook |
Pole delivery_date predajnej objednávky (/sales_orders) | Termín dodania zákazky, priorita zákazníka | Katana → SkyPlanner | V reálnom čase cez webhook |
Poradie výrobných príkazov (POST /manufacturing_order_rerank) | Poradie otvorených výrobných príkazov v rozvrhu | SkyPlanner → Katana | Pri zmene rozvrhu |
Pole production_deadline_date výrobného príkazu (PATCH /manufacturing_orders/{id}) | Plánované dokončenie | SkyPlanner → Katana | Pri zmene rozvrhu |
Polia status, total_actual_time v riadku operácie (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, časové záznamy | SkyPlanner → Katana | Pri zaznamenávaní práce |
| Nie sú v systéme Katana | Zmeny, neprítomnosti, matica časov prípravy, nástroje, počty operátorov, alternatívne pracoviská | Spravované v SkyPlanner | Nastavenie počas úvodného nasadenia |
Integračné postupy
1. Úvodné načítanie kmeňových dát. Postupne načítajte stránky výrobkov, materiálov, variantov, riadkov receptúr a riadkov operácií výrobkov. Rýchlosť volaní obmedzte tak, aby ste neprekročili limit. Z jednotlivých zdrojov v riadkoch operácií vytvorte pracoviská v SkyPlanner a zachovajte mapovanie kľúčov 1:1. Pre každé pracovisko nastavte v SkyPlanner zmeny, dovolenky a nadčasy, pretože Katana nemá kalendár zdrojov.
2. Synchronizácia príkazov. Prihláste sa na odber udalostí výrobných príkazov, riadkov operácií, skladových zásob a nákupných objednávok. Pri každej udalosti načítajte objekt z jeho adresy href a aktualizujte operáciu. SkyPlanner považuje objednaný materiál za dostupný v deň dodania nákupnej objednávky a po jej príjme aktualizuje zásoby. Nočné porovnanie dát s filtrami podľa dátumu aktualizácie zachytí všetky zmeškané udalosti.
3. Spätný zápis rozvrhu. Plán prenesiete do systému Katana dvoma volaniami:
- POST
/manufacturing_order_rerank„moves one or more manufacturing orders to an exact place in the production schedule“ (presunie jeden alebo viac výrobných príkazov na presné miesto v rozvrhu výroby). V jednej požiadavke prijme až 250 otvorených výrobných príkazov a umiestni ich na začiatok, na koniec alebo pred či za určený výrobný príkaz. (zdroj) - PATCH
/manufacturing_orders/{id}nastaví poleproduction_deadline_date. Katana túto hodnotu prijme len vtedy, keď je pre danú výrobnú lokalitu vypnutý automatický výpočet termínu dokončenia. (zdroj)
Zmena poradia nemá vplyv len na zoznam. V systéme Katana platí: „higher-priority MOs reserve required materials and subassemblies first“ (výrobné príkazy s vyššou prioritou si rezervujú potrebné materiály a podzostavy ako prvé). Poradie zo SkyPlanner teda určuje aj to, ktorému výrobnému príkazu Katana pridelí zásoby.
4. Potvrdzovanie práce v dielni. Operátori zaznamenávajú prácu pomocou SkyPlanner Mobile Confirmations, Production Timer alebo Quick Log Mode. SkyPlanner zapisuje stav a skutočný čas do riadka operácie výrobného príkazu. Ak závod namiesto toho naďalej používa Katana Shop Floor App, SkyPlanner načítava udalosti riadkov operácií. Pre každý závod zvoľte jeden spôsob vykazovania práce.
5. Pravidlá správy dát a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:
| Dáta | Zodpovedný systém |
|---|---|
| Výrobky, receptúry, výrobné operácie, skladové zásoby, nákup, predajné objednávky | Katana |
| Poradie operácií, časy začiatku a konca, pracovisko pre každú operáciu | SkyPlanner |
| Poradie výrobných príkazov na karte Schedule a termín dokončenia výroby | SkyPlanner, so zápisom do systému Katana |
| Zmeny, neprítomnosti, matica časov prípravy, nástroje, alternatívne zdroje | SkyPlanner |
| Stav operácie a zaznamenaný čas | Jeden kanál zvolený pri definovaní rozsahu |
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 počas 30-dňovej bezplatnej skúšobnej verzie vyskúšate systém na vlastných dátach z CSV exportu zo systému Katana, napríklad zo zoznamu Tasks na obrazovke Make.
Samotný projekt zahŕňa:
- Program a kľúč. Overte, či váš program Katana zahŕňa API a Manufacturing Management, a vytvorte API kľúč.
- Režim termínov. Dohodnite sa na vypnutí automatických termínov pre daný výrobný závod, aby výrobné termíny riadil SkyPlanner.
- Mapovanie. Definitívne určte mapovaciu tabuľku, kľúče zdrojov, pravidlá zodpovednosti za dáta a kanál na vykazovanie.
- Úvodné načítanie. Produkty, varianty, receptúry, výrobné operácie a zdroje.
- Synchronizácia udalostí. Webhooky pre objednávky, operácie, zásoby a nákupné objednávky spolu s nočnou kontrolou a zosúladením dát.
- Nastavenie obmedzení v systéme SkyPlanner. Zmeny, matica časov prestavenia, nástroje, počty operátorov a alternatívne pracoviská.
- Spätný zápis. Zmena poradia a termíny, potom stav operácií a čas.
- Paralelné testovanie a spustenie do prevádzky. Porovnajte dátumy zo systému SkyPlanner s aktuálnou kartou Schedule, opravte kmeňové dáta a potom zapnite spätný zápis.
S čím počítať pri integrácii so systémom Katana
- Režim termínov prepíše dátumy. „Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.“ (Po zapnutí automatického režimu sa všetky manuálne termíny prepíšu a nebude ich možné obnoviť.) Režim zvoľte raz, hneď na začiatku projektu.
- Chýba kalendár zdrojov. Neodvodzujte zmeny z jedinej hodnoty Weekly throughput. Nastavte ich v systéme SkyPlanner pre každé pracovisko osobitne.
- Zdroje sú len v riadkoch operácií. Názvy zdrojov v systéme Katana nemeňte, pretože slúžia ako kľúč k pracoviskám v systéme SkyPlanner.
- Časové jednotky.
planned_time_parametersa udáva v sekundách: pri operáciách typu per-unit na jednotku, pri typoch process, setup a fixed ako celkový čas. Typ namapujte správne, inak bude trvanie násobne vyššie alebo nižšie podľa množstva. - Skupiny pri výrobe na zákazku. Pri zmene poradia zostávajú výrobné príkazy (MO) prepojené s tou istou predajnou objednávkou spolu, preto ich zaraďujte ako skupinu.
- Správanie pri zmene poradia sa zmenilo. Od 7. októbra 2026 umiestňujú endpointy na zmenu poradia objednávky presne na požadované miesto. Integrácie vytvorené pre pôvodné správanie treba znovu otestovať. (zdroj)
Integrácia so systémom Katana: kto ju nastavuje a zabezpečuje jej podporu
Nastavenie zahŕňa vaše zdroje, výrobné operácie, tok objednávok a režim termínov. Dopĺňa údaje, ktoré Katana neuchováva: zmeny, maticu časov prestavenia, nástroje, počty operátorov a alternatívne zdroje.
- Tím SkyPlanner integráciu nastaví počas zavádzania a po spustení do prevádzky poskytuje podporu. Každý závod nastavuje zdroje a operácie v systéme Katana inak. Práve pri tomto nastavení sa uplatní znalosť vašej prevádzky.
- Integráciu môže vytvoriť váš konzultant pre systém Katana alebo integračný partner. SkyPlanner poskytuje REST API, dokumentáciu Swagger/OpenAPI a webhooky.
- Vaši vývojári môžu integráciu ďalej rozvíjať pomocou API tokenu. Na začiatok stačí API token a tím SkyPlanner v prípade potreby pomôže. Produktovú dokumentáciu vrátane nákupných objednávok a API pre produkty a materiály nájdete v dokumentácii SkyPlanner.
Cena SkyPlanner začína na 199 € mesačne pri mesačnej fakturácii a zahŕňa 5 pracovísk. Cenovú ponuku integrácie pripravíme vopred podľa vašich procesov a potrieb spolu s ponukou programu, aby ste ešte pred začiatkom poznali celkové náklady. Pozrite si cenník, funkcie a porovnanie s rozvrhovaním priamo v systéme Katana na stránke Plánovanie výroby v systéme Katana s ohľadom na reálne kapacity. Prehľad nájdete na stránke Katana a ďalšie ERP systémy v prehľade integrácií s ERP.
Skúsenosti výrobcov so systémom SkyPlanner
2 hušetrené každý týždeň
„Vďaka systému 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 dodávateľského reťazca
UTU · Elektrické rozvádzače a spínacie zariadenia
Plánovanie výroby šetrí každý týždeň 2 hodiny práce a nový zoznam operácií sa dostane na linku v priebehu niekoľkých sekúnd.
+90 %efektívnosť výroby
„Efektívnosť výroby sa zvýšila o 90 %.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektívnosť výroby sa zvýšila o 90 % a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej než 30 minút.
Menejprestojov pre nedostatok materiálu
„Prínos systému SkyPlanner pre nás spočíva v tom, že je to nástroj, ktorý funguje v každodennej praxi, najmä pri určovaní termínov dodania.“
Tommi Männistö, vedúci plánovania výroby
Eskomatic · Zákazkové obrábanie
Automatické rozvrhovanie zaťaženia umožňuje presnejšie určovať termíny dodania a prestoje vo výrobe spôsobené nedostatkom materiálu výrazne klesli.
1 000 a viacautomaticky rozvrhnutých výrobných príkazov
„Výrobu máme pod kontrolou celkom inak 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
Má Katana API a ktorý program potrebujem?
Áno. Katana ponúka verejné REST API v1 so špecifikáciou OpenAPI 3.0. Jej cenník uvádza prístup k API v programoch Free a Advantage. Na autentifikáciu slúži API kľúč typu bearer zo Settings > API.
Môže SkyPlanner zapísať rozvrh späť do systému Katana?
Áno. SkyPlanner prostredníctvom /manufacturing_order_rerank zoradí otvorené výrobné príkazy na karte Schedule v systéme Katana podľa svojho poradia a pri každom MO zapíše production_deadline_date. Stav operácie a skutočný čas sa zapisujú do riadkov operácií MO. Časový rozvrh pre jednotlivé pracoviská zostáva v systéme SkyPlanner, kde operátori pracujú podľa svojho zoznamu operácií.
Odosiela Katana zmeny v reálnom čase?
Áno. Webhooky systému Katana pokrývajú výrobné príkazy, riadky operácií, zásoby, nákupné aj predajné objednávky. SkyPlanner načíta každý zmenený objekt a každú noc dáta skontroluje a zosúladí, takže ani pri nezachytenej udalosti nezostane operácia neaktuálna.
Ako sa zo zdrojov v systéme Katana stanú pracoviská v systéme SkyPlanner?
Z každého jedinečného zdroja v riadkoch operácií systému Katana sa vytvorí pracovisko v systéme SkyPlanner s priradením kľúča 1:1. Zmeny, neprítomnosti a alternatívne pracoviská sa potom nastavia v systéme SkyPlanner.
Môžeme si SkyPlanner otestovať ešte pred vytvorením integrácie?
Áno. Bezplatná 30-dňová skúšobná verzia podporuje až 20 pracovísk s importom CSV zo systému Katana, bez potreby platobnej karty. Spustite skúšobnú verziu alebo kontaktujte obchodný tím a dohodnite rozsah integrácie.
