Abonelik E-Ticaret Markaları Yinelenen Gönderileri Tracking API ile Nasıl Takip Edebilir
Yinelenen gönderileri bir takip API'siyle izlemek için her fiziksel paket için bir gönderi kaydı oluşturun, bu kaydı ilgili abonelik döngüsünün fulfillment siparişine bağlayın ve deponuz veya fulfillment iş ortağınız sağladığında takip numarasını kaydedin. Müşterilere paketin nerede olduğunu göstermek ve teslimat istisnalarını ekibiniz için işaretlemek üzere API'nin takip güncellemelerini kullanın. Abonelik kimliğini döngüler arasında bağlantı olarak tutun; bir paketin tanımlayıcısı olarak kullanmayın.

Aboneliği değil, paketi takip edin
Bir abonelik, müşterinin zaman içinde alması planlanan ürünleri gösterir. Bir fulfillment siparişi, bir döngü için gönderilmesi gerekenleri belirtir. Bir takip numarası ise belirli bir paket hakkında bilgi verir. Bu kayıtları ayrı tutmak, bir döngüdeki geciken gönderinin sonraki döngünün takip sayfasında görünmesini önler.
Örneğin, Mayıs abonelik kutusunun iki pakete bölündüğünü ve bir Mayıs paketi hâlâ yoldayken Haziran kutusunun gönderildiğini varsayalım. Müşteri, Mayıs siparişinin altında iki paket ve Haziran siparişinin altında ayrı bir paket görmelidir. Mayıs ayındaki gecikme güncellemesi yalnızca Mayıs paketini değiştirmelidir. Bir ürünü değiştirerek yeniden gönderirseniz yeni bir gönderi kaydı oluşturun ve destek ekibinin ikisinin neden var olduğunu görebilmesi için bunu orijinal kayda bağlayın.
- Abonelik: Destek ekibinin müşterinin gönderi geçmişini bulabilmesi için abonelik kimliğini saklayın.
- Döngü ve sipariş: Döngü tanımlayıcısını veya planlanan fulfillment tarihini, sipariş kimliğini ve paketleri doğru siparişle eşleştirmek için gereken fulfillment kimliklerini kaydedin. Döngüyü, bir takip etkinliğinin ulaştığı tarihten çıkarmayın.
- Gönderi: Her pakete dahili bir gönderi kimliği verin. Kargo şirketini ve takip numarasını, ilgili fulfillment referansını ve sağlayıcının döndürdüğü takip kayıt kimliğini saklayın. İptal edilen etiketleri ve geçersiz kılınmış takip numaralarını aktif müşteri görünümünden çıkarın; ancak destek için geçmişi koruyun.
Sipariş sayfasında, sipariş özetinin yanında paket düzeyindeki ilerlemeyi gösterin. Bir paket teslim edilmiş, diğeri yoldaysa bunu açıkça belirtin. Tüm siparişin teslim edildiğini yalnızca siparişi tamamlamak için gerekli tüm paketler ulaştığında gösterin; iptal edilen gönderileri ve değişimleri hesaba katın.
Fulfillment'ı takip API'sine bağlayın
- Bir fulfillment etkinliğinden kaydedin. Bir fulfillment sistemi, depo veya üçüncü taraf lojistik iş ortağı kargo şirketini ve takip numarasını gönderdiğinde kaydı tetikleyin. Yenileme ödemesi için bu işlem çok erkendir: sipariş hâlâ gönderilmeyi bekliyor olabilir ve henüz bir takip numarası bulunmayabilir.
- API'yi çağırmadan önce gönderiyi kaydedin. Dahili gönderi kaydını kalıcı olarak saklayın ve kayıt isteğini kuyruğa alın. Aynı fulfillment mesajı iki kez gelirse başka bir paket oluşturmak yerine bu kaydı yeniden kullanın. API çağrısı zaman aşımına uğrarsa, sağlayıcı bunu yapmanıza olanak tanıyorsa yeniden denemeden önce orijinal isteğin başarılı olup olmadığını kontrol edin.
- Güncellemeleri kaydedilen paketle eşleştirin. Güncellemelerde döndürülüyorsa sağlayıcının kayıt tanımlayıcısını kullanın. Aksi hâlde, sağlayıcının belgelerinde belirttiği tanımlayıcılarla eşleştirme yapın ve sonucu gönderi kayıtlarınıza göre doğrulayın. Bir güncelleme birden fazla kayda ait olabilecekse bunu en son siparişe uygulamak yerine incelemeye gönderin.
- Etiket oluşturmayı kargo hareketinden ayırın. Kargo şirketi paketi teslim aldığını kaydetmeden önce bir takip numarası mevcut olabilir. Elinizde yalnızca bir etiket varsa “Kargo şirketinin teslim alması bekleniyor” gibi bir mesaj kullanın. “Yolda” ifadesini bunu destekleyen kargo şirketi bilgileri bulunduğunda kullanın.
17TRACK Tracking API bu kurulum için seçeneklerden biridir. geliştirici belgeleri, takip numaralarının kaydedilmesi ve takip güncellemelerinin alınması için referanstır. Sisteminizdeki paket kaydını güncel tutmak için bu güncellemeleri kullanın; döngü ataması, siparişin tamamlanması ve müşteri bildirim kurallarını e-ticaret uygulamanızda tutun. Yayına almadan önce yalnızca bir kargo şirketi listesine güvenmek yerine gerçek kargo rotalarınızdan ve fulfillment iş ortaklarınızdan gelen paketlerle test yapın.
Güncellemelerin iki kez güvenle işlenmesini sağlayın
Sağlayıcınız webhook sunuyorsa her paketi sürekli sorgulamak yerine güncellemeleri almak için bunları kullanın. Webhook, sağlayıcının uygulamanıza gönderdiği bir HTTP isteğidir. Sağlayıcının doğrulama gerekliliklerini izleyin, kabul edilen payload'ları kalıcı olarak saklayın ve istekleri belgelenmiş yanıt kurallarına göre onaylayın. Sipariş görünümlerini güncellemek veya e-posta göndermek gibi daha yavaş işlemleri istek işleyicisinin dışında çalıştırın.
İşleme yolunu, yinelenen bir güncellemenin ek bir etkisi olmayacak şekilde oluşturun. Sağlayıcı kararlı etkinlik kimlikleri sunuyorsa bunları tekrarları tanımak için kullanın. Sağlayıcı tek tek etkinlikler yerine takip anlık görüntüleri gönderiyorsa, işlem yapmadan önce gelen durumu ve tarama geçmişini mevcut verilerinizle karşılaştırın. Müşteri mesajlarının tekrarını ayrıca önleyin: zaten gönderilmiş bir teslimat bildirimi, aynı gönderi verileri iki kez işlendi diye yeniden gönderilmemelidir.
Bir taramanın gerçekleştiği zamanı, uygulamanızın onu aldığı zamandan ayrı tutun. Geç ulaşan bir yoldaki tarama, daha yeni bir teslim edildi durumunun yerine geçmeden paket geçmişine eklenebilir. Ancak her geçerli değişikliğin paketi ileriye taşıdığını varsaymayın. Kargo şirketinin düzeltmesi veya göndericiye iade güncellemesi, gösterdiğiniz bilgileri değiştirmeyi gerektirebilir. Yeni veriler kayıtlı durumla çelişiyor ve hangisinin doğru olduğunu belirleyemiyorsanız gönderiyi inceleme kuyruğuna alın.
Dikkat gerektirebilecek açık gönderiler için düzenli bir kontrol çalıştırın: hâlâ bekleyen kayıtlar, beklenen teslim aşamasından sonra ilk taraması olmayan paketler ve takibi sessizleşen gönderiler. API bir arama veya yenileme özelliğini destekliyorsa bunu sağlayıcının sınırları dâhilinde seçici biçimde kullanın. Bir durumu yükseltmeden önce kargo şirketleri ve depolar arasındaki örüntüyü kontrol edin. Birbiriyle ilgisiz birçok gönderide güncellemeler aynı anda durursa tek tek teslimat vakaları açmadan önce entegrasyonu araştırın.
Takip verilerini yararlı müşteri mesajlarına dönüştürün
Müşterilerin her tarama için nadiren e-postaya ihtiyacı olur. Mesajları, bilmeleri veya yapmaları gereken bir şeyle bağlantılı olarak başlatın: paket kargo şirketinin ağına girdi, teslimat denemesi işlem gerektiriyor veya kargo şirketi teslimatı bildirdi. Abonelerin mesajın hangi gönderiyle ilgili olduğunu anlayabilmesi için sipariş referansını ve ilgili kutuyu veya döngüyü gösterin. Bölünmüş bir siparişte paketi belirtin ve siparişin geri kalanının hâlâ yolda olup olmadığını açıkça ifade edin.
- Etiket oluşturuldu, tarama yok: Beklenen teslim aşamasını depo kayıtlarıyla karşılaştırın. Teslim penceresi geçtiyse müşteriye yolda gecikme olduğunu söylemeden önce fulfillment ekibinden paketin tesisten çıkıp çıkmadığını doğrulamasını isteyin.
- Takip ilerlemeyi durdurdu: Her paket için tek bir zamanlayıcı kullanmak yerine rotayı ve hizmeti yansıtan eşikler kullanın. Sınır ötesi gönderilerde müşteriye ulaşmaya veya durumu yükseltmeye karar vermeden önce son kargo şirketi etkinliğini inceleyin.
- Başarısız deneme veya teslim alma gerekiyor: Kargo şirketi açık talimatlar sağlıyorsa müşteriye hangi işlemin gerektiğini bildirin. Etkinlik belirsizse yeniden teslimat tarihi veya teslim alma konumu hakkında tahminde bulunmak yerine vakayı desteğe yönlendirin.
- Teslim edildi olarak işaretlendi ancak alınmadı: Kargo şirketinin bildirdiği durumu koruyun ve ayrı bir destek vakası açın. Destek iş akışınız, müşteri bildirimini kargo şirketinin düzeltmesinden ayırmalıdır.
Destek çalışanlarına döngünün, siparişin, paket geçmişinin ve daha önce gönderilmiş mesajların tek bir görünümünü sunun. Her istisna için bir sorumlu ve sonraki adımı atayın. Fulfillment ekibi eksik bir teslim aşamasını araştırabilir, lojistik ekibi bir kargo şirketi istisnasını takip edebilir ve destek ekibi müşteri iletişimini yönetebilir. Bir takip durumu paketi açıklar; değişim veya para iadesi gerekip gerekmediğine karar vermez.
Yayına almadan önce çakışmayı test edin
Bir fulfillment iş ortağıyla ve iş ortağının siparişleri gerçekte nasıl gönderdiğini yansıtan bir gönderi grubuyla başlayın. Birden fazla paket içeren bir döngüyü, geçersiz kılınmış bir etiketi, bir değişimi ve sonraki döngü gönderildiğinde hâlâ açık olan daha eski bir gönderiyi dahil edin. Ardından yinelenen bir webhook'u bilerek yeniden oynatın ve daha yeni bir etkinlikten sonra daha eski bir etkinlik gönderin. Paket kaydını, müşteri sipariş sayfasını, destek görünümünü ve bildirim günlüğünü kontrol edin. Yalnızca başarılı bir API yanıtını doğrulayan bir test, en maliyetli hatayı gözden kaçırabilir: yanlış siparişi güncellemek veya yanlış müşteriye mesaj göndermek.
Kayıt başarısızlıklarını, başarıyla kaydedilen uygun paketlerin oranını, beklenenden geç gerçekleşen ilk taramaları ve eşleştirilemeyen güncellemeleri izleyin. Güncelleme gecikmesini takip ediyorsanız kargo şirketi etkinliği ile alım arasındaki süreyi, kendi sisteminizin bunu işleme süresinden ayırın. Bu, bir kargo şirketi akışını, webhook uç noktanızı veya uygulamanızdaki bir kuyruğu araştırmanız gerekip gerekmediğine karar vermenize yardımcı olur.
Daha fazla rotaya geçmeden önce herhangi bir paket için üç soruyu yanıtlayabildiğinizden emin olun: Hangi döngüye ait? Kargo şirketi en son ne bildirdi? Güncelleme eksik veya hatalıysa kim harekete geçer? Herhangi bir yanıt belirsizse daha fazla bildirim kuralı eklemeden önce kayıt eşleştirmesini veya istisna iş akışını düzeltin.
SSS
Bir takip API'si müşterilere bir sonraki abonelik kutularının ne zaman gönderileceğini söyleyebilir mi?
Bir sonraki planlanan gönderim tarihi için abonelik programınızı ve fulfillment sisteminizi kullanın. Takip API'si, takip bilgileri mevcut olduğunda belirli bir paket içindir. Planlanan gönderim tarihi, kargo şirketinin teslimat tahmini ve teyit edilmiş teslimat farklı gerçeklerdir ve ayrı şekilde etiketlenmelidir.
Bir e-posta gönderildikten sonra depo takip numarasını değiştirirse ne olur?
Eski etiketi geçersiz kılınmış olarak işaretleyin ve yeni takip numarasını aynı siparişe bağlayın. E-postanız sipariş düzeyinde bir takip sayfasına yönlendiriyorsa müşterinin orijinal kargo şirketi bağlantısına ihtiyaç duymadan aktif paketi bulabilmesi için bu sayfayı güncelleyin. Değişiklik, müşterinin işlem yapmak için ihtiyaç duyduğu bilgileri etkiliyorsa bir düzeltme gönderin.
Bir fulfillment iş ortağı kargo şirketi kodları olmadan takip numaraları gönderirse ne olur?
İş ortağından tutarlı bir kargo şirketi alanı veya gönderim hizmeti kodları için bir eşleme isteyin. API'niz kargo şirketi algılaması sunuyorsa buna güvenmeden önce iş ortağının etiketleriyle nasıl çalıştığını doğrulayın. Belirsiz eşleşmeleri, yalnızca takip numarasına göre bir kargo şirketi seçmek yerine incelemeye yönlendirin.
Duraklatılan veya atlanan aboneliklerin takip kayıtlarına ihtiyacı var mı?
Hiç gönderilmeyen bir döngü için paket kaydı gerekmez. Önceki bir gönderi hâlâ açıksa abonelik duraklatılmış, atlanmış veya iptal edilmiş olsa bile onu takip etmeye devam edin. Abonelik durumu gelecekteki fulfillment sürecini kontrol eder; depodan zaten ayrılmış bir pakete ne olduğunu göstermez.
Kaynaklar
- 17TRACK Tracking API — paket takibini işletme sistemlerine entegre etmek için ürün genel görünümü.
- 17TRACK Tracking API documentation — takip numaralarını kaydetmek ve takip verilerini almak için uygulama referansı.
- Stripe webhook documentation — yinelenen etkinlikleri işleme ve teslimat sırasıyla ilgili varsayımlardan kaçınma gibi genel webhook uygulamaları için referans. Doğrulama ve onaylama konusunda kendi takip sağlayıcınızın kurallarını izleyin.


