Skip to main content
Ana səhifəBloqBələdçilərXaricdəki anbarlar yerli çatdırılmaları izləmək üçün izləmə API-lərindən necə istifadə edə bilər

Xaricdəki anbarlar yerli çatdırılmaları izləmək üçün izləmə API-lərindən necə istifadə edə bilər

17TRACK

Xarici anbarlar hər bir göndərilən bağlamanı daşıyıcı və izləmə nömrəsi ilə əlaqələndirməklə, izləmə hadisələrini anbar və ya sifariş idarəetmə sisteminə ötürməklə və çatdırılma istisnalarını təyin edilmiş tapşırıqlara çevirməklə yerli çatdırılmaları izləmək üçün izləmə API-lərindən istifadə edə bilərlər. Ən faydalı quraşdırma etiket yaradılmasını daşıyıcının qəbulundan fərqləndirir, göndəriş tarixçəsini qoruyur və əməliyyat qruplarına sadəcə hansı bağlamaların yeni statusa malik olduğunu deyil, hansı bağlamaların tədbir tələb etdiyini bildirir.

Xarici anbarlar yerli çatdırılmaları izləmək üçün izləmə API-lərindən necə istifadə edə bilər

Bu təlimat satıcının əsas bazarından kənarda inventar saxlayan və həmin təyinat bazarındakı müştərilərə sifariş göndərən anbarlara yönəlib. Bu komandalar üçün xarici ölkələr üzrə izləmə anbarın göndəriş qeydlərini yerli daşıyıcının çatdırılma marşrutu ilə əlaqələndirməlidir. Bu əlaqə anbar menecerlərinə, nəqliyyat koordinatorlarına və satıcı dəstək qruplarına eyni göndəriş qeydi əsasında işləməyə kömək edir.

Anbar görünürlüğünün harada bitdiyini və daşıyıcı görünürlüğünün harada başladığını müəyyənləşdirin

Anbar idarəetmə sistemi sifarişin seçildiyini, qablaşdırıldığını, etiketləndiyini və göndəriş sahəsinə yerləşdirildiyini qeyd edə bilər. Bu qeydlər özlüyündə daşıyıcının bağlamanı qəbul etdiyini sübut etmir. İzləmə API-si daşıyıcı tərəfindən bildirilən hadisələri əlavə edir, lakin anbarın təhvil qeydlərini əvəz edə və heç vaxt baş verməmiş fiziki skan yarada bilməz.

Üç mərhələni ayrı saxlayın: götürülməyə hazır, anbar qeydlərinə əsasən təhvil verilib və daşıyıcının izləmə hadisələrinə əsasən qəbul edilib. Bu ayrım daxildə göndərilmiş kimi görünən, lakin daşıyıcı hərəkəti olmayan bağlamaları araşdırmağı asanlaşdırır.

Məsələn, bağlama götürülmə manifestində görünür, lakin qəbul hadisəsi yoxdursa, növbəti addım yükləmə qeydlərini yoxlamaq və götürmə daşıyıcısı ilə əlaqə saxlamaqdır. Bağlamanı itmiş kimi təsnif etmək tezdir. Daşıyıcı artıq uğursuz çatdırılma cəhdini bildirmişdirsə, uyğun tədbir fərqlidir: səbəbi araşdırın və növbəti addımı satıcı və ya səlahiyyətli alıcı əlaqələndiricisi ilə razılaşdırın.

API-yə qoşulmazdan əvvəl göndəriş qeydini yaradın

Əsas məqam müştəri sifarişi, fiziki bağlama və daşıyıcının izləmə identifikatoru arasında etibarlı əlaqədir. Sifariş nömrəsini bağlama identifikatorunun əvəzi kimi istifadə etməyin. Bir sifariş anbardan bir neçə bağlama şəklində çıxa bilər və əvəzləyici göndəriş üçün ayrıca qeyd lazımdır.

QeydTövsiyə olunan sahələrƏməliyyat məqsədi
Göndəriş identikliyiDaxili göndəriş ID-si, sifariş ID-si, bağlama ID-si, satıcı hesabıBölünmüş göndərişləri və müxtəlif müştəriləri ayrı saxlayın.
Daşıyıcı identikliyiDaşıyıcı identifikatoru, izləmə nömrəsi, məlum olduqda xidmətDüzgün izləmə sorğusunu göndərin və araşdırmaları yönləndirin.
Anbar təhviliAnbar, göndəriş vaxtı, götürmə istinadı, manifest istinadıFiziki göndəriş sübutlarını daşıyıcı hadisələri ilə müqayisə edin.
İzləmə tarixçəsiXam hadisə, uyğunlaşdırılmış status, hadisə vaxtı, qəbul vaxtı, təqdim edildikdə məkanSübutları qoruyun və hadisə vaxtını hesabat gecikmələrindən ayırın.
İstisna prosesiProblem növü, məsul şəxs, növbəti tədbir, nəzərdən keçirmə müddəti, həllİzləmə məlumatlarını məsuliyyətli işə çevirin.

Formatın qorunması üçün izləmə nömrələrini mətn kimi saxlayın. Anbar etiket yaradılarkən daşıyıcını artıq bilirsə, yalnız nömrənin tanınmasına etibar etmək əvəzinə bu identikatoru inteqrasiya vasitəsilə ötürün. Həmçinin ilkin, əvəzləyici, geri qaytarılan və sonrakı çatdırılma bağlamaları arasındakı əlaqələri onların fərdi tarixçələrini üzərindən yazmadan saxlayın.

Anbarın daşıyıcı kombinasiyasına uyğun inteqrasiya seçin

Anbar daşıyıcıları ilə birbaşa inteqrasiya yarada və ya çoxdaşıyıcılı izləmə API-sindən istifadə edə bilər. Xüsusilə daşıyıcıya xas məlumatlar tələb olunduqda, az sayda daşıyıcı ilə sabit fəaliyyət göstərən əməliyyat üçün birbaşa inteqrasiya praktik ola bilər. Anbarın bir neçə çatdırılma şəbəkəsi üzrə ortaq izləmə interfeysinə ehtiyacı olduqda, çoxdaşıyıcılı API-ni qiymətləndirmək məqsədəuyğundur.

17TRACK-in İzləmə API-si bu inteqrasiya modeli üçün uyğun seçimdir. Göndərişlərin qeydiyyatı, izləmənin əldə edilməsi və izləmə yeniləmələrinin sisteminizə necə uyğunlaşacağını qiymətləndirmək üçün onun rəsmi API sənədlərindən istifadə edin. Ümumi daşıyıcı əlçatanlığını bütün tələb olunan hadisələrin qaytarılacağına sübut kimi qəbul etmək əvəzinə, hər bir anbarın istifadə etdiyi dəqiq daşıyıcı və xidmət kombinasiyalarını təsdiqləyin.

Əlaqəni real əməliyyat tələbləri əsasında qiymətləndirin:

  • Sisteminiz göndəriş pikləri zamanı yaradılan bağlamaları etibarlı şəkildə qeydiyyatdan keçirə bilərmi?
  • Həqiqətən satın aldığınız yerli çatdırılma xidmətləri üçün hansı hadisələr qaytarılır?
  • Uğursuz sorğular, təkrar qeydiyyatlar və etibarsız daşıyıcı identifikatorları necə idarə olunur?
  • Yeniləmələr necə çatdırılır və ya əldə edilir, buraxılmış yeniləmələr necə uzlaşdırılır?
  • Hesabınıza hansı istifadə limitləri, saxlama şərtləri, təhlükəsizlik nəzarətləri və kommersiya şərtləri tətbiq olunur?

İzləmə əlaqəsinin etiket satınalmasını, ünvan düzəlişini, çatdırılmanın yenidən planlaşdırılmasını və ya iddia təqdim edilməsini əhatə etdiyi qəbul edilməməlidir. Müvafiq məhsul sənədlərində əks təsdiq açıq şəkildə göstərilmədikcə, bunları ayrıca proseslər kimi qəbul edin.

Göndərişi, izləmə yeniləmələrini və istisnaların idarə edilməsini əlaqələndirin

1. Bağlamaları nəzarət olunan göndəriş mərhələsində qeydiyyatdan keçirin

Etiketin təsdiqi və ya göndərişin təsdiqi kimi ardıcıl qeydiyyat tətikçisi seçin. Etiket yaradılarkən qeydiyyat hələ götürülməmiş bağlamaları üzə çıxara bilər, lakin ləğv edilmiş etiketlərin idarə olunmasını da tələb edir. Yalnız göndərişdən sonra qeydiyyat istifadə olunmamış qeydiyyatları azaldır, lakin etiket yaradılması ilə fiziki təhvil arasındakı intervalı gizlədə bilər.

Seçdiyiniz tətikçidən asılı olmayaraq, qeydiyyat nəticəsini bağlama ilə əlaqələndirib saxlayın. Uğursuz qeydiyyatlar tətbiq jurnallarında yoxa çıxmaq əvəzinə yenidən cəhd və ya düzəliş növbəsinə daxil edilməlidir. Təkrar emalın dublikat biznes qeydləri yaratmasının qarşısını almaq üçün sabit daxili identifikatordan istifadə edin.

2. Paneli əsas məlumat mənbəyinə çevirmədən yeniləmələri qəbul edin

API-nin sənədləşdirilmiş seçimlərindən asılı olaraq yeniləmələr sorğular vasitəsilə əldə edilə və ya webhook bildirişləri ilə qəbul edilə bilər. Webhook provayderdə yeniləmə olduqda sisteminizə göndərilən mesajdır; sorğulama isə sisteminizin məlumatı tələb etməsi deməkdir.

Webhook əsaslı tətbiqlərdə daxil olan mesajları provayderin sənədləşdirilmiş yoxlama üsulu ilə təsdiqləyin. Qəbul edilmiş mesajları təsdiqləməzdən əvvəl etibarlı şəkildə saxlayın, sonra onları asinxron emal edin. Dublikat mesajlar və ardıcıllıqdan kənar gələn hadisələr üçün dizayn edin. Hər bir provayderin eyni davrandığını fərz etmək əvəzinə, sənədləşdirilmiş cavab və yenidən cəhd tələblərinə əməl edin.

Sorğulama zamanı tətbiq olunan istifadə limitləri daxilində qalaraq aktiv göndərişlərə və həll edilməmiş istisnalara üstünlük verin. Dəstəkləndikdə yeniləmə tarixçəsi natamam görünən göndərişləri yoxlamaq üçün uzlaşdırma sorğularından istifadə edin. Məlumat qəbulunda yaranan xətaları daşıyıcının çatdırılma istisnalarından ayrı qeyd edin: pozulmuş əlaqə bağlamanın hərəkətini dayandırdığının sübutu deyil.

3. İlkin sübutu qoruyaraq statusları normallaşdırın

Qəbul gözlənilir, tranzitdə, çatdırılmaya çıxıb, çatdırılmaya cəhd edilib, çatdırılıb və geri qaytarılma hərəkəti kimi az sayda əməliyyat kateqoriyası yaradın. Bunlar təklif olunan anbar kateqoriyalarıdır və hər bir daşıyıcının uyğun hadisələri təqdim edəcəyinə zəmanət vermir.

İlkin təsviri uyğunlaşdırılmış kateqoriyanın yanında saxlayın. “Götürülməyə hazırdır” ifadəsi səssizcə “çatdırılıb”a, “qaytarılma başladılıb” isə “anbara geri qəbul edilib”ə çevrilməməlidir. Tanınmayan hadisələrin nəzərdən keçirilməsi üçün naməlum və ya uyğunlaşdırılmamış vəziyyətə icazə verin.

Həm hadisə vaxtını, həm də sisteminizin onu qəbul etdiyi vaxtı saxlayın. Təqdim edildikdə ilkin vaxt qurşağını və ya ofseti qoruyun və ardıcıl daxili vaxt standartından istifadə edin. Gecikmiş hadisə yalnız ən son qəbul edildiyinə görə göndərişi avtomatik olaraq əvvəlki mərhələyə qaytarmamalıdır; açıq ardıcıllıq qaydaları tətbiq edin və tarixçəni saxlayın.

4. İstisnalar üçün məsul şəxslər təyin edin

Kimsə onun əsasında tədbir görə bilmirsə, xəbərdarlıq faydasızdır. Qəbul skanlarının olmamasını anbarın göndəriş komandasına, alıcının müdaxiləsini tələb edən çatdırılma cəhdlərini satıcının dəstək komandasına, davamlı daşıyıcı hərəkəti problemlərini isə nəqliyyat koordinatoruna yönləndirin. Bunlar tövsiyə olunan başlanğıc nöqtələridir; məsuliyyətlər anbarın müqavilələrini və əməliyyat modelini əks etdirməlidir.

İzləmə tarixçəsini, təhvil istinadını, son hadisəni, araşdırma qeydlərini və növbəti nəzərdən keçirmə vaxtını hər bir işə əlavə edin. Eyni dayanmış bağlama hər sinxronizasiyadan sonra yeni tapşırıq yaratmasın deyə təkrar xəbərdarlıqları eyni açıq problem altında qruplaşdırın.

Xəbərdarlıqları ixtiyari taymerlərə deyil, xidmət gözləntilərinə əsasən qurun

Yeni skanı olmayan bağlamanın gecikmiş və ya itmiş sayılacağı universal müddət yoxdur. Xəbərdarlıq hədlərini daşıyıcının xidmətinə, götürmə cədvəlinə, iş günlərinə, təyinat yerinə və satıcının öhdəliyinə uyğun qurun. Daxili araşdırma həddini müştəriyə yönəlmiş çatdırılma vədindən ayrı saxlayın.

  • Təhvil verildikdən sonra qəbul yoxdur: Eskalasiya etməzdən əvvəl götürmə qeydini və daşıyıcının təsdiqini yoxlayın.
  • Gözlənilən müddətdən artıq hərəkət yoxdur: Son hadisəni, xidmət gözləntilərini və məlum əməliyyat fasilələrini nəzərdən keçirin.
  • Uğursuz çatdırılma cəhdi: Növbəti tədbirin daşıyıcıya, satıcıya və ya alıcıya aid olub-olmadığına qərar verməzdən əvvəl səbəbi oxuyun.
  • Qaytarılma hərəkəti: Qaytarılma prosesini hazırlayın, lakin fiziki qəbul və tələb olunan yoxlama tamamlanana qədər satıla bilən inventarı artırmayın.
  • Çatdırılıb, lakin mübahisələndirilir: Araşdırma açın və mövcud çatdırılma sübutlarını tələb edin; yalnız statusu şikayətin həlli kimi qəbul etməyin.

İzləmə davamlı bağlama məkanını deyil, bildirilmiş göndəriş hadisələrini əks etdirir. Son yeniləmə vaxtının göstərilməsi işçilərə məlumatın yeniliyini anlamağa kömək edir, lakin canlı GPS görünürlüğü təəssüratı yaratmır.

Hər komandaya istifadə edilə bilən görünüş təqdim edin

Anbar rəhbərlərinə göndərişdən qəbula qədər olan istisnalar lazımdır. Nəqliyyat koordinatorlarına daşıyıcıya xas növbələr və köhnəlmiş işlər lazımdır. Satıcı dəstək qruplarına aydın göndəriş qrafiki və növbəti razılaşdırılmış tədbir lazımdır. Ortaq məlumat modeli hər bir istifadəçiyə hər satıcının göndərişlərinə giriş vermədən bu görünüşləri dəstəkləyə bilər.

Çoxmüştərili anbar üçün satıcı səviyyəsində girişi yalnız panel filtrləri ilə deyil, serverdə tətbiq edin. API məlumatlarını brauzer kodundan uzaq saxlayın, alıcı məlumatlarına girişi məhdudlaşdırın və saxlama və silmə qaydalarını müəyyən edin. İzləmə istinadlarında və diaqnostik jurnallarda lazımsız şəxsi məlumat yerləşdirməkdən çəkinin.

Faydalı göstəricilərə izləmə üçün uğurla qeydiyyatdan keçirilmiş göndərilmiş bağlamaların payı, daşıyıcı qəbul hadisəsi olan bağlamaların payı, göndərişdən qəbula qədər müddət, həll edilməmiş istisnaların yaşı və inteqrasiyanın emal xətaları daxildir. Hər məxrəc və vaxt əsasını müəyyən edin. Vaxtında çatdırılmanı ölçərkən ümumi çatdırılma müddəti ilə deyil, sənədləşdirilmiş vəd və ya xidmət öhdəliyi ilə müqayisə aparın.

İş prosesini genişləndirməzdən əvvəl sınaqdan keçirin

Aydın müəyyən edilmiş anbar, daşıyıcı dəsti və satıcı qrupu ilə başlayın. Ləğv edilmiş etiketlər, bölünmüş sifarişlər, ilk skanların olmaması, uğursuz çatdırılma cəhdləri, dublikat bildirişlər, ardıcıllıqdan kənar hadisələr və qaytarılmalar kimi çətin qeydlərlə yanaşı adi çatdırılmaları da daxil edin. Uyğun olduqda səlahiyyətli sınaq məlumatlarından və ya tarixi qeydlərdən istifadə edin; istehsal mühitində daşıyıcı hadisələri uydurmayın.

İşə başlamazdan əvvəl qəbul meyarları barədə razılaşın. Göndərilən hər bağlamanın ya uğurlu qeydiyyat qeydi, ya da məsul şəxsi müəyyən edilmiş uğursuzluq işi olmalıdır. Təkrar oynadılan mesajlar dublikat tapşırıqlar yaratmamalıdır. İzləmə hadisələri öz mənbəyinə qədər izlənilə bilməli və istifadəçilər başqa satıcının qeydlərini görməməlidir.

Yalnız əməliyyat işçiləri istisna növbəsini etibarlı şəkildə idarə edə və texniki işçilər uğursuz yeniləmələri bərpa edə bildikdən sonra genişləndirin. Praktik məqsəd statuslarla dolu panel deyil. Məqsəd anbar göndərişindən daşıyıcının çatdırılmasına qədər izlənə bilən əlaqə və bu səyahət diqqət tələb etdikdə aydın məsuliyyətdir.

FAQ

İzləmə API-si anbar idarəetmə sistemini əvəz edə bilərmi?

Xeyr. İzləmə API-si göndəriş görünürlüğü təmin edir. Anbar sistemi inventar nəzarəti, məhsulların seçilməsi, qablaşdırma və fiziki göndəriş qeydləri kimi fəaliyyətlərə cavabdeh olaraq qalır. Daşıyıcı hadisələrinin anbar sübutlarını əvəz etmədən əlavə kontekst verməsi üçün ikisini bağlama identifikatorları vasitəsilə əlaqələndirin.

İzləmə API-si real vaxt rejimində GPS məkanı təqdim edirmi?

Bunu fərz etməyin. Bağlama izləməsi adətən bildirilmiş hadisələrdən və məkanlardan ibarətdir. Yenilənmə vaxtı daşıyıcıdan və inteqrasiyadan asılıdır. Davamlı nəqliyyat vasitəsi və ya bağlama məkanı ayrıca təsdiqlənmiş imkan tələb edir.

Bağlamada izləmə yeniləmələri olmadıqda işçilər nə etməlidir?

Əvvəlcə qeydiyyatın uğurlu olub-olmadığını, daşıyıcının identikliyini və izləmə nömrəsinin dəqiqliyini yoxlayın. Sonra son hadisəni anbarın təhvil sübutları və gözlənilən xidmət qrafiki ilə müqayisə edin. Hansı komandanın eskalasiya etməli olduğuna qərar verməzdən əvvəl inteqrasiya xətələrini çatışmayan daşıyıcı skanlarından ayrı araşdırın.

İzləmə hadisələri avtomatik olaraq geri ödənişləri və ya inventar yeniləmələrini işə sala bilərmi?

Onlar iş prosesinə məlumat verə bilər, lakin nəticə doğuran tədbirlər əlavə nəzarət tələb edir. Çatdırılma istisnası mütləq geri ödəniş hüququ yaratmır və qaytarılma hərəkəti bağlamanın fiziki olaraq anbara qəbul edildiyini göstərmir. Pul və ya inventar qeydlərini dəyişməzdən əvvəl satıcı siyasətlərini, səlahiyyət yoxlamalarını və qəbul prosedurlarını tətbiq edin.

Bölünmüş sifarişlər satıcı dəstək komandalarına necə göstərilməlidir?

Hər bağlamanı əsas sifarişin altında ayrıca göstərin. Bir bağlamanın çatdırılması digər bağlama tranzitdə qaldıqda bütün sifarişi tamamlanmış kimi göstərməməlidir. Əvəzləyici və qaytarılan göndərişləri əlaqəli, lakin fərqləndirilə bilən saxlayın.

Mənbələr

  • 17TRACK İzləmə API-si — izləmə API-si inteqrasiya seçimi üçün rəsmi məhsul istinadı.
  • 17TRACK API Sənədləri — qeydiyyatın, izləmə sorğularının, yeniləmələrin idarə edilməsinin və tətbiq tələblərinin yoxlanılması üçün texniki istinad. Bu təlimatda göstərilən əməliyyat prosesləri və xəbərdarlıq qaydaları tövsiyələrdir, provayder və ya daşıyıcı davranışına zəmanət deyil.