Integracijos / ERP / Katana
Katana integravimo vadovas gamybos tvarkaraščiams sudaryti su SkyPlanner APS
Šiame Katana integravimo vadove konsultantams ir IT komandoms paaiškinama, kaip sujungti Katana Cloud Inventory (Katana MRP) su SkyPlanner APS. SkyPlanner keičiasi duomenimis su Katana abiem kryptimis per viešąją Katana API:
- Į SkyPlanner perduodami gamybos užsakymai, operacijų eilutės, gaminių receptūros, gamybos operacijos, ištekliai, atsargos ir pirkimo užsakymai.
- Tvarkaraštyje nustatyta užsakymų seka grąžinama į Katana skirtuką Schedule, o kiekvienam gamybos užsakymui nurodomas gamybos terminas.
- Operacijų būsena ir faktinė trukmė grąžinamos į operacijų eilutes.
- Katana įvykių pranešimai informuoja SkyPlanner apie pasikeitimus, o SkyPlanner įvykių pranešimai perduoda tvarkaraščio pakeitimus iškart jiems įvykus.
Diegimo metu SkyPlanner komanda sukonfigūruoja integraciją pagal jūsų Katana nustatymus ir prižiūri ją pradėjus naudoti. Šis vadovas skirtas konsultantams ir programuotojams, norintiems prisidėti prie integravimo arba patiems kurti sprendimus naudojantis dokumentuota SkyPlanner REST API (API žinynas).
Katana API
Katana yra vienas debesijos produktas su atskiromis klientų aplinkomis, todėl visi klientai naudoja tą pačią API. Tai REST API v1 versija, pasiekiama adresu https://api.katanamrp.com/v1. OpenAPI 3.0 specifikacija pateikta adresu https://api.katanamrp.com/v1/openapi.json. Dokumentaciją rasite Katana Developer Hub.
Tvarkaraščiams sudaryti reikalingi API prieigos taškai:
- Pagrindiniai duomenys:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Užsakymai:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Seka:
/manufacturing_order_rerank. - Pasiūla ir paklausa:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Prieigos taško /resources nėra. Ištekliai nurodomi gaminio operacijų ir gamybos užsakymo (MO) operacijų eilutėse, laukuose resource_id ir resource_name.
Autentifikavimas ir apribojimai
Autentifikavimui naudojamas API raktas, perduodamas kaip Bearer prieigos raktas: Authorization: Bearer <api key>. Raktą sukurkite pasirinkę Settings > API > Add new API key. (Šaltinis)
Projektuojant sinchronizavimą reikia atsižvelgti į šiuos ribojimus:
- Pagal numatytuosius nustatymus Katana API leidžia 60 užklausų per 60 sekundžių (šaltinis)
- Viršijus šią ribą, API grąžina kodą 429 su
Retry-After.X-Ratelimit-Remainingnurodo, kiek užklausų dar galima pateikti. - Sąrašų prieigos taškai grąžina rezultatus puslapiais ir leidžia filtruoti pagal atnaujinimo datą, todėl sinchronizuojant perduodamų pakeitimų apimtis išlieka nedidelė.
SkyPlanner REST API autentifikavimui naudojamas API prieigos raktas (SkyPlanner Settings > API), o dokumentacija pateikta Swagger/OpenAPI formatu. Integravimo pamokoje paaiškinama, kaip atlikti pirmąsias užklausas.
Įvykių pranešimai
Užregistruokite įvykių pranešimų gavimą POST užklausa į /webhooks, nurodydami HTTPS URL ir reikiamus įvykius. (Šaltinis) Tvarkaraščiams sudaryti naudingi šie įvykiai:
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.*irpurchase_order_row.*, įskaitant gavimo įvykiusproduct.*,product_recipe_row.*irsales_order.*
Pranešimuose pateikiama tik ištekliaus rūšis, veiksmas ir href. Gavėjas parsisiunčia visą objektą pagal href nuorodą. Kiekviename pranešime yra patikrai skirta x-sha2-signature antraštė (HMAC SHA-256). Jūsų prieigos taškas turi per 10 sekundžių atsakyti kodu 20X. Katana pakartoja siuntimą tris kartus: po 30 sekundžių, 2 minučių ir 15 minučių.
Duomenų susiejimas
| Katana objektas (prieigos taškas) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
Gaminiai, medžiagos, variantai (/products, /materials, /variants) | Produktai ir medžiagos | Katana → SkyPlanner | Pradinis įkėlimas, vėliau – gavus įvykio pranešimą |
Gaminio receptūra / BOM (/recipe_rows, /bom_rows) | Gaminio struktūra, pusgaminiai | Katana → SkyPlanner | Pradinis įkėlimas, vėliau – gavus įvykio pranešimą |
Gamybos operacijos (/product_operation_rows): tipas, išteklius, laikas | Proceso etapai su trukme ir paruošimo laiku | Katana → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
Ištekliai (resource_id, resource_name operacijų eilutėse) | Darbo centrai, darbo centrų grupės | Katana → SkyPlanner | Pradinis įkėlimas, vėliau – atsiradus naujam ištekliui |
Gamybos užsakymas su operacijų eilutėmis (/manufacturing_orders, /manufacturing_order_operation_rows) | Užsakymai ir užduotys | Katana → SkyPlanner | Realiuoju laiku per įvykių pranešimus |
Gamybos užsakymo medžiagos (/manufacturing_order_recipe_rows) | Užduočiai reikalingos medžiagos | Katana → SkyPlanner | Realiuoju laiku per įvykių pranešimus |
Atsargos, pirkimo užsakymai su pristatymo datomis (/inventory, /purchase_order_rows) | Atsargos ir numatomos gauti medžiagos | Katana → SkyPlanner | Realiuoju laiku per įvykių pranešimus |
Pardavimo užsakymo laukas delivery_date (/sales_orders) | Užsakymo įvykdymo terminas, kliento prioritetas | Katana → SkyPlanner | Realiuoju laiku per įvykių pranešimus |
Gamybos užsakymų seka (POST /manufacturing_order_rerank) | Atvirų gamybos užsakymų seka tvarkaraštyje | SkyPlanner → Katana | Pasikeitus tvarkaraščiui |
Gamybos užsakymo laukas production_deadline_date (PATCH /manufacturing_orders/{id}) | Planuojama pabaiga | SkyPlanner → Katana | Pasikeitus tvarkaraščiui |
Operacijos eilutės laukai status, total_actual_time (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, darbo laiko įrašai | SkyPlanner → Katana | Registruojant atliktą darbą |
| Katana šių duomenų nėra | Pamainos, neatvykimai, paruošimo laikų matrica, įrankiai, operatorių skaičius, alternatyvūs darbo centrai | Tvarkoma SkyPlanner sistemoje | Nustatoma pradedant naudotis sistema |
Integravimo modeliai
1. Pradinis pagrindinių duomenų įkėlimas. Nuskaitykite produktus, medžiagas, variantus, receptūrų eilutes ir produktų operacijų eilutes puslapiais, ribodami užklausų dažnį, kad neviršytumėte leistinos ribos. Pagal operacijų eilutėse nurodytus atskirus išteklius sukurkite SkyPlanner darbo centrus ir išlaikykite raktų atitiktį santykiu 1:1. Kiekvienam darbo centrui SkyPlanner sistemoje nustatykite pamainas, atostogas ir viršvalandžius, nes Katana neturi išteklių kalendoriaus.
2. Užsakymų sinchronizavimas. Užsiprenumeruokite gamybos užsakymų, operacijų eilučių, atsargų ir pirkimo užsakymų įvykius. Gavę kiekvieną įvykį, nuskaitykite objektą pagal jo href ir atnaujinkite užduotį. SkyPlanner laiko, kad užsakytos medžiagos bus prieinamos pirkimo užsakymo pristatymo dieną, o gavus užsakytas prekes atnaujina atsargas. Kasnakt atliekamas duomenų sutikrinimas pagal atnaujinimo datos filtrus aptinka visus praleistus įvykius.
3. Tvarkaraščio įrašymas atgal į Katana. Planas į Katana perkeliamas dviem užklausomis:
- POST
/manufacturing_order_rerank„moves one or more manufacturing orders to an exact place in the production schedule” (perkelia vieną ar daugiau gamybos užsakymų į konkrečią gamybos tvarkaraščio vietą). Viena užklausa galima perkelti iki 250 atvirų gamybos užsakymų į pradžią, pabaigą arba prieš nurodytą gamybos užsakymą ar po jo. (šaltinis) - PATCH
/manufacturing_orders/{id}nustato laukąproduction_deadline_date. Katana priima šią reikšmę tik tada, kai tai gamyklos vietai išjungtas automatinis termino skaičiavimas. (šaltinis)
Sekos pakeitimas turi įtakos ne tik sąrašui. Katana sistemoje „higher-priority MOs reserve required materials and subassemblies first” (aukštesnio prioriteto gamybos užsakymai pirmieji rezervuoja reikalingas medžiagas ir mazgus), todėl SkyPlanner nustatyta seka taip pat lemia, kuriam gamybos užsakymui Katana skirs atsargas.
4. Atlikto darbo patvirtinimai gamybos ceche. Operatoriai registruoja atliktą darbą naudodami SkyPlanner Mobile Confirmations, Production Timer arba Quick Log Mode. SkyPlanner įrašo būseną ir faktinį darbo laiką į gamybos užsakymo operacijos eilutę. Jei gamykla vietoj šių priemonių toliau naudoja Katana Shop Floor App, SkyPlanner nuskaito operacijų eilučių įvykius. Kiekvienai gamyklai pasirinkite vieną atlikto darbo registravimo kanalą.
5. Atsakomybės už duomenis ir konfliktų sprendimo taisyklės. Užrašykite jas prieš pradėdami naudoti integraciją:
| Duomenys | Atsakinga sistema |
|---|---|
| Produktai, receptūros, gamybos operacijos, atsargos, pirkimai, pardavimo užsakymai | Katana |
| Operacijų seka, pradžios ir pabaigos laikai, kiekvienai operacijai priskirtas darbo centras | SkyPlanner |
| Gamybos užsakymo vieta skirtuke Schedule ir gamybos užbaigimo terminas | SkyPlanner, duomenys įrašomi į Katana |
| Pamainos, neatvykimai, paruošimo laikų matrica, įrankiai, alternatyvūs ištekliai | SkyPlanner |
| Operacijos būsena ir užregistruotas laikas | Vienas kanalas, pasirinktas apibrėžiant apimtį |
Įprasti projekto etapai
Diegimas paprastai baigiamas per kelias savaites nuo pasirengimo naudoti sistemą pradžios. Prieš tai 30 dienų nemokamai bandote sistemą su savo duomenimis, eksportuotais iš Katana CSV formatu, pavyzdžiui, su Tasks sąrašu iš Make ekrano.
Patį projektą sudaro šie etapai:
- Planas ir raktas. Patikrinkite, ar jūsų Katana planas apima API ir Manufacturing Management, ir sukurkite API raktą.
- Terminų režimas. Sutarkite išjungti automatinį terminų nustatymą gamyklos vietai, kad gamybos terminus valdytų SkyPlanner.
- Susiejimas. Patvirtinkite susiejimo lentelę, išteklių raktus, taisykles, kuri sistema valdo duomenis, ir ataskaitų teikimo kanalą.
- Pradinis duomenų įkėlimas. Produktai, variantai, receptūros, gamybos operacijos, ištekliai.
- Sinchronizavimas pagal įvykius. Įvykių pranešimai apie užsakymus, operacijas, atsargas ir pirkimo užsakymus bei naktinis duomenų sutikrinimas.
- Apribojimų nustatymas SkyPlanner sistemoje. Pamainos, paruošimo laikų matrica, įrankiai, operatorių skaičius ir alternatyvūs darbo centrai.
- Duomenų įrašymas atgal. Užsakymų eiliškumas ir terminai, vėliau – operacijų būsenos ir laikas.
- Lygiagretus testavimas ir paleidimas. Palyginkite SkyPlanner datas su dabartinėmis datomis Schedule skirtuke, pataisykite pagrindinius duomenis ir įjunkite duomenų įrašymą atgal.
Į ką atsižvelgti planuojant integraciją su Katana
- Terminų režimas perrašo datas. „Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Įjungus automatinį režimą, visi rankiniu būdu nustatyti terminai bus perrašyti ir jų atkurti nebebus galima.) Režimą pasirinkite vieną kartą, projekto pradžioje.
- Nėra išteklių kalendoriaus. Nenustatykite pamainų remdamiesi vien Weekly throughput reikšme. Kiekvienam darbo centrui jas nustatykite SkyPlanner sistemoje.
- Ištekliai nurodomi tik operacijų eilutėse. Nekeiskite išteklių pavadinimų Katana sistemoje, nes pagal juos ištekliai susiejami su SkyPlanner darbo centrais.
- Laiko vienetai.
planned_time_parameternurodomas sekundėmis: per-unit operacijoms – vienam vienetui, o process, setup ir fixed tipams – bendra trukmė. Teisingai susiekite tipą, antraip apskaičiuotos trukmės nuo teisingų skirsis tiek kartų, kiek yra vienetų. - Gamybos pagal užsakymą grupės. Keičiant eiliškumą, su tuo pačiu pardavimo užsakymu susieti gamybos užsakymai (MO) lieka kartu, todėl jų vietą eilėje nustatykite kaip vienos grupės.
- Pasikeitė eiliškumo keitimo logika. Nuo 2026 m. spalio 7 d. rerank prieigos taškai perkelia užsakymus tiksliai į nurodytą vietą. Integracijas, pritaikytas ankstesnei logikai, reikia išbandyti iš naujo. (Šaltinis)
Integracija su Katana: kas ją konfigūruoja ir prižiūri
Darbai apima jūsų išteklius, gamybos operacijas, užsakymų srautą ir terminų režimą. Taip pat nustatoma tai, ko Katana nesaugo: pamainos, paruošimo laikų matrica, įrankiai, operatorių skaičius ir alternatyvūs ištekliai.
- SkyPlanner komanda sukonfigūruoja integraciją rengiantis naudoti sistemą ir prižiūri ją po paleidimo. Kiekviena gamykla Katana išteklius ir operacijas nustato skirtingai, todėl šiame etape pritaikoma sukaupta patirtis.
- Integraciją gali sukurti jūsų Katana konsultantas arba integracijų partneris. SkyPlanner teikia REST API, Swagger/OpenAPI dokumentaciją ir įvykių pranešimus.
- Jūsų programuotojai gali kurti sprendimus šiuo pagrindu naudodami API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Produkto dokumentaciją, įskaitant pirkimo užsakymus bei produktų ir medžiagų API, rasite SkyPlanner dokumentacijoje.
SkyPlanner kaina prasideda nuo 199 € per mėnesį su 5 darbo centrais, mokant kas mėnesį. Integracijos kainos pasiūlymas pagal jūsų procesą ir poreikius pateikiamas iš anksto kartu su pasirinktu planu, tad visas išlaidas žinote dar prieš pradėdami. Peržiūrėkite kainas, funkcijas ir palyginimą su pačios Katana tvarkaraščių sudarymu puslapyje Gamybos planavimas su Katana pagal realius įrenginių ir darbuotojų pajėgumus. Apžvalgą rasite Katana puslapyje, o kitas ERP sistemas – ERP integracijų skiltyje.
Gamintojų atsiliepimai apie SkyPlanner
2 hsutaupoma kas savaitę
„Su SkyPlanner nuo gamybos planavimo Excel lentelėse perėjome prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros skydai ir skirstymo įranga
Gamybos planavimas kas savaitę sutaupo 2 valandas darbo laiko, o nauja darbų eilė gamybos liniją pasiekia per kelias sekundes.
+90%gamybos efektyvumas
„Gamybos efektyvumas padidėjo 90%.“
Abdul Rucyinga, IT vadovas
Laboratory & Allied · Vaistų gamyba
Gamybos efektyvumas padidėjo 90%, o optimizuotas trijų mėnesių planas visiems darbo centrams sudaromas greičiau nei per 30 minučių.
Mažiauprastovų dėl medžiagų trūkumo
„SkyPlanner mums vertingas tuo, kad tai kasdieniame darbe veikiantis įrankis, ypač nustatant pristatymo datas.“
Tommi Männistö, gamybos planavimo vadovas
Eskomatic · Mechaninis apdirbimas pagal užsakymą
Automatiškai planuojant apkrovą, tiksliau nustatomos pristatymo datos, o gamybos prastovų dėl medžiagų trūkumo gerokai sumažėjo.
1 000-iaiautomatiškai suplanuotų gamybos užsakymų
„Gamybą dabar valdome kitaip, o mūsų supratimas apie pajėgumus pakilo į visiškai kitą lygį.“
Hannu Ryynänen, generalinis direktorius
Mamec · Pramoninės maišyklės, siurbliai ir aukštųjų technologijų sutartinė gamyba
Tūkstančiai gamybos užsakymų suplanuojami automatiškai, o visa organizacija mato gamybos būklę realiuoju laiku.
Dažniausiai užduodami klausimai
Ar Katana turi API ir kokio plano reikia?
Taip. Katana teikia viešą REST API, v1, su OpenAPI 3.0 specifikacija. Kainų puslapyje API prieiga nurodyta Free ir Advantage planuose. Autentifikavimui naudojamas API raktas, sukurtas skiltyje Settings > API ir perduodamas kaip Bearer prieigos raktas.
Ar SkyPlanner gali įrašyti tvarkaraštį į Katana?
Taip. Per /manufacturing_order_rerank SkyPlanner išdėsto atvirus gamybos užsakymus Katana skirtuke Schedule pagal savo nustatytą eiliškumą ir įrašo kiekvieno gamybos užsakymo (MO) production_deadline_date. Operacijų būsenos ir faktinis laikas įrašomi į MO operacijų eilutes. Kiekvieno darbo centro planas su nustatytu užduočių laiku lieka SkyPlanner sistemoje, kur operatoriai dirba pagal savo užduočių eilę.
Ar Katana siunčia pakeitimus realiuoju laiku?
Taip. Katana įvykių pranešimai apima gamybos užsakymus, operacijų eilutes, atsargas, pirkimo ir pardavimo užsakymus. SkyPlanner gauna kiekvieną pakeistą objektą ir kas naktį sutikrina duomenis, todėl net ir praleidus įvykį užduoties duomenys nelieka pasenę.
Kaip Katana ištekliai tampa SkyPlanner darbo centrais?
Kiekvienas atskiras išteklius Katana operacijų eilutėse tampa SkyPlanner darbo centru, susietu raktu santykiu 1:1. Tuomet SkyPlanner sistemoje nustatomos pamainos, neatvykimai ir alternatyvūs darbo centrai.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų, importavę CSV duomenis iš Katana. Mokėjimo kortelės nereikia. Pradėkite bandymą arba susisiekite su pardavimo komanda, kad apibrėžtumėte integracijos apimtį.
