Web Kancası Geliştirici Kılavuzu
Giriş
FedEx takip web kancaları, gönderi yaşam döngüsü boyunca gönderiyle ilgili neredeyse gerçek zamanlı güncellemeler sağlar.
Uygulamaların gönderi durumunu sorgulamasını gerektiren takip API'lerinin aksine, web kancaları yeni bilgiler ortaya çıktıkça gönderi güncellemelerini otomatik olarak iletir.
Bu kılavuz şunları kapsar:
- Üç entegrasyon ilkesi
- Web kancaları nasıl çalışır?
- Web kancası safi yüklerini işleme
- Müşteri bildirimleri
- Zaman Bilgileri
- En iyi uygulamalar ve sık karşılaşılan entegrasyon sorunları
Üç entegrasyon ilkesi
Başarılı web kancası entegrasyonları üç ilkeyi takip eder.
Her web kancası safi yükünü bir gönderi durumu güncellemesi olarak ele alın
Her bir safi yükün yeni bir takip aşamasını temsil ettiğini varsaymayın. FedEx, yeni gönderi bilgileri kullanılabilir hale geldiğinde yeni bir safi yük yayınlar.
Bir safi yük şunları içerebilir:
- Yeni bir takip olayı
- Güncellenmiş teslimat tahminleri
- Teslimat kanıtı bilgileri
- Alıcı bilgileri
- Diğer gönderi verisi değişiklikleri
Birden fazla safi yük, farklı gönderi bilgileri içermekle birlikte aynı takip aşamasını paylaşabilir.
Gönderi verilerini depolayın ve birleştirin
Her bir safi yük, yeni veya güncellenmiş gönderi bilgileri içerebilir. Her bir web kancası safi yükünü depolayın ve yeni bilgileri mevcut gönderi kaydıyla birleştirin.
Mevcut gönderi kaydının üzerine en son safi yükle yazmayın. Bunun yerine, daha önce alınan gönderi verilerini muhafaza edin ve gönderi yaşam döngüsü boyunca eksiksiz, güncel bir gönderi kaydı sağlamak için yeni bilgileri dahil edin.
Eylemleri yönlendirmek için iş kurallarını kullanın
Sistemlerin ne zaman güncelleneceğini veya müşterilerin ne zaman bilgilendirileceğini belirlemek için iş kurallarını kullanın.
Eylemleri yalnızca bir olay koduna dayanarak tetiklemeyin. Müşterilere yönelik uygulamaları güncellemeden veya bildirim göndermeden önce şunları değerlendirin:
- Takip aşamaları
- Gönderi mevcudiyeti
- Bildirim zamanlaması
- İş gereksinimleri
Önerilen işleme modeli
Aşağıdaki şema, üç web kancası entegrasyon ilkesinin tipik bir uygulamada nasıl birlikte çalıştığını göstermektedir. Her bir web kancası safi yükü, gönderi durumu güncellemesi olarak işlenir, merkezi bir gönderi kaydıyla birleştirilir ve uygulamalar güncellenmeden ya da müşterilere bildirim gönderilmeden önce iş kuralları çerçevesinde değerlendirilir.
Web kancaları nasıl çalışır?
FedEx, gönderi bilgileri değiştiğinde veya kullanılabilir hale geldiğinde yeni bir web kancası safi yükü yayınlar. Bir gönderi, yaşam döngüsü boyunca birden fazla safi yük oluşturabilir; buna, aynı takip aşamasıyla ilişkili birden fazla safi yük de dahildir.
Ek safi yükler şunları içerebilir:
- Takip aşamaları: Teslim alındı, Taşıma sürecinde, Dağıtımda ve Teslim edildi.
- Gönderi verileri: Teslimat Kanıtı (PPOD), İmzalı Teslimat Kanıtı (SPOD), GPS Destekli Teslimat Kanıtı (GPS POD) ve alıcı bilgileri.
- Teslimat tahmini güncellemeleri: Tahmini teslimat tarihi ve saatindeki değişiklikler.
- Teslimat istisnaları: Gönderim ve teslimat istisnalarına ilişkin güncellemeler ve nedenleri.
- Gönderi üst verisi güncellemeleri: Adres güncellemeleri, referanslar ve hizmet detayları.
- Operasyonel düzeltmeler: Ek takip aşamaları ve
previousEventsgüncellemeleri.
Not: Teslim edilen tüm gönderiler için fotoğraflı kanıt mevcut değildir. Kullanılabilirlik; teslimat türüne, imza gerekliliklerine ve diğer iş kurallarına bağlıdır.
Her bir safi yük, gönderinin bilinen en güncel durumunu temsil eder. Gönderi kaydınızın eksiksiz ve güncel kalmasını sağlamak için her bir safi yükü işleyin.
Web kancası güncellemelerini anlama
Aşağıdaki örnek, aynı gönderi için yaşam döngüsü boyunca nasıl birden fazla web kancası safi yükü oluşturulabileceğini göstermektedir. Bazı safi yükler yeni bir takip aşaması içerir. Diğerleri; teslimat tahminleri, teslimat kanıtı verileri veya gönderi ayrıntıları gibi gönderim bilgilerini ekler.
Önemli: Aynı takip aşaması için birden fazla web kancası safi yükü oluşturulabilir. Yeni gönderi bilgilerinin gönderi kaydına dahil edilmesini sağlamak için her bir veri paketini işleyin.
Web kancası safi yüklerini işleme
Her bir web kancası safi yükü, gönderi durumu güncellemesi olarak işleyin.
Her bir web kancası safi yükünün yeni bir takip aşamasını temsil ettiğini varsaymayın. FedEx, yeni gönderi bilgileri kullanılabilir hale geldiğinde yeni bir safi yük gönderir. Örneğin, teslim edilmiş bir gönderi; teslimat kanıtı bilgileri, alıcı bilgileri veya diğer gönderi verileri eklendiğinde ya da güncellendiğinde ek safi yükler oluşturabilir.
Her bir safi yük için şunu sorun:
- Hangi takip aşaması değişti?
- Gönderi bilgilerinde neler değişti?
- Güncelleme, müşteriye yönelik bir uygulamayı etkiliyor mu?
- Güncelleme bir bildirimi tetikliyor mu?
Gönderi geçmişini işleyin
Hem scanEvent hem de previousEvents öğelerini izleyin.
scanEvent, safi yükle ilişkili mevcut takip aşamasını içerir.previousEvents, mevcutscanEventiçinde yer almayabilecek aşamalar da dahil olmak üzere, gönderi geçmişine dair ek bilgiler içerir.
Bazı takip aşamaları, yeni bir scanEvent olarak yayınlanmak yerine previousEvents içinde yer alır. Yalnızca scanEvent verilerini işleyen uygulamalar, gönderi güncellemelerini gözden kaçırabilir ve eksik gönderi geçmişleri oluşturabilir. Gönderiye dair eksiksiz bir görünüm elde etmek için her iki koleksiyonu da işleyin.
Gönderi kaydı tutun
Her bir web kancası safi yükünü depolayın ve yeni bilgileri mevcut gönderi kaydıyla birleştirin.
Eksiksiz bir gönderi kaydı, aşağıdakiler genelinde neredeyse gerçek zamanlı görünürlük sağlar:
- Gönderi takip panelleri
- Müşteri hizmetleri uygulamaları
- Sipariş yönetim sistemleri (OMS)
Gönderiye ilişkin en doğru ve eksiksiz görünümü korumak adına, gönderi kaydını her bir safi yükle güncelleyin.
Müşteri bildirimleri
İş gereksinimlerinize ve sağlamak istediğiniz gönderi ayrıntısı düzeyine dayalı bir bildirim stratejisi seçin.
FedEx takip web kancaları; takip aşamalarına ve gönderi verilerindeki değişikliklere ilişkin güncellemeleri, neredeyse gerçek zamanlı olarak iletir. Hangi güncellemelerin işletmeniz için önemli olduğunu ve hangilerinin göz ardı edilebileceğini belirlemek üzere iş kurallarını kullanın.
Yaygın bildirim stratejileri şunları içerir:
Neredeyse gerçek zamanlı bildirimler
Bir takip aşaması gerçekleştiği anda bildirim gönderin.
Avantajlar
- En hızlı müşteri iletişimi
- En düşük gecikme
Dikkat: Gönderiye ilişkin ek bilgiler henüz mevcut olmayabilir.
Zengin bildirimler
Gönderiyle ilgili ek bilgilerin ulaşabilmesi için takip aşamasındaki bir güncellemeden sonra birkaç dakika bekleyin.
Örneğin, teslimat aşamasından sonra aşağıdaki bilgilerin alınabilmesi için birkaç dakika bekleyin:
- Teslimat Kanıtı (POD)
- İmzalı Teslimat Kanıtı (SPOD)
- GPS ile Teslimat Kanıtı
- Alıcı bilgileri
Avantajlar
- Müşteriler için daha kapsamlı gönderi güncellemeleri
- Daha az takip bildirimi
- Müşteri destek temaslarında azalma
FedEx, bir teslimat aşaması gerçekleştikten sonra yaklaşık beş dakika beklenmesini önerir; çünkü teslimat kanıtına ilişkin bilgiler genellikle ilk teslimat olayından kısa bir süre sonra sisteme eklenir.
Bildirim zamanlaması önerileri
Bildirim zamanlaması, müşteriye ve kullanım durumuna göre değişiklik gösterir. Ancak satın alma sonrası alıcı bildirimleri için aşağıdaki öneriler yaygın olarak kullanılmaktadır. Diğer bildirim türleri (iş kullanıcıları, müşteri hizmetleri temsilcileri vb.) için, kullanım senaryonuza uygun bir bildirim stratejisi seçin.
- Tahmini Teslimat: Hem Taahhüt Tarihi hem de ilk tahmini teslimat tarihi (EDD) belli olduktan sonra yaklaşık 15 dakika bekleyin.
- Teslimata Çıkış: Hemen veya iş programınıza uygun olarak (örneğin, her gün saat 08:00'de) gönderin.
- Teslim edildi: Teslimatla ilgili ek bilgilerin ulaşması için yaklaşık 5 dakika bekleyin.
- Teslimat Denemesi: Teslimat bilgilerinin ulaşmasını sağlamak için "Teslim Edildi" durumundakine benzer bir yaklaşım uygulayın.
İş verileri etrafında bildirim kuralları oluşturma
Her gönderi güncellemesi bildirim gerektirmez. İş gereksinimlerinizi destekleyen bildirim kuralları tanımlayın.
Önerilen yaklaşım
Yalnızca eventCode öğesine dayanarak bildirimleri tetiklemeyin.
Değerlendirin:
- Takip aşaması
- Gerekli gönderi verileri
- İş kuralları
Bildirimleri yalnızca gerekli bilgiler mevcut olduğunda oluşturun.
Bu yaklaşım şunların önlenmesine yardımcı olur:
- Yinelenen bildirimler
- Eksik teslimat bilgisi
- Tamamlanmamış teslimat bildirimleri
- Gereksiz takip bildirimleri
Zaman Bilgileri
Kullanım durumunuza uygun zaman bilgisini kullanın.
eventCreateTime: Gönderi olayının gerçekleştiği zaman. Bunu, müşteriye yönelik takip geçmişi için kullanın.- İletinin gönderilme zamanı: FedEx'in web kancası safi yükünü gönderdiği an. Bunu yalnızca hata ayıklama ve izleme amacıyla kullanın; müşteriye yönelik deneyimlerde kullanmayın.
eventCreateTime, gönderi olayının ne zaman gerçekleştiğini yansıtır. FedEx, daha sonra ek gönderi bilgileri girildiğinde bu değeri güncellemez. Örneğin, teslim edilmiş bir olay; sonraki safi yükler teslimat kanıtı bilgileri veya diğer gönderi güncellemelerini eklese dahi, orijinal eventCreateTime değerini korur. Sonuç olarak, olayın ne zaman gerçekleştiğini belirlemek için ilgili gönderi bilgilerinin ne zaman eklendiğini değil, eventCreateTime kullanılmalıdır.
Bazı durumlarda, bir olay zamanı mevcut olmayabilir. Bu durum gerçekleştiğinde, zaman bilgisi 00:00:00 şeklinde bir varsayılan değer içerebilir. Ek safi yükler, kullanılabilir hale geldiklerinde daha hassas bir zaman bilgisi içerebilir.
En iyi uygulamalar ve sık karşılaşılan entegrasyon sorunları
En iyi uygulamalar
- Her web kancası safi yükünü işleyin; her mesaj yeni bir takip olayı veya gönderi verisi güncellemesi içerebilir.
- Kademeli güncellemeleri mevcut gönderi kaydınızla birleştirin.
- Gönderi geçmişinin tamamını yakalamak için hem
scanEventhem depreviousEventsöğelerini izleyin. - Müşteri bildirimlerini yalnızca ham olayları kullanarak değil, iş kurallarından yararlanarak tetikleyin.
- Müşterileri bilgilendirmeden önce, beklenen zenginleştirmelerin (örneğin PPOD, SPOD, GPS) gerçekleşmesi için zaman tanıyın.
- Yinelenen ve sırası bozulmuş mesajları yönetebilen, tekrarlı çalıştırmalarda tutarlı sonuç veren ve hatalara dayanıklı bir işleme mekanizması tasarlayın.
Yaygın entegrasyon sorunları
- Her bir safi yükün, yeni bir takip aşamasını temsil ettiği varsayma.
- Gönderi kaydının üzerine en güncel veri yükünün yazılması.
- Yalnızca
scanEventdeğerine güvenme. - Yalnızca
eventCodedeğerine dayalı olarak bildirimleri tetikleme. - İlk teslim edilen yükün, tüm teslimat detaylarını içerdiği varsayılmaktadır.
- Web kancası iletilerinin yalnızca bir kez veya kronolojik sırada geldiği varsayma.
Özet
Her bir web kancası safi yükü, gönderi durumu güncellemesi olarak işleyin. Gönderi güncellemelerini depolayıp birleştirin, hem scanEvent hem de previousEvents değerlerini izleyin ve uygulamaların ne zaman güncelleneceğine ya da müşterilerin ne zaman bilgilendirileceğine karar vermek için iş kurallarını kullanın.
Bu yaklaşım; gönderi görünürlüğünün doğruluğunu, eksiksiz bir takip geçmişini ve müşterilerle daha bilinçli iletişim kurulmasını sağlamaya yardımcı olur.
