Bildirim Yoksa Sipariş Yok Demek Değildir
Webhook, sipariş paketindeki bir gelişmeyi satıcının belirlediği sunucuya iletir. Bildirim alınmaması, mağazada sipariş oluşmadığını kanıtlamaz. Sorun bildirim adresinde, sunucunun erişilebilirliğinde veya abonelik kaydında olabilir. Trendyol, webhook yanında siparişlerin düzenli servis sorgularıyla eşitlenmesini de önerir. Bu ikinci kontrol, bildirim kesildiğinde operasyonun tamamen görünmez hâle gelmesini önler. İzlenecek temel fark, pazaryerindeki güncel paket sayısıyla işletmenin sistemine alınan paket sayısıdır. Webhook durumunun aktif görünmesi de tek başına son bildirimlerin başarıyla işlendiğini göstermez.
Yetkilendirme ve Durum Aboneliği
Trendyol webhook bağlantısı BASIC_AUTHENTICATION veya API_KEY yöntemiyle tanımlanabilir. API anahtarı yöntemi kullanıldığında karşı tarafın x-api-key başlığını beklemesi gerekir. Sipariş sorgulamak için kullanılan kimlik bilgileriyle gelen webhook isteğini doğrulayan ayarlar birbirine karıştırılmamalıdır. Ayrıca subscribedStatuses alanı hangi durumların bildirileceğini belirler. Yalnızca oluşturulan siparişlere abone bir uygulama, teslimat değişikliğini bu abonelikten beklememelidir. Erişim sorunu incelenirken gizli değerler ekranda paylaşılmaz; kullanılan yöntem, beklenen başlık ve sunucunun verdiği yanıt kodu üzerinden ilerlenir. Anahtar değişikliği iki uçta uyumlu uygulanır.
Tekrar Gelen Bildirimlerin İşlenmesi
Başarısız teslimatlar yeniden gönderilebilir. Bu nedenle aynı sipariş paketine ait bildirimin birden fazla kez gelmesi mümkün kabul edilmelidir. Uygulama her gelen mesajı yeni sipariş gibi işlerse stok veya hazırlama listesi iki kez etkilenebilir. Tekrarlanan bildirimin ikinci kez iş sonucu üretmesini önleyen kontrol, entegrasyonun kendi sorumluluğudur. Aynı zamanda paketin sonraki durum değişikliği de yanlışlıkla tekrar diye atılmamalıdır. Paket kimliği, durum ve olayın içeriği birlikte değerlendirilir. Sunucu bildirimi kalıcı olarak kaydetmeden başarı yanıtı verirse, uygulama çöktüğünde alınmış görünen veri kaybolabilir.
Pasife Alınan Bağlantıyı Düzeltmek
Trendyol dokümantasyonunda sürekli başarısız olan webhook bağlantılarının bildirim e-postaları sonrasında pasife alınabildiği belirtilir. Hatanın nedeni giderilmeden yalnızca bağlantıyı yeniden aktif etmek kalıcı çözüm oluşturmaz. Önce sunucu kayıtlarındaki erişim, yetki veya uygulama hatası belirlenir; ardından ilgili webhook kimliği üzerinden etkinleştirme yapılır. Kesinti boyunca oluşan sipariş ve durum değişiklikleri ayrıca sorgulanmalıdır. Bağlantı tekrar çalıştığında geçmişte kaçırılan bütün verinin kendiliğinden eksiksiz tamamlandığı varsayılmaz. İşletme, son başarılı eşitleme zamanını ve yeniden alınan kayıtların kapsamını görebilmelidir.
Operasyon İçin Anlamlı İzleme
İzleme ekranında yalnızca toplam istek sayısı göstermek yetersizdir. Son başarılı bildirim, başarısız yanıtların türü, işlenmeyi bekleyen kayıtlar ve periyodik eşitleme sonucu birlikte değerlidir. Kurgusal bir mağazada yeni siparişler geliyor ama kargoya teslim durumları görünmüyorsa önce durum aboneliği incelenebilir; hiçbir bildirim gelmiyorsa erişim ve aktiflik öncelik kazanır. Bir sorun kaydında webhook kimliği ve maskelenmiş örnek paket bilgisi bulunması yeterlidir. Müşteri adreslerini veya gizli anahtarları günlük dosyalarına açık yazmadan da teknik teşhis yapılabilir. Amaç bildirim sayısını artırmak değil, sipariş durumlarını güvenilir biçimde güncel tutmaktır.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- Başarısız Teslimat
- Başarısız teslimat, kargonun alıcıya ilk denemede ulaştırılamamasıdır; alıcının adreste bulunmaması, adresin hatalı olması ya da teslimin reddedilmesi gibi nedenlerle paket yeniden denenir ya da şubeye döner.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.
Trendyol