Webhook ve JSON entegrasyonu: hazır bağlantısı olmayan sistemler için

Webhook: iş emri olayları

Ayarlar › Webhook'lar ekranında bir adres tanımlar ve hangi olayları dinleyeceğinizi seçersiniz. Bugün gönderilen olaylar iş emirleriyle ilgilidir:

Her istek bir HTTP POST'tur; gövde {event, timestamp, tenantId, data} biçiminde JSON'dur. Başlıklarda olay adı (X-Webhook-Event), zaman (X-Webhook-Timestamp), teslimat kimliği (X-Webhook-Delivery) ve imza (X-Webhook-Signature) bulunur. Webhook'u yalnızca yöneticiler tanımlayabilir.

İmza, tekrar deneme ve teslimat kaydı

• İmza: gövdenin, webhook'a özel gizli anahtarla (whsec_ ile başlar) HMAC-SHA256 özeti; başlıkta sha256=<hex> olarak gelir. Alıcı aynı hesabı yapıp karşılaştırarak isteğin ModernMES'ten geldiğini doğrular. Anahtar yalnızca oluşturulduğunda bir kez gösterilir ve istendiğinde yenilenebilir.
• Tekrar deneme: 2xx dışı bir yanıt ya da 30 saniyelik zaman aşımında istek toplam 3 kez denenir.
• Teslimat kaydı: her gönderimin durumu, yanıt kodu ve yanıtın ilk kısmı webhook'un detay sayfasında görünür. "Test et" düğmesi örnek bir istek gönderir.
• Güvenlik: hedef adres her denemede yeniden kontrol edilir; iç ağ ve bulut meta veri adreslerine istek gönderilmez, yönlendirmeler izlenmez.

Genel JSON bağlantısı: kendi ERP aktarımınız

Genel JSON bağlantısı, ERP entegrasyonlarının hazır bağlantısı olmayan sistemler için olan türüdür. ERP iş ortağınız ya da yazılım ekibiniz küçük bir uç nokta yazar, ModernMES ona üretim kayıtlarını gönderir:

• Gönderim adresi: biten iş için {"type": "production_receipt", "data": {...}}, fire için {"type": "scrap", "data": {...}} POST edilir. data içinde iş emri no, parça kodu ve adı, birim, adet, belge tarihi ve saati, proje, operatör ve makine kodu ile kaydın benzersiz referansı bulunur.
• Kart okuma adresleri (isteğe bağlı): [{"code","name","unit"}] ya da {"items":[...],"hasMore":true} döndüren bir stok ve bir cari adresi. Sayfalar ?page=1,2… ile istenir.
• Kimlik doğrulama: isteğe bağlı Bearer token. İmza: isteğe bağlı gizli anahtarla zaman.gövde üzerinden HMAC-SHA256; başlıklar X-ModernMes-Signature (sha256=…) ve X-ModernMes-Timestamp.

Gönderimler ERP bağlantılarıyla aynı kuralları izler: ne zaman gönderileceğini siz seçersiniz (parçanın son operasyonu bitince, her operasyon bitince ya da elle), aynı bitiş kuyruğa yalnızca bir kez girer, karşı taraf yanıt vermezse 1 dakikadan 12 saate uzayan aralıklarla 8 deneme yapılır ve her aktarım geçmişte görünür.

Hangisini seçmeli?

Sık sorulan sorular