Skip to main content
AnasayfaBlogKılavuzlar3Pl ve sipariş karşılama sağlayıcılarının müşteri hesapları genelinde Shipment Tracking API'yi kullanma şekli

3Pl ve sipariş karşılama sağlayıcılarının müşteri hesapları genelinde Shipment Tracking API'yi kullanma şekli

17TRACK

3PL ve sipariş karşılama sağlayıcıları, birden fazla müşteriye ait gönderiler için taşıyıcı güncellemelerini toplamak ve ardından her güncellemeyi doğru müşteri hesabına, siparişe, destek ekibine ve raporlama görünümüne yönlendirmek amacıyla bir gönderi takip API'si kullanır. API takip verilerini sağlar; sağlayıcının kendi sistemi müşteri sahipliğini korumalı, erişimi kontrol etmeli, istisnaları ele almalı ve her müşterinin ve alışveriş yapan kişinin neleri görebileceğine karar vermelidir.

3PL ve Sipariş Karşılama Sağlayıcıları Gönderi Takip API'sini Nasıl Kullanır

Bu ayrım, tek bir depo operasyonu birçok satıcıya hizmet verdiğinde önem kazanır. Yalnızca takip numarası bir müşteri hesabı tanımlayıcısı değildir. Hesaplar arasında güvenilir görünürlük sağlamak için sipariş karşılama sağlayıcısının her gönderinin kime ait olduğuna dair bir kayda ve taşıyıcı güncellemelerini müşteriye özel bilgilere dönüştürmek için tekrarlanabilir bir sürece ihtiyacı vardır.

Temel iş akışı: kaydetme, alma, yönlendirme, işlem yapma

İşlem sahibi genellikle 3PL'nin operasyon veya mühendislik ekibidir. Takip hizmetini bir kez entegre eder; ardından takip kayıtlarını tek tek müşterilerle ilişkilendirmek için depo yönetim sistemini, sipariş yönetim sistemini veya entegrasyon katmanını kullanır. Uygulanabilir bir iş akışı dört aşamadan oluşur:

  1. Gönderiyi kaydedin. Bir etiket oluşturulduğunda veya bir paket taşıyıcıya teslim edildiğinde sağlayıcı; takip numarasını, mevcutsa taşıyıcı bilgilerini, müşteri hesap kimliğini, sipariş referansını ve dahili gönderi kimliğini saklar. Takip ayrıntılarını, sağlayıcının belgelenmiş yöntemini kullanarak takip entegrasyonuna gönderir.
  2. Güncellemeleri alın. Entegrasyon yeni takip bilgilerini API'nin gerçekten desteklediği yöntemlerle alır. Hizmete ve yapılandırmaya bağlı olarak bu işlem mevcut durum sorgularını, değişiklik bildirimlerini veya her ikisini içerebilir.
  3. Yönlendirin ve yorumlayın. Sağlayıcı, döndürülen takip kaydını dahili gönderi kimliği ve müşteri hesabıyla eşleştirir. Taşıyıcının mesajını saklar ve yararlı ayrıntıları kaybetmeden sınırlı sayıdaki operasyonel duruma eşler.
  4. İşlem yapın. Doğru müşteri ilerlemeyi görüntüleyebilir, müşteri hizmetleri bir soruyu yanıtlayabilir ve operasyon ekibi bir istisnayı inceleyebilir. Alışveriş yapan kişilere yönelik güncellemelerde ilgili müşterinin onayladığı kanallar ve mesaj kuralları kullanılmalıdır.

Temel tasarım kararı ilk API isteğinden önce verilir: her gönderinin 3PL kayıtlarında açıkça belirlenmiş bir sahibi olmalıdır. Bu bağlantı olmadan takip yanıtı teknik olarak doğru olsa bile kullanılamaz olabilir veya yanlış satıcı tarafından görülebilir.

Müşteri sahipliğini takip kimliğinden ayrı tutun

Çok müşterili bir veri modeli müşteri hesabını, siparişi, dahili gönderiyi, taşıyıcıyı ve takip tanımlayıcısını birbirinden ayırmalıdır. Bunlar birbiriyle ilişkilidir ancak birbirlerinin yerine kullanılamaz. Bir sipariş birden fazla paket oluşturabilir; bir pakette anlamlı taşıyıcı taramaları görünmeden önce takip numarası bulunabilir ve bir müşteri farklı siparişlerde farklı taşıyıcılar kullanabilir.

Örneğin bir depo, bir satıcının siparişi için iki paket gönderirse sipariş sayfasında iki ayrı gönderi zaman çizelgesi gösterilmesi gerekebilir. Paketlerden biri teslimat istisnasıyla karşılaşırsa 3PL, tüm siparişi teslim edilemez olarak işaretlemek yerine etkilenen paketi belirlemelidir. Müşteriye görünen sipariş referansları müşteriler arasında benzersiz olmadığında bile dahili gönderi kimliği bu kayıtlar için kararlı bir birleştirme noktası sağlar.

Müşteri hesap kimliğini gönderi kaydıyla birlikte saklayın ve kayıt oluşturulurken, alınırken, dışa aktarılırken veya başka bir sisteme gönderilirken erişim kontrollerini uygulayın. Tek yetkilendirme anahtarı olarak takip numarasına güvenmeyin. Takip numaraları operasyonel tanımlayıcılardır, kimlik bilgileri değildir; ortak bir kontrol paneli, bir kullanıcının bir numarayı bilmesi nedeniyle bir satıcının siparişlerini açığa çıkarmamalıdır.

Müşteriler kendi taşıyıcılarını yönetiyor veya kendi kimlik bilgilerini sağlıyorsa bu kimlik bilgilerinin nerede tutulacağına ve hangi hesabın bunları kullanabileceğine karar verin. Tek bir takip entegrasyonu, tüm müşterilerin aynı taşıyıcı anlaşmalarını, veri izinlerini veya müşteri iletişim tercihlerini paylaştığı anlamına gelmez. Bu sınırlar yapılandırmaya yansıtılmalı ve test edilmelidir.

Taşıyıcı mesajlarını kullanılabilir müşteri durumlarına dönüştürün

Taşıyıcı olay açıklamaları farklılık gösterir. Bir 3PL; kontrol panelleri ve istisna kuyrukları için etiket oluşturuldu, taşımada, dağıtıma çıktı, teslim edildi ve istisna gibi ortak bir etiket seti kullanmak isteyebilir. Bu eşleme bir uygulama kararıdır; orijinal olayın yerine geçmez. Bir destek temsilcisinin gerçekte ne olduğunu anlayabilmesi için kaynak durumunu, sağlanmışsa olay zamanını, taşıyıcı kimliğini ve mevcutsa konumu koruyun.

Her yeni mesajı ilerleme olarak değerlendirmeyin. Güncellemeler geç gelebilir, önceki taramaları açıklayabilir veya daha önce alınmış bir olayı tekrarlayabilir. Entegrasyon her gelen güncelleme için bunun bilinen bir gönderiye ait olup olmadığını, yinelenip yinelenmediğini ve olay zamanının zaman çizelgesini değiştirip değiştirmediğini kontrol etmelidir. Alınan en son mesaj, gerçekleşen en son olay olmak zorunda değildir.

Benzer şekilde, “teslim edildi” durumu paketin hedeflenen alıcı tarafından şahsen kabul edildiği iddiasına dönüştürülmemelidir. Bir teslimat taramasının anlamı, taşıyıcının olay ayrıntılarına ve bu gönderi için mevcut teslimat kanıtı bilgilerine bağlıdır. Müşteriye yönelik arayüz, verilerin desteklediğinden fazlasını varsaymak yerine sahip olduğu kanıtı göstermelidir.

Yararlı bir yaklaşım, filtreleme için normalleştirilmiş durumu ve inceleme için temel taşıyıcı olayını birlikte tutmaktır. Ortak durum, 3PL'nin birçok müşteri hesabında ilgilenilmesi gereken gönderileri bulmasına yardımcı olur; orijinal ayrıntı ise personelin geniş bir kategoriyi yanlış bir sonuca dönüştürmeden tek bir gönderiyi açıklamasını sağlar.

İstisna yönetimini sorunu kimin çözebileceği etrafında tasarlayın

Takip, ekibin bir sonraki adımını değiştirdiğinde operasyonel olarak değerli hale gelir. Bir teslimat istisnası; müşteriye bildirim, taşıyıcıya sorgu, adres kontrolü veya sonraki tarama beklenirken hemen işlem yapılmamasını gerektirebilir. Doğru yanıt, olaya ve 3PL ile müşterisi arasındaki sorumluluklara bağlıdır.

Uyarılar oluşturulmadan önce yaygın durumlar için sahiplik kurallarını belirleyin. Örneğin 3PL, teslimden önce durmuş görünen bir paketin incelenmesini üstlenebilirken satıcı, alışveriş yapan kişinin teslimat adresini değiştirme talebini ele alabilir. Bunlar olası düzenleme örnekleridir ve evrensel kurallar değildir. Her sağlayıcı kendi hizmet sınırlarını ve eskalasyon yolunu belgelemelidir.

Bildirim kurallarının da güvenlik önlemlerine ihtiyacı vardır. Her tarama için mesaj göndermek personeli ve alışveriş yapan kişileri bunaltabilir. Ancak yinelenen her durumu bastırmak, konumdaki anlamlı bir değişikliği veya yeni bir istisnayı gizleyebilir. Hangi olayların operasyon kuyruğuna gireceğini, hangilerinin yalnızca kontrol panelinde görüneceğini ve hangilerinin müşteri ya da alışveriş yapan kişi iletişimini tetikleyebileceğini tanımlayın. Bir kuralın incelenmesi gerektiğinde personele temel takip zaman çizelgesine erişim verin.

Bir API'yi seçerken veya uygularken neleri doğrulamalısınız?

Bir takip API'si, 3PL'nin çalışanlardan her taşıyıcıyı ayrı ayrı kontrol etmelerini istemek yerine gönderi güncellemelerini kendi sistemlerinde görmesi gerektiğinde uygundur. Satın alma sorusu yalnızca API'nin bir durum döndürüp döndürmediği değildir. Asıl soru, belgelenmiş davranışının sağlayıcının gerçek gönderi karmasını ve hesap iş akışını destekleyip desteklemediğidir.

  • Taşıyıcı ve gönderi uygunluğu: Müşterilerin kullandığı belirli taşıyıcıları ve gönderi hizmetlerini kontrol edin. API'nin bir taşıyıcıyı nasıl tanımladığını ve takip numarası belirsiz olduğunda veya henüz olay bulunmadığında ne olduğunu doğrulayın.
  • Güncelleme iletimi: Değişiklikleri alma seçeneklerini, beklenen istek ve yanıt biçimlerini ve hataların ya da yeniden denemelerin nasıl ele alınması gerektiğini belgelerden inceleyin. Olay bildirimleri mevcutsa bunların kimlik doğrulamasını ve yeniden deneme davranışını doğrulayın; tüm ek istekleri ortadan kaldırdıklarını varsaymayın.
  • Hesap eşleme: Sağlayıcının kendi referansını bir takip kaydına ekleyip ekleyemeyeceğini belirleyin. API özelliklerinden bağımsız olarak takip kaydı ile müşteri hesabı ve gönderi kimliği arasında dahili bir eşleme tutun.
  • Veri ayrıntısı: Operasyon ve destek ekiplerinin ihtiyaç duyduğu olayları, zaman damgalarını, taşıyıcı açıklamalarını, konumları ve teslimat bilgilerini görmek için örnek yanıtları inceleyin. Hangi alanların bulunmayabileceğini doğrulayın.
  • Operasyonel sınırlar: Belgelenmiş kimlik doğrulamasını, kullanım sınırlarını, hata yanıtlarını ve beklenen gönderi hacmiyle ilgili ticari şartları kontrol edin. Amaçlanan istek düzenini test etmeden, maliyetleri öne çıkarılan bir fiyattan tahmin etmeyin.
  • Güvenlik ve saklama: Takip geçmişlerine kimlerin erişebileceğine, kimlik bilgilerinin nasıl korunacağına, kayıtların ne kadar süre saklanacağına ve müşterilerin kendi verilerini nasıl alacağına veya dışa aktaracağına karar verin.

17TRACK'in Takip API'si sayfası ve geliştirici belgeleri, çoklu taşıyıcı takip entegrasyonunu değerlendiren bir sağlayıcı için uygun başlangıç noktalarıdır. Bunların varlığı, hizmetin bir 3PL'nin müşteri izinlerini veya hesap yapısını yönettiği anlamına gelmez. Güncel API davranışını belgelerde ve bir test entegrasyonunda doğrulayın; ardından belirli bir desteklenen düzenleme onaylanmadıkça kiracı sahipliğini ve erişim kontrollerini 3PL'nin kendi uygulamasında uygulayın.

Küçük bir pilot uygulama, özellik listesinden daha fazlasını ortaya çıkarır

Her müşteri hesabını bağlamadan önce, kasıtlı olarak farklı gönderilerden oluşan bir grupla pilot uygulama yapın. Birden fazla müşteriyi, bu müşterilerin gerçekten kullandığı taşıyıcıları, çok paketli bir siparişi, ilk taraması olmayan bir takip numarasını ve hem normal teslimat hem de istisna durumlarına ulaşan gönderileri dahil edin. Testlerin yanlışlıkla alışveriş yapan kişilere mesaj göndermemesi için pilot verilerini üretim iletişimlerinden ayrı tutun.

Her gönderiyi depo kaydından takip kaydına ve müşteri görünümüne kadar izleyin. Somut sorular sorun: Kaydın sahibi doğru hesap mı? Başka bir hesap bu kaydı kontrol paneli, arama, dışa aktarma veya bildirim yoluyla görebiliyor mu? Eski bir tarama olay zaman çizelgesine doğru yerleştirilmiş mi? Takip hizmeti bir isteği geçici olarak reddederse veya yeni bilgi döndürmezse ne olur? Bir destek temsilcisi taşıyıcının orijinal ifadesini hâlâ belirleyebilir mi?

Yanıtları izlenimler olarak değil, kabul kriterleri olarak kaydedin. Başarılı bir pilot, 3PL'nin her gönderinin sahibini belirleyebildiğini, yararlı olayları görüntüleyebildiğini, rutin entegrasyon hatalarından kurtulabildiğini ve istisnaları doğru ekibe yönlendirebildiğini gösterir. Bu koşullar karşılanmıyorsa daha fazla müşteri hesabı eklemek sorunu çözmek yerine büyütür.

En dayanıklı mimari, takibi etrafında müşteriye özel kontroller bulunan ortak bir veri girdisi olarak ele alır. API gönderi bilgilerinin alınmasına yardımcı olur; 3PL ise bu bilgileri siparişlerle birleştirmekten, hesap sınırlarını korumaktan ve bilgileri eyleme dönüştürmekten sorumlu olmaya devam eder.

SSS

Bir 3PL, birden fazla müşteri için tek bir takip API entegrasyonu kullanabilir mi?

API'nin şartları ve teknik modeli amaçlanan kullanımı destekliyorsa potansiyel olarak evet. Ancak 3PL'nin her gönderinin hangi müşteriye ait olduğunu belirlemesi ve bu sınırı tüm sistemlerinde uygulaması gerekir. Tek bir entegrasyonun her düzenlemeye izin verdiğini varsaymak yerine hesap, kimlik bilgisi ve ticari gereklilikleri API sağlayıcısıyla doğrulayın.

Müşteri hesapları aynı takip kontrol panelini paylaşmalı mı?

Aynı temel uygulamayı paylaşabilirler; ancak her müşteri yalnızca erişim yetkisine sahip olduğu gönderileri ve bilgileri görmelidir. Yalıtımı yalnızca ana kontrol paneli sayfasında değil; arama, dışa aktarmalar, bildirimler, destek araçları ve API yanıtlarında da test edin.

Bir takip numarası hemen güncelleme döndürmezse ne olur?

Gönderiyi siparişine ve müşteri hesabına bağlı tutun, doğru bir beklemede durumu gösterin ve yeniden kontrol için API'nin belgelenmiş yönlendirmesini izleyin. Taşıyıcı etkinliği görünmeden önce bir etiket mevcut olabilir; tarama bulunmaması otomatik olarak kayıp paket şeklinde sunulmamalıdır.

Markalı teslimat güncellemeleri göndermek için bir takip API'si yeterli mi?

Hayır. Takip verileri güncellemeyi tetikleyen olayı sağlayabilir; ancak 3PL veya satıcı ayrıca mesajı kimin göndereceğine, hangi müşteri markasının uygulanacağına, hangi alıcılara izin verildiğine ve mesajın ne söylemesi gerektiğine karar vermelidir. Bu iletişim ve hesap kuralları takip olayının kendisinin dışında yer alır.

Çok müşterili bir kullanıma sunumda oluşturulacak ilk kontrol nedir?

Her dahili gönderi kimliği ile sahibi olan müşteri hesabı arasındaki bağlantıyı oluşturun ve test edin. Takip verilerinin görüntülenebildiği veya dağıtılabildiği her yerde bu sahiplik kontrolünü uygulayın. Bu, güvenilir raporlama, destek iş akışları ve hesap yalıtımının temelidir.

Kaynaklar