Integrācijas / ERP / Katana
Katana integrācijas ceļvedis ražošanas grafiku sastādīšanai ar SkyPlanner APS
Šajā Katana integrācijas ceļvedī konsultantiem un IT komandām skaidrots, kā savienot Katana Cloud Inventory (Katana MRP) ar SkyPlanner APS. SkyPlanner nodrošina divvirzienu integrāciju ar Katana, izmantojot publisko Katana API:
- SkyPlanner saņem ražošanas pasūtījumus, operāciju rindas, produktu receptūras, ražošanas operācijas, resursus, krājumu datus un iepirkuma pasūtījumus.
- Grafikā noteiktā secība tiek nosūtīta atpakaļ uz Katana cilni Schedule kopā ar katra ražošanas pasūtījuma izpildes termiņu.
- Operācijas statuss un faktiskais izpildes laiks tiek ierakstīti atpakaļ operāciju rindās.
- Katana tīmekļa aizķeres ziņo SkyPlanner par izmaiņām, savukārt SkyPlanner tīmekļa aizķeres nosūta grafika izmaiņas, tiklīdz tās notiek.
Ieviešanas laikā SkyPlanner komanda pielāgo integrāciju jūsu Katana konfigurācijai un nodrošina tās atbalstu arī pēc palaišanas. Šis ceļvedis paredzēts konsultantiem un izstrādātājiem, kuri vēlas piedalīties integrācijā vai paši veidot risinājumus, izmantojot dokumentēto SkyPlanner REST API (API uzziņa).
Katana API
Katana ir vienots mākoņprodukts ar vairāku nomnieku arhitektūru, tāpēc visi klienti izmanto vienu un to pašu API. Tas ir REST API versijā v1 ar adresi https://api.katanamrp.com/v1; OpenAPI 3.0 specifikācija pieejama adresē https://api.katanamrp.com/v1/openapi.json. Dokumentācija atrodama Katana Developer Hub.
Grafiku sastādīšanai nepieciešamie galapunkti:
- Pamatdati:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Pasūtījumi:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Secība:
/manufacturing_order_rerank. - Piegāde un pieprasījums:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Galapunkta /resources nav. Resursi ir norādīti produktu operāciju rindās un ražošanas pasūtījumu operāciju rindās laukos resource_id un resource_name.
Autentifikācija un ierobežojumi
Autentifikācijai izmanto API atslēgu kā bearer pilnvaru: Authorization: Bearer <api key>. Izveidojiet atslēgu sadaļā Settings > API > Add new API key. (Avots)
Veidojot sinhronizāciju, jāņem vērā šādi ierobežojumi:
- Pēc noklusējuma Katana API atļauj 60 pieprasījumus 60 sekundēs (avots)
- Pārsniedzot šo limitu, API atgriež kodu 429 ar
Retry-After.X-Ratelimit-Remainingnorāda atlikušo atļauto pieprasījumu skaitu. - Sarakstu galapunkti atgriež rezultātus pa lapām un atbalsta filtrēšanu pēc atjaunināšanas datuma, tāpēc pārsūtāmo izmaiņu apjoms paliek neliels.
SkyPlanner REST API autentifikācijai izmanto API pilnvaru (SkyPlanner Settings > API), un tā dokumentācija ir pieejama Swagger/OpenAPI formātā. Integrācijas pamācībā soli pa solim izskaidroti pirmie izsaukumi.
Tīmekļa aizķeres
Reģistrējiet tīmekļa aizķeri ar POST /webhooks, norādot HTTPS URL un vajadzīgos notikumus. (Avots) Grafiku sastādīšanai noder šādi notikumi:
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.*unpurchase_order_row.*, tostarp saņemšanas notikumiproduct.*,product_recipe_row.*unsales_order.*
Paziņojumos ir tikai resursa tips, darbība un href. Saņēmējs iegūst pilnu objektu no href norādītās adreses. Katrā piegādē ir iekļauta galvene x-sha2-signature (HMAC SHA-256) pārbaudei. Jūsu galapunktam jāatbild ar 20X kodu 10 sekunžu laikā. Katana veic trīs atkārtotus mēģinājumus: pēc 30 sekundēm, 2 minūtēm un 15 minūtēm.
Datu kartēšana
| Katana objekts (galapunkts) | SkyPlanner objekts | Virziens | Biežums |
|---|---|---|---|
Produkti, materiāli, varianti (/products, /materials, /variants) | Produkti un materiāli | Katana → SkyPlanner | Sākotnējā ielāde, pēc tam — saņemot webhook paziņojumu |
Produkta receptūra / BOM (/recipe_rows, /bom_rows) | Produkta struktūra, apakšprodukti | Katana → SkyPlanner | Sākotnējā ielāde, pēc tam — saņemot webhook paziņojumu |
Ražošanas operācijas (/product_operation_rows): tips, resurss, laiks | Procesa soļi ar izpildes un sagatavošanas laiku | Katana → SkyPlanner | Sākotnējā ielāde, pēc tam izmaiņu gadījumā |
Resursi (resource_id, resource_name operāciju rindās) | Darba centri, darba centru grupas | Katana → SkyPlanner | Sākotnējā ielāde un pievienojot jaunu resursu |
Ražošanas pasūtījums ar operāciju rindām (/manufacturing_orders, /manufacturing_order_operation_rows) | Pasūtījumi un ražošanas uzdevumi | Katana → SkyPlanner | Reāllaikā ar tīmekļa aizķeri |
Ražošanas pasūtījuma materiāli (/manufacturing_order_recipe_rows) | Katra ražošanas uzdevuma materiāli | Katana → SkyPlanner | Reāllaikā ar tīmekļa aizķeri |
Krājumi, iepirkuma pasūtījumi ar piegādes datumiem (/inventory, /purchase_order_rows) | Krājumi un gaidāmie materiāli | Katana → SkyPlanner | Reāllaikā ar tīmekļa aizķeri |
Pārdošanas pasūtījuma lauks delivery_date (/sales_orders) | Pasūtījuma izpildes termiņš, klienta prioritāte | Katana → SkyPlanner | Reāllaikā ar tīmekļa aizķeri |
Ražošanas pasūtījumu secība (POST /manufacturing_order_rerank) | Atvērto ražošanas pasūtījumu secība grafikā | SkyPlanner → Katana | Mainoties grafikam |
Ražošanas pasūtījuma lauks production_deadline_date (PATCH /manufacturing_orders/{id}) | Plānotā pabeigšana | SkyPlanner → Katana | Mainoties grafikam |
Operācijas rindas lauki status, total_actual_time (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, darba laika ieraksti | SkyPlanner → Katana | Reģistrējot paveikto darbu |
| Katana nav pieejams | Maiņas, prombūtnes, sagatavošanas laiku matrica, instrumenti, operatoru skaits, alternatīvie darba centri | Uztur SkyPlanner sistēmā | Konfigurē ieviešanas laikā |
Integrācijas scenāriji
1. Sākotnējā pamatdatu ielāde. Iegūstiet produktus, materiālus, variantus, receptūru rindas un produktu operāciju rindas pa lapām, pielāgojot pieprasījumu biežumu atļautajam limitam. Izveidojiet SkyPlanner darba centrus no operāciju rindās norādītajiem unikālajiem resursiem un saglabājiet atslēgu atbilstību 1:1. Katram darba centram iestatiet maiņas, atvaļinājumus un virsstundas SkyPlanner, jo Katana nav resursu kalendāra.
2. Pasūtījumu sinhronizācija. Abonējiet ražošanas pasūtījumu, operāciju rindu, krājumu un iepirkuma pasūtījumu notikumus. Saņemot katru notikumu, iegūstiet objektu no tā href adreses un atjauniniet ražošanas uzdevumu. SkyPlanner uzskata pasūtīto materiālu par pieejamu iepirkuma pasūtījuma piegādes datumā un atjaunina krājumus, kad pasūtījums ir saņemts. Ik nakti veiciet datu salīdzināšanu ar filtriem pēc atjaunināšanas datuma, lai konstatētu nepamanītos notikumus.
3. Grafika ierakstīšana atpakaļ. Plānu Katana ieraksta ar diviem izsaukumiem:
- POST
/manufacturing_order_rerank“moves one or more manufacturing orders to an exact place in the production schedule” (pārvieto vienu vai vairākus ražošanas pasūtījumus uz precīzu vietu ražošanas grafikā). Vienā pieprasījumā var norādīt līdz 250 atvērtiem ražošanas pasūtījumiem, izvietojot tos sākumā, beigās vai pirms vai pēc noteikta ražošanas pasūtījuma. (Avots) - PATCH
/manufacturing_orders/{id}iestataproduction_deadline_date. Katana to pieņem tikai tad, ja attiecīgajai ražotnes atrašanās vietai ir izslēgta automātiskā termiņa aprēķināšana. (Avots)
Secības maiņa ietekmē ne tikai sarakstu. Katana sistēmā “higher-priority MOs reserve required materials and subassemblies first” (ražošanas pasūtījumi ar augstāku prioritāti pirmie rezervē vajadzīgos materiālus un mezglus), tāpēc SkyPlanner noteiktā secība nosaka arī to, kuram ražošanas pasūtījumam Katana piešķir krājumus.
4. Paveiktā darba apstiprinājumi ražošanas cehā. Operatori reģistrē darbu ar SkyPlanner Mobile Confirmations, Production Timer vai Quick Log Mode. SkyPlanner ieraksta statusu un faktisko izpildes laiku ražošanas pasūtījuma operācijas rindā. Ja ražotne tā vietā turpina izmantot Katana Shop Floor App, SkyPlanner nolasa operāciju rindu notikumus. Katrai ražotnei izvēlieties vienu darba uzskaites kanālu.
5. Atbildība par datiem un konfliktu risināšanas noteikumi. Dokumentējiet tos pirms palaišanas:
| Dati | Atbildīgā sistēma |
|---|---|
| Produkti, receptūras, ražošanas operācijas, krājumi, iepirkumi, pārdošanas pasūtījumi | Katana |
| Operāciju secība, sākuma un beigu laiks, katras operācijas darba centrs | SkyPlanner |
| Ražošanas pasūtījuma vieta cilnē Schedule un ražošanas termiņš | SkyPlanner; datus ieraksta arī Katana sistēmā |
| Maiņas, prombūtnes, sagatavošanas laiku matrica, instrumenti, alternatīvie resursi | SkyPlanner |
| Operācijas statuss un reģistrētais laiks | Viens kanāls, ko izvēlas, nosakot tvērumu |
Tipiskie projekta soļi
Ieviešana parasti tiek pabeigta dažu nedēļu laikā pēc klienta sākotnējās sagatavošanas uzsākšanas. Pirms tam 30 dienu bezmaksas izmēģinājumā varat izmantot savus datus no Katana CSV eksporta, piemēram, Tasks sarakstu Make skatā.
Projektā ietilpst šādi soļi:
- Abonēšanas plāns un atslēga. Pārliecinieties, ka Katana plānā ir iekļauts API un Manufacturing Management, un izveidojiet API atslēgu.
- Termiņu režīms. Vienojieties par automātisko termiņu izslēgšanu rūpnīcas atrašanās vietai, lai ražošanas termiņus pārvaldītu SkyPlanner.
- Datu atbilstība. Apstipriniet atbilstības tabulu, resursu atslēgas, noteikumus par atbildību par datiem un darba uzskaites kanālu.
- Sākotnējā ielāde. Produkti, varianti, receptūras, ražošanas operācijas un resursi.
- Notikumu sinhronizācija. Webhook paziņojumi par pasūtījumiem, operācijām, krājumiem un iepirkuma pasūtījumiem, kā arī datu salīdzināšana un saskaņošana katru nakti.
- Ierobežojumu iestatīšana SkyPlanner. Maiņas, pārregulēšanas laiku matrica, instrumenti, operatoru skaits un alternatīvie darba centri.
- Datu ierakstīšana atpakaļ. Secības maiņa un termiņi, pēc tam operāciju statuss un laiks.
- Paralēlā testēšana un palaišana darbā. Salīdziniet SkyPlanner datumus ar pašreizējiem datumiem cilnē Schedule, izlabojiet pamatdatus un tad ieslēdziet datu ierakstīšanu atpakaļ.
Kas jāņem vērā, integrējot Katana
- Termiņu režīms pārraksta datumus. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Ieslēdzot automātisko režīmu, visi manuāli iestatītie termiņi tiks pārrakstīti, un tos nevarēs atjaunot.) Izvēlieties režīmu vienreiz — projekta sākumā.
- Nav resursu kalendāra. Neveidojiet maiņas, balstoties tikai uz vienu Weekly throughput vērtību. Iestatiet tās SkyPlanner katram darba centram atsevišķi.
- Resursi ir tikai operāciju rindās. Nemainiet resursu nosaukumus Katana, jo tie kalpo par atslēgu sasaistei ar SkyPlanner darba centriem.
- Laika mērvienības.
planned_time_parametertiek norādīts sekundēs: per-unit operācijām — uz vienu vienību, bet process, setup un fixed tipiem — kopā. Pareizi sasaistiet operāciju tipus, citādi aprēķinātais ilgums būs kļūdaini reizināts vai dalīts ar daudzumu. - Grupas ražošanai pēc pasūtījuma. Mainot secību, ražošanas pasūtījumi (MO), kas saistīti ar vienu un to pašu pārdošanas pasūtījumu, paliek kopā, tāpēc plānojiet tos kā vienu grupu.
- Mainīts secības pārkārtošanas princips. Kopš 2026. gada 7. oktobra secības maiņas galapunkti ievieto pasūtījumus tieši norādītajā vietā. Integrācijas, kas izstrādātas, ņemot vērā iepriekšējo darbības principu, jāpārbauda atkārtoti. (avots)
Katana integrācija: kas to konfigurē un nodrošina atbalstu
Darbs aptver jūsu resursus, ražošanas operācijas, pasūtījumu plūsmu un termiņu režīmu. Tiek pievienots arī tas, ko Katana neglabā: maiņas, pārregulēšanas laiku matrica, instrumenti, operatoru skaits un alternatīvie resursi.
- SkyPlanner komanda konfigurē integrāciju ieviešanas laikā un nodrošina atbalstu pēc palaišanas darbā. Katrā rūpnīcā Katana resursi un operācijas ir iestatīti atšķirīgi, un konfigurēšanā tiek izmantotas zināšanas par šīm īpatnībām.
- Integrāciju var izveidot jūsu Katana konsultants vai integrācijas partneris. SkyPlanner nodrošina REST API, Swagger/OpenAPI dokumentāciju un webhook paziņojumus.
- Arī jūsu izstrādātāji var veidot savus risinājumus, izmantojot API piekļuves pilnvaru. Ar API piekļuves pilnvaru pietiek, lai sāktu darbu, un SkyPlanner komanda vajadzības gadījumā palīdz. Produkta dokumentācija, tostarp par iepirkuma pasūtījumiem un produktu un materiālu API, ir pieejama SkyPlanner dokumentācijā.
SkyPlanner cena ir no 199 € mēnesī, iekļaujot 5 darba centrus un maksājot katru mēnesi. Integrācijas cenu piedāvājumu sagatavojam iepriekš atbilstoši jūsu procesam un vajadzībām kopā ar abonēšanas plānu, lai visas izmaksas būtu zināmas pirms darba sākuma. Apskatiet cenas, funkcijas un salīdzinājumu ar Katana grafiku sastādīšanas iespējām rakstā Ražošanas plānošana ar Katana, ievērojot iekārtu un darbinieku faktisko jaudu. Pārskats ir pieejams Katana lapā, bet citas ERP sistēmas atradīsiet ERP integrāciju sadaļā.
Ražotāju atsauksmes par SkyPlanner
2 hietaupītas katru nedēļu
“Ar SkyPlanner mūsu ražošanas plānošana no Excel izklājlapām ir pārgājusi uz ražošanas optimizāciju reāllaikā.”
Kalle Kalliomäki, piegādes ķēdes speciālists
UTU · Elektriskās sadalnes un komutācijas iekārtas
Ražošanas plānošana ļauj katru nedēļu ietaupīt 2 darba stundas, un jaunā uzdevumu rinda nonāk ražošanas līnijā dažu sekunžu laikā.
+90%ražošanas efektivitāte
“Ražošanas efektivitāte ir pieaugusi par 90%.”
Abdul Rucyinga, IT vadītājs
Laboratory & Allied · Farmaceitisko produktu ražošana
Ražošanas efektivitāte ir pieaugusi par 90%, un optimizēta trīs mēnešu plāna izveide visiem darba centriem aizņem mazāk nekā 30 minūtes.
Mazākdīkstāvju materiālu trūkuma dēļ
“SkyPlanner vērtība mums ir tā, ka tas ir ikdienā noderīgs rīks, īpaši piegādes datumu noteikšanai.”
Tommi Männistö, ražošanas plānošanas vadītājs
Eskomatic · Mehāniskā apstrāde pēc pasūtījuma
Automātiska slodzes plānošana ļauj precīzāk noteikt piegādes datumus, un ražošanas dīkstāves materiālu trūkuma dēļ ir strauji samazinājušās.
1 000-iemdarba pasūtījumu grafiki sastādīti automātiski
“Tagad ražošanu kontrolējam citādi, un mūsu izpratne par jaudu ir pavisam citā līmenī.”
Hannu Ryynänen, izpilddirektors
Mamec · Rūpnieciskie maisītāji, sūkņi un augsto tehnoloģiju līgumražošana
Tūkstošiem darba pasūtījumu grafiki tiek sastādīti automātiski, un visam uzņēmumam ir pieejams ražošanas pārskats reāllaikā.
Biežāk uzdotie jautājumi
Vai Katana ir API, un kurš plāns man nepieciešams?
Jā. Katana piedāvā publisku REST API v1 ar OpenAPI 3.0 specifikāciju. Cenu lapā API piekļuve ir norādīta Free un Advantage plāniem. Autentifikācijai izmanto bearer API atslēgu, kas pieejama sadaļā Settings > API.
Vai SkyPlanner var ierakstīt grafiku atpakaļ Katana?
Jā. Izmantojot /manufacturing_order_rerank, SkyPlanner sakārto atvērtos ražošanas pasūtījumus savā noteiktajā secībā Katana cilnē Schedule un ieraksta katra MO laukā production_deadline_date tā termiņu. Operācijas statuss un faktiskais laiks tiek ierakstīti MO operāciju rindās. Katra darba centra grafiks ar konkrētiem laikiem tiek glabāts SkyPlanner, kur operatori strādā pēc savas uzdevumu rindas.
Vai Katana nosūta izmaiņas reāllaikā?
Jā. Katana webhook paziņojumi aptver ražošanas pasūtījumus, operāciju rindas, krājumus, iepirkuma pasūtījumus un pārdošanas pasūtījumus. SkyPlanner izgūst katru mainīto objektu un katru nakti salīdzina un saskaņo datus, tāpēc arī nepiegādāta notikuma dēļ ražošanas uzdevumā nekad nepaliek novecojuši dati.
Kā Katana resursi kļūst par SkyPlanner darba centriem?
Katrs atšķirīgais resurss Katana operāciju rindās kļūst par SkyPlanner darba centru ar atslēgu, kas nodrošina 1:1 atbilstību. Pēc tam SkyPlanner sistēmā iestata maiņas, prombūtnes un alternatīvos darba centrus.
Vai varam izmēģināt SkyPlanner pirms integrācijas izveides?
Jā. 30 dienu bezmaksas izmēģinājumā var izmantot līdz 20 darba centriem, importējot CSV datus no Katana. Kredītkarte nav nepieciešama. Sāciet izmēģinājumu vai sazinieties ar pārdošanas komandu, lai noteiktu integrācijas tvērumu.
