Workcube entegrasyonu: üretim kayıtları WEX ile Workcube'a

Neden hazır bir Workcube bağlantısı yok?

Workcube dış sistemlerle veri alışverişini WEX (Workcube Exchange) ile yapar. WEX hazır uç noktalar sunan bir API sayılmaz. Her kurulumda iş ortağının yazdığı servisler bu katmanda çalışır ve hangi fişin hangi alanlarla açılacağı firmaya göre tasarlanır. Bu yüzden her Workcube'da aynı şekilde çalışan, yayımlanmış bir "üretim sonucu" ya da "stok fişi" servisi bulunmaz.

ModernMES burada tahminle bir bağlantı yazmaz. Onun yerine kendi kayıt biçimini sabit ve belgeli tutar. Workcube tarafındaki servis bu biçimi okuyacak şekilde bir kez yazılır, gerisini ModernMES'in aktarım kuyruğu yürütür.

Nasıl çalışır?

data alanında iş emri numarası, parça kodu ve adı, birim, adet, belge tarihi ve saati, proje, operatör ve makine kodu bulunur. Her kaydın bir de benzersiz referansı vardır. WEX servisi bu referansı saklarsa aynı kaydın iki kez fişe dönüşmesini kendi tarafında engelleyebilir.

İsterseniz istekler bir Bearer anahtarıyla gönderilir. Bir gizli anahtar da girerseniz her istek bu anahtarla imzalanır ve X-ModernMes-Signature ile X-ModernMes-Timestamp başlıklarını taşır. Ayrıntılı biçimi webhook ve JSON API sayfasında bulabilirsiniz.

Kurulum

1. Workcube iş ortağınız, ModernMES'in JSON kaydını alıp Workcube'da üretim sonucu ya da stok fişi açan bir WEX servisi yazar. İsterse stok ve cari kartlarını sayfa sayfa döndüren iki okuma servisi de ekler.
2. Yönetici ya da müdür rolündeki bir kullanıcı Ayarlar → ERP Bağlantısı ekranında Genel JSON API bağlantısını seçer. Ardından servis adreslerini ve anahtarları girer.
3. "Bağlantıyı test et" düğmesi servise bir test kaydı gönderir ve gelen yanıt kodunu gösterir.
4. Aktarımın ne zaman yapılacağını siz seçersiniz. Varsayılan ayarda kayıt, parçanın son operasyonu bitince gider. Bunun yerine her operasyon bitince ya da yalnızca elle aktarmayı da seçebilirsiniz.

Operatör Workcube'un yanıtını beklemez. İş terminalde hemen biter ve kayıt arka planda gider. Servis o an yanıt vermezse ModernMES 8 kez dener, denemeler arasındaki süre de 1 dakikadan 12 saate kadar uzar. Her aktarım, Workcube'un verdiği yanıtla birlikte aktarım geçmişinde görünür.

Hazır bağlantı için

Workcube'unuzda üretim ya da stok fişi açan bir WEX servisi zaten varsa, servisin çağrı adını, alanlarını ve kimlik doğrulama yöntemini içeren tanımını bizimle paylaşın. Belgelenmiş bir servise doğrudan bağlanan bir Workcube bağlantısını bu tanıma göre değerlendirebiliriz.

Sık sorulan sorular