Abunəlik əsaslı e-ticarət brendləri Tracking API ilə təkrarlanan göndərişləri necə izləyə bilər
Abunəlik üzrə təkrarlanan göndərişləri izləmə API-si ilə izləmək üçün hər fiziki bağlama üçün ayrıca göndəriş qeydi yaradın, onu həmin abunəlik dövrünün icra sifarişi ilə əlaqələndirin və anbarınız və ya icra tərəfdaşınız təqdim etdikdə izləmə nömrəsini qeydiyyatdan keçirin. Müştərilərə bağlamanın harada olduğunu göstərmək və komandanız üçün çatdırılma istisnalarını işarələmək məqsədilə API-nin izləmə yeniləmələrindən istifadə edin. Abunəlik ID-sini dövrlər arasında əlaqə kimi saxlayın, bağlamanın identifikatoru kimi deyil.

Abunəliyi deyil, bağlamanı izləyin
Abunəlik müştərinin zamanla nə almasının planlaşdırıldığını göstərir. İcra sifarişi bir dövr üçün nəyin göndərilməli olduğunu göstərir. İzləmə nömrəsi isə konkret bağlama haqqında məlumat verir. Bu qeydləri ayrı saxlamaq bir dövrün gecikmiş göndərişinin növbəti dövr üçün izləmə səhifəsində görünməsinin qarşısını alır.
Məsələn, fərz edək ki, may abunəlik qutusu iki bağlamaya bölünüb və iyun qutusu göndərilərkən may bağlamalarından biri hələ də daşınma mərhələsindədir. Müştəri may sifarişi altında iki bağlama və iyun sifarişi altında ayrıca bir bağlama görməlidir. May ayına aid gecikmiş yeniləmə yalnız may bağlamasını dəyişməlidir. Əvəzləyici göndərirsinizsə, yeni göndəriş qeydi yaradın və dəstək əməkdaşlarının hər ikisinin niyə mövcud olduğunu görə bilməsi üçün onu ilkin qeydlə əlaqələndirin.
- Abunəlik: Dəstək əməkdaşlarının müştərinin göndəriş tarixçəsini tapa bilməsi üçün abunəlik ID-sini saxlayın.
- Dövr və sifariş: Dövr identifikatorunu və ya planlaşdırılmış icra tarixini, sifariş ID-sini və bağlamaları düzgün sifarişlə uyğunlaşdırmaq üçün lazım olan icra ID-lərini qeyd edin. Dövrü izləmə hadisəsinin daxil olduğu tarixdən çıxarmayın.
- Göndəriş: Hər bağlamaya daxili göndəriş ID-si verin. Daşıyıcını və izləmə nömrəsini, müvafiq icra istinadını və provayderin qaytardığı hər hansı izləmə qeydiyyatı ID-sini saxlayın. Ləğv edilmiş etiketləri və artıq qüvvədə olmayan izləmə nömrələrini müştərinin aktiv görünüşündən çıxarın, lakin dəstək üçün tarixçəni saxlayın.
Sifariş səhifəsində hər hansı sifariş xülasəsi ilə yanaşı bağlama səviyyəsində irəliləyişi göstərin. Bir bağlama çatdırılıb, digəri isə daşınmadadırsa, bunu bildirin. Yalnız sifarişi tamamlamaq üçün tələb olunan bütün bağlamalar çatdıqda, ləğv edilmiş göndərişləri və əvəzləmələri nəzərə alaraq bütün sifarişi çatdırılmış kimi göstərin.
İcranı izləmə API-sinə qoşun
- İcra hadisəsindən qeydiyyatdan keçirin. İcra sistemi, anbar və ya üçüncü tərəf logistika tərəfdaşı daşıyıcı və izləmə nömrəsini göndərdikdə qeydiyyatı başladın. Yenilənmə ödənişi bunun üçün çox erkəndir: sifariş hələ göndərilməyi gözləyə bilər və heç bir izləmə nömrəsi mövcud olmaya bilər.
- API-ni çağırmazdan əvvəl göndərişi yadda saxlayın. Daxili göndəriş qeydini saxlayın və qeydiyyat sorğusunu növbəyə əlavə edin. Eyni icra mesajı iki dəfə daxil olarsa, başqa bağlama yaratmaq əvəzinə həmin qeyddən istifadə edin. API çağırışının vaxtı bitərsə, provayder bunu etməyə imkan verirsə, yenidən cəhd etməzdən əvvəl ilkin sorğunun uğurlu olub-olmadığını yoxlayın.
- Yeniləmələri qeydiyyatdan keçmiş bağlama ilə uyğunlaşdırın. Yeniləmələrdə qaytarılırsa, provayderin qeydiyyat identifikatorundan istifadə edin. Əks halda, onun sənədlərində göstərilən identifikatorlarla uyğunlaşdırın və nəticəni göndəriş qeydlərinizlə yoxlayın. Yeniləmə birdən çox qeydə aid ola bilərsə, onu ən son sifarişə tətbiq etmək əvəzinə nəzərdən keçirilməsi üçün göndərin.
- Etiket yaradılmasını daşıyıcının daşınmasından ayırın. Daşıyıcı bağlamanı qəbul etməzdən əvvəl izləmə nömrəsi mövcud ola bilər. Əlinizdə yalnız etiket varsa, “Daşıyıcının götürməsi üçün hazırlanır” kimi mesajdan istifadə edin. “Daşınmada” statusunu yalnız bunu təsdiqləyən daşıyıcı məlumatı olduqda göstərin.
17TRACK Tracking API bu quraşdırma üçün seçimlərdən biridir. Onun developer documentation bölməsi izləmə nömrələrinin qeydiyyata alınması və izləmə yeniləmələrinin qəbul edilməsi üçün istinaddır. Sisteminizdəki bağlama qeydini yeniləmək üçün bu yeniləmələrdən istifadə edin; dövrün təyin edilməsini, sifarişin tamamlanmasını və müştəri bildirişləri qaydalarını e-ticarət tətbiqinizdə saxlayın. İstifadəyə başlamazdan əvvəl yalnız daşıyıcı siyahısına əsaslanmaq əvəzinə faktiki daşıyıcı marşrutlarınızdan və icra tərəfdaşlarınızdan olan bağlamalarla sınaq keçirin.
Yeniləmələrin iki dəfə təhlükəsiz işlənməsini təmin edin
Provayderiniz vebhukları dəstəkləyirsə, hər bağlamanı fasiləsiz sorğulamaq əvəzinə yeniləmələri qəbul etmək üçün onlardan istifadə edin. Vebhuk provayderin tətbiqinizə göndərdiyi HTTP sorğusudur. Provayderin yoxlama tələblərinə əməl edin, qəbul edilmiş məlumat paketlərini davamlı şəkildə saxlayın və sənədləşdirilmiş cavab qaydalarına uyğun cavab verin. Sifariş görünüşlərinin yenilənməsi və ya e-poçt göndərilməsi kimi daha yavaş işləri sorğu işləyicisindən kənarda icra edin.
Emal yolunu elə qurun ki, təkrarlanan yeniləmənin əlavə təsiri olmasın. Provayder sabit hadisə ID-ləri təqdim edirsə, təkrarları tanımaq üçün onlardan istifadə edin. Fərdi hadisələr əvəzinə izləmə görüntüləri göndərirsə, tədbir görməzdən əvvəl daxil olan vəziyyəti və skan tarixçəsini mövcud məlumatlarınızla müqayisə edin. Müştəri mesajlarının təkrar göndərilməsini ayrıca aradan qaldırın: çatdırılma bildirişi artıq göndərilibsə, eyni göndəriş məlumatları iki dəfə işləndiyinə görə yenidən göndərilməməlidir.
Skanın baş verdiyi vaxtı tətbiqinizin onu qəbul etdiyi vaxtdan ayrı saxlayın. Gecikmiş daxil olan daşınma skanı daha yeni çatdırılmış statusu əvəz etmədən bağlamanın tarixçəsinə əlavə edilə bilər. Bununla belə, hər qanuni dəyişikliyin bağlamanı irəli aparacağını düşünməyin. Daşıyıcının düzəlişi və ya göndəriciyə qaytarılma yeniləməsi göstərdiyiniz məlumatı dəyişdirməli ola bilər. Yeni məlumat saxlanmış vəziyyətlə ziddiyyət təşkil edirsə və hansının düzgün olduğunu müəyyən edə bilmirsinizsə, göndərişi nəzərdən keçirmə növbəsinə yerləşdirin.
Diqqət tələb edə biləcək açıq göndərişləri vaxtaşırı yoxlayın: hələ də gözləmədə olan qeydiyyatlar, gözlənilən təhvil verilmədən sonra ilk skanı olmayan bağlamalar və izləməsi dayanmış göndərişlər. API axtarışı və ya yeniləməni dəstəkləyirsə, provayderin limitləri daxilində ondan seçmə qaydada istifadə edin. Eskalasiya etməzdən əvvəl daşıyıcılar və anbarlar üzrə nümunəni yoxlayın. Bir çox əlaqəsiz göndəriş üzrə yeniləmələr eyni anda dayanarsa, ayrı-ayrı çatdırılma hallarını açmazdan əvvəl inteqrasiyanı araşdırın.
İzləmə məlumatlarını faydalı müştəri mesajlarına çevirin
Müştərilərə nadir hallarda hər skan üçün e-poçt göndərmək lazımdır. Mesajları onların bilməli və ya etməli olduğu məqamlarla əlaqələndirməklə başlayın: bağlama daşıyıcının şəbəkəsinə daxil olub, çatdırılma cəhdi üzrə tədbir görülməlidir və ya daşıyıcı çatdırılma barədə məlumat verir. Abunəçilərin mesajın hansı göndərişə aid olduğunu anlaması üçün sifariş istinadını və müvafiq qutu və ya dövrü göstərin. Bölünmüş sifariş üçün bağlamanı müəyyənləşdirin və sifarişin qalan hissəsinin hələ yolda olub-olmadığını aydın bildirin.
- Etiket yaradılıb, skan yoxdur: Gözlənilən təhvili anbar qeydləri ilə müqayisə edin. Təhvil pəncərəsi keçibsə, müştəriyə bağlamanın daşınmada gecikdiyini bildirməzdən əvvəl icra bölməsindən bağlamanın müəssisədən çıxıb-çıxmadığını təsdiqləməsini istəyin.
- İzləmə hərəkətsiz qalıb: Hər bağlama üçün eyni taymerdən istifadə etmək əvəzinə marşrutu və xidməti əks etdirən hədlər tətbiq edin. Sərhədlərarası göndərişlər üçün müştəri ilə əlaqə saxlamazdan və ya eskalasiya etməzdən əvvəl son daşıyıcı hadisəsini nəzərdən keçirin.
- Uğursuz cəhd və ya götürülmə tələb olunur: Daşıyıcı aydın təlimatlar təqdim edirsə, müştəriyə hansı tədbirin görülməli olduğunu bildirin. Hadisə qeyri-müəyyəndirsə, yenidən çatdırılma tarixini və ya götürülmə məntəqəsini təxmin etmək əvəzinə işi dəstəyə yönləndirin.
- Çatdırılıb kimi qeyd olunub, lakin alınmayıb: Daşıyıcının bildirdiyi statusu saxlayın və ayrıca dəstək işi açın. Dəstək iş axınınız müştəri hesabatını daşıyıcının düzəlişindən fərqləndirməlidir.
Dəstək əməkdaşlarına dövrün, sifarişin, bağlama tarixçəsinin və artıq göndərilmiş mesajların vahid görünüşünü təqdim edin. Hər istisna üçün məsul şəxs və növbəti addım təyin edin. İcra bölməsi itkin təhvili araşdıra, logistika daşıyıcı istisnasını izləyə, dəstək isə müştəri ilə əlaqəni idarə edə bilər. İzləmə statusu bağlamanı təsvir edir; əvəzləmə və ya geri ödənişin lazım olub-olmadığına qərar vermir.
İstifadəyə başlamazdan əvvəl üst-üstə düşmələri yoxlayın
Bir icra tərəfdaşı və onun sifarişləri faktiki olaraq necə göndərdiyini əks etdirən göndərişlər dəsti ilə başlayın. Çoxsaylı bağlamaları olan bir dövrü, ləğv edilmiş etiketi, əvəzləməni və növbəti dövr göndərilərkən hələ də açıq olan köhnə göndərişi daxil edin. Sonra qəsdən təkrarlanan vebhuku yenidən oynadın və daha yeni hadisədən sonra köhnə hadisəni çatdırın. Bağlama qeydini, müştərinin sifariş səhifəsini, dəstək görünüşünü və bildiriş jurnalını yoxlayın. Yalnız uğurlu API cavabını təsdiqləyən test ən bahalı səhvi qaçıra bilər: yanlış sifarişi yeniləmək və ya yanlış müştəriyə mesaj göndərmək.
Qeydiyyat uğursuzluqlarını, uyğun bağlamaların uğurla qeydiyyatdan keçən hissəsini, gözləniləndən gec baş verən ilk skanları və uyğunlaşdırılmamış yeniləmələri izləyin. Yeniləmə gecikməsini izləyirsinizsə, daşıyıcı hadisəsi ilə onun qəbul edilməsi arasındakı vaxtı öz sisteminizin onu emal etməsi üçün sərf etdiyi vaxtdan fərqləndirin. Bu, daşıyıcı məlumat axınını, vebhuk son nöqtənizi və ya tətbiqinizdəki növbəni araşdırıb-araşdırmamağa qərar verməyə kömək edir.
İstənilən bağlama üzrə üç suala cavab verə bildikdən sonra daha çox marşruta keçin: Hansı dövrə aiddir? Daşıyıcı son olaraq nə bildirib? Yeniləmə çatışmırsa və ya yanlışdırsa, kim tədbir görür? Cavablardan hər hansı biri aydın deyilsə, daha çox bildiriş qaydası əlavə etməzdən əvvəl qeyd uyğunlaşdırmasını və ya istisna iş axınını düzəldin.
Tez-tez verilən suallar
İzləmə API-si müştərilərə növbəti abunəlik qutusunun nə vaxt göndəriləcəyini deyə bilərmi?
Növbəti planlaşdırılmış göndəriş tarixi üçün abunəlik cədvəlinizdən və icra sisteminizdən istifadə edin. İzləmə API-si izləmə məlumatı mövcud olduqdan sonra konkret bağlama üçün nəzərdə tutulub. Planlaşdırılmış göndəriş tarixi, daşıyıcının çatdırılma təxmini və təsdiqlənmiş çatdırılma fərqli faktlardır və ayrıca etiketlənməlidir.
E-poçt göndərildikdən sonra anbar izləmə nömrəsini dəyişərsə nə etməli?
Köhnə etiketi artıq qüvvədə olmayan kimi qeyd edin və yeni izləmə nömrəsini eyni sifarişlə əlaqələndirin. E-poçtunuz sifariş səviyyəsində izləmə səhifəsinə yönləndirirsə, müştərinin ilkin daşıyıcı keçidinə ehtiyac olmadan aktiv bağlamanı tapa bilməsi üçün həmin səhifəni yeniləyin. Dəyişiklik müştərinin tədbir görməsi üçün lazım olan məlumatlara təsir edirsə, düzəliş göndərin.
İcra tərəfdaşı daşıyıcı kodları olmadan izləmə nömrələri göndərərsə nə etməli?
Tərəfdaşdan ardıcıl daşıyıcı sahəsi və ya onun göndəriş xidməti kodları ilə uyğunlaşdırma tələb edin. API-niz daşıyıcının avtomatik müəyyən edilməsini təklif edirsə, ona etibar etməzdən əvvəl tərəfdaşın etiketləri ilə necə işlədiyini yoxlayın. Yalnız izləmə nömrəsinə əsasən daşıyıcı seçmək əvəzinə qeyri-müəyyən uyğunluqları nəzərdən keçirilməyə yönləndirin.
Dayandırılmış və ya ötürülmüş abunəliklərin izləmə qeydlərinə ehtiyacı varmı?
Heç vaxt göndərilməyən dövr üçün bağlama qeydi lazım deyil. Əvvəlki göndəriş hələ də açıqdırsa, abunəlik dayandırılsa, ötürülsə və ya ləğv edilsə belə, onu izləməyə davam edin. Abunəlik statusu gələcək icranı idarə edir; artıq anbardan çıxmış bağlamanın başına nə gəldiyini bildirmir.
Mənbələr
- 17TRACK Tracking API — bağlama izləməsini biznes sistemlərinə inteqrasiya etmək üçün məhsul icmalı.
- 17TRACK Tracking API documentation — izləmə nömrələrinin qeydiyyata alınması və izləmə məlumatlarının qəbul edilməsi üçün tətbiqetmə istinadı.
- Stripe webhook documentation — təkrarlanan hadisələrin idarə edilməsi və çatdırılma ardıcıllığı barədə fərziyyələrdən yayınmaq kimi ümumi vebhuk təcrübələri üçün istinad. Yoxlama və təsdiqləmə üzrə izləmə provayderinizin öz qaydalarına əməl edin.


