Katana-integrációs útmutató gyártásütemezéshez a SkyPlanner APS rendszerrel

A Katana közös, több-bérlős felhőszolgáltatás, így minden ügyfél ugyanazt az API-t használja. Ez egy v1 verziójú REST API, amely a https://api.katanamrp.com/v1 címen érhető el. Az OpenAPI 3.0 specifikáció a https://api.katanamrp.com/v1/openapi.json címen található. A dokumentációt a Katana Developer Hub tartalmazza.

Az ütemezéshez szükséges végpontok:

• Törzsadatok: /products, /materials, /variants, /recipe_rows, /bom_rows, /product_operation_rows.
• Rendelések: /manufacturing_orders, /manufacturing_order_operation_rows, /manufacturing_order_recipe_rows, /manufacturing_order_productions.
• Sorrend: /manufacturing_order_rerank.
• Ellátás és igény: /inventory, /purchase_orders, /purchase_order_rows, /sales_orders, /sales_order_rows.

Nincs /resources végpont. Az erőforrások a termékek és a gyártási rendelések műveleti soraiban, a resource_id és a resource_name mezőkben jelennek meg.

Webhook regisztrálásához küldjön POST kérést a /webhooks végpontra, és adjon meg egy HTTPS URL-t, valamint a szükséges eseményeket. (forrás) Az ütemezéshez hasznos események:

• manufacturing_order.created, .updated, .deleted, .in_progress, .blocked, .done
• manufacturing_order_operation_row.created, .updated, .in_progress, .paused, .completed
• current_inventory.material_updated, .material_out_of_stock
• purchase_order.* és purchase_order_row.*, beleértve a beérkezést is
• product.*, product_recipe_row.* és sales_order.*

Az üzenetek kevés adatot tartalmaznak: az erőforrás típusát, a műveletet és egy href mezőt. A fogadó a href címéről kéri le a teljes objektumot. Minden kézbesítés tartalmaz egy x-sha2-signature fejlécet (HMAC SHA-256) az ellenőrzéshez. A végpontnak 10 másodpercen belül 20X választ kell adnia. A Katana háromszor próbálkozik újra: 30 másodperc, 2 perc és 15 perc elteltével.

1. A törzsadatok kezdeti betöltése. Kérje le lapozva a termékeket, anyagokat, változatokat, receptsorokat és termékműveleti sorokat úgy, hogy ne lépje túl a híváskorlátot. A műveleti sorokban szereplő különböző erőforrásokból hozzon létre SkyPlanner-munkaállomásokat, és tartson fenn 1:1 kulcsmegfeleltetést. A műszakokat, szabadságokat és túlórákat munkaállomásonként állítsa be a SkyPlannerben, mivel a Katanában nincs erőforrásnaptár.

2. Rendelések szinkronizálása. Iratkozzon fel a gyártási rendelések, műveleti sorok, készletek és beszerzési rendelések eseményeire. Minden eseménynél kérje le az objektumot a href címéről, és frissítse a gyártási feladatot. A SkyPlanner a megrendelt anyagot a beszerzési rendelés szállítási dátumán tekinti elérhetőnek, és a beérkezéskor frissíti a készletet. Az éjszakai, módosítási dátum szerinti szűréssel végzett egyeztetés pótolja az esetleg kimaradt eseményeket.

3. Az ütemterv visszaírása. Két hívással kerül át a terv a Katanába:

• A POST /manufacturing_order_rerank „moves one or more manufacturing orders to an exact place in the production schedule” (egy vagy több gyártási rendelést a gyártási ütemterv pontosan megadott helyére mozgat). Kérésenként legfeljebb 250 nyitott gyártási rendelést fogad, amelyeket a sorrend elejére, végére, illetve egy megadott gyártási rendelés elé vagy mögé helyez. (forrás)
• A PATCH /manufacturing_orders/{id} beállítja a production_deadline_date mezőt. A Katana ezt csak akkor fogadja el, ha az adott gyártási telephelyen ki van kapcsolva az automatikus határidő-számítás. (forrás)

Az átsorolás nem csak a lista sorrendjét érinti. A Katanában „higher-priority MOs reserve required materials and subassemblies first” (a magasabb prioritású gyártási rendelések foglalják le először a szükséges anyagokat és részegységeket). Így a SkyPlanner sorrendje azt is meghatározza, hogy a Katanában melyik gyártási rendelés kapja meg a készletet.

4. Üzemi visszajelentések. A gépkezelők a SkyPlanner Mobile Confirmations, Production Timer vagy Quick Log Mode funkciójával rögzítik a munkát. A SkyPlanner az állapotot és a tényleges időt a gyártási rendelés műveleti sorába írja. Ha egy üzem inkább a Katana Shop Floor App használatánál marad, a SkyPlanner a műveleti sorok eseményeit olvassa be. Üzemenként egyetlen visszajelentési csatornát válasszon.

5. Adatgazdák és ütközéskezelési szabályok. Ezeket még az éles indulás előtt rögzítse:

• A határidőkezelési mód felülírja a dátumokat. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Az automatikus mód bekapcsolásakor minden kézi határidő felülíródik, és nem állítható vissza.) A módot egyszer, a projekt indításakor válasszák ki.
• Nincs erőforrásnaptár. Ne az egyetlen Weekly throughput értékből vezesse le a műszakokat. Állítsa be őket munkaállomásonként a SkyPlannerben.
• Erőforrások csak a műveleti sorokban. Ne változtassa az erőforrások nevét a Katanában, mert ezek alapján kapcsolódnak a SkyPlanner munkaállomásaihoz.
• Időegységek. A planned_time_parameter másodpercben értendő: az egységenkénti műveleteknél egységenként, a process, setup és fixed típusoknál pedig összesen. Ügyeljen a típus helyes megfeleltetésére, különben az időtartamok a mennyiség szorzójával térnek el a helyes értéktől.
• Csoportok rendelésre gyártásnál. A sorrend átrendezésekor az ugyanahhoz a vevői rendeléshez kapcsolódó gyártási rendelések (MO-k) együtt maradnak, ezért csoportként rendezze őket sorba.
• Megváltozott a rerank működése. 2026. október 7. óta a rerank végpontok pontosan a kért helyre teszik a rendeléseket. A korábbi működésre épülő integrációkat újra kell tesztelni. (forrás)