Skip to main content
Ana səhifəBloqBələdçilərTracking API göndərmə etiketləri olmadan işləyə bilərmi? 3Pl və marketplace sifarişlərini izləmək?

Tracking API göndərmə etiketləri olmadan işləyə bilərmi? 3Pl və marketplace sifarişlərini izləmək?

17TRACK

Bəli. Daşıma API-si biznesinizin göndəriş etiketləri yaratması olmadan da işləyə bilər; bunun üçün daşıyıcı və ya göndəriş tərəfdaşı izlənilə bilən göndəriş yaratmalı və siz API-nin dəstəklədiyi istifadə edilə bilən izləmə nömrəsini və ya başqa identifikatoru əldə edə bilməlisiniz. Bu, üçüncü tərəf logistika provayderi (3PL) və ya marketplace sifarişlərin icrasını idarə etdikdə geniş yayılmış haldır. Fərq etiketi özünüz almamağınız ilə ümumiyyətlə heç bir göndəriş identifikatorunun olmaması arasındadır: birinci hal adətən mümkündür; ikinci halda isə API-nin izləmək üçün heç bir məlumatı olmaya bilər.

Can a Tracking API Work without Shipping Labels Tracking 3Pl

Satıcı, marketplace operatoru və ya inteqrasiya komandası üçün praktiki vəzifə hər bir sifarişi onu faktiki olaraq göndərən tərəfin yaratdığı göndərişlə əlaqələndirməkdir. Bunun üçün etiketlərin yaradılmasına nəzarət etmək deyil, düzgün məlumatlara çıxış əldə etmək lazımdır.

Etiketi özünüz yaratmadıqda daşıma API-sinin ehtiyac duyduğu məlumatlar

Göndəriş etiketi göndəriş identifikatoru yaratmağın bir üsuludur, lakin adətən daşıma API-sinin oxuduğu giriş məlumatı deyil. İzləmə inteqrasiyaları ümumiyyətlə etiket başqa yerdə yaradıldıqdan sonra təqdim edilən göndəriş məlumatları əsasında işləyir. Bağlantını layihələndirməzdən əvvəl çox vaxt bir-birini əvəz edən məlumatlar kimi qəbul edilən üç qeydi ayırın:

  • Sifariş ID-si: Mağazanızda, marketplace hesabınızda və ya sifarişlərin idarə edilməsi sisteminizdə alış-verişi müəyyən edir. Bir neçə məhsulu və bir neçə göndərişi əhatə edə bilər.
  • İcra və ya bağlama ID-si: 3PL və ya marketplace sistemində icra əməlini və ya bağlamanı müəyyən edir. Onun formatı və mənası həmin sistemdən asılıdır.
  • Daşıyıcının izləmə nömrəsi: Daşıyıcının və izləmə xidmətinin onu qəbul etməsi şərtilə, izləmə məqsədləri üçün göndərişi müəyyən edir.

Daxili sifariş ID-niz düzgün müştəri sifarişini tapmağınıza kömək edir. O, avtomatik olaraq daşıyıcının izləmə nömrəsi funksiyasını daşımır. Adi inteqrasiya modeli 3PL və ya marketplace-dən izləmə nömrəsini əldə etmək, həmin nömrəni daşıma API-si vasitəsilə qeydiyyatdan keçirmək və ya sorğulamaq, sonra isə qaytarılan göndəriş məlumatlarını müvafiq sifariş və ya bağlama ilə əlaqələndirməkdir.

Daşıyıcının adı və ya kodu da tələb oluna bilər. Bəzi xidmətlər daşıyıcını avtomatik müəyyən etməyə cəhd edə bilər, lakin xüsusilə identifikatorlar müxtəlif daşıyıcılarda üst-üstə düşdükdə və ya sifariş bir neçə çatdırılma şəbəkəsindən keçdikdə bunu fərz etmək əvəzinə sınaqdan keçirmək lazımdır. İnteqrasiyanı həyata keçirməzdən əvvəl API-nin qəbul etdiyi identifikatorları, daşıyıcı seçimi qaydalarını, qeydiyyat tələblərini və status sahələrini onun sənədlərindən yoxlayın.

3PL tərəfindən göndərilən sifarişlərin izlənməsi

3PL sifarişi qablaşdırdıqda, etiketi aldıqda və bağlamanı daşıyıcıya təhvil verdikdə biznesiniz etiketi heç vaxt görməyə bilər. Buna baxmayaraq, həmin proses nəticəsində yaranan göndəriş məlumatlarına ehtiyacınız var. 3PL-dən soruşun ki, hansı sistem və ya məlumat axını izləmə nömrələrini, daşıyıcı məlumatlarını, bağlama identifikatorlarını və icranı tələb edərkən təqdim etdiyiniz sifariş istinadını göstərir.

İşlək 3PL axını adətən belə görünür:

  1. Mövcud icra prosesiniz vasitəsilə sifarişi və sabit istinadı 3PL-ə göndərin.
  2. Bağlama səviyyəsində izləmə nömrəsini və mümkün olduqda daşıyıcını ehtiva edən icra təsdiqini alın.
  3. Həmin bağlamanı düzgün müştəri sifarişi və məhsullarla uyğunlaşdırın.
  4. Dəstəklənən göndəriş identifikatorunu daşıma API-sinə göndərin və ya API-nin müəyyən etdiyi axtarış prosesindən istifadə edin.
  5. İzləmə yeniləmələrini bağlama üzrə qeyd edin, sonra əməliyyat komandanıza və ya müştəriyə sifariş səviyyəsində görünüş təqdim edin.

Uyğunlaşdırma mərhələsi xüsusi diqqət tələb edir. Tək bir sifariş anbardan iki qutuda çıxa bilər və ya bir məhsul digərlərindən gec göndərilə bilər. Hər iki halda bütün sifarişi dəqiq təsvir edən vahid bağlama statusu yoxdur. Bağlama səviyyəsində qeydləri saxlayın və sifariş səviyyəsindəki istənilən mesajı bu qeydlərdən formalaşdırın. Məsələn, ilk bağlama çatdırıldığı üçün sifarişi çatdırılmış kimi işarələməyin.

Düzəlişlərin necə çatdırılacağı barədə 3PL ilə razılaşın. Etiketlər ləğv edilə, bağlamalar yenidən qablaşdırıla və ilkin izləmə nömrəsi dəyişdirilə bilər. İnteqrasiyanız əvəzedici nömrəni eyni sifarişlə əlaqələndirməli və hər iki nömrəni qeyri-müəyyən müddət ərzində aktiv göndəriş kimi göstərməməlidir.

Marketplace göndərişə nəzarət etdikdə marketplace sifarişlərinin izlənməsi

Marketplace icrası oxşar texniki sual, lakin fərqli çıxış sualı yaradır. Marketplace və ya onun icra tərəfdaşı etiketi yarada bilər, lakin satıcı yalnız hesabının, sifariş prosesinin və ya səlahiyyətli inteqrasiyasının təqdim etdiyi göndəriş məlumatlarını əldə edə bilər. Marketplace onu sizin üçün əlçatan etməyibsə, daşıma API-si olmayan izləmə nömrəsini əvəz edə bilməz.

Hər bir sifariş üçün icra modelini müəyyən etməklə başlayın. Satıcı tərəfindən icra olunan sifarişlərdə bağlama məlumatlarının mənbəyi öz göndəriş prosesiniz və ya 3PL ola bilər. Marketplace tərəfindən icra olunan sifarişlərdə isə göndəriş məlumatlarının mənbəyi marketplace ola bilər və satıcı üçün əlçatan sahələr fərqlənə bilər. Sifariş səhifəsində çatdırılma statusunun göstərilməsi ayrıca API-də qeydiyyatdan keçirmək üçün uyğun daşıyıcı izləmə nömrəsinin də təqdim edildiyi anlamına gəlmir.

Marketplace izlənilə bilən nömrə təqdim edirsə, onu nəzərdə tutduğunuz sistemdə əldə etməyə və istifadə etməyə icazəniz olduğunu təsdiqləyin. Sonra daşıma API-sinin həmin identifikatoru qəbul edib-etmədiyini və nəticədə yaranan hadisələrin marketplace statusundan əlavə faydalı məlumat verib-vermədiyini yoxlayın. Marketplace yalnız öz sifariş və ya çatdırılma istinadını təqdim edirsə, açıq şəkildə dəstəklənən axtarış metodunun olub-olmadığını yoxlayın. Daxili marketplace sifariş ID-sini daşıyıcı nömrəsi kimi təqdim edib etibarlı nəticə gözləməyin.

Marketplace-in sifariş vəziyyətini və daşıma API-sinin göndəriş vəziyyətini ayrı saxlayın. Marketplace icra təsdiqləndikdən sonra sifarişi göndərilmiş kimi təsvir edə bilər, halbuki daşıyıcının izləməsində hələ qəbul skanı görünməyə bilər. Bu qeydlər müxtəlif suallara cavab verir və fərqli vaxtlarda yenilənə bilər.

Etiketsiz izləmənin problemi həll etməyəcəyi hallar

“Etiketi bizim tərəfimizdən yaradılmayıb” maneə deyil. Aşağıdakı vəziyyətlər maneə ola bilər:

  • Heç bir göndəriş yaradılmayıb: İcra prosesi istifadə edilə bilən identifikator yaratmazdan əvvəl sorğulamaq üçün heç bir daşıyıcı göndərişi olmaya bilər. Təkcə sifariş təsdiqi bağlamanın daşınmaqda olduğuna sübut deyil.
  • İdentifikator sizin üçün əlçatan deyil: 3PL və ya marketplace nömrəni saxlaya bilər, lakin onu səlahiyyətli iş prosesiniz vasitəsilə təqdim etməyə bilər. Bu məlumat çıxışı problemini mənbədə həll edin.
  • İdentifikator dəstəklənmir: İstinad nömrəsi, yalnız marketplace-də istifadə olunan kod və ya dəstəklənməyən daşıyıcı formatı seçilmiş API ilə işləməyə bilər. Sənədlərdə və sınaq göndərişi ilə qəbul edilən girişləri yoxlayın.
  • Bağlamanın hələ yeni skanı yoxdur: Daşıyıcı ilk qəbul hadisəsini qeyd etməzdən əvvəl nömrə yaradıla bilər. Boş və ya dəyişməz nəticəni nömrənin etibarsız olduğuna avtomatik sübut kimi deyil, araşdırılmalı vəziyyət kimi qəbul edin.
  • İzləmə məhdudlaşdırılıb və ya natamamdır: Daşıyıcı, xidmət və ya göndəriş prosesi müştəriyə yönəlmiş istifadə ssenariniz üçün tələb olunan hadisələri təqdim etməyə bilər. Nümunəvi göndərişlərdən istifadə etməklə faktiki hadisə keyfiyyətini təsdiqləyin.

Bu məhdudiyyətlər vacibdir, çünki API mövcud olmayan fiziki hadisələri yarada və ya başqa tərəfin sifariş məlumatlarına çıxış verə bilməz. Onun dəyəri zəruri identifikator və icazələr mövcud olduqdan sonra dəstəklənən izləmə məlumatlarını əldə edib təşkil etməkdədir.

Bu iş axını üçün API-ni necə qiymətləndirmək olar

17TRACK-in Tracking API-si komandanızın etiket almaq üçün alətə deyil, öz sistemlərində göndəriş izləmə məlumatlarına ehtiyacı olduqda araşdırıla biləcək uyğun seçimdir. Onun developer documentation bölməsi qəbul edilən qeydiyyat sahələrini, dəstəklənən daşıyıcıları, cavab strukturunu, autentifikasiyanı və istifadə ssenariniz üçün mövcud yeniləmə çatdırılması metodlarını yoxlamaq üçün nəzərdə tutulub. Ümumi daşıma API-sinin mövcudluğuna əsasən konkret 3PL, marketplace və ya xüsusi identifikator üçün dəstək olduğunu fərz etməyin.

İstənilən provayderi seçməzdən və ya tətbiq etməzdən əvvəl kiçik sınaq dəsti yaradın. Buraya daşıyıcı nömrəsi olan 3PL sifarişi, hesabınızın nömrəni təqdim etdiyi marketplace sifarişi, bir neçə bağlamalı sifariş, ilk skandan əvvəl yaradılmış nömrə və sonrakı çatdırılma hadisəsi olan göndəriş daxil edin. Əvəzetmələr və ya beynəlxalq təhvil-təslimlər adi haldırsa, onları da əlavə edin. Sınaq yalnız sorğunun uğurlu HTTP cavabı qaytarıb-qaytarmadığını deyil, əməliyyat suallarını cavablandırmalıdır:

  • Faktiki olaraq aldığınız identifikatorları əl ilə yenidən yazmadan ötürə bilirsinizmi?
  • Hər bir izləmə qeydini düzgün sifariş və bağlama ilə etibarlı şəkildə əlaqələndirə bilirsinizmi?
  • Hadisə təsvirləri, vaxt göstəriciləri və daşıyıcı məlumatları müştəri mesajlarınız və dəstək iş axınlarınız üçün kifayətdirmi?
  • Sisteminiz təkrarlanan yeniləmələri, çatışmayan hadisələri, nömrə dəyişikliklərini və uğursuz sorğuları necə idarə edəcək?
  • Marketplace və müştəri məlumatlarından nəzərdə tutduğunuz istifadə həmin məlumatlara tətbiq olunan çıxış şərtlərinə uyğundurmu?

İnteqrasiyanın özü üçün həm ilkin mənbə qeydini, həm də daşıma API-si qeydini qoruyun. Sifariş istinadını, bağlama istinadını, təqdim edilmiş izləmə nömrəsini, mövcuddursa daşıyıcı məlumatlarını və hər bir yeniləmənin alındığı vaxtı saxlayın. Bu, API hadisəsini tam icra tarixçəsi kimi təqdim etmədən uyğunsuzluğu araşdırmağı asanlaşdırır. API plan üzrə yoxlama ilə dəstəklənən çatdırılma mexanizmi vasitəsilə yeniləmələrin alınması arasında seçim təklif edirsə, seçimi sənədləşdirilmiş davranışa və vaxtında yeniləmələrə olan ehtiyacınıza əsasən edin; hər iki yanaşma səhvlərin idarə edilməsinə ehtiyacı aradan qaldırmır.

Praktiki qərar

Başqa tərəf bağlamanı göndərdikdə və sizə istifadə etməyə səlahiyyətiniz olan dəstəklənən göndəriş identifikatorunu verdikdə etiket yaratmadan daşıma API-sindən istifadə edin. Əvvəlcə 3PL və ya marketplace-dən etibarlı bağlama məlumatları axınını təmin edin. Sonra identifikatorları və izləmə hadisələrini API və sifariş uyğunlaşdırma məntiqinizlə sınaqdan keçirin. Əlinizdə yalnız sifariş ID-si və ya marketplace statusu varsa, daşıyıcı izləmə inteqrasiyasına investisiya qoymazdan əvvəl mənbə məlumatlarındakı boşluğu həll edin.

FAQ

Yalnız mağazamın sifariş nömrəsindən istifadə etməklə sifarişi izləyə bilərəmmi?

Adətən daşıyıcı izləmə API-si vasitəsilə bunu etmək mümkün deyil. Mağazanızın sifariş nömrəsi sisteminizdəki alışı müəyyən edir. Konkret xidmət sizin sifariş istinadınızın növü üzrə axtarışı açıq şəkildə dəstəkləmirsə, ümumiyyətlə müvafiq göndəriş identifikatoruna ehtiyacınız var.

3PL-in izləmə nömrələrindən istifadə etmək üçün onun icazəsinə ehtiyacım varmı?

Göndəriş məlumatlarına müqavilə və texniki çıxışınızı təsdiqləyin. 3PL artıq icra məlumatları axınının bir hissəsi kimi izləmə nömrələrini qaytara bilər, lakin inteqrasiya səlahiyyətli kanaldan istifadə etməli və müştəri məlumatlarını lazımi qaydada idarə etməlidir.

3PL nömrə göndərdikdən sonra API niyə heç bir hərəkət göstərmir?

Nömrə daşıyıcının ilk qeydə alınmış skanından əvvəl yaradılmış ola bilər. İdentifikatorun və daşıyıcının düzgün olub-olmadığını, ilkin etiketin dəyişdirilib-dəyişdirilmədiyini və sonrakı sorğunun hadisələri qaytarıb-qaytarmadığını yoxlayın. İcra qeydini yoxlamadan “hələ skan yoxdur” ifadəsini “göndərilməyib” kimi qəbul etməyin.

Bir marketplace sifarişi bir neçə bağlamada göndərilərsə nə etməliyəm?

Mövcud hər bir bağlama identifikatorunu ayrıca izləyin və bütün bağlamaları eyni sifarişlə əlaqələndirin. Bir bağlamanın çatdırılması bütün sifarişin tamamlanmış görünməsinə səbəb olmasın deyə müştəriyə təqdim olunan sifariş statusunu ayrı-ayrı bağlama statuslarından fərqləndirin.

Mənbələr

  • 17TRACK Tracking API — göndəriş izləmə inteqrasiyasını qiymətləndirmək üçün məhsul məlumatları.
  • 17TRACK API Documentation — qəbul edilən girişləri və inteqrasiya davranışını yoxlamaq üçün texniki istinad.