Liidestused / ERP / Katana
Katana liidestamise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See Katana liidestamise juhend selgitab konsultantidele ja IT-meeskondadele, kuidas ühendada Katana Cloud Inventory (Katana MRP) SkyPlanner APS-iga. SkyPlanner vahetab Katanaga andmeid mõlemas suunas avaliku Katana API kaudu:
- SkyPlannerisse tuuakse tootmistellimused, operatsiooniread, tooteretseptid, tootmisoperatsioonid, ressursid, laoseis ja ostutellimused.
- Ajakava järjekord saadetakse tagasi Katana vahekaardile Schedule ning igale tootmistellimusele lisatakse tootmise tähtaeg.
- Operatsiooni olek ja tegelik ajakulu kirjutatakse tagasi operatsiooniridadele.
- Katana veebihaagid teavitavad SkyPlannerit muudatustest ja SkyPlanneri veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
SkyPlanneri meeskond seadistab liidestuse kasutuselevõtu käigus teie Katana seadistusele vastavaks ning pakub tuge ka pärast käivitamist. Juhend on mõeldud konsultantidele ja arendajatele, kes soovivad selles osaleda või luua ise lahendusi SkyPlanneri dokumenteeritud REST API abil (API teatmik).
Katana API
Katana on üks mitme rentnikuga pilvetoode, seega kasutavad kõik kliendid sama API-t. REST API versioon v1 asub aadressil https://api.katanamrp.com/v1 ja OpenAPI 3.0 spetsifikatsioon aadressil https://api.katanamrp.com/v1/openapi.json. Dokumentatsiooni leiate Katana Developer Hubist.
Ajakava koostamiseks vajalikud otspunktid:
- Põhiandmed:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Tellimused:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Järjekord:
/manufacturing_order_rerank. - Varustatus ja nõudlus:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Otspunkti /resources ei ole. Ressursid on esitatud toodete ja tootmistellimuste operatsiooniridadel väljadena resource_id ja resource_name.
Autentimine ja piirangud
Autentimiseks kasutatakse API võtit Bearer-tokenina: Authorization: Bearer <api key>. Looge võti menüüs Settings > API > Add new API key. (allikas)
Sünkroonimise kavandamisel tuleb arvestada järgmiste piirangutega:
- Vaikimisi lubab Katana API 60 päringut 60 sekundi jooksul (allikas)
- Piirangu ületamisel tagastab API vastuse 429 koos päisega
Retry-After. PäisX-Ratelimit-Remainingnäitab, kui palju päringuid on veel lubatud. - Loendite otspunktid tagastavad tulemused lehekülgedena ja võimaldavad filtreerida muutmiskuupäeva järgi, nii jääb muudatuste maht väikeseks.
SkyPlanneri REST API kasutab autentimiseks API tokenit (SkyPlanner Settings > API) ning on dokumenteeritud Swagger/OpenAPI vormingus. Liidestamise õpetus näitab, kuidas teha esimesed päringud.
Veebihaagid
Registreerige veebihaak päringuga POST /webhooks, lisades HTTPS-aadressi ja vajalikud sündmused. (allikas) Ajakava koostamisel on kasulikud järgmised sündmused:
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.*japurchase_order_row.*, sealhulgas kauba vastuvõtmise sündmusedproduct.*,product_recipe_row.*jasales_order.*
Sõnumi sisu on napp: ressursi tüüp, toiming ja href. Vastuvõtja pärib täieliku objekti href-aadressilt. Iga edastus sisaldab kontrollimiseks päist x-sha2-signature (HMAC SHA-256). Teie otspunkt peab vastama koodiga 20X 10 sekundi jooksul. Katana proovib uuesti kolm korda: 30 sekundi, 2 minuti ja 15 minuti pärast.
Andmete vastendamine
| Katana objekt (otspunkt) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Tooted, materjalid, variandid (/products, /materials, /variants) | Tooted ja materjalid | Katana → SkyPlanner | Esmalaadimisel, seejärel veebihaagi teate korral |
Tooteretsept / BOM (/recipe_rows, /bom_rows) | Tootestruktuur, alamtooted | Katana → SkyPlanner | Esmalaadimisel, seejärel veebihaagi teate korral |
Tootmisoperatsioonid (/product_operation_rows): tüüp, ressurss, aeg | Protsessietapid koos kestuste ja seadistusaegadega | Katana → SkyPlanner | Esmane laadimine, seejärel muudatuse korral |
Ressursid (resource_id, resource_name operatsiooniridadel) | Töökeskused, töökeskuste rühmad | Katana → SkyPlanner | Esmalaadimisel ja uue ressursi lisamisel |
Tootmistellimus koos operatsiooniridadega (/manufacturing_orders, /manufacturing_order_operation_rows) | Tellimused ja tööd | Katana → SkyPlanner | Reaalajas veebihaagi kaudu |
Tootmistellimuse koostisosad (/manufacturing_order_recipe_rows) | Materjalid töö kaupa | Katana → SkyPlanner | Reaalajas veebihaagi kaudu |
Laoseis, ostutellimused koos saabumiskuupäevadega (/inventory, /purchase_order_rows) | Laoseis ja saabuv materjal | Katana → SkyPlanner | Reaalajas veebihaagi kaudu |
Müügitellimuse delivery_date (/sales_orders) | Tellimuse tähtaeg, kliendi prioriteet | Katana → SkyPlanner | Reaalajas veebihaagi kaudu |
Tootmistellimuste järjekord (POST /manufacturing_order_rerank) | Avatud tootmistellimuste järjekord ajakavas | SkyPlanner → Katana | Ajakava muutumisel |
Tootmistellimuse production_deadline_date (PATCH /manufacturing_orders/{id}) | Planeeritud lõpp | SkyPlanner → Katana | Ajakava muutumisel |
Operatsioonirea status, total_actual_time (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, ajalogid | SkyPlanner → Katana | Töö registreerimisel |
| Katanas puudub | Vahetused, puudumised, seadistusaegade maatriks, tööriistad, operaatorite arv, alternatiivsed töökeskused | Hallatakse SkyPlanneris | Seadistatakse kasutuselevõtu käigus |
Liidestuslahendused
1. Põhiandmete esmane laadimine. Pärige tooted, materjalid, variandid, retseptiread ja toodete operatsiooniread lehekülgede kaupa, hoides päringusageduse lubatud piirides. Looge SkyPlanneri töökeskused operatsiooniridadel olevate erinevate ressursside põhjal ja säilitage võtmete 1:1 vastavus. Määrake SkyPlanneris iga töökeskuse vahetused, puhkused ja ületunnid, sest Katanas puudub ressursikalender.
2. Tellimuste sünkroonimine. Tellige tootmistellimuste, operatsiooniridade, laoseisu ja ostutellimuste sündmused. Iga sündmuse korral pärige objekt selle href-aadressilt ja uuendage tööd. SkyPlanner arvestab tellitud materjali kättesaadavaks ostutellimuse tarnekuupäeval ning uuendab laoseisu ostutellimuse kauba vastuvõtmisel. Igaöine andmete võrdlus muutmiskuupäeva filtrite abil tuvastab vahele jäänud sündmused.
3. Ajakava tagasikirjutamine. Plaan kantakse Katanasse kahe päringuga:
- POST
/manufacturing_order_rerank“moves one or more manufacturing orders to an exact place in the production schedule” (viib ühe või mitu tootmistellimust tootmise ajakavas täpselt määratud kohale). Ühe päringuga saab edastada kuni 250 avatud tootmistellimust, paigutades need loendi algusesse, lõppu või määratud tootmistellimuse ette või järele. (allikas) - PATCH
/manufacturing_orders/{id}määrab väljaproduction_deadline_dateväärtuse. Katana võtab selle vastu ainult siis, kui tähtaja automaatne arvutamine on selle tehase asukoha jaoks välja lülitatud. (allikas)
Järjekorra muutmise mõju ei piirdu loendiga. Katanas kehtib põhimõte “higher-priority MOs reserve required materials and subassemblies first” (kõrgema prioriteediga tootmistellimused reserveerivad vajalikud materjalid ja alamkoostud esimesena). Seega määrab SkyPlanneri järjekord ka selle, millisele tootmistellimusele Katanas laovaru eraldatakse.
4. Tootmissaali tagasiside. Operaatorid registreerivad tööd SkyPlanner Mobile Confirmationsi, Production Timeri või Quick Log Mode’i abil. SkyPlanner kirjutab oleku ja tegeliku ajakulu tootmistellimuse operatsioonireale. Kui tehas jätkab selle asemel Katana Shop Floor Appi kasutamist, loeb SkyPlanner operatsiooniridade sündmusi. Valige iga tehase jaoks üks tagasisidekanal.
5. Andmevastutuse ja konfliktide lahendamise reeglid. Pange need enne käivitamist kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Tooted, retseptid, tootmisoperatsioonid, laoseis, ostud, müügitellimused | Katana |
| Operatsioonide järjekord, algus- ja lõpuajad, iga operatsiooni töökeskus | SkyPlanner |
| Tootmistellimuse koht vahekaardil Schedule ja tootmise tähtaeg | SkyPlanner, andmed kirjutatakse Katanasse |
| Vahetused, puudumised, seadistusaegade maatriks, tööriistad, alternatiivsed ressursid | SkyPlanner |
| Operatsiooni olek ja registreeritud aeg | Üks kanal, mis valitakse ulatuse määramisel |
Projekti tavapärased etapid
Juurutamine saab tavaliselt valmis mõne nädala jooksul pärast kasutuselevõtu alustamist. Sellele eelneb 30-päevane tasuta prooviperiood, mille ajal kasutate oma andmeid Katana CSV-ekspordist, näiteks Make-vaate Tasks-loendist.
Projekt ise hõlmab järgmisi etappe:
- Pakett ja võti. Kontrollige, et Katana pakett sisaldaks API-t ja Manufacturing Managementi, ning looge API-võti.
- Tähtaegade režiim. Leppige kokku, et selle tootmiskoha tähtaegade automaatne arvutamine lülitatakse välja, nii et tootmistähtajad määrab SkyPlanner.
- Vastendamine. Kinnitage vastendustabel, ressursside võtmed, andmete haldamise vastutusreeglid ja aruandluskanal.
- Esmane andmete laadimine. Tooted, variandid, retseptid, tootmisoperatsioonid ja ressursid.
- Sündmuspõhine sünkroonimine. Veebihaagid tellimuste, operatsioonide, laoseisu ja ostutellimuste jaoks ning igaöine andmete kooskõlastamine.
- Piirangute seadistamine SkyPlanneris. Vahetused, seadistusaegade maatriks, tööriistad, operaatorite arv ja alternatiivsed töökeskused.
- Tagasikirjutamine. Järjekorra muutmine ja tähtajad, seejärel operatsioonide olek ja aeg.
- Paralleeltestimine ja kasutuselevõtt. Võrrelge SkyPlanneri kuupäevi praeguse Schedule-vahekaardi andmetega, parandage põhiandmed ja lülitage seejärel tagasikirjutamine sisse.
Millega Katana liidestamisel arvestada
- Tähtaegade režiim kirjutab kuupäevad üle. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Automaatrežiimi sisselülitamisel kirjutatakse kõik käsitsi määratud tähtajad üle ja neid ei saa taastada.) Otsustage režiim üks kord, projekti alguses.
- Ressursikalender puudub. Ärge tuletage vahetusi üksnes Weekly throughput väärtusest. Seadistage need SkyPlanneris iga töökeskuse jaoks eraldi.
- Ressursid on ainult operatsiooniridadel. Hoidke Katana ressursside nimed muutumatuna, sest nende alusel seotakse ressursid SkyPlanneri töökeskustega.
- Ajaühikud.
planned_time_parameteron sekundites: per-unit-operatsioonidel ühiku kohta ning tüüpidel process, setup ja fixed koguaeg. Vastendage tüüp õigesti, vastasel juhul on kestused koguse võrra korrutatud või jagatud. - Tellimuspõhise tootmise rühmad. Järjekorra muutmisel jäävad sama müügitellimusega seotud tootmistellimused kokku, seega järjestage neid rühmana.
- Järjekorra muutmise loogika on muutunud. Alates 7. oktoobrist 2026 paigutavad rerank-lõpp-punktid tellimused täpselt soovitud kohale. Varasema loogika jaoks loodud liidestusi tuleb uuesti testida. (allikas)
Katana liidestus: kes seadistab ja pakub tuge
Töö hõlmab teie ressursse, tootmisoperatsioone, tellimuste liikumist ja tähtaegade režiimi. Lisatakse see, mida Katana ei sisalda: vahetused, seadistusaegade maatriks, tööriistad, operaatorite arv ja alternatiivsed ressursid.
- SkyPlanneri meeskond seadistab liidestuse kasutuselevõtu käigus ja pakub tuge ka pärast seda. Iga tehas seadistab Katana ressursid ja operatsioonid erinevalt ning liidestamisel rakendatakse just neid teadmisi.
- Liidestuse saab luua teie Katana konsultant või liidestuspartner. SkyPlanner pakub REST API-t, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Teie arendajad saavad liidestust edasi arendada, kasutades API-pääsutõendit. Alustamiseks piisab API-pääsutõendist ja SkyPlanneri meeskond aitab vajaduse korral. Toote dokumentatsiooni, sealhulgas ostutellimuste ning toodete ja materjalide API kirjeldused, leiate SkyPlanneri dokumentatsioonist.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub kord kuus. Teie protsessile ja vajadustele vastava liidestuse hinnapakkumine esitatakse ette koos paketi hinnaga, nii et näete kogukulu enne alustamist. Vaadake hindu ja funktsioone ning lugege võrdlust Katana enda ajakava koostamise võimalustega lehelt tootmise planeerimine Katanaga, arvestades masinate ja töötajate tegelikku võimsust. Ülevaate leiate Katana lehelt ja teised ERP-süsteemid ERP-liidestuste lehelt.
Tootjate kogemused SkyPlanneriga
2 hkokkuhoidu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.”
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel säästetakse igal nädalal 2 tundi tööaega ja uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise tõhusust
„Tootmise tõhusus on kasvanud 90%.”
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise tõhusus on kasvanud 90% ja kõiki töökeskusi hõlmava optimeeritud kolmekuulise plaani koostamiseks kulub alla 30 minuti.
Vähemmaterjalipuudusest tingitud seisakuid
„SkyPlanneri väärtus meie jaoks seisneb selles, et see on igapäevatöös toimiv tööriist, eriti tarnetähtaegade määramisel.”
Tommi Männistö, tootmise planeerimise juht
Eskomatic · Allhankeline mehaaniline töötlus
Automaatne tootmiskoormuse planeerimine annab täpsemad tarnetähtajad ja materjalipuudusest tingitud tootmisseisakud on järsult vähenenud.
1 000-dtootmistellimused ajastatakse automaatselt
„Tootmine on hoopis teistmoodi kontrolli all ja meie arusaam tootmisvõimsusest on täiesti uuel tasemel.”
Hannu Ryynänen, tegevjuht
Mamec · Tööstuslikud segistid, pumbad ja kõrgtehnoloogiline allhanketootmine
Tuhandete tootmistellimuste ajakava koostatakse automaatselt ja kogu organisatsioonil on tootmisest reaalajas ülevaade.
Korduma kippuvad küsimused
Kas Katanal on API ja millist paketti on vaja?
Jah. Katana pakub avalikku REST API-t v1 koos OpenAPI 3.0 spetsifikatsiooniga. Katana hinnalehe järgi sisaldavad API-juurdepääsu paketid Free ja Advantage. Autentimiseks kasutatakse bearer-tüüpi API-võtit, mille saab menüüst Settings > API.
Kas SkyPlanner saab ajakava Katanasse tagasi kirjutada?
Jah. SkyPlanner järjestab avatud tootmistellimused Katana Schedule-vahekaardil enda määratud järjekorda, kasutades lõpp-punkti /manufacturing_order_rerank, ja määrab iga tootmistellimuse välja production_deadline_date väärtuse. Operatsiooni olek ja tegelik ajakulu edastatakse tootmistellimuse operatsiooniridadele. Töökeskuste ajastatud plaan asub SkyPlanneris, kus operaatorid töötavad oma tööjärjekorra järgi.
Kas Katana saadab muudatused reaalajas?
Jah. Katana veebihaagid hõlmavad tootmistellimusi, operatsiooniridu, laoseisu, ostutellimusi ja müügitellimusi. SkyPlanner pärib iga muutunud objekti ja kooskõlastab andmed igal ööl, nii et märkamata jäänud sündmuse tõttu ei jää ühegi töö andmed aegunuks.
Kuidas saavad Katana ressurssidest SkyPlanneri töökeskused?
Igast Katana operatsiooniridadel olevast eraldi ressursist saab SkyPlanneri töökeskus, mis seotakse võtmega 1:1. Vahetused, puudumised ja alternatiivsed töökeskused seadistatakse seejärel SkyPlanneris.
Kas saame SkyPlannerit enne liidestuse loomist proovida?
Jah. 30-päevasel tasuta prooviperioodil saate kasutada kuni 20 töökeskust ja importida Katanast andmeid CSV-failina. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga liidestuse ulatuse määramiseks.
