Panduan Integrasi Katana untuk Penjadwalan Produksi dengan SkyPlanner APS

Katana merupakan satu produk cloud multitenan, sehingga semua pelanggan menggunakan API yang sama. API ini adalah REST API versi v1 di https://api.katanamrp.com/v1, dengan spesifikasi OpenAPI 3.0 di https://api.katanamrp.com/v1/openapi.json. Dokumentasinya tersedia di Katana Developer Hub.

Endpoint yang diperlukan untuk penjadwalan:

• Master data: /products, /materials, /variants, /recipe_rows, /bom_rows, /product_operation_rows.
• Order: /manufacturing_orders, /manufacturing_order_operation_rows, /manufacturing_order_recipe_rows, /manufacturing_order_productions.
• Urutan: /manufacturing_order_rerank.
• Pasokan dan permintaan: /inventory, /purchase_orders, /purchase_order_rows, /sales_orders, /sales_order_rows.

Tidak ada endpoint /resources. Sumber daya produksi tercantum sebagai resource_id dan resource_name pada baris operasi produk dan baris operasi MO.

Daftarkan webhook melalui POST /webhooks dengan URL HTTPS dan event yang Anda perlukan. (sumber) Berikut event yang berguna untuk penjadwalan:

• 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.* dan purchase_order_row.*, termasuk event received
• product.*, product_recipe_row.* dan sales_order.*

Payload hanya berisi tipe resource, tindakan, dan href. Penerima mengambil objek lengkap dari href tersebut. Setiap pengiriman menyertakan header x-sha2-signature (HMAC SHA-256) untuk verifikasi. Endpoint Anda harus merespons dengan 20X dalam 10 detik. Katana mencoba ulang tiga kali, pada 30 detik, 2 menit, dan 15 menit.

1. Pemuatan awal master data. Ambil produk, material, varian, baris resep, dan baris operasi produk halaman demi halaman, dengan laju permintaan di bawah batas yang diizinkan. Buat stasiun kerja SkyPlanner dari setiap sumber daya produksi yang berbeda pada baris operasi dan pertahankan pemetaan kunci 1:1. Atur shift, cuti, dan lembur di SkyPlanner untuk setiap stasiun kerja karena Katana tidak memiliki kalender sumber daya produksi.

2. Sinkronisasi order. Berlangganan event MO, baris operasi, persediaan, dan pesanan pembelian. Setiap kali ada event, ambil objek dari href-nya dan perbarui job. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO diterima. Rekonsiliasi setiap malam dengan filter tanggal pembaruan mendeteksi event yang terlewat.

3. Penulisan kembali jadwal. Dua panggilan API memasukkan rencana ke Katana:

• POST /manufacturing_order_rerank “moves one or more manufacturing orders to an exact place in the production schedule” (memindahkan satu atau beberapa order produksi ke posisi tertentu dalam jadwal produksi). Endpoint ini menerima hingga 250 MO yang masih terbuka per permintaan, untuk ditempatkan di urutan teratas, terbawah, atau sebelum maupun sesudah MO tertentu. (sumber)
• PATCH /manufacturing_orders/{id} menetapkan production_deadline_date. Katana hanya menerimanya jika perhitungan tenggat otomatis untuk lokasi pabrik tersebut dinonaktifkan. (sumber)

Pengurutan ulang tidak hanya memengaruhi daftar. Di Katana, “higher-priority MOs reserve required materials and subassemblies first” (MO berprioritas lebih tinggi lebih dahulu mengalokasikan material dan subrakitan yang diperlukan). Karena itu, urutan dari SkyPlanner juga menentukan MO mana yang mendapat stok di Katana.

4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations, Production Timer, atau Quick Log Mode. SkyPlanner menuliskan status dan waktu aktual ke baris operasi MO. Jika pabrik tetap menggunakan Katana Shop Floor App, SkyPlanner membaca event baris operasi. Pilih satu saluran pelaporan untuk setiap pabrik.

5. Aturan kepemilikan dan konflik data. Dokumentasikan aturan ini sebelum integrasi mulai digunakan:

• Mode tenggat menimpa tanggal. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Setelah mode otomatis diaktifkan, semua tenggat manual akan ditimpa dan tidak dapat dipulihkan.) Tetapkan mode satu kali saja, saat proyek dimulai.
• Tidak ada kalender sumber daya produksi. Jangan menentukan shift berdasarkan satu nilai Weekly throughput saja. Atur shift untuk setiap stasiun kerja di SkyPlanner.
• Sumber daya produksi hanya ada pada baris operasi. Jangan mengubah nama sumber daya produksi di Katana, karena nama tersebut menjadi kunci penghubung ke stasiun kerja SkyPlanner.
• Satuan waktu. planned_time_parameter menggunakan satuan detik: per unit untuk operasi per-unit dan total untuk tipe process, setup, dan fixed. Petakan tipe dengan benar agar perhitungan durasi tidak meleset sebesar faktor kuantitas.
• Kelompok make to order. Saat urutan diubah, MO yang terkait dengan pesanan penjualan yang sama tetap dikelompokkan, jadi atur urutannya sebagai satu kelompok.
• Perilaku pengurutan ulang telah berubah. Sejak 7 Oktober 2026, endpoint rerank menempatkan pesanan tepat pada posisi yang diminta. Integrasi yang dibuat untuk perilaku lama perlu diuji ulang. (sumber)