Integracije / ERP / Katana
Vodnik za integracijo sistema Katana s SkyPlanner APS za terminiranje proizvodnje
Ta vodnik za integracijo sistema Katana svetovalcem in ekipam IT pokaže, kako povezati Katana Cloud Inventory (Katana MRP) s SkyPlanner APS. SkyPlanner se s sistemom Katana povezuje dvosmerno prek javnega vmesnika Katana API:
- V SkyPlanner se prenašajo proizvodni nalogi, vrstice operacij, recepture izdelkov, proizvodne operacije, viri, zaloge in nabavna naročila.
- Vrstni red iz terminskega plana se prenese nazaj na zavihek Schedule v sistemu Katana, skupaj z rokom izdelave za vsak proizvodni nalog.
- Status operacije in dejanski čas se zapišeta nazaj v vrstice operacij.
- Spletni kavlji Katana sporočajo spremembe v SkyPlanner, spletni kavlji SkyPlanner pa sproti pošiljajo spremembe terminskega plana.
Ekipa SkyPlanner med uvajanjem prilagodi integracijo vaši konfiguraciji Katana in zanjo zagotavlja podporo tudi po prehodu v živo. Ta vodnik je namenjen svetovalcem in razvijalcem, ki želijo sodelovati ali sami razvijati rešitve na podlagi dokumentiranega vmesnika REST API SkyPlanner (referenčna dokumentacija API).
Katana API
Katana je enoten oblačni izdelek z večnajemniško arhitekturo, zato vse stranke uporabljajo isti API. To je REST API različice v1 na naslovu https://api.katanamrp.com/v1, s specifikacijo OpenAPI 3.0 na naslovu https://api.katanamrp.com/v1/openapi.json. Dokumentacija je na voljo na portalu Katana Developer Hub.
Končne točke, potrebne za terminiranje:
- Matični podatki:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Nalogi:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Vrstni red:
/manufacturing_order_rerank. - Oskrba in povpraševanje:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Končna točka /resources ne obstaja. Viri so navedeni v poljih resource_id in resource_name v vrsticah operacij izdelkov in proizvodnih nalogov.
Avtentikacija in omejitve
Za avtentikacijo se uporablja ključ API kot žeton bearer: Authorization: Bearer <api key>. Ključ ustvarite v meniju Settings > API > Add new API key. (vir)
Pri zasnovi sinhronizacije upoštevajte omejitve:
- Katana API privzeto dovoljuje 60 zahtevkov v 60 sekundah (vir)
- Ob prekoračitvi te omejitve API vrne kodo 429 z glavo
Retry-After. GlavaX-Ratelimit-Remainingprikazuje število preostalih dovoljenih zahtev. - Končne točke za sezname vračajo rezultate po straneh in podpirajo filtre po datumu posodobitve, zato ostaja obseg prenesenih sprememb majhen.
REST API na strani SkyPlanner za avtentikacijo uporablja žeton API (SkyPlanner Settings > API), dokumentiran pa je v Swagger/OpenAPI. Vodič za integracijo vas popelje skozi prve klice.
Spletni kavlji
Spletni kavelj registrirajte s klicem POST /webhooks, naslovom HTTPS in želenimi dogodki. (vir) Za terminiranje so uporabni naslednji dogodki:
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.*inpurchase_order_row.*, vključno z dogodki prejemaproduct.*,product_recipe_row.*insales_order.*
Sporočila vsebujejo le najnujnejše podatke: vrsto vira, dejanje in href. Prejemnik pridobi celoten objekt z naslova href. Vsako poslano sporočilo vsebuje glavo x-sha2-signature (HMAC SHA-256) za preverjanje pristnosti. Vaša končna točka mora v 10 sekundah odgovoriti s kodo 20X. Katana pošiljanje ponovi trikrat: po 30 sekundah, 2 minutah in 15 minutah.
Preslikava podatkov
| Objekt Katana (končna točka) | Objekt SkyPlanner | Smer | Pogostost |
|---|---|---|---|
Izdelki, materiali, različice (/products, /materials, /variants) | Izdelki in materiali | Katana → SkyPlanner | Začetni prenos, nato ob obvestilu spletnega kavlja |
Receptura izdelka / BOM (/recipe_rows, /bom_rows) | Struktura izdelka, podizdelki | Katana → SkyPlanner | Začetni prenos, nato ob obvestilu spletnega kavlja |
Proizvodne operacije (/product_operation_rows): vrsta, vir, čas | Procesni koraki s trajanjem in pripravljalnimi časi | Katana → SkyPlanner | Začetni prenos, nato ob spremembah |
Viri (resource_id, resource_name v vrsticah operacij) | Delovni centri, skupine delovnih centrov | Katana → SkyPlanner | Začetni prenos in ob dodajanju novega vira |
Proizvodni nalog z vrsticami operacij (/manufacturing_orders, /manufacturing_order_operation_rows) | Nalogi in operacije | Katana → SkyPlanner | V realnem času prek spletnega kavlja |
Sestavine proizvodnega naloga (/manufacturing_order_recipe_rows) | Materiali za posamezno operacijo | Katana → SkyPlanner | V realnem času prek spletnega kavlja |
Zaloge, nabavna naročila z datumi dobave (/inventory, /purchase_order_rows) | Zaloge in pričakovani material | Katana → SkyPlanner | V realnem času prek spletnega kavlja |
Polje delivery_date prodajnega naročila (/sales_orders) | Rok naročila, prednost stranke | Katana → SkyPlanner | V realnem času prek spletnega kavlja |
Vrstni red proizvodnih nalogov (POST /manufacturing_order_rerank) | Vrstni red odprtih proizvodnih nalogov v terminskem planu | SkyPlanner → Katana | Ob spremembi terminskega plana |
Polje production_deadline_date proizvodnega naloga (PATCH /manufacturing_orders/{id}) | Planirani zaključek | SkyPlanner → Katana | Ob spremembi terminskega plana |
Polji status, total_actual_time v vrstici operacije (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, časovni zapisi | SkyPlanner → Katana | Ob beleženju dela |
| Ni v sistemu Katana | Izmene, odsotnosti, matrika pripravljalnih časov, orodja, število operaterjev, alternativni delovni centri | Vzdrževanje v SkyPlanner | Nastavitev med uvajanjem |
Vzorci integracije
1. Začetni prenos matičnih podatkov. Po straneh pridobite izdelke, materiale, različice, vrstice receptur in vrstice operacij izdelkov. Hitrost zahtev prilagodite omejitvi klicev. Za vsak različen vir v vrsticah operacij ustvarite delovni center v SkyPlanner in ohranite preslikavo ključev 1:1. Za vsak delovni center v SkyPlanner nastavite izmene, dopuste in nadure, saj Katana nima koledarja virov.
2. Sinhronizacija nalogov. Naročite se na dogodke proizvodnih nalogov, vrstic operacij, zalog in nabavnih naročil. Ob vsakem dogodku pridobite objekt z njegovega naslova href in posodobite operacijo. SkyPlanner obravnava naročeni material kot razpoložljiv na datum dobave nabavnega naročila, zalogo pa posodobi ob prejemu naročila. Nočno usklajevanje s filtri po datumu posodobitve zajame morebitne izpuščene dogodke.
3. Povratni zapis terminskega plana. Dva klica preneseta plan v sistem Katana:
- POST
/manufacturing_order_rerank“moves one or more manufacturing orders to an exact place in the production schedule” (premakne enega ali več proizvodnih nalogov na točno določeno mesto v terminskem planu proizvodnje). Posamezna zahteva sprejme do 250 odprtih proizvodnih nalogov in jih postavi na začetek, na konec ali pred oziroma za določen proizvodni nalog. (vir) - PATCH
/manufacturing_orders/{id}nastavi poljeproduction_deadline_date. Katana to vrednost sprejme le, če je samodejni izračun rokov za to proizvodno lokacijo izklopljen. (vir)
Sprememba vrstnega reda ne vpliva le na seznam. V sistemu Katana velja: “higher-priority MOs reserve required materials and subassemblies first” (proizvodni nalogi z višjo prednostjo prvi rezervirajo potrebne materiale in podsklope). Vrstni red iz SkyPlanner torej določa tudi, kateri proizvodni nalog dobi zalogo v sistemu Katana.
4. Potrjevanje dela v proizvodnji. Operaterji beležijo delo s funkcijami SkyPlanner Mobile Confirmations, Production Timer ali Quick Log Mode. SkyPlanner zapiše status in dejanski čas v vrstico operacije proizvodnega naloga. Če obrat namesto tega obdrži Katana Shop Floor App, SkyPlanner bere dogodke vrstic operacij. Za vsak obrat izberite en kanal poročanja.
5. Pravila o skrbništvu podatkov in reševanju neskladij. Zapišite jih pred prehodom v živo:
| Podatki | Skrbnik |
|---|---|
| Izdelki, recepture, proizvodne operacije, zaloge, nabava, prodajna naročila | Katana |
| Vrstni red operacij, začetni in končni časi, delovni center za posamezno operacijo | SkyPlanner |
| Položaj proizvodnega naloga na zavihku Schedule in rok izdelave | SkyPlanner, z zapisom v Katana |
| Izmene, odsotnosti, matrika pripravljalnih časov, orodja, alternativni viri | SkyPlanner |
| Stanje operacije in evidentirani čas | En kanal, izbran ob opredelitvi obsega |
Običajni koraki projekta
Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Pred tem lahko v 30-dnevnem brezplačnem preizkusu uporabite lastne podatke, izvožene iz sistema Katana v obliki CSV, na primer seznam Tasks na zaslonu Make.
Projekt vključuje naslednje korake:
- Paket in ključ. Preverite, ali vaš paket Katana vključuje API in Manufacturing Management, ter ustvarite ključ API.
- Način določanja rokov. Dogovorite se za izklop samodejnih rokov za proizvodno lokacijo, da bo proizvodne roke določal SkyPlanner.
- Preslikava. Določite tabelo preslikav, ključe virov, pravila o tem, kateri sistem upravlja posamezne podatke, in kanal za poročanje.
- Začetni prenos. Izdelki, različice, recepture, proizvodne operacije in viri.
- Sinhronizacija dogodkov. Spletni kavlji za naročila, operacije, zaloge in nabavna naročila ter nočno usklajevanje podatkov.
- Nastavitev omejitev v sistemu SkyPlanner. Izmene, matrika pripravljalnih časov, orodja, število operaterjev in nadomestni delovni centri.
- Povratni zapis. Spremembe vrstnega reda in roki, nato stanje operacij in čas.
- Vzporedno testiranje in prehod v živo. Primerjajte datume v sistemu SkyPlanner s trenutnimi datumi na zavihku Schedule, popravite matične podatke in nato vklopite povratni zapis.
Kaj upoštevati pri integraciji s sistemom Katana
- Način določanja rokov izbriše datume. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Ko omogočite samodejni način, se vsi ročno določeni roki prepišejo in jih ni mogoče obnoviti.) Način izberite enkrat, ob začetku projekta.
- Ni koledarja virov. Izmen ne izpeljujte iz ene same vrednosti Weekly throughput. V sistemu SkyPlanner jih nastavite za vsak delovni center posebej.
- Viri so samo v vrsticah operacij. Imen virov v sistemu Katana ne spreminjajte, saj so ključ za povezavo z delovnimi centri v sistemu SkyPlanner.
- Časovne enote.
planned_time_parameterje izražen v sekundah: pri operacijah na enoto velja za posamezno enoto, pri tipih process, setup in fixed pa za celotno operacijo. Tip preslikajte pravilno, sicer bodo trajanja napačna za faktor količine. - Skupine pri izdelavi po naročilu. Proizvodni nalogi (MO), povezani z istim prodajnim naročilom, ob spremembi vrstnega reda ostanejo skupaj, zato jih razvrščajte kot skupino.
- Spremenjeno delovanje pri razvrščanju. Od 7. oktobra 2026 končne točke za spreminjanje vrstnega reda postavijo naročila natanko na zahtevano mesto. Integracije, razvite za prejšnje delovanje, je treba znova preizkusiti. (vir)
Integracija s sistemom Katana: kdo jo nastavi in zagotavlja podporo
Delo zajema vaše vire, proizvodne operacije, tok naročil in način določanja rokov. Dodajo se podatki, ki jih Katana ne hrani: izmene, matrika pripravljalnih časov, orodja, število operaterjev in nadomestni viri.
- Ekipa SkyPlanner integracijo nastavi med uvajanjem in zagotavlja podporo po prehodu v živo. Vsaka tovarna vire in operacije v sistemu Katana nastavi drugače, pri nastavitvi integracije pa uporabimo to znanje.
- Integracijo lahko razvije vaš svetovalec za Katana ali integracijski partner. SkyPlanner zagotavlja REST API, dokumentacijo Swagger/OpenAPI in spletne kavlje.
- Vaši razvijalci lahko na tej osnovi razvijajo lastne rešitve z žetonom API. Za začetek zadostuje žeton API, ekipa SkyPlanner pa po potrebi pomaga. Dokumentacija izdelka, vključno z nabavnimi naročili ter API za izdelke in materiale, je na voljo v dokumentaciji SkyPlanner.
SkyPlanner je na voljo od 199 € na mesec z vključenimi 5 delovnimi centri in mesečnim obračunavanjem. Ponudbo za integracijo pripravimo vnaprej glede na vaše procese in potrebe, skupaj z vašim paketom, tako da celotne stroške poznate že pred začetkom. Oglejte si cene in funkcije, primerjavo z lastnim terminiranjem sistema Katana pa najdete na strani Katana in terminiranje proizvodnje ob upoštevanju dejanskih zmogljivosti. Pregled je na strani Katana, druge sisteme ERP pa najdete v pregledu integracij s sistemi ERP.
Mnenja proizvodnih podjetij o sistemu SkyPlanner
2 hprihranka vsak teden
»S sistemom SkyPlanner smo pri planiranju proizvodnje prešli z Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, strokovnjak za oskrbovalno verigo
UTU · Električni razdelilniki in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri dela, nova čakalna vrsta operacij pa do proizvodne linije prispe v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost v proizvodnji se je povečala za 90 %.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90 %, izdelava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
Manjzastojev zaradi pomanjkanja materiala
»Vrednost sistema SkyPlanner je za nas v tem, da je orodje, ki se obnese pri vsakodnevnem delu, zlasti pri določanju dobavnih rokov.«
Tommi Männistö, vodja planiranja proizvodnje
Eskomatic · Pogodbena strojna obdelava
Samodejno terminiranje obremenitev omogoča natančnejše dobavne roke, zastoji v proizvodnji zaradi pomanjkanja materiala pa so se močno zmanjšali.
1.000 in večsamodejno terminiranih delovnih nalogov
»Proizvodnjo imamo pod nadzorom na povsem drugačen način, naše razumevanje zmogljivosti pa je na povsem drugi ravni.«
Hannu Ryynänen, direktor
Mamec · Industrijska mešala, črpalke in visokotehnološka pogodbena proizvodnja
Na tisoče delovnih nalogov se terminira samodejno, celotna organizacija pa ima vpogled v proizvodnjo v realnem času.
Pogosta vprašanja
Ali ima Katana API in kateri paket potrebujem?
Da. Katana ponuja javni REST API, v1, s specifikacijo OpenAPI 3.0. Na strani s cenami je dostop do API naveden pri paketih Free in Advantage. Za avtentikacijo se uporablja ključ API vrste bearer, ki ga ustvarite v Settings > API.
Ali lahko SkyPlanner zapiše terminski plan nazaj v sistem Katana?
Da. SkyPlanner prek /manufacturing_order_rerank razvrsti odprte proizvodne naloge na zavihku Schedule v sistemu Katana po svojem vrstnem redu in za vsak MO zapiše production_deadline_date. Stanje operacij in dejanski čas se zapišeta v vrstice operacij proizvodnega naloga. Časovno razporejeni plan za vsak delovni center ostane v sistemu SkyPlanner, kjer operaterji delajo po svoji čakalni vrsti operacij.
Ali Katana pošilja spremembe v realnem času?
Da. Spletni kavlji sistema Katana pokrivajo proizvodne naloge, vrstice operacij, zaloge, nabavna in prodajna naročila. SkyPlanner pridobi vsak spremenjeni objekt in podatke usklajuje vsako noč, zato izpuščen dogodek nikoli ne pusti operacije z zastarelimi podatki.
Kako viri iz sistema Katana postanejo delovni centri v sistemu SkyPlanner?
Vsak različen vir v vrsticah operacij sistema Katana postane delovni center v sistemu SkyPlanner s povezavo ključev 1:1. Izmene, odsotnosti in nadomestne delovne centre nato nastavite v sistemu SkyPlanner.
Ali lahko SkyPlanner preizkusimo pred razvojem integracije?
Da. V 30-dnevnem brezplačnem preizkusu lahko z uvozom CSV iz sistema Katana uporabite do 20 delovnih centrov, brez kreditne kartice. Začnite preizkus ali se obrnite na prodajno ekipo, da opredelite obseg integracije.
