Entegrasyonlar / ERP / Katana
SkyPlanner APS ile Üretim Çizelgeleme için Katana Entegrasyon Rehberi
Bu Katana entegrasyon rehberi, danışmanlara ve BT ekiplerine Katana Cloud Inventory (Katana MRP) ile SkyPlanner APS arasında nasıl bağlantı kurulacağını anlatır. SkyPlanner, herkese açık Katana API üzerinden Katana ile çift yönlü entegre olur:
- Üretim emirleri, operasyon satırları, ürün reçeteleri, üretim operasyonları, kaynaklar, stoklar ve satın alma siparişleri SkyPlanner’a aktarılır.
- Çizelgedeki sıralama, her üretim emri için üretimin tamamlanması gereken tarihle birlikte Katana’nın Schedule sekmesine geri aktarılır.
- Operasyon durumu ve gerçekleşen süre, operasyon satırlarına geri yazılır.
- Katana webhook bildirimleri değişiklikleri SkyPlanner’a iletir; SkyPlanner webhook bildirimleri ise çizelge değişikliklerini anında gönderir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu Katana kurulumunuza göre yapılandırır ve canlıya geçişten sonra da destek sağlar. Bu rehber, sürece katılmak veya SkyPlanner’ın dokümante edilmiş REST API’sini (API referansı) kullanarak kendi çözümlerini geliştirmek isteyen danışmanlar ve geliştiriciler içindir.
Katana API
Katana, çok kiracılı tek bir bulut ürünüdür; bu nedenle tüm müşteriler aynı API’yi kullanır. v1 sürümündeki bu REST API, https://api.katanamrp.com/v1 adresinde, OpenAPI 3.0 tanımı ise https://api.katanamrp.com/v1/openapi.json adresinde yer alır. Dokümantasyona Katana Developer Hub üzerinden ulaşabilirsiniz.
Çizelgeleme için gereken uç noktalar:
- Ana veriler:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Emirler:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Sıralama:
/manufacturing_order_rerank. - Arz ve talep:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
/resources uç noktası yoktur. Kaynaklar, ürün operasyon satırlarında ve üretim emri operasyon satırlarında resource_id ve resource_name alanlarıyla yer alır.
Kimlik doğrulama ve sınırlar
Kimlik doğrulamada API anahtarı bearer token olarak kullanılır: Authorization: Bearer <api key>. Anahtarı Settings > API > Add new API key yolundan oluşturun. (kaynak)
Senkronizasyon tasarımı şu sınırlara göre şekillenir:
- Katana API, varsayılan olarak 60 saniyede 60 isteğe izin verir (kaynak)
- Bu sınır aşıldığında API,
Retry-Afterile birlikte 429 döndürür.X-Ratelimit-Remaining, kalan istek hakkını gösterir. - Listeleme uç noktaları sonuçları sayfalara böler ve güncelleme tarihine göre filtrelemeyi destekler. Böylece her seferinde aktarılan değişiklik miktarı küçük kalır.
SkyPlanner tarafında REST API, kimlik doğrulama için API token kullanır (SkyPlanner Settings > API) ve Swagger/OpenAPI ile dokümante edilmiştir. Entegrasyon kılavuzu, ilk çağrıları adım adım açıklar.
Webhook bildirimleri
POST /webhooks çağrısıyla bir HTTPS URL’si ve ihtiyacınız olan olayları belirterek webhook kaydı oluşturun. (kaynak) Çizelgeleme için yararlı olaylar:
manufacturing_order.created,.updated,.deleted,.in_progress,.blocked,.donemanufacturing_order_operation_row.created,.updated,.in_progress,.paused,.completedcurrent_inventory.material_updated,.material_out_of_stock- Mal kabul olayları dahil
purchase_order.*vepurchase_order_row.* product.*,product_recipe_row.*vesales_order.*
Bildirimlerin veri yükü sınırlıdır: kaynak türü, eylem ve bir href içerir. Alıcı, nesnenin tamamını href adresinden getirir. Her bildirimde doğrulama için bir x-sha2-signature başlığı (HMAC SHA-256) bulunur. Uç noktanız 10 saniye içinde 20X yanıtı vermelidir. Katana, 30 saniye, 2 dakika ve 15 dakika sonra olmak üzere üç kez yeniden dener.
Veri eşleme
| Katana nesnesi (uç nokta) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
Ürünler, malzemeler, varyantlar (/products, /materials, /variants) | Ürünler ve malzemeler | Katana → SkyPlanner | İlk yüklemede, ardından webhook bildirimi geldiğinde |
Ürün reçetesi / BOM (/recipe_rows, /bom_rows) | Ürün yapısı, alt ürünler | Katana → SkyPlanner | İlk yüklemede, ardından webhook bildirimi geldiğinde |
Üretim operasyonları (/product_operation_rows): tür, kaynak, süre | Süreleri ve hazırlık süreleriyle birlikte işlem adımları | Katana → SkyPlanner | İlk yükleme, ardından her değişiklikte |
Kaynaklar (operasyon satırlarındaki resource_id, resource_name) | İş merkezleri, iş merkezi grupları | Katana → SkyPlanner | İlk yüklemede ve yeni kaynak eklendiğinde |
Operasyon satırlarıyla birlikte üretim emri (/manufacturing_orders, /manufacturing_order_operation_rows) | Siparişler ve işler | Katana → SkyPlanner | Webhook ile gerçek zamanlı |
Üretim emri bileşenleri (/manufacturing_order_recipe_rows) | İş bazında malzemeler | Katana → SkyPlanner | Webhook ile gerçek zamanlı |
Stoklar, varış tarihleriyle birlikte satın alma siparişleri (/inventory, /purchase_order_rows) | Stok ve gelecek malzeme | Katana → SkyPlanner | Webhook ile gerçek zamanlı |
Satış siparişinin delivery_date alanı (/sales_orders) | Siparişin teslim tarihi, müşteri önceliği | Katana → SkyPlanner | Webhook ile gerçek zamanlı |
Üretim emri sıralaması (POST /manufacturing_order_rerank) | Açık üretim emirlerinin çizelgedeki sırası | SkyPlanner → Katana | Çizelge değiştiğinde |
Üretim emrinin production_deadline_date alanı (PATCH /manufacturing_orders/{id}) | Planlanan bitiş | SkyPlanner → Katana | Çizelge değiştiğinde |
Operasyon satırının status, total_actual_time alanları (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, süre kayıtları | SkyPlanner → Katana | İş kaydı girildikçe |
| Katana’da bulunmaz | Vardiyalar, devamsızlıklar, hazırlık süresi matrisi, takımlar, operatör sayıları, alternatif iş merkezleri | SkyPlanner’da yönetilir | Devreye alma sürecinde yapılandırılır |
Entegrasyon yöntemleri
1. Ana verilerin ilk yüklemesi. Ürünleri, malzemeleri, varyantları, reçete satırlarını ve ürün operasyon satırlarını, istek sınırını aşmadan sayfalar halinde alın. Operasyon satırlarındaki her farklı kaynak için SkyPlanner’da bir iş merkezi oluşturun ve 1:1 anahtar eşlemesini koruyun. Katana’da kaynak takvimi bulunmadığından vardiya, izin ve fazla mesaileri SkyPlanner’da her iş merkezi için tanımlayın.
2. Emir senkronizasyonu. Üretim emri, operasyon satırı, stok ve satın alma siparişi olaylarına abone olun. Her olayda nesneyi href adresinden getirip işi güncelleyin. SkyPlanner, sipariş edilen malzemeyi satın alma siparişinin teslim tarihinde kullanılabilir kabul eder ve mal kabulü yapıldığında stoku günceller. Güncelleme tarihi filtreleriyle her gece yapılan mutabakat, kaçırılan olayları yakalar.
3. Çizelgenin geri yazılması. İki çağrıyla plan Katana’ya aktarılır:
- POST
/manufacturing_order_rerank“moves one or more manufacturing orders to an exact place in the production schedule” (bir veya daha fazla üretim emrini üretim çizelgesinde belirli bir konuma taşır). Her istekte en fazla 250 açık üretim emri alır; bunları en başa, en sona ya da belirli bir üretim emrinin önüne veya arkasına yerleştirir. (kaynak) - PATCH
/manufacturing_orders/{id},production_deadline_datealanını ayarlar. Katana bunu yalnızca ilgili fabrika konumu için otomatik termin hesaplaması kapalıysa kabul eder. (kaynak)
Yeniden sıralamanın etkisi listeyle sınırlı değildir. Katana’da “higher-priority MOs reserve required materials and subassemblies first” (önceliği daha yüksek üretim emirleri, gerekli malzemeleri ve alt montajları önce rezerve eder). Dolayısıyla SkyPlanner’daki sıralama, Katana’da stokun hangi üretim emrine ayrılacağını da belirler.
4. Üretim sahasından gelen bildirimler. Operatörler iş kayıtlarını SkyPlanner Mobile Confirmations, Production Timer veya Quick Log Mode ile girer. SkyPlanner, durumu ve gerçekleşen süreyi üretim emrinin operasyon satırına yazar. Tesis bunun yerine Katana Shop Floor App kullanmaya devam ederse SkyPlanner operasyon satırı olaylarını okur. Her tesis için tek bir raporlama kanalı seçin.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı hale getirin:
| Veri | Veri sahibi |
|---|---|
| Ürünler, reçeteler, üretim operasyonları, stoklar, satın alma, satış siparişleri | Katana |
| Operasyon sırası, başlangıç ve bitiş zamanları, her operasyonun iş merkezi | SkyPlanner |
| Üretim emrinin Schedule sekmesindeki sırası ve üretimin tamamlanması gereken tarih | SkyPlanner; Katana’ya yazılır |
| Vardiyalar, devamsızlıklar, hazırlık süresi matrisi, takımlar, alternatif kaynaklar | SkyPlanner |
| Operasyon durumu ve kaydedilen süre | Kapsam belirleme aşamasında seçilen tek bir kanal |
Tipik proje adımları
Uygulama, devreye alma süreci başladıktan sonra genellikle birkaç hafta içinde tamamlanır. Öncesindeki 30 günlük ücretsiz denemede, Katana’dan CSV olarak dışa aktardığınız kendi verilerinizi kullanırsınız; örneğin Make ekranındaki Tasks listesini.
Proje şu adımlardan oluşur:
- Plan ve anahtar. Katana planınızın API ve Manufacturing Management içerdiğini doğrulayın ve API anahtarını oluşturun.
- Termin modu. Üretim terminlerini SkyPlanner’ın yönetmesi için fabrika lokasyonunda otomatik terminlerin kapatılması konusunda mutabık kalın.
- Eşleştirme. Eşleştirme tablosunu, kaynak anahtarlarını, hangi veriyi hangi sistemin yöneteceğini ve raporlama kanalını kesinleştirin.
- İlk veri yüklemesi. Ürünler, varyantlar, reçeteler, üretim operasyonları ve kaynaklar.
- Olay bazlı senkronizasyon. Siparişler, operasyonlar, stok ve satın alma siparişleri için webhook’lar ve her gece veri mutabakatı.
- SkyPlanner’da kısıtların tanımlanması. Vardiyalar, hazırlık süresi matrisi, takımlar, operatör sayıları ve alternatif iş merkezleri.
- Geri yazma. Önce sıralama ve terminler, ardından operasyon durumu ve süre.
- Paralel test ve canlıya geçiş. SkyPlanner’daki tarihleri mevcut Schedule sekmesindeki tarihlerle karşılaştırın, ana verileri düzeltin ve ardından geri yazmayı etkinleştirin.
Katana entegrasyonunda dikkat edilmesi gerekenler
- Termin modu tarihlerin üzerine yazar. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Otomatik mod etkinleştirildiğinde tüm manuel terminlerin üzerine yazılır ve bu tarihler geri getirilemez.) Kullanılacak modu proje başlangıcında bir kez belirleyin.
- Kaynak takvimi yoktur. Vardiyaları tek bir Weekly throughput değerinden türetmeyin. SkyPlanner’da her iş merkezi için ayrı tanımlayın.
- Kaynaklar yalnızca operasyon satırlarında yer alır. Katana’daki kaynak adlarını sabit tutun; bu adlar SkyPlanner iş merkezleriyle eşleştirmede anahtar olarak kullanılır.
- Zaman birimleri.
planned_time_parametersaniye cinsindendir; birim bazlı operasyonlarda birim başına süreyi, process, setup ve fixed türlerinde ise toplam süreyi belirtir. Türü doğru eşleştirin; aksi halde sürelerde miktar katsayısı kadar hata oluşur. - Siparişe göre üretim grupları. Yeniden sıralamada aynı satış siparişine bağlı MO’lar bir arada kalır. Bu nedenle bunları grup olarak sıralayın.
- Yeniden sıralama davranışı değişti. 7 Ekim 2026 tarihinden bu yana rerank uç noktaları siparişleri tam olarak istenen konuma yerleştirir. Eski davranışa göre yazılmış entegrasyonların yeniden test edilmesi gerekir. (kaynak)
Katana entegrasyonunu kim yapılandırır, kim destekler?
Çalışma; kaynaklarınızı, üretim operasyonlarınızı, sipariş akışınızı ve termin modunuzu kapsar. Katana’da bulunmayan vardiyalar, hazırlık süresi matrisi, takımlar, operatör sayıları ve alternatif kaynaklar da bu kapsamda eklenir.
- SkyPlanner ekibi, devreye alma sürecinde entegrasyonu yapılandırır ve canlıya geçişten sonra destek verir. Her fabrika Katana’daki kaynakları ve operasyonları farklı şekilde tanımlar. Fabrikaya özgü bu bilgi, yapılandırmaya yansıtılır.
- Entegrasyonu Katana danışmanınız veya entegrasyon iş ortağınız geliştirebilir. SkyPlanner; REST API, Swagger/OpenAPI dokümantasyonu ve webhook’lar sunar.
- Kendi geliştiricileriniz de entegrasyon üzerinde geliştirme yapabilir. Başlamak için bir API token yeterlidir; gerektiğinde SkyPlanner ekibi yardımcı olur. Satın alma siparişleri ile ürün ve malzeme API’si dahil ürün dokümantasyonuna SkyPlanner dokümantasyonundan ulaşabilirsiniz.
SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlar ve aylık faturalandırılır. Sürecinize ve ihtiyaçlarınıza göre entegrasyon teklifi, planınızla birlikte önceden sunulur; böylece başlamadan önce toplam maliyeti görürsünüz. Fiyatları ve özellikleri inceleyin. Katana’nın kendi çizelgeleme işlevleriyle karşılaştırma için Katana üretim çizelgeleme sayfasına bakın. Genel bilgileri Katana sayfasında, diğer ERP’leri ise ERP entegrasyonları sayfasında bulabilirsiniz.
Üreticilerin SkyPlanner yorumları
2 saather hafta tasarruf edilen süre
“SkyPlanner, üretim planlamamızı Excel tablolarından gerçek zamanlı üretim optimizasyonuna taşıdı.”
Kalle Kalliomäki, Tedarik Zinciri Uzmanı
UTU · Elektrik panoları ve şalt ekipmanları
Üretim planlamada her hafta 2 saatlik çalışma süresinden tasarruf ediliyor ve yeni iş kuyruğu üretim hattına saniyeler içinde ulaşıyor.
+%90üretim verimliliği
“Üretimde verimlilik %90 arttı.”
Abdul Rucyinga, BT Müdürü
Laboratory & Allied · İlaç üretimi
Üretim verimliliği %90 arttı. Tüm iş merkezlerini kapsayan üç aylık optimize edilmiş bir planın hazırlanması 30 dakikadan kısa sürüyor.
Daha azmalzeme eksikliğinden kaynaklanan duruş
“SkyPlanner’ın bize kattığı değer, günlük kullanımda, özellikle teslimat tarihlerini belirlerken işimizi gören bir araç olması.”
Tommi Männistö, Üretim Planlama Müdürü
Eskomatic · Fason talaşlı imalat
İş yükünün otomatik çizelgelenmesi daha doğru teslimat tarihleri sağlıyor. Malzeme eksikliğinden kaynaklanan üretim duruşları da büyük ölçüde azaldı.
1.000’lerceiş emri otomatik çizelgeleniyor
“Üretimi artık bambaşka bir şekilde kontrol altında tutuyoruz; kapasitemizi de artık tamamen farklı bir düzeyde kavrıyoruz.”
Hannu Ryynänen, CEO
Mamec · Endüstriyel karıştırıcılar, pompalar ve yüksek teknolojili fason üretim
Binlerce iş emri otomatik olarak çizelgeleniyor ve tüm kuruluş üretimi gerçek zamanlı olarak görebiliyor.
Sık sorulan sorular
Katana’nın API’si var mı, hangi plana ihtiyacım var?
Evet. Katana, OpenAPI 3.0 spesifikasyonuna sahip, v1 sürümünde herkese açık bir REST API sunar. Fiyatlandırma sayfasında Free ve Advantage planlarında API erişimi olduğu belirtilir. Kimlik doğrulamada, Settings > API bölümünden alınan API anahtarı bearer token olarak kullanılır.
SkyPlanner çizelgeyi Katana’ya geri yazabilir mi?
Evet. SkyPlanner, /manufacturing_order_rerank üzerinden Katana’nın Schedule sekmesindeki açık üretim emirlerini kendi belirlediği sıraya getirir ve her MO’nun production_deadline_date alanını yazar. Operasyon durumu ve gerçekleşen süre, MO operasyon satırlarına aktarılır. İş merkezi bazında zamanlanmış plan SkyPlanner’da tutulur; operatörler de buradaki iş kuyruklarına göre çalışır.
Katana değişiklikleri gerçek zamanlı olarak iletir mi?
Evet. Katana webhook’ları üretim emirlerini, operasyon satırlarını, stokları, satın alma siparişlerini ve satış siparişlerini kapsar. SkyPlanner değişen her nesneyi alır ve her gece veri mutabakatı yapar. Böylece kaçırılan bir olay nedeniyle hiçbir iş güncelliğini yitirmiş halde kalmaz.
Katana kaynakları SkyPlanner iş merkezlerine nasıl dönüştürülür?
Katana’nın operasyon satırlarındaki her farklı kaynak, anahtar üzerinden 1:1 eşleştirmeyle bir SkyPlanner iş merkezine dönüştürülür. Ardından vardiyalar, devamsızlıklar ve alternatif iş merkezleri SkyPlanner’da tanımlanır.
Entegrasyonu geliştirmeden önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz deneme, Katana’dan CSV içe aktarımıyla 20 iş merkezine kadar kullanım sunar; kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
