Qaytarma platformaları qaytarılan göndərişləri izləmək üçün Shipment Tracking API-dən necə istifadə edir
Qaytarma platformaları təsdiqlənmiş qaytarmanı onun fiziki göndərişi ilə əlaqələndirmək üçün göndəriş izləmə API-sindən istifadə edir. Platforma qaytarılan göndərişin daşıyıcısını və izləmə identifikatorunu qeyd edir, izləmə hadisələrini əldə edir və bu hadisələrdən tərəqqini göstərmək və ya əməliyyat yoxlaması tələb etmək üçün istifadə edir. API göndərişin görünürlüğünü təmin edir; qaytarma platforması isə qaytarma sorğusuna, siyasət qərarlarına, anbar yoxlamasına və geri ödəniş prosesinə sahib olmağa davam edir.

Qaytarma əməliyyatları və ya məhsul komandası üçün faydalı sual sadəcə API-nin izləmə statusunu göstərə bilib-bilməməsi deyil. Əsas məsələ inteqrasiyanın düzgün qaytarılan göndərişi etibarlı şəkildə müəyyən edə bilməsi, aldığı hadisələri düzgün şərh etməsi və izləmə yeniləməsinin yanlış müştəri mesajını və ya geri ödəniş əməliyyatını işə salmasının qarşısını almasıdır.
İzləmə qaytarmaya necə inteqrasiya olunur
Qaytarma biznes qeydi kimi başlayır: müştəri məhsulu geri göndərmək istəyir və tacir nəyə icazə veriləcəyinə qərar verir. İzləmə qeydi isə başqa bir şeyi — bağlamanın hərəkətini təsvir edir. Bu iki qeydin əlaqələndirilməsi qaytarma platformasına müştərinin bağlamanı daşıyıcıya təhvil verib-vermədiyi, bağlamanın qaytarma ünvanına doğru hərəkət edib-etmədiyi və çatdırılma hadisəsinin qeydə alınıb-alınmadığı kimi suallara cavab verməyə imkan verir.
Bu əlaqə açıq şəkildə müəyyən edilməlidir. Sifarişdə bir neçə məhsul ola bilər, müştəri eyni sifariş üzrə birdən çox qaytarma yarada bilər və bir qaytarma bir neçə bağlamanı əhatə edə bilər. İlkin çıxış göndərişinin izləmə nömrəsi qaytarma izləmə nömrəsi ilə səhv salınmamalıdır. Praktik məlumat modeli sifariş, qaytarma icazəsi, qaytarma bağlaması, daşıyıcı və izləmə qeydi üçün ayrıca identifikatorlar saxlamalı, sonra isə onların arasındakı əlaqələri qeyd etməlidir.
İzləmənin də aydın sərhədi var. Daşıyıcının çatdırılma hadisəsi bağlamanın ünvana və ya obyektə çatdığını göstərə bilər. Lakin bu, anbarın gözlənilən məhsulu qəbul etdiyini, məhsulun yoxlamadan keçdiyini və ya geri ödənişin edilməli olduğunu təsdiq etmir. Bu qərarlar üçün ayrıca sübutlar və qaydalar tələb olunur.
İnteqrasiya axını: icazədən qəbul edilməyə qədər
1. Bağlamanı izləməzdən əvvəl qaytarma qeydini yaradın
Qaytarma platforması əvvəlcə sorğunu, aidiyyəti məhsulları, icazə verilmiş təyinatı və mümkün həll variantını qeyd edir. Qaytarma tacir tərəfindən təqdim edilmiş etiketdən istifadə edirsə, platforma etiketin izləmə identifikatorunu qaytarma bağlaması ilə əlaqələndirə bilər. Müştəri göndərişi müstəqil şəkildə təşkil edirsə, monitorinq başlamazdan əvvəl daşıyıcı və izləmə nömrəsini toplamaq və yoxlamaq üçün platformaya mexanizm lazım ola bilər.
Məlumat keyfiyyətinin görünürlüğə təsir etdiyi ilk məqam budur. Etibarlı bağlama-qaytarma əlaqəsi olmayan izləmə nömrəsi yanlış qaytarma üzrə tam dəqiq daşıyıcı yeniləməsi yarada bilər. Komandalar düzəldilmiş izləmə nömrələrini, əvəzedici etiketləri və eyni identifikatoru iki dəfə təqdim edən müştəriləri necə idarə edəcəklərinə də qərar verməlidirlər.
2. Göndərişi qeydiyyata alın və ya axtarın
Platforma göndəriş qeydi yaratmaq və ya əldə etmək üçün seçilmiş izləmə provayderinin tələb etdiyi məlumatları göndərir. Dəqiq sorğu sahələri və ardıcıllıq provayderin sənədlərindən asılıdır. Ən azı, provayderin göndəriş istinadını platformanın öz qaytarma bağlaması qeydi ilə etibarlı şəkildə əlaqələndirmək mümkün olmalıdır. Daşıyıcının müəyyənləşdirilməsi tələb olunduqda, platforma yalnız izləmə nömrəsinin kifayət etdiyini düşünmək əvəzinə qeyri-müəyyən və ya dəstəklənməyən daşıyıcı məlumatlarının necə idarə edildiyini dəqiqləşdirməlidir.
Provayderin cavabını, inteqrasiya xətalarını və platformanın monitorinqə başladığı tarixi saxlayın. Qəbul edilmiş sorğu daşıyıcının bağlamanı skan etdiyini mütləq sübut etmir. İlk skandan əvvəl müştəriyə göstərilən status qaytarmanın yolda olduğunu deyil, izləmənin gözlənildiyini bildirməli ola bilər.
3. İlkin hadisəni itirmədən yeniləmələri qəbul edin
API-dən asılı olaraq yeniləmələr webhook vasitəsilə gələ, sorğu ilə əldə edilə və ya sənədləşdirilmiş başqa üsuldan istifadə edə bilər. İnteqrasiya provayderin xam hadisə məlumatlarını qaytarma platformasında göstərilən sadələşdirilmiş statusla birlikdə saxlamalıdır. Faydalı sahələrə hadisənin təsviri, hadisə vaxtı, təqdim edildikdə məkan, daşıyıcı istinadı və platformanın yeniləməni aldığı vaxt daxil ola bilər.
Bu iki vaxt müxtəlif suallara cavab verir. Hadisə vaxtı fəaliyyətin nə vaxt baş verdiyinin bildirildiyini göstərir; qəbul vaxtı isə qaytarma platformasının bunu nə vaxt öyrəndiyini göstərir. Gecikmələr, təkrar çatdırılmalar və ardıcıllığı pozulmuş mesajlar əks halda qaytarmanın geriyə getdiyi təəssüratını yarada bilər. Provayder hadisə identifikatorları təqdim edirsə, dublikatların qarşısını almaq üçün onlardan istifadə edin. Təqdim etmirsə, ehtiyatlı dublikat aşkarlama üsulu müəyyənləşdirin və onu real inteqrasiya nümunələri ilə sınaqdan keçirin.
4. İzləmə hadisələrini qaytarma statuslarına çevirin
Daşıyıcı hadisələrinin təsvirləri qaytarma siyasəti deyil. Qaytarma platforması adətən onları təhvil gözlənilir, yoldadır, çatdırılma bildirilib və ya yoxlama tələb olunur kimi daha az sayda əməliyyat statusuna uyğunlaşdırır. Uyğunlaşdırma naməlum hadisələri də nəzərə almalı və tanınmayan hər yeniləməni səssizcə irəliləyiş kimi qəbul etməməlidir.
Məsələn, daşıyıcının ilk skanı müştəriyə bağlamasının yolda göründüyünü bildirmək üçün kifayət edə bilər. Lakin bu, geri ödəniş tarixini vəd etmək üçün kifayət etməyə bilər. Çatdırılma hadisəsi anbara uyğun bağlamaya üstünlük verməyə kömək edə bilər, amma geri ödəniş qaydası hələ də fiziki qəbul və yoxlama tələb edə bilər. Komandalar statusları avtomatlaşdırılmış əməliyyatlara bağlamazdan əvvəl bu fərqləri iş axınına yazmalıdırlar.
5. Anbar sübutları ilə prosesi tamamlayın
Bağlama gəldikdən sonra anbar və ya qaytarma obyekti daxili barkodu skan edə, bağlamanı qaytarma icazəsi ilə uyğunlaşdıra, məzmunu yoxlaya və nəticəni qeyd edə bilər. Bunlar qaytarma idarəetməsi hadisələridir, daşıyıcı izləmə hadisələri deyil. Hər iki sistem əlaqələndirildikdə platforma daha faydalı ardıcıllıq göstərə bilər: göndərişin hərəkəti, daşıyıcının bildirdiyi çatdırılma, obyekt tərəfindən bağlamanın qəbulu və qərarın tamamlanması.
Bu ardıcıllıq istisnaların həllinə də kömək edir. İzləmə çatdırılmanı göstərir, lakin anbar qəbzi görünmürsə, operator müştəriyə açıqlama verməzdən əvvəl təyinatı, daşıyıcı hadisəsini, obyektin qəbul növbəsini və bağlama identifikatorunu araşdıra bilər. Anbar istifadəyə yararlı izləmə tarixçəsi olmayan bağlama alarsa, fiziki qəbul yenə də qeyd edilə bilər; çatışmayan izləmə məlumatı müstəqil anbar sübutunu silməməlidir.
İzləmə API-si platformaya nə deyə bilər və nə deyə bilməz
Göndəriş izləmə API-si provayderin sənədləşdirilmiş əhatə dairəsi, hadisələrin əlçatanlığı və inteqrasiya davranışı çərçivəsində daşıyıcının bildirdiyi hərəkəti başqa tətbiq üçün əlçatan edə bilər. Lakin API təkbaşına qaytarmanın məzmununu yoxlaya və tacirin siyasət şərtlərinə əməl edilib-edilmədiyinə qərar verə bilməz. İlk daşıyıcı skanından əvvəl onun bildirəcəyi heç bir yeniləmə də olmaya bilər.
Avtomatlaşdırma layihələndirilərkən bu fərq vacibdir. Statuslar bir-birini əvəz edən sübut kimi deyil, müəyyən edilmiş istifadə sahələri olan siqnallar kimi qəbul edilməlidir. Daşıyıcıya təhvil hadisəsi irəliləyiş bildirişini işə sala bilər. Çatdırılma hadisəsi anbar üçün izləmə tapşırığı yarada bilər. Təsdiqlənmiş anbar qəbzi qaytarmanı yoxlamaya yönəldə bilər. Geri ödəniş və ya mübadilə qərarı tacirin faktiki qaydalarına və həmin qaydaların tələb etdiyi sübutlara əsaslanmalıdır.
Müştəriyə yönəlmiş dil də eyni sərhədi əks etdirməlidir. Yoxlama aparılmayıbsa, “Daşıyıcı qaytarmanızın çatdırıldığını bildirir” ifadəsi “Geri ödənişinizi təsdiqləmişik” ifadəsindən daha dəqiqdir. Eyni şəkildə, “İlk daşıyıcı yeniləməsini gözləyirik” ifadəsi səbəbi izah edilməyən boş izləmə səhifəsindən daha məlumatlandırıcıdır.
Qaytarma izləməsində qarşısı alına bilən səhvlərin qarşısını alan yoxlamalar
- Bağlama səviyyəsində uyğunlaşdırın. Bölünmüş qaytarmaları, bir icazə üzrə çoxsaylı bağlamaları, əvəzedici etiketləri və bir sifariş üzrə təkrar qaytarmaları sınaqdan keçirin. Hər bağlama öz izləmə qeydi ilə birmənalı şəkildə əlaqələndirilməlidir.
- Status üstünlüyünü müəyyən edin. Çatdırılma hadisəsindən sonra köhnə yolda hadisə gəldikdə nə baş verəcəyinə qərar verin. Göstərilən qaytarma statusunu avtomatik olaraq aşağı salmadan hadisə tarixçəsini qoruyun.
- Provayder xətalarını daşıyıcının səssizliyindən ayırın. Autentifikasiya xətası, rədd edilmiş sorğu və ya uğursuz webhook emalı inteqrasiya problemidir. Hələ skanın olmaması isə başqa haldır və fərqli şəkildə çatdırılmalıdır.
- Dublikatlar və təkrar cəhdlər üçün plan qurun. Çatdırılma yeniləməsi təkrarlana bilər. Hadisələrin qəbulunu təkrar cəhdlər üçün təhlükəsiz edin və eyni müştəri bildirişinin göndərilməsindən və ya eyni tapşırığın iki dəfə yaradılmasından çəkinin.
- Müştəri və göndəriş məlumatlarını qoruyun. İzləmə məlumatlarına çıxışı məhdudlaşdırın, yalnız iş axınının ehtiyac duyduğu məlumatları saxlayın və istifadəyə verməzdən əvvəl provayderin sənədləşdirilmiş autentifikasiya və təhlükəsizlik tələblərini nəzərdən keçirin.
- Əl ilə müdaxilə imkanını saxlayın. Bəzi qaytarmalarda izləmə məlumatları natamam, gecikmiş və ya uyğunsuz olacaq. Operatorların daşıyıcı hadisələri uydurmadan qaytarma qeydini araşdırmaq və düzəltmək imkanı olmalıdır.
Bu yoxlamalar tək bir uğurlu göndəriş əvəzinə konkret ssenarilər üzrə sınaqdan keçirildikdə daha faydalıdır. Kiçik test dəstinə ilk skanın olmaması, yanlış izləmə nömrəsi, dublikat hadisə, ardıcıllığı pozulmuş hadisə, anbar qəbzi olmadan çatdırılma hesabatı və uyğun çatdırılma hesabatı olmadan anbar qəbzi daxil edilməlidir. Hər hal üçün gözlənilən müştəri mesajı və operatorun əməliyyatı əvvəlcədən müəyyən edilməlidir.
API-nin seçilməsi və iş bölgüsünün müəyyənləşdirilməsi
Biznesin faktiki istifadə etdiyi qaytarma marşrutları və daşıyıcılarla başlayın. Sonra provayderin aktual sənədlərində göndəriş qeydiyyatının necə aparıldığını, hansı identifikatorların tələb olunduğunu, yeniləmələrin necə çatdırıldığını, hansı hadisə məlumatlarının təqdim edildiyini və xətalarla təkrar cəhdlərin necə idarə olunduğunu yoxlayın. Daşıyıcı əhatəsi barədə ümumi bəyanatdan nəticə çıxarmaq əvəzinə, müvafiq daşıyıcıları və qaytarma marşrutlarını birbaşa təsdiqləyin. Uyğunlaşdırılmış statuslara müştəri kommunikasiyası və ya avtomatlaşdırma üçün etibar etməzdən əvvəl real nümunələri əks etdirən göndərişlərlə sınaq keçirin.
17TRACK İzləmə API-si haqqında ümumi məlumat və API sənədləri təqdim edir; onun 17RETURNS məhsul səhifəsi iş axınının qaytarma idarəetməsi tərəfini izah edir. Bunlar qaytarma prosesi ilə yanaşı izləmə görünürlüğünü qiymətləndirən komanda üçün uyğun başlanğıc nöqtələridir. Hər iki məhsul sahəsinin mövcudluğu konkret inteqrasiyanın, daşıyıcının, hadisənin və ya avtomatlaşdırılmış geri ödəniş qaydasının əlçatan olduğuna sübut kimi qəbul edilməməlidir. Dəqiq iş axınını aktual sənədlərdə və lazım gəldikdə provayderlə yoxlayın.
Təchizat və ya konsepsiyanın sübutu üçün qaytarma siyasətinə və anbar əməliyyatlarına sahib olan komandadan status uyğunlaşdırmasını mühəndislik komandası ilə birlikdə nəzərdən keçirməsini xahiş edin. Mühəndislik API-nin istifadə edilə bilən hadisələr təqdim edib-etmədiyini təsdiqləyə bilər; əməliyyatlar isə bu hadisələrin təklif olunan əməliyyatı əsaslandırıb-əsaslandırmadığını müəyyən edə bilər. Uğurlu inteqrasiya işçilərə və müştərilərə bağlamanı izləməyə kömək edən, eyni zamanda icazə, qəbul, yoxlama və qərarı ayrı mərhələlər kimi saxlayan inteqrasiyadır.
Tez-tez verilən suallar
Qaytarma üçün ilkin sifarişdən fərqli izləmə nömrəsi lazımdırmı?
Platforma çıxış və qaytarma göndərişləri üçün ayrıca qeydlər saxlamalıdır. Qaytarma adətən ayrıca göndəriş kimi daşındığı üçün onun izləmə identifikatoru ilkin sifarişin çıxış identifikatoru hesab edilmək əvəzinə qaytarma bağlaması ilə əlaqələndirilməlidir. Mövcud dəqiq identifikatorlar qaytarmanın necə göndərilməsindən asılıdır.
İzləmə API-si geri ödənişin edilməli olduğunu təsdiqləyə bilərmi?
Xeyr. Heç bir izləmə hadisəsi qaytarılan məhsulun tacirin geri ödəniş şərtlərinə cavab verdiyini təkbaşına təsdiqləmir. Platforma daşıyıcı hadisələrindən iş axınına giriş kimi istifadə edə bilər, lakin geri ödəniş hüququ icazədən, fiziki qəbuldan, yoxlamadan və tacirin siyasətindən də asılı ola bilər.
İzləmə çatdırılmanı göstərir, lakin anbar bağlamanı tapa bilmirsə nə etməli?
Daşıyıcının bildirdiyi çatdırılma hadisəsini və anbar qəbzi qeydini ayrı saxlayın. Bildirilən təyinatı və hadisə məlumatlarını yoxlayın, sonra obyektin qəbul və uyğunlaşdırma prosesini araşdırın. Daşıyıcının çatdırılmasını səssizcə təsdiqlənmiş anbar qəbzinə çevirməyin.
Qaytarma göndərişlərini izləmək üçün webhook-lar məcburidirmi?
Mütləq deyil. Yeniləmə üsulu seçilmiş provayderdən və onun sənədləşdirilmiş seçimlərindən asılıdır. Webhook-lar mövcuddursa, autentifikasiya, təkrar cəhdlər, dublikat çatdırılmalar və emal xətələri üçün plan qurun. Sorğu üsulundan istifadə edilirsə, qaytarma iş axınına və provayderin tələblərinə uyğun interval və dayandırma qaydası seçin.
Müştəri ilk izləmə yeniləməsini nə vaxt görməlidir?
Bu, daşıyıcının hadisəni nə vaxt bildirməsindən və inteqrasiyanın onu nə vaxt almasından asılıdır. Etiketin yaradılması və ya göndərişin qeydiyyata alınması daşıyıcının skanından əvvəl baş verə bilər. Müştərilərin gözlənilən ilk yeniləməni təsdiqlənmiş hərəkət kimi başa düşməməsi üçün bu fərqi aydın göstərin.


