Skip to main content
AnasayfaBlogKılavuzlarİade platformlarının iade gönderilerini takip etmek için Shipment Tracking API'yi kullanma şekli

İade platformlarının iade gönderilerini takip etmek için Shipment Tracking API'yi kullanma şekli

17TRACK

İade platformları, onaylanmış bir iadeyi fiziksel gönderisiyle ilişkilendirmek için bir gönderi takip API'si kullanır. Platform, iade gönderisinin taşıyıcısını ve takip kimliğini kaydeder, takip olaylarını alır ve ilerlemeyi göstermek veya operasyonel inceleme başlatmak için bu olaylardan yararlanır. API, gönderi görünürlüğü sağlar; iade platformu ise iade talebinin, politika kararlarının, depo incelemesinin ve geri ödeme iş akışının sorumluluğunu üstlenmeye devam eder.

İade Platformları Gönderi Takip API’sini Nasıl Kullanır

İade operasyonları veya ürün ekibi için yararlı soru, bir API'nin yalnızca takip durumunu gösterip gösteremeyeceği değildir. Asıl soru, entegrasyonun doğru iade gönderisini güvenilir biçimde tanımlayıp tanımlayamadığı, aldığı olayları yorumlayıp yorumlayamadığı ve bir takip güncellemesinin yanlış müşteri mesajını veya geri ödeme işlemini tetiklemesini önleyip önleyemediğidir.

Takip, iadeye nasıl dahil olur?

İade bir iş kaydı olarak başlar: müşteri bir ürünü geri göndermek ister ve satıcı neyi onaylayacağına karar verir. Takip kaydı ise farklı bir şeyi, bir paketin hareketini açıklar. Bu iki kaydı birbirine bağlamak, iade platformunun müşterinin paketi taşıyıcıya teslim etmiş görünüp görünmediği, paketin iade adresine doğru ilerleyip ilerlemediği ve bir teslimat olayının bildirilip bildirilmediği gibi soruları yanıtlamasını sağlar.

Bu bağlantı açıkça kurulmalıdır. Bir sipariş birden fazla ürün içerebilir, müşteri aynı sipariş için birden fazla iade yapabilir ve tek bir iade birden fazla paket içerebilir. İlk gönderiye ait takip numarası, iade takip numarasıyla karıştırılmamalıdır. Uygulanabilir bir veri modeli; sipariş, iade yetkilendirmesi, iade paketi, taşıyıcı ve takip kaydı için ayrı kimlikler tutmalı, ardından bunlar arasındaki ilişkileri saklamalıdır.

Takibin de net bir sınırı vardır. Bir taşıyıcının teslimat olayı, paketin bir adrese veya tesise ulaştığını gösterebilir. Ancak beklenen ürünün depoya teslim alındığını, ürünü incelemeden geçtiğini veya geri ödemenin yapılması gerektiğini kanıtlamaz. Bu kararlar kendi kanıtlarına ve kurallarına ihtiyaç duyar.

Yetkilendirmeden teslim almaya entegrasyon akışı

1. Paketi takip etmeden önce iade kaydını oluşturun

İade platformu önce talebi, ilgili ürünleri, yetkilendirilen adresi ve izin verilen çözümü kaydeder. İadede satıcı tarafından oluşturulan bir etiket kullanılıyorsa platform, etiketin takip kimliğini iade paketiyle ilişkilendirebilir. Müşteri gönderimi bağımsız olarak düzenliyorsa platformun izleme başlamadan önce taşıyıcıyı ve takip numarasını toplamak ve doğrulamak için bir yönteme ihtiyacı olabilir.

Veri kalitesinin görünürlüğü etkilediği ilk nokta budur. Güvenilir bir paket-iade ilişkisi olmadan kullanılan takip numarası, yanlış iade için tamamen doğru bir taşıyıcı güncellemesi oluşturabilir. Ekipler ayrıca düzeltilen takip numaralarını, yenilenen etiketleri ve aynı kimliği iki kez gönderen müşterileri nasıl ele alacaklarına karar vermelidir.

2. Gönderiyi kaydedin veya arayın

Platform, bir gönderi kaydı oluşturmak veya mevcut kaydı almak için seçilen takip sağlayıcısının gerektirdiği bilgileri gönderir. Tam istek alanları ve sıralama, sağlayıcının belgelerine bağlıdır. En azından uygulamanın, sağlayıcının gönderi referansını kendi iade paketi kaydıyla güvenilir biçimde ilişkilendirmesi gerekir. Taşıyıcı kimliği gerekiyorsa platform, yalnızca takip numarasının yeterli olduğunu varsaymak yerine belirsiz veya desteklenmeyen taşıyıcı bilgilerinin nasıl ele alındığını doğrulamalıdır.

Sağlayıcı yanıtını, entegrasyon hatalarını ve platformun izlemeye başladığı tarihi saklayın. Kabul edilen bir istek, taşıyıcının paketi taradığı anlamına gelmez. İlk taramadan önce müşteriye gösterilen durum, iadenin taşınmakta olduğunu söylemek yerine takibin beklemede olduğunu belirtmelidir.

3. İlk olayı kaybetmeden güncellemeleri alın

API'ye bağlı olarak güncellemeler webhook aracılığıyla gelebilir, yoklama yöntemiyle alınabilir veya belgelenmiş başka bir yöntem kullanılabilir. Entegrasyon, iade platformunda gösterilen sadeleştirilmiş durumun yanında sağlayıcının ham olay bilgilerini de korumalıdır. Yararlı alanlar arasında olay açıklaması, olay zamanı, sağlanmışsa konum, taşıyıcı referansı ve platformun güncellemeyi aldığı zaman bulunabilir.

Bu iki zaman farklı soruları yanıtlar. Olay zaman damgası bir etkinliğin ne zaman gerçekleştiğinin bildirildiğini, alım zaman damgası ise iade platformunun bunu ne zaman öğrendiğini gösterir. Aksi hâlde gecikmeler, tekrarlanan teslimatlar ve sırası bozulmuş mesajlar iadenin geriye doğru ilerliyor gibi görünmesine neden olabilir. Sağlayıcı olay kimlikleri sunuyorsa bunları yinelenen kayıtları ayıklamak için kullanın. Sunmuyorsa dikkatli bir tekilleştirme yöntemi tanımlayın ve bunu gerçek entegrasyon örnekleriyle test edin.

4. Takip olaylarını iade durumlarına dönüştürün

Taşıyıcı olay açıklamaları bir iade politikası değildir. İade platformu bunları genellikle teslim bekleniyor, taşımada, teslimat bildirildi veya inceleme gerekiyor gibi daha küçük bir operasyonel durum kümesine eşler. Eşleme, tanınmayan her güncellemeyi sessizce ilerleme olarak değerlendirmek yerine bilinmeyen olayları da hesaba katmalıdır.

Örneğin ilk taşıyıcı taraması, müşteriye paketinin yolda göründüğünü söylemek için yeterli olabilir. Ancak geri ödeme tarihi sözü vermek için yeterli olmayabilir. Bir teslimat olayı, deponun eşleşen pakete öncelik vermesine yardımcı olabilir; yine de geri ödeme kuralı fiziksel teslim alma ve inceleme gerektirebilir. Ekipler, durumları otomatik işlemlere bağlamadan önce bu ayrımları iş akışına yazmalıdır.

5. Depo kanıtlarıyla süreci tamamlayın

Bir paket ulaştığında depo veya iade tesisi dahili bir barkodu tarayabilir, paketi iade yetkilendirmesiyle eşleştirebilir, içeriğini inceleyebilir ve sonucu kaydedebilir. Bunlar taşıyıcı takip olayları değil, iade yönetimi olaylarıdır. Her iki sistem bağlı olduğunda platform daha yararlı bir sıra gösterebilir: gönderi hareketi, taşııcı tarafından bildirilen teslimat, tesis tarafından alınan paket ve tamamlanan işlem.

Bu sıra istisnelerin çözülmesine de yardımcı olur. Takip teslimatı bildiriyor ancak depo teslim alma kaydı görünmüyorsa operatör, müşteriye yönelik bir bildirimde bulunmadan önce varış yerini, taşıyıcı olayını, tesisin kabul kuyruğunu ve paket kimliğini inceleyebilir. Depo kullanılabilir bir takip geçmişi olmayan bir paket alırsa fiziksel teslim alma yine de kaydedilebilir; eksik takip verileri bağımsız depo kanıtlarını silmemelidir.

Bir takip API'si platforma ne söyleyebilir, ne söyleyemez?

Bir gönderi takip API'si, sağlayıcının belgelenmiş kapsamı, olay kullanılabilirliği ve entegrasyon davranışına bağlı olarak taşıyıcı tarafından bildirilen hareketleri başka bir uygulamaya sunabilir. Ancak tek başına iadenin içeriğini doğrulayamaz veya satıcının politikasının karşılanıp karşılanmadığına karar veremez. İlk taşıyıcı taramasından önce bildirilecek bir güncellemesi de olmayabilir.

Otomasyon tasarlanırken bu ayrım önemlidir. Durumlar, birbirinin yerine geçebilen kanıtlar olarak değil, tanımlanmış kullanım alanlarına sahip sinyaller olarak ele alınmalıdır. Bir taşıyıcı teslim alma olayı ilerleme bildirimi başlatabilir. Bir teslimat olayı depo takip görevi oluşturabilir. Doğrulanmış bir depo teslim alımı iadeyi incelemeye yönlendirebilir. Geri ödeme veya değişim kararı, satıcının gerçek kurallarını ve bu kuralların gerektirdiği kanıtları izlemelidir.

Müşteriye yönelik dil de aynı sınırı yansıtmalıdır. İnceleme yapılmamışsa “Geri ödemenizi onayladık” yerine “Taşıyıcı, iadenizin teslim edildiğini bildiriyor” ifadesi daha doğrudur. Benzer şekilde “İlk taşıyıcı güncellemesini bekliyoruz” ifadesi, açıklanmayan boş bir takip sayfasından daha bilgilendiricidir.

Önlenebilir iade takip hatalarını engelleyen tasarım kontrolleri

  • Paket düzeyinde eşleştirin. Bölünmüş iadeleri, tek bir yetkilendirme altındaki birden fazla paketi, yenilenen etiketleri ve tek bir siparişe ilişkin tekrarlanan iadeleri test edin. Her paket kendi takip kaydıyla açıkça ilişkilendirilmelidir.
  • Durum önceliğini tanımlayın. Teslimat olayından sonra daha eski bir taşıma olayı gelirse ne olacağına karar verin. Olay geçmişini koruyun ancak gösterilen iade durumunu otomatik olarak geriletmeyin.
  • Sağlayıcı hatalarını taşıyıcı sessizliğinden ayırın. Kimlik doğrulama hatası, reddedilen istek veya başarısız webhook işleme bir entegrasyon sorunudur. Henüz tarama yapılmamış olması farklı bir durumdur ve farklı iletilmelidir.
  • Yinelenen kayıtları ve yeniden denemeleri planlayın. Teslimat güncellemesi tekrarlanabilir. Olay alımını yeniden denemeye dayanıklı hâle getirin ve aynı müşteri bildirimini iki kez göndermekten veya aynı görevi iki kez oluşturmaktan kaçının.
  • Müşteri ve gönderi verilerini koruyun. Takip kimlik bilgilerine erişimi kısıtlayın, yalnızca iş akışının ihtiyaç duyduğu verileri saklayın ve kullanıma almadan önce sağlayıcının belgelenmiş kimlik doğrulama ve güvenlik gereksinimlerini inceleyin.
  • Manuel bir yol bırakın. Bazı iadelerde takip bilgileri eksik, geç veya uyumsuz olabilir. Operatörlerin taşıyıcı olayları uydurmadan iade kaydını inceleyip düzeltmesini sağlayan bir yöntem bulunmalıdır.

Bu kontroller, tek bir başarılı gönderi yerine somut senaryolarla test edildiğinde en yararlı hâle gelir. Küçük bir test kümesinde ilk taramanın olmaması, yanlış takip numarası, yinelenen olay, sırası bozulmuş olay, depo teslim alımı olmadan teslimat bildirimi ve eşleşen teslimat bildirimi olmadan depo teslim alımı bulunmalıdır. Her durum için beklenen müşteri mesajı ve operatör işlemi belirlenmelidir.

API'yi seçme ve iş bölümünü tanımlama

İşletmenin gerçekten kullandığı iade rotaları ve taşıyıcılarla başlayın. Ardından sağlayıcının güncel belgelerinde gönderi kaydının nasıl çalıştığını, hangi kimliklerin gerekli olduğunu, güncellemelerin nasıl iletildiğini, hangi olay verilerinin sunulduğunu ve hatalarla yeniden denemelerin nasıl ele alındığını doğrulayın. Taşıyıcı kapsamına ilişkin genel bir ifadeden sonuç çıkarmak yerine ilgili taşıyıcıları ve iade rotalarını doğrudan doğrulayın. Müşteri iletişimi veya otomasyon için eşlenmiş durumlara güvenmeden önce temsili gönderilerle test yapın.

17TRACK, bir Tracking API genel bakışı ve API belgeleri yayımlar; 17RETURNS ürün sayfası ise iş akışının iade yönetimi tarafını ele alır. Bunlar, takip görünürlüğünü iade süreciyle birlikte değerlendiren bir ekip için uygun başlangıç noktalarıdır. Her iki ürün alanının bulunması, belirli bir entegrasyonun, taşıyıcının, olayın veya otomatik geri ödeme kuralının mevcut olduğunun kanıtı olarak görülmemelidir. Tam iş akışını güncel belgelerde ve gerektiğinde sağlayıcıyla doğrulayın.

Satın alma veya kavram kanıtı sürecinde, iade politikasından ve depo operasyonlarından sorumlu ekibin durum eşlemesini mühendislikle birlikte incelemesini isteyin. Mühendislik API'nin kullanılabilir olaylar sağlayıp sağlamadığını doğrulayabilir; operasyon ekibi bu olayların önerilen işlemi haklı çıkarıp çıkarmadığını değerlendirebilir. Başarılı entegrasyon, yetkilendirme, teslim alma, inceleme ve çözümü birbirinden ayrı adımlar olarak korurken personelin ve müşterilerin paketi takip etmesine yardımcı olandır.

SSS

Bir iadenin orijinal siparişten farklı bir takip numarasına ihtiyacı var mı?

Platform, çıkış ve iade gönderisi kayıtlarını ayrı tutmalıdır. İade genellikle ayrı bir gönderi olarak taşındığından takip kimliği, orijinal siparişin çıkış kimliği olduğu varsayılmadan iade paketiyle ilişkilendirilmelidir. Kullanılabilen tam kimlikler, iadenin nasıl gönderildiğine bağlıdır.

Bir takip API'si geri ödeme yapılması gerektiğini doğrulayabilir mi?

Hayır. Hiçbir takip olayı tek başına iade edilen ürünün satıcının geri ödeme koşullarını karşıladığını doğrulamaz. Platform, taşıyıcı olaylarını bir iş akışına girdi olarak kullanabilir; ancak geri ödeme uygunluğu yetkilendirmeye, fiziksel teslim almaya, incelemeye ve satıcının politikasına da bağlı olabilir.

Takip teslimatı gösteriyor ancak depo paketi bulamıyorsa ne olur?

Taşıyıcı tarafından bildirilen teslimat olayını depo teslim alma kaydından ayrı tutun. Bildirilen varış yerini ve olay ayrıntılarını kontrol edin, ardından tesisin kabul ve eşleştirme sürecini inceleyin. Taşıyıcı teslimatını sessizce doğrulanmış depo teslim alımına dönüştürmeyin.

İade gönderilerini takip etmek için webhook'lar gerekli mi?

Gerekli olmayabilir. Güncelleme yöntemi seçilen sağlayıcıya ve belgelenmiş seçeneklerine bağlıdır. Webhook'lar mevcutsa kimlik doğrulama, yeniden denemeler, yinelenen teslimatlar ve işleme hatalarını planlayın. Yoklama kullanılıyorsa iade iş akışına ve sağlayıcının gereksinimlerine uygun bir aralık ve durdurma kuralı seçin.

Bir müşteri ilk takip güncellemesini ne zaman görmelidir?

Bu, taşıyıcının bir olayı ne zaman bildirdiğine ve entegrasyonun bunu ne zaman aldığına bağlıdır. Etiket oluşturma veya gönderi kaydetme işlemi, taşıyıcı taramasından önce gerçekleşebilir. Müşterilerin bekleyen ilk güncellemeyi doğrulanmış hareket olarak yorumlamaması için bu ayrımı açıkça gösterin.

Kaynaklar