Bir API ilə Avstraliya və Yeni Zelandiya üzrə göndərişlərin izlənməsini necə vahid sistemdə birləşdirmək olar

Avstraliya və Yeni Zelandiya üzrə göndəriş izləməsini vahid API ilə birləşdirmək üçün sifariş və ya icra sisteminizi çoxdaşıyıcılı izləmə xidmətinə qoşun, hər bir göndərişi düzgün daşıyıcı identifikatoru ilə qeydiyyatdan keçirin və daxil olan izləmə yeniləmələrini ardıcıl daxili hadisə modelinə çevirin. İnteqrasiya daşıyıcıya xas detalları qoruyarkən əməliyyat komandanıza və müştərilərinizə ölkədaxili və Tasman dənizi üzərindən həyata keçirilən çatdırılmalar üçün vahid izləmə təcrübəsi təqdim etməlidir.

Tərtibatçılar, e-ticarət operatorları və logistika komandaları üçün əsas çətinlik ilk API sorğusunu göndərmək deyil. Çətinlik müxtəlif daşıyıcılar eyni marşrutu fərqli şəkildə təsvir etdikdə göndəriş identifikatorlarını, çatdırılma statuslarını, daşıyıcı təhvil-təslimlərini və müştəri bildirişlərini ardıcıl saxlamaqdır. Bu bələdçi həmin inteqrasiyanı necə layihələndirməyi, izləmə API-sini necə qiymətləndirməyi və istehsal mühitində ona etibar etməzdən əvvəl necə sınaqdan keçirməyi izah edir.

Vahid API-nin nələri birləşdirməli olduğunu müəyyənləşdirin

Ortaq API tətbiqiniz üçün vahid inteqrasiya nöqtəsi yaradır. Bu, hər daşıyıcının eyni məlumatları yayımlayacağı və ya bağlamaları eyni tezlikdə skan edəcəyi demək deyil. Arxitekturanız ardıcıl interfeys ilə tam görünürlük arasında fərq qoymalıdır.

Hər iki ölkədə fəaliyyət göstərən daşıyıcıların ümumi siyahısı əvəzinə faktiki icra fəaliyyətinə əsaslanan göndəriş inventarı ilə başlayın. Avstraliyadakı ölkədaxili göndərişləri, Yeni Zelandiyadakı ölkədaxili göndərişləri və hər iki istiqamətdə sərhədlərarası daşımaları daxil edin. Biznesinizin bir hissəsidirsə, digər beynəlxalq mənşə nöqtələrini də əlavə edin.

• Daşıyıcı və xidmət: Daşıyıcını, istifadə olunan xidməti və məlum çatdırılma tərəfdaşını qeyd edin.
• Marşrut: Göndərişin mənşə və təyinatını son skanın yerləşdiyi məkandan fərqləndirin.
• İdentifikatorlar: Sifariş istinadını, icra istinadını, izləmə nömrəsini və hər hansı əvəzləyici və ya tərəfdaş nömrəsini əldə edin.
• Əməliyyat məqsədi: Yeniləmələrin müştəri izləməsini, istisnaların idarə edilməsini, çatdırılmanın təsdiqini və ya hər üçünü dəstəklədiyini müəyyənləşdirin.
• Tələb olunan detal: Ümumi çatdırılma statusunun kifayət edib-etmədiyinə, yoxsa agentlərə skan təsvirləri, məkanlar və vaxt möhürlərinin də lazım olub-olmadığına qərar verin.

Bu inventar qəbul yoxlama siyahınıza çevrilir. Təchizatçının ümumi daşıyıcı əhatəsi ilkin seçim üçün faydalıdır, lakin qərarınız faktiki daşıyıcı-xidmət kombinasiyalarınızın istifadə edilə bilən izləmə məlumatı qaytarıb-qaytarmamasına əsaslanmalıdır.

İzləmə API-sini göndəriş çeşidinizə uyğun qiymətləndirin

17TRACK çoxdaşıyıcılı inteqrasiya üçün qiymətləndirilə biləcək uyğun seçim olan Tracking API təklif edir. Cari inteqrasiya tələblərini yoxlamaq üçün onun rəsmi API sənədlərindən istifadə edin. Daşıyıcı dəstəyi, hadisə sahələri, yeniləmə davranışı, hesab limitləri və kommersiya şərtlərini məhsul kateqoriyasından çıxarılan fərziyyələr kimi deyil, tətbiqiniz üçün yoxlanmalı məsələlər kimi nəzərdən keçirin.

Nəzərdən keçirdiyiniz istənilən API üçün eyni praktiki sualları verin:

• O, göndəriş inventarınızdakı daşıyıcıları və xidmətləri müəyyən edib izləyə bilirmi?
• Daşıyıcının müəyyən edilməsi qeyri-müəyyən olduqda, açıq daşıyıcı identifikatoru təqdim edə bilərsinizmi?
• Tətbiqiniz yeniləmələri necə qəbul edir və yeniləmə buraxıldıqda hansı bərpa mexanizmi mövcuddur?
• Normallaşdırılmış statuslarla yanaşı hansı ilkin daşıyıcı detalları əlçatan olaraq qalır?
• İzləmə nömrəsi etibarsız olduqda, hələ tanınmadıqda və ya birdən çox mümkün daşıyıcı ilə əlaqəli olduqda nə baş verir?
• İstifadə, hesablaşma, izləmə müddəti və giriş limitləri hesabınız üçün necə müəyyən edilir?

Tövsiyə olunan qərar qaydası: ən böyük reklam edilən daşıyıcı sayına deyil, real göndəriş nümunələriniz üzrə uğurlu sınaqlara əsasən seçim edin. İnteqrasiya əməliyyat qərarlarınızı dəstəkləmək üçün kifayət qədər məlumat təqdim etdikdə və nasazlıqları onlardan bərpa oluna biləcək qədər aydın göstərdikdə uyğun sayılır.

Daşıyıcı fərqlərinə davam gətirən daxili model yaradın

Sifarişləri, göndərişləri və izləmə mərhələlərini ayırın

İzləmə nömrəsindən sifariş üçün əsas açar kimi istifadə etməyin. Bir sifarişdə bir neçə bağlama ola bilər və bağlamanın marşrutunda birdən çox izləmə identifikatoru iştirak edə bilər. Bunun əvəzinə daxili göndəriş ID-si yaradın və izləmə qeydlərini ona bağlayın.

Praktiki modelin üç səviyyəsi var: müştəri sifarişi, onun fiziki göndərişləri və hər göndərişlə əlaqəli izləmə mərhələləri. Ölkədaxili bağlama üçün yalnız bir izləmə mərhələsi kifayət edə bilər. Sərhədlərarası bağlama üçün başqa daşıyıcı və ya identifikator əhəmiyyət kəsb etdikdə əlaqəli qeydlər tələb oluna bilər.

İzləmə qeydini izləmə nömrəsi ilə yanaşı daşıyıcı üzrə də əhatələndirin və onun göndəriş ID-si ilə əlaqəsini qoruyun. Yeni çatdırılma tərəfdaşı nömrəsi yarandıqda ilkin nömrənin üzərinə yazmaq əvəzinə onu əlaqəli identifikator kimi əlavə edin. Bu, təhvil-təslimi araşdırarkən dəstək agentlərinə lazım olan tarixçəni qoruyur.

Xam hadisəni və normallaşdırılmış hadisəni saxlayın

Biznesinizin əməliyyat göstərə biləcəyi kiçik daxili status lüğətindən istifadə edin. Məsələn, tranzitdən əvvəl, tranzitdə, çatdırılmaya çıxarılıb, götürülməyə hazırdır, çatdırılıb, istisna və naməlum statuslarını müəyyənləşdirə bilərsiniz. Bunlar təklif olunan daxili kateqoriyalardır və konkret təchizatçının status sxemi ilə bağlı iddia deyil.

İlkin daşıyıcı təsvirini xəritələndirilmiş statusla yanaşı saxlayın. Götürmə məntəqəsi hadisəsi və ünvan problemi müştərinin hərəkət etməsini tələb edə bilər, lakin onlar eyni mesajı yaratmamalıdır. Eyni şəkildə, etiketin yaradılması daşıyıcının bağlamanı fiziki olaraq qəbul etdiyinə avtomatik sübut sayılmamalıdır.

Xəritələndirmə qərarlarını versiyalaşdırılmış konfiqurasiyada sənədləşdirin. Yeni hadisə təsviri yarandıqda, mənası aydın deyilsə, onu nəzərdən keçirmə növbəsinə yerləşdirin. Açıq şəkildə naməlum vəziyyəti seçmək yanlış çatdırılma nəticəsini əminliklə təyin etməkdən daha təhlükəsizdir.

Hadisə vaxtını qəbul vaxtından fərqləndirin

Hadisənin baş verdiyi vaxtı sisteminizin onu qəbul etdiyi vaxtdan ayrı saxlayın. Xüsusilə yeniləmələr gecikdikdə və ya tarixi hadisələr birlikdə təqdim edildikdə, köhnə skan daha yeni skandan sonra gələ bilər.

Avstraliya və Yeni Zelandiya üçün hər göndərişə vahid sabit vaxt fərqi tətbiq etməkdən çəkinin. Təqdim edildikdə mənbə vaxt möhürlərini və fərqləri qoruyun. Etibarlı məkan kontekstiniz olduqda göstərim üçün uyğun adlandırılmış vaxt qurşağından istifadə edin və yay vaxtı fərqlərini nəzərə alın. Mənbənin vaxt qurşağı yoxdursa, dəqiq UTC çevirməsi uydurmaq əvəzinə bu qeyri-müəyyənliyi saxlayın.

Etibarlı məlumat qəbul etmə iş axını tətbiq edin

1. Əvvəlcə daxili göndərişi yaradın. İzləmə xidmətində qeydiyyatdan əvvəl onun sifarişlə əlaqəsini, marşrutunu, daşıyıcı seçimini və izləmə identifikatorunu qeyd edin.
2. İzləmə qeydiyyatını göndərin. Təchizatçının sənədləşdirilmiş sorğu formatından istifadə edin. Cavabı saxlayın və uğurlu qeydiyyatı daşıyıcı hadisələrinin sonradan əlçatan olmasından fərqləndirin.
3. Nasazlıqları təsnif edin. Etibarsız daxiletmə və autentifikasiya problemlərini müvəqqəti xidmət nasazlıqlarından ayırın. Yalnız yenidən cəhdin əsaslı şəkildə kömək edə biləcəyi hallarda təkrar cəhd edin.
4. Yeniləmələri qəbul edin və ya əldə edin. Seçdiyiniz API-nin dəstəklədiyi çatdırılma mexanizmini tətbiq edin. Vebhuklardan istifadə edirsinizsə, daxil olan sorğuları təchizatçının sənədləşdirilmiş metodu ilə yoxlayın və qəbul edilmiş hadisələri davamlı növbə vasitəsilə emal edin.
5. Dəyişiklikləri tətbiq etməzdən əvvəl dublikatları silin. Mövcud olduqda təchizatçı hadisə identifikatorundan və ya diqqətlə hazırlanmış kompozit açardan istifadə edin. Təkrar çatdırılma təkrar müştəri bildirişlərini işə salmamalıdır.
6. Göndəriş vəziyyətini yenidən hesablayın. Cari statusu son gələn yeniləmə ilə əvəz etmək əvəzinə hadisənin mənasını və xronologiyasını qiymətləndirin.
7. Tam olmayan qeydləri uyğunlaşdırın. API əldə etməni dəstəklədikdə, buraxılmış yeniləmələri və ya köhnəlmiş qeydləri tətbiq olunan istifadə limitləri daxilində araşdırmaq üçün bu imkandan istifadə edin.

Təchizatçıya xas autentifikasiyanı, sahə adlarını və xəta emalını adapter daxilində saxlayın. Sifariş idarəetmə sisteminiz təchizatçı cavabının hər detalından birbaşa asılı olmaq əvəzinə daxili göndəriş modelinizi qəbul etməlidir. Bu ayrılma sonrakı API dəyişikliklərinin sınağını da asanlaşdırır.

Tasman dənizi üzərindən marşrutları əminlik uydurmadan idarə edin

Sərhədlərarası izləmə status etiketləri ardıcıllığından daha çox kontekst tələb edir. Mənbə məlumatları bu fərqləri dəstəklədikdə tətbiqiniz ixrac hadisəsini, gömrüklə bağlı hadisəni, daşıyıcı təhvil-təslimini və son çatdırılma hadisəsini fərqləndirməlidir.

Ümumi tranzit skanından gömrük rəsmiləşdirilməsini nəticə kimi çıxarmayın. Eyni şəkildə, son skanın olmaması gömrüyün bağlamanı saxladığını göstərmir. Faydalı müştəri mesajı son təsdiqlənmiş hadisəni və onun vaxtını bildirir, sonra komandanızın həqiqətən dəstəkləyə biləcəyi növbəti addımı izah edir.

Mənşə və təyinatı skan məkanından ayrı saxlayın. Avstraliyadan Yeni Zelandiyaya gedən göndəriş gəliş skanı aldığı üçün Yeni Zelandiyanın ölkədaxili göndərişinə çevrilmir. Bu fərq marşrut hesabatları və istisnaya görə məsuliyyət baxımından əhəmiyyətlidir.

Çatdırılma tərəfdaşı prosesə qoşularsa, onun izləmə qeydini yalnız əlaqə göndəriş məlumatları, izləmə xidməti və ya əməliyyat baxımından təsdiqlənmiş qeyd tərəfindən dəstəkləndikdə bağlayın. İdentifikatorlar oxşar göründüyü üçün bağlamaları birləşdirməyin.

İzləmə hadisələrini faydalı müştəri yeniləmələrinə çevirin

Müştəriyə təqdim olunan səhifəniz dörd suala cavab verməlidir: son təsdiqlənmiş status nədir, bu nə vaxt baş verib, məlumdursa harada qeydə alınıb və müştərinin hərəkət etməsi tələb olunurmu?

Bildiriş qaydalarını hadisələrin qəbulundan ayrı saxlayın. Hər skan e-poçt və ya mətn mesajına layiq deyil. İlk təsdiqlənmiş hərəkət, çatdırılma cəhdi, götürmə tələbi və ya çatdırılma hadisəsi kimi mənalı keçidləri müəyyənləşdirin və eyni keçid üçün təkrarlanan xəbərdarlıqları dayandırın.

• Köhnəlmiş izləmə: Sükutu itki sübutu kimi təqdim etmədən son yeniləmənin nə vaxt baş verdiyini bildirin.
• Çatdırılma təxminləri: Daşıyıcının təqdim etdiyi təxmini satıcının vədindən fərqləndirin. Heç biri mövcud olmadıqda tarix uydurmayın.
• İstisnalar: İzah olunmayan xəta etiketi göstərmək əvəzinə, məlum olduqda konkret növbəti addımı bildirin.
• Çatdırılma ilə bağlı mübahisələr: Mənbə hadisəsini qoruyun və işi dəstəyə yönləndirin; yalnız çatdırılıb statusu hər müştəri mübahisəsini həll etmir.

API məlumatları ilə yanaşı izləmə səhifələrini də qoruyun. Lazımsız ünvan və əlaqə məlumatlarını göstərməkdən çəkinin, xidmət məlumatlarını serverdə saxlayın və göstərilən məlumatlara uyğun giriş nəzarətləri tətbiq edin.

Yayılmadan əvvəl marşrut əsaslı pilot həyata keçirin

Biznesiniz üçün əhəmiyyətli olduqda Avstraliya daxilində, Yeni Zelandiya daxilində, Avstraliyadan Yeni Zelandiyaya və Yeni Zelandiyadan Avstraliyaya göndərişləri sınaqdan keçirin. Adi çatdırılmaları və parçalanmış sifarişlər, tanınmayan nömrələr, təhvil-təslimlər, çatdırılma cəhdləri, götürmə hadisələri, qaytarmalar və gecikmiş skanlar kimi əməliyyatın kənar hallarını daxil edin.

Daşıyıcının yoxlanması üçün uyğun icazəyə malik real göndəriş qeydlərindən istifadə edin. Öz tətbiqinizin dayanıqlığını sınaqdan keçirmək üçün sintetik hadisələrdən yararlanın, lakin sintetik nəticələri canlı daşıyıcı əhatəsinin sübutu hesab etməyin.

• İdentiklik yoxlaması: Hər yeniləmə düzgün göndərişə və sifarişə çatır.
• Xronologiya yoxlaması: Ardıcıllıqdan kənar hadisələr çatdırılma irəliləyişini səhvən geri çevirmir.
• Bərpa yoxlaması: Müvəqqəti nasazlıqlar və dublikat yeniləmələr məlumat itkisinə və ya təkrar xəbərdarlıqlara səbəb olmur.
• Dəstək yoxlaması: Agentlər ilkin hadisəni yoxlaya və müştəriyə təqdim olunan statusu anlaya bilirlər.
• Kommersiya yoxlaması: Gözlənilən istifadə hesabın təsdiqlənmiş hesablaşma modelinə və limitlərinə uyğundur.

Pilotun qiymətləndirilməsindən əvvəl qəbul hədlərini müəyyənləşdirin. Qeydiyyat nəticələrini, xəritələndirilməmiş hadisələri, emal gecikmələrini, dublikat bildirişləri və həll olunmamış köhnəlmiş göndərişləri ölçün. Düzəlişin düzgün məsul şəxsə çatması üçün daşıyıcı məlumatlarındakı gecikmələri öz tətbiqiniz daxilindəki gecikmələrdən ayırın.

Tətbiq komandanız natamam izləməni izah edib bərpa edə bildikdə, yalnız uğurlu çatdırılmaları göstərə bildikdə deyil, hazır sayılır. Bir API bağlantını sadələşdirir; bu bağlantını etibarlı edən isə göndəriş modeliniz, hadisə qaydalarınız və əməliyyat prosedurlarınızdır.

FAQ

Bir izləmə API-si daşıyıcı üzrə göndəriş inteqrasiyalarını əvəz edirmi?

Mütləq deyil. İzləmə, etiket yaradılması, götürmə sifarişi, tarif hesablanması və gömrük sənədləri ayrı funksiyalardır. Seçilmiş məhsulun əhatə dairəsini yoxlayın və icra prosesiniz tələb etdikdə digər inteqrasiyaları saxlayın.

İlk daşıyıcı skanından əvvəl izləmə nömrəsini qeydiyyatdan keçirə bilərəmmi?

API-nin qeydiyyat qaydalarını yoxlayın. Tətbiqinizi qəbul edilmiş izləmə qeydiyyatını təsdiqlənmiş fiziki hərəkətdən fərqləndirəcək şəkildə layihələndirin. Heç bir hadisəsi olmayan qeyd avtomatik olaraq tranzitdə göstərilməməlidir.

Vahid API hər daşıyıcı üçün real vaxt yeniləmələri təmin edəcəkmi?

Bunu fərz etməyin. Başdan-başa yenilənmə sürəti daşıyıcının məlumatı nə vaxt yayımlamasından, izləmə xidmətinin onu nə vaxt əldə etməsindən və tətbiqinizin onu nə vaxt emal etməsindən asılıdır. İstifadə etdiyiniz daşıyıcı-xidmət kombinasiyaları üzrə yeniləmə davranışını təsdiqləyin.

İzləmə nömrəsi dəyişdikdə nə baş verməlidir?

İlkin identifikatoru saxlayın və təsdiqlənmiş əvəzləyici və ya tərəfdaş identifikatorunu eyni daxili göndərişə əlavə edin. Hər iki tarixçəni qoruyun və dublikat qeydlərin ziddiyyətli bildirişlər yaratmasının qarşısını alın.

17TRACK bu inteqrasiya üçün uyğundurmu?

Bəli. Onun Tracking API-si burada təsvir edilən çoxdaşıyıcılı inteqrasiya üçün uyğundur. Yerləşdirmədən əvvəl Avstraliya və Yeni Zelandiya göndəriş nümunələrinizdən istifadə edərək onu qiymətləndirin və rəsmi API resursları vasitəsilə daşıyıcı dəstəyini, texniki davranışı və hesab şərtlərini təsdiqləyin.

Mənbələr

• 17TRACK Tracking API — bu bələdçidə müzakirə olunan API seçimi üçün rəsmi məhsul resursu.
• 17TRACK API documentation — sorğu formatlarını, inteqrasiya tələblərini və dəstəklənən davranışı yoxlamaq üçün rəsmi texniki istinad.