SkyPlanner APS ile Üretim Çizelgeleme için MRPeasy Entegrasyon Rehberi

MRPeasy, şirket içi kurulum sürümü olmayan tek bir bulut ürünüdür. Bu nedenle tüm müşteriler aynı API’yi kullanır. İki sürüm bulunur:

1. REST API v1 (OpenAPI 1.0, sunucu: https://api.mrpeasy.com/rest/v1), canlı kullanımda olan API’dir. /items, /boms, /routings, /manufacturing-orders, /work-centers, /work-center-types, /customer-orders, /purchase-orders, /stock/inventory, /lots, /units ve /report/production/operations gibi üretim raporlarını kapsar.
2. REST API v2 (OpenAPI 2.0.0, sunucu: https://api.mrpeasy.com/rest/v2) henüz geliştirme aşamasının başındadır. Bu sürümle work_hours ve holidays alanlarını içeren /workstation-groups, productivity ve idle alanlarını içeren /workstations, ayrıca /inventory, /stock-movement ve PATCH eklenir. Üretim emirleri v1 üzerinde kalır.

Adlandırmaya dikkat edin. MRPeasy arayüzündeki Workstation group, v1’de work-center-types (type_id) olarak geçer. Workstation ise work-centers (center_id) karşılığıdır. Rota operasyonları, type_id üzerinden bir gruba bağlanır; bir makineye değil.

API, MRPeasy’nin Unlimited planında ücretli hesaplara sunulur. MRPeasy ayrıca şu ifadeye yer verir: “Our Support Department cannot help you using the API.” (Destek departmanımız API kullanımı konusunda size yardımcı olamaz.) Bu nedenle entegrasyonun bir sorumlusu olmalıdır: SkyPlanner, MRPeasy danışmanınız veya geliştiriciniz. SkyPlanner ekibi, devreye alma sürecinde tam da bu işi üstlenir.

MRPeasy’nin fiyatlandırma sayfasında “API, webhooks (for paid accounts)” (API ve webhook’lar, ücretli hesaplar için) ifadesi yer alır. Ancak v1 ve v2 teknik belgelerinde üretim emirlerine yönelik herhangi bir webhook olayı tanımlanmaz. Bu nedenle entegrasyon, MRPeasy’yi yalnızca yeni ve değişen verileri alacak şekilde periyodik olarak sorgular:

• Üretim emirleri, Not scheduled (15), Scheduled (20), In progress (30) ve Paused (35) durumlarına göre filtrelenerek alınır.
• Satın alma siparişleri ve stoklar, belirli aralıklarla veya her çizelgeleme öncesinde alınır.
• Ana veriler, değişiklik olduğunda veya her gece alınır.

Sıralı ve filtreli sorgulama, 10 saniyede 100 istek sınırının oldukça altında kalır. Ters yönde ise SkyPlanner’ın kendi webhook’ları, çizelge değişikliklerini gerçekleştiği anda iletir. Böylece geri yazma işlemleri olay bazlı yürütülür.

1. Ana verilerin ilk aktarımı. Stok kartlarını, birimleri, BOM’ları ve rotaları v1’den; iş merkezi gruplarını ve iş merkezlerini ise v1 veya v2’den alın. Takvimleri v2 /workstation-groups (work_hours, holidays) üzerinden alın veya vardiyaları doğrudan SkyPlanner’da tanımlayın. Her Active processing grubunu, o gruptaki iş merkezlerini de içeren bir SkyPlanner iş merkezi grubuyla eşleyin.

2. Sipariş eşitleme. Açık üretim emirlerini operasyonlarıyla birlikte, ayrıca açık satın alma siparişlerini ve stokları okuyun. SkyPlanner, sipariş edilen malzemeyi satın alma siparişinin teslim tarihinde kullanılabilir kabul eder ve sipariş Delivered olarak işaretlendiğinde stokları günceller. Her yeniden çizelgelemede hem stoklar hem de gelecek satın alımlar kontrol edilir.

3. Çizelgenin geri yazılması. PUT /manufacturing-orders/{id}; code, quantity, due_date ve assigned_id alanlarının yanı sıra custom_<id> biçimindeki özel alanları destekler. SkyPlanner, üzerinde anlaşılmışsa planlanan bitişi due_date alanına; planlanan başlangıç, planlanan bitiş ve ilerleme bilgilerini de MRPeasy özel alanlarına yazar. Böylece MRPeasy’deki satış ve satın alma ekipleri gerçek çizelgeyi görür. Ayrıntılı operasyon sırası ve her operasyona atanan iş merkezi SkyPlanner’da tutulur. Üretim sahasında işlerin yürütülmesi için kullanılan görünüm SkyPlanner’dır.

4. MRPeasy dışında oluşturulan siparişler. Siparişler API üzerinden oluşturulacaksa POST /manufacturing-orders, no_scheduling ve no_bookings parametrelerini kabul eder. MRPeasy’nin, SkyPlanner tarafından zaten çizelgelenen iş merkezlerine rezervasyon yapmaması için bunları kullanın.

5. Üretim sahası bildirimleri. Operatörler, SkyPlanner Mobile Confirmations, Production Timer veya Quick Log Mode ile işlerini kaydeder. Zaman kayıtları çizelgenin güncel kalmasını sağlar. Tek bir bildirim kanalı seçin. Aynı operasyonlar için MRPeasy’nin Internet-kiosk özelliğini ve SkyPlanner’ı birlikte kullanmak, birbiriyle yarışan iki ayrı kayıt oluşturur.

6. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı hale getirin:

Mühendis siparişine göre üretim akışı. Tamamlanan bir MRPeasy projesinde her müşteri projesi, bir ana ürün ve bir ila üç yarı mamul olarak modellenir. Her birinin MRPeasy içinde kendi BOM’u ve rotası vardır; üretim emri ise her iki sistemde de bulunur. Güncellemelerin hiçbir zaman mükerrer kayıt oluşturmaması için her emirde değişmeyen ortak bir tanımlayıcı kullanın.

• Süre alanları arayüze göre değişir. Kullanıcı arayüzündeki Setup time, Cycle time ve Capacity alanları, API’de sırasıyla fixed_time, variable_time ve variable_quantity olarak geçer. Capacity değerinin 1 üzerinde olması, fırında olduğu gibi parti halinde işlem yapıldığını gösterir. Bunu daha uzun bir çevrim olarak değil, parti işi olarak eşleştirin.
• Passive processing grupları. Kurutma ve soğutma grupları kapasite sınırı olmadan 24/7 çalışır. Bunları sınırlı kapasiteye sahip iş merkezleri olarak değil, bekleme süreleri olarak eşleştirin.
• v1 takvim verilerini içermez. work-centers yalnızca center_id, type_id, code ve title döndürür. v2 kullanın veya vardiyaları SkyPlanner’da yönetin.
• Boşta kalma süresi. İş merkezinin boşta kalma süresi, bakım ve duruşları içerir. Bu veriyi senkronize edin; aksi halde SkyPlanner, çalışmayan bir makineye iş planlar.
• Rotalar gruplara bağlıdır. MRPeasy, müsaitliği en uygun olan makineyi seçer. SkyPlanner’da grubun iş merkezleri, motorun aralarından seçim yaptığı gerçek alternatifler haline gelir.