SkyPlanner APS ile Üretim Çizelgeleme için Business Central Entegrasyon Kılavuzu

Entegrasyon, Business Central ile birlikte gelen iki arayüz üzerinden çalışır:

1. Ticari veriler ve stok verileri için API v2.0 kullanılır. Bu arayüz items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers ve employees varlıklarını sunar. Üretim varlıklarını içermediği için üretim verileri ikinci arayüz üzerinden alınır.
2. Üretim verileri için OData v4 web servisleri kullanılır. Herhangi bir Business Central sayfası, Web Services sayfasından OData v4 web servisi olarak yayımlanabilir. Nesne türü olarak Page seçin, sayfa kimliğini ve servis adını belirtin, ardından Published seçeneğini işaretleyin. AL kodu yazmadan veya uzantı dağıtmadan uç nokta kullanıma hazır hale gelir. Entegrasyon; serbest bırakılmış üretim emirleri, Prod. Order Routing Lines, iş merkezleri, makine merkezleri ve rotalar için standart sayfaları yayımlar. Bu sayfalara /ODataV4/Company('{name}')/{ServiceName} üzerinden erişilir.

Yayımlanan sayfalar hem okumayı hem de yazmayı destekler. Microsoft bunu şöyle açıklar: “If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,” (Düzenlenebilir bir sayfa web servisi olarak sunulursa, bağlı tablodaki verilere bir OData çağrısıyla erişilebilir ve bu veriler değiştirilebilir.) Güncellemeler için PATCH kullanılır. Planlanan tarihler böylece planlamacının kullandığı sayfa ve doğrulama mekanizması üzerinden Business Central’a geri yazılır.

SOAP kullanmayın. Microsoft, SOAP web servislerini kullanımdan kaldırma sürecine aldı. Microsoft kullanıcı arayüzü sayfalarının SOAP olarak yayımlanması desteği de 2026 release wave 2 (v29) ile kaldırılıyor.

Business Central, POST /api/v2.0/subscriptions üzerinden items ve salesOrders gibi API v2.0 varlıkları için webhook aboneliklerini destekler. Kurallar şöyledir:

• Abonelik oluşturmak için el sıkışma gerekir: uç noktanız validationToken değerini 200 OK yanıtıyla döndürmelidir.
• Abonelikler üç gün sonra sona erer. PATCH ile yenilediğinizde el sıkışma işlemi yeniden çalışır.
• Bildirimler kaydın tamamını değil, kaynak yolunu, changeType ve clientState değerlerinizi içerir. Kaydı daha sonra okursunuz.
• Bildirimler gecikmeli gönderilir: Business Central online ilk değişiklikten sonra 30 saniye bekler. Bu süre içinde değişen kayıt sayısı 1.000’i aşarsa tek bir collection bildirimi gönderilir.
• Çevrimiçi sürümde ortam başına en fazla 200 webhook aboneliği olabilir.

Üretim emirleri, rota satırları ve satınalma siparişleri, yayımlanan sayfalar ve purchaseOrders üzerinden birkaç dakikada bir sorgulanır. Yalnızca açık emir ve siparişleri filtrelemek ve sonuçları sayfalara bölmek, istek sayısını Business Central sınırlarının oldukça altında tutar.

SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir. Bu nedenle geri yazma işlemleri olay tabanlı çalışır.

1. Ana verilerin ilk aktarımı. Certified durumundaki rotaları ve üretim BOM’larını, iş merkezlerini ve makine merkezlerini yayımlanan sayfalardan; stok kartlarını ve ölçü birimlerini ise API v2.0 üzerinden alın. Her iş veya makine merkezinin SkyPlanner’daki karşılığını bilinçli olarak belirleyin: üç makine merkezi içeren bir iş merkezinin tek bir iş merkezi grubu mu, yoksa üç ayrı iş merkezi mi olacağına karar verin.

2. Emir ve sipariş senkronizasyonu. Released durumundaki üretim emirlerini rota satırları ve bileşenleriyle birlikte yayımlanan sayfalardan okuyun. Firm Planned durumundaki emirleri de çizelgeliyorsanız bunları da dahil edin. Açık satınalma siparişi satırlarını API v2.0 üzerinden alın. SkyPlanner, sipariş edilen malzemeyi satınalma siparişinin teslim tarihinde kullanılabilir kabul eder ve sipariş Delivered olarak işaretlendiğinde stoku günceller. Böylece çizelgelemede hem mevcut stok hem de gelecek satınalmalar kontrol edilir.

Planned durumundaki üretim emirlerini asla çizelgelemeyin. Microsoft, Business Central’ın bu emirler için “deletes them the next time you run planning.” (Planlamayı bir sonraki çalıştırmanızda bunları siler.) ifadesini kullanır. Planning Worksheet tedarik önerileri sunmaya devam ederken SkyPlanner kesinleşmiş emirleri gerçek kapasiteye göre çizelgeler.

3. Çizelgenin geri yazılması. Standart Prod. Order Routing sayfası, OData v4 web servisi olarak yayımlanır. Motorun çizelgeye yerleştirdiği veya yerini değiştirdiği her operasyon için SkyPlanner, ilgili rota satırına If-Match ETag değeriyle bir PATCH isteği gönderir. Starting Date-Time ve Ending Date-Time alanlarını ayarlar. Operasyon alternatif bir makineye taşındıysa Type ve No. alanlarını da ayarlar.

PATCH, sayfa ve tablo tetikleyicilerini çalıştırır. Böylece Business Central, alanları kendi mantığıyla, planlamacının Prod. Order Routing sayfasında düzenleme yaptığı durumla aynı şekilde doğrular. Üretim emri satırındaki Starting ve Ending Date-Time değerleri de buna göre güncellenir. Miktarlar, durum ve maliyetler Business Central’da tutulmaya devam eder.

4. Üretim sahası bildirimleri. Operatörler, SkyPlanner Mobile Confirmations veya Production Timer ile çalışmalarını kaydeder. Bu süre kayıtları çizelgeyi güncel tutar. Üretim bildirimi, daha önce olduğu gibi Business Central’da Production Journal veya Output Journal üzerinden yapılabilir.

Üretim ve tüketim kayıtlarının tamamen otomatik işlenmesini isterseniz, üretim günlüğü kayıtlarını işlemek için standart bir Business Central API sayfası eklenir. Ardından SkyPlanner, her operasyon için hazırlık süresini, çalışma süresini ve üretim miktarını işler. Bu işlem Capacity Ledger Entries kayıtlarını günceller; rotanın son operasyonundaki üretim bildirimi ise ürünü stoka ekler.

Üretim kayıtlarını işlemek için tek bir kanal seçin. Hem SkyPlanner’dan hem de Business Central Production Journal üzerinden kayıt işlemek mükerrer kayıtlara yol açar.

5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı olarak belirleyin:

Çakışmaların başlıca kaynağı, üretim emirlerindeki Refresh ve Replan işlemleridir. Microsoft: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Üretim emri satırlarını yeniden hesaplamak için Refresh işlemini kullanırsanız Business Central mevcut satırları siler ve yeni satırları hesaplar.) Replan kapasite ihtiyacını da değiştirebilir. Bileşenleri yeniden hesaplama işlemi ise “deletes previous changes in the components.” (Bileşenlerde daha önce yapılan değişiklikleri siler.)

Yenilenen emri yeni bir sürüm olarak ele alın, yeniden senkronize edin ve SkyPlanner’ın yeniden çizelgelemesini sağlayın. Autopilot ile SkyPlanner, üretimde değişiklik olduğunda otomatik olarak yeniden çizelgeler.

• Rotalardaki birimler. Setup Time üretim emri başına, Run Time ise üretilen ürün başına tanımlanır. Her birinin kendi Unit of Measure Code değeri vardır. Wait Time ve Move Time, iş merkezi kapasitesini tüketmez. İş merkezinin birimi Days ise bir gün, sekiz saatlik bir vardiya değil, 24 saattir. İçe aktarırken birim dönüşümü yapın; aksi halde tüm süreler yanlış olur.
• Güncel olmayan takvimler. Kapasite, ancak ilgili planlama dönemi için Calculate Work Center Calendar çalıştırıldıktan sonra oluşur. İlk veri aktarımından önce Calendar Entries Available Until alanını kontrol edin.
• Görünmeyen makine merkezi kapasitesi. Consolidated Calendar kapalıyken yalnızca iş merkezinin kendi kapasitesi planlanır: “The machine center capacity is excluded.” (Makine merkezi kapasitesi dahil edilmez.) İş merkezi toplamlarına güvenmek yerine makine merkezi kapasitesini doğrudan okuyun.
• Capacity ve Efficiency. Business Central, süreyi Run Time / Efficiency / Capacity formülüyle hesaplar. Hesaplanan takvim kayıtları zaten her ikisini de içerir. Efficiency değerini SkyPlanner iş merkezi verimliliğine eşlerken etkisini iki kez değil, yalnızca bir kez uygulayın.
• Alternate Work Center yalnızca bilgi amaçlıdır. Microsoft’un ifadesiyle “isn’t automatically included in planning processes.” (Planlama süreçlerine otomatik olarak dahil edilmez.) Alternatifleri SkyPlanner’da açıkça alternatif iş merkezleri olarak tanımlayın.
• İstek sınırlaması. Çevrimiçi ortamda sınırlar kullanıcı başına uygulanır ve hizmet sorumlusu da tek kullanıcı sayılır: 5 dakikalık kayan zaman aralığında 6.000 OData isteği ve aynı anda 5 istek. Sayfa boyutu en fazla 20.000 kayıt, bir $batch en fazla 100 işlem içerebilir. Bir işlem 8 dakika sonra zaman aşımına uğrar. İstek hızı sınırı aşıldığında 429 yanıtı döner. Tüm verileri yeniden yüklemek yerine değişiklikleri toplu isteklerle alın, sayfalayın ve periyodik olarak sorgulayın.
• Lisanslama. Üretim işlevleri yalnızca Premium deneyiminde bulunur. Essentials kullanıcıları, Premium olarak ayarlanmış bir şirkette oturum açamaz.