Braziliyada sərhədlərarası e-ticarət üçün Göndəriş İzləmə API-sini necə seçmək olar

Başlıq daşıyıcılarının sayını müqayisə etməklə deyil, faktiki daşınma marşrutlarınızı, beynəlxalq daşımadan daxili çatdırılmaya keçidləri, gömrüklə bağlı hadisələri və çatdırılma istisnalarını sınaqdan keçirərək Braziliyada sərhədlərarası e-ticarət üçün yük izləmə API-si seçin. Düzgün API faydalı yük məlumatlarını qoruyub saxlamalı, sistemlərinizlə etibarlı şəkildə inteqrasiya olunmalı və natamam izləmə məlumatlarını çatdırılma vədinə çevirmədən dəqiq portuqalca müştəri mesajlarını dəstəkləməlidir.

E-ticarət əməliyyatları rəhbəri və mühəndislik komandası üçün satınalma qərarı son nəticədə əməliyyat xarakterlidir: bu inteqrasiya sifarişin harada olduğunu izah edə, növbəti addımı kimin atmalı olduğunu müəyyənləşdirə və müştəri dəstəyinin köhnəlmiş və ya yanıltıcı məlumatlarla işləməsinin qarşısını ala bilərmi? Tələbləri praktik qısa siyahıya və konsepsiyanın sübutuna çevirmək üçün aşağıdakı çərçivədən istifadə edin.

Provayderin daşıyıcı kataloqu ilə deyil, Braziliyaya daşınma marşrutlarınızla başlayın

Daşıyıcı siyahısı başlanğıc nöqtəsidir, lakin API-nin həmin daşıyıcıdan satın aldığınız hər xidməti izləyəcəyinə sübut deyil. Sərhədlərarası daşımalar mənşə daşıyıcısını, beynəlxalq logistika tərəfdaşını və daxili çatdırılma operatorunu əhatə edə bilər. İzləmənin davamlılığı həmin konkret zəncir üzrə hansı hadisələrin və identifikatorların mövcud olmasından asılıdır.

Provayderlərlə əlaqə saxlamazdan əvvəl son göndərişlərdən istifadə edərək marşrut inventarı yaradın. Mənşə ölkəsini, daşınma xidmətini, beynəlxalq logistika provayderini, məlum olduğu halda Braziliyadakı çatdırılma operatorunu və hər mərhələdə mövcud olan izləmə nömrələrini qeyd edin. Həm əsas marşrutlarınızı, həm də müntəzəm olaraq dəstək müraciətləri yaradan daha az həcmli marşrutları daxil edin.

• Poçt və ekspress marşrutları ayırın. Birindəki uğurun digərinə hazırlığı sübut etdiyini düşünməyin.
• İdentifikator dəyişikliklərini qeyd edin. Keçid mərhələsindən sonra göndərişin eyni izləmə nömrəsini saxladığını, yoxsa yeni nömrə aldığını müəyyənləşdirin.
• Çətin istiqamətləri və nəticələri daxil edin. Yalnız uğurlu çatdırılmaları deyil, gecikmiş göndərişləri, uğursuz çatdırılma cəhdlərini, qaytarmaları və natamam izləmə tarixçələrini də sınaqdan keçirin.
• Biznes məsulunu müəyyən edin. Əməliyyatlar hadisələrin faydalılığını, mühəndislik inteqrasiyanın davranışını, dəstək isə müştəri izahlarını yoxlamalıdır.

İlk seçim qaydanız sadə olmalıdır: provayder vacib marşrutlarınız üzrə faydalı izləməni nümayiş etdirməlidir. Başqa yerlərdə geniş əhatə dairəsi müştərilərinizin istifadə etdiyi marşrutlarda çatışmayan keçidi kompensasiya edə bilməz.

İstifadəyə yararlı izləmə hadisəsinin nələri ehtiva etməli olduğunu müəyyənləşdirin

“Yoldadır” kimi standartlaşdırılmış status hesabat hazırlamağa kömək edir, lakin sərhədlərarası dəstək üçün nadir hallarda kifayətdir. Nümunə cavablar istəyin və API-nin əsas hadisəni necə təqdim etdiyini yoxlayın. Həqiqətən yeni hərəkəti tərcümə edilmiş təsvir, təkrarlanan hadisə və ya gecikmiş yeniləmədən ayırmaq lazımdır.

Qiymətləndiriləcək məlumat	Nə üçün vacibdir	Nəyi sınaqdan keçirmək lazımdır
Hadisənin ilkin təsviri	Geniş statusun buraxa biləcəyi detalları qoruyur.	Dəstək normallaşdırılmış statusla yanaşı daşıyıcının ifadəsini də əldə edə bilərmi?
Hadisə vaxtı və saat qurşağının işlənməsi	Yanlış vaxt qrafiklərinin və yanıltıcı gecikmə hesablamalarının qarşısını almağa kömək edir.	Çatışmayan ofsetlər, gecikmiş hadisələr və müxtəlif ölkələrdən gələn hadisələr necə təqdim olunur?
Daşıyıcı və izləmə identifikatorları	Beynəlxalq hərəkəti daxili çatdırılma ilə əlaqələndirir.	Əlaqəli nömrələr təkrarlanan müştəri göndərişləri yaratmadan əlaqələndirilə bilərmi?
Məkan məlumatı	Mənbə təqdim etdikdə kontekst yaradır.	İnteqrasiya bildirilmiş məkanı çatışmayan və ya çıxarılan məlumatdan ayırırmı?
İstisna detalları	Düzgün əməliyyat reaksiyasını dəstəkləyir.	Tətbiqiniz çatdırılma cəhdini gömrüklə bağlı problemdən ayıra bilərmi?

Hər hadisənin bütün sahələri ehtiva etməsini tələb etməyin. İlkin mənbələr bəzi məlumatları buraxa bilər. Bunun əvəzinə, bildirilmiş faktlar, provayder şərhləri və mövcud olmayan məlumatlar arasında aydın fərq tələb edin.

Gömrük görünürlüğünü rəsmiləşdirmə səlahiyyəti deyil, məlumat kimi qəbul edin

Braziliyaya yönələn göndərişlər üçün gömrüklə bağlı izləmə ayrıca qəbul sınağı tələb edir. Ümumi istisna dəstəyin göndərişin emal olunub-olunmadığını, məlumatın çatışıb-çatışmadığını və ya alıcının hərəkətinin bildirilib-bildirilmədiyini müəyyənləşdirməsinə mane ola bilər.

API-nin daşıyıcıdan və ya logistika tərəfdaşından həqiqətən nə qəbul etdiyini qiymətləndirin. İzləmə inteqrasiyasının idxal rüsumlarını hesablaya, rəsmiləşdirmə sənədlərini təqdim edə, ödənişi təsdiqləyə və ya bağlamanı buraxa biləcəyini düşünməyin. Bunlar ayrıca yoxlama tələb edən ayrı imkanlar və məsuliyyətlərdir.

• Gömrüklə bağlı hadisələrin ilkin təsvirlərini qoruyub saxlamadığını yoxlayın.
• “Hərəkət tələb olunur” ifadəsinin açıq şəkildə bildirildiyini, yoxsa geniş statusdan çıxarıldığını müəyyən edin.
• Növbəti addımı hansı rəsmi daşıyıcı və ya logistika kanalının təsdiqləməli olduğunu müəyyənləşdirin.
• Avtomatlaşdırılmış mesajların ödəniş məbləği, son tarix və ya tələb olunan sənəd uydurmasının qarşısını alın.

Correios tərəfindən idarə olunan göndərişlər üçün alıcıya yönəlmiş prosedurları yoxlamağa rəsmi veb-saytdan başlayın. Digər çatdırılma tənzimləmələri üçün müvafiq rəsmi kanalı müqavilə bağladığınız logistika provayderi ilə təsdiqləyin. İzləmə bildirişi bildirilmiş vəziyyəti izah etməli və müştərini təhlükəsiz şəkildə yönləndirməlidir; təsdiqlənməmiş göstərişi rəsmi tələb kimi təqdim etməməlidir.

İnteqrasiyanın etibarlılığını yalnız ideal ssenari ilə məhdudlaşmadan sınaqdan keçirin

Uğurlu API sorğusu göndərişin bütün səfəri boyunca sinxron qalacağını sübut etmir. Provayderlərdən qeydiyyat, yeniləmələrin əldə edilməsi, hadisələrin çatdırılması, izləmənin müddətinin bitməsi və kəsintidən sonra bərpa prosesini izah etmələrini istəyin. Öhdəlik götürməzdən əvvəl cavabları sənədlərlə və sınaq davranışı ilə yoxlayın.

Webhook çatdırılması və bərpa

Provayder webhook-lar təklif edirsə, autentifikasiyanı, təkrar cəhd davranışını, vaxt aşımı gözləntilərini və təkrar oynatma və ya bərpa mexanizmini təsdiqləyin. Provayder açıq şəkildə başqa cür zəmanət verməyibsə, qəbul edən sisteminizi təkrar çatdırılmaları və sıradan kənar gələn hadisələri idarə edəcək şəkildə qurun. Qəbul etməni vaxtında təsdiqləyin, emalı növbəyə qoyun və müştəri mesajlarını birbaşa yoxlanılmamış daxil olan məlumatdan göndərməyin.

Son nöqtəniz əlçatan olmadıqda nə baş verdiyini soruşun. Komandanız çatışmayan yeniləmələri uzlaşdırmaq üçün sənədləşdirilmiş üsula ehtiyac duyur; bu, əldəetmə son nöqtəsi, təkrar oynatma prosesi və ya başqa dəstəklənən bərpa üsulu ola bilər. Seçilmiş metodun gözlənilən kəsinti ssenarilərinə uyğun olduğunu təsdiqləyin.

Daşıyıcının müəyyənləşdirilməsi və göndərişin qeydiyyatı

Avtomatik aşkarlamanın həmişə nəzərdə tutulan daşıyıcını müəyyən etdiyini düşünmək əvəzinə, qeyri-müəyyən izləmə nömrələrini sınaqdan keçirin. Dəstəkləndiyi halda, məlum daşıyıcı identifikatorunun təqdim edilməsi qeyri-müəyyənliyi azalda bilər. Həmçinin təkrar qeydiyyatları, etibarsız nömrələri, ilk skanın gecikməsini və ikinci identifikator əldə edən göndərişi sınaqdan keçirin.

Yenilik və müşahidəolunma

Daşıyıcı hadisəsinin vaxtını sisteminizin onu qəbul etdiyi vaxtdan ayırın. Daşıyıcının ictimai izləmə səhifəsinin özü gec yenilənə və ya başqa məlumat kanalı ilə fərqlənə biləcəyini nəzərə alaraq fərqi sənədləşdirilmiş istinadla müqayisə edin. Provayderin dayanmış izləməni və mənbənin müvəqqəti nasazlıqlarını necə idarə etdiyini soruşun; hər sakit dövrü itirilmiş bağlama kimi şərh etməyin.

Portuqalca mesajları növbəti faydalı addım ətrafında qurun

Portuqalca lokallaşdırma status adlarını tərcümə etməkdən daha çox şeydir. Müştəri nə baş verdiyini, hərəkətin lazım olub-olmadığını və etibarlı yardımı haradan alacağını bilməlidir. Dəstək agentlərinə qeyri-adi hadisəni araşdırmaq üçün daşıyıcının ilkin təsviri də lazım ola bilər.

Üç təbəqəni ayrı saxlayın: mənbə hadisəsi, daxili əməliyyat kateqoriyanız və müştəriyə yönəlmiş mesaj. Məsələn, qeyri-müəyyən gömrük hadisəsi avtomatik olaraq ödəniş tələbinə çevrilməməlidir. Gəliş skanı “çatdırılmaya çıxıb” bildirişinə çevrilməməlidir.

Təkrarlar, köhnə hadisələr və aşağı dəyərli aralıq skanlar üçün bildirişlərin susdurulması qaydalarını müəyyənləşdirin. Çatdırılma təxminlərini göstərirsinizsə, onların mənbəyini və mənasını yoxlayın. Satıcının vədi, daşıyıcının təxmini və provayderin yaratdığı proqnoz fərqli anlayışlardır və bir-birinin əvəzinə təqdim edilməməlidir.

Məxfilik, təhlükəsizlik və kommersiya şərtlərini birlikdə yoxlayın

Müqavilə şərtlərini qiymətləndirməzdən əvvəl inteqrasiyanızın ötürəcəyi məlumatları xəritələndirin. İzləmə qeydləri müştəri sifarişləri ilə əlaqələndirilə bilər, buna görə lazımsız şəxsi məlumatları minimuma endirin və göndəriş məlumatlarına çıxışı məhdudlaşdırın. Yük məlumatı əlavə sahələrə icazə verdiyi üçün müştərinin vergi identifikatorlarını, ünvanlarını və ya telefon nömrələrini göndərməyin.

Braziliya ilə bağlı şəxsi məlumatların emalı üçün LGPD üzrə öhdəlikləri qiymətləndirərkən məxfilik və ya hüquq komandanızı cəlb edin. Braziliyanın məlumatların mühafizəsi qurumu ANPD rəsmi istinad nöqtəsidir. Tənzimləmənizə tətbiq olunduğu qədər emal rollarını, saxlanmanı, silinməni, subemalçıları, beynəlxalq ötürmələri və insident prosedurlarını nəzərdən keçirin. Satıcının ümumi təhlükəsizlik bəyanatı bu qiymətləndirməni əvəz etmir.

Öz göndəriş həcminizə və həyat dövrünüzə əsaslanan yazılı kommersiya ssenarisi istəyin. Nəyin ödənişli olduğunu təsdiqləyin: qeydiyyat, izlənən göndəriş, API sorğusu, yeniləmə və ya başqa vahid. Təkrarlamaların, uzunmüddətli göndərişlərin, yenidən izləmənin, limitdən artıq istifadənin, dəstəyin və tarixi girişin təklifə necə təsir etdiyini soruşun. Bunlar yoxlanmalı suallardır, hər hansı provayderin qiymətləri barədə fərziyyələr deyil.

Mühəndislik texniki xidmətini və istisnaların əl ilə idarə edilməsini də daxil etməklə ümumi əməliyyat xərclərini müqayisə edin. Təklif olunan vahid qiymətinin aşağı olması mütləq daha ucuz həll demək deyil; inteqrasiya ən çox istifadə olunan marşrutlarınızı əl ilə yoxlamalardan asılı vəziyyətdə qoya bilər.

17TRACK qiymətləndirməyə necə uyğun gəlir

İzləmə inteqrasiyasını qiymətləndirən komandalar üçün nəzərdən keçirilməli uyğun 17TRACK məhsulu onun Tracking API-sidir. Təklif olunan tətbiqi qiymətləndirmək üçün rəsmi API sənədlərindən istifadə edin və Braziliyaya yönələn konkret daşıyıcılarınızı, xidmətlərinizi və keçid ssenarilərinizi təsdiqləməyi xahiş edin.

Burada təsvir olunan eyni qəbul sınaqlarını tətbiq edin. İstehlakçı izləmə nəticəsini API çatdırılma davranışının, müqavilə üzrə əlçatanlığın və ya müəyyən məlumat sahəsinin sübutu kimi qəbul etməyin. API cavabını, inteqrasiya tələblərini, kommersiya şərtlərini və dəstək razılaşmalarını birbaşa təsdiqləyin.

Marşrutlarınız bir neçə logistika provayderini əhatə etdikdə və komandanız ümumi interfeys istədikdə çoxdaşıyıcılı inteqrasiyanı qiymətləndirməyə dəyər. Bir müqaviləli xidmət üstünlük təşkil edir və məlumat tələblərinizə cavab verirsə, birbaşa daşıyıcı inteqrasiyası kifayət edə bilər. Heç bir arxitektura faktiki göndəriş tarixçələrini sınaqdan keçirmək ehtiyacını aradan qaldırmır.

Aydın satınalma meyarları ilə konsepsiyanın sübutunu həyata keçirin

Tamamlanmış səfərləri yoxlamaq üçün tarixi göndərişlərdən, yeniləmələrin çatdırılmasını sınaqdan keçirmək üçün isə canlı göndərişlərdən istifadə edin. Yalnız tarixi izləmə yeni hadisələrin sisteminizə nə qədər tez çatacağını nümayiş etdirə bilməz. Lazım gəldikdə icazə alın və lazımsız müştəri məlumatlarını paylaşmayın.

1. Təmsilçi nümunə seçin. Vacib mənşə nöqtələrinizi, xidmətlərinizi, daxili çatdırılma tənzimləmələrinizi və istisna növlərinizi əhatə edin.
2. Hər göndəriş üçün istinad müəyyən edin. Müvafiq daşıyıcı tarixçəsini və məlum identifikator dəyişikliklərini qeyd edin. Fərqləri daha əlverişli nəticəni səssizcə seçmədən sənədləşdirin.
3. Marşrut səviyyəsində nəticələri ölçün. Qeydiyyat uğurunu, müvafiq hadisələrin əlçatanlığını, keçidin davamlılığını və müşahidə olunan yeniləmə gecikməsini qiymətləndirin. Məxrəci və çatışmayan halları görünən saxlayın.
4. Uğursuzluqların idarə edilməsini sınaqdan keçirin. Webhook qəbul edənin işini dayandırın, təkrar göndərişlər təqdim edin və təkrar müştəri bildirişləri yaratmadan bərpanı sınaqdan keçirin.
5. Mesajları dəstək komandası ilə nəzərdən keçirin. Agentlərdən nəticənin göndərişi izah edib-etmədiyini və əsaslandırıla bilən növbəti addımı müəyyən edib-etmədiyini soruşun.
6. Məsuliyyəti və xərci təsdiqləyin. İnteqrasiya xətalarına, daşıyıcı eskalasiyalarına, müştəri mesajlarına və hesab-fakturaların yoxlanmasına məsul şəxsi təyin edin.

Nəticələri nəzərdən keçirməzdən əvvəl biznes ehtiyaclarınıza əsaslanan qəbul hədlərini müəyyənləşdirin; ixtiyari universal göstəricidən istifadə etməyin. Tələb olunan marşrut əhatəsini, təhlükəsiz inteqrasiyanı və buraxılmış yeniləmələrdən bərpanı satınalma meyarları kimi qəbul edin. İkinci dərəcəli xüsusiyyətlərdən yalnız bu meyarlar yerinə yetirildikdən sonra provayderləri fərqləndirmək üçün istifadə edin.

Braziliyaya yönələn vacib səfərlərinizi praktikada başa düşülən və bərpa edilə bilən edən API-ni seçin. Kritik keçid və ya istisna yoxlanılmamış qalırsa, tətbiqi genişləndirməzdən əvvəl əlavə sınaq və ya yazılı tətbiq öhdəliyi ilə məsələni həll edin.

FAQ

Braziliyaya daxil olan göndərişlər üçün Correios dəstəyi kifayətdirmi?

Mütləq deyil. Bu, müqavilə bağladığınız marşrutdan və son çatdırılma tənzimləməsindən asılıdır. Beynəlxalq mərhələni, istənilən identifikator dəyişikliyini və daxili mərhələni birlikdə sınaqdan keçirin. Bir operatorun siyahıda olması bütün səfər üzrə görünürlüğü təsdiqləmir.

İzləmə API-si gömrük gecikməsini həll edə bilərmi?

İzləmə bildirilmiş hadisələri üzə çıxarmağa və problemi düzgün şəxsə yönləndirməyə kömək edə bilər. Lakin özü-özlüyündə sənədlər təqdim etmək, idxal ödənişlərini toplamaq və ya malları buraxmaq səlahiyyəti yaratmır. İş axınınız bunları tələb edirsə, həmin funksiyaları ayrıca yoxlayın.

Webhook-lardan, yoxsa sorğulama üsulundan istifadə etməliyik?

Dəstəkləndikdə webhook-lar təkrar sorğulara ehtiyacı azalda bilər. Bununla belə, onlar autentifikasiya, təkrarların idarə edilməsi və bərpa planlaması tələb edir. Sorğulama provayderin dəstəklədiyi dizayn və limitlərdən asılı olaraq əsas əldəetmə metodu və ya uzlaşdırma mexanizmi kimi xidmət edə bilər.

İzləmə yenilənməyi dayandırdıqda nə baş verməlidir?

İnteqrasiya problemini yeni bildirilmiş hərəkəti olmayan göndərişdən ayırın. Məlumat qəbulunun vəziyyətini və rəsmi mənbəni yoxlayın, sonra marşruta xas eskalasiya siyasətini tətbiq edin. Göndərişi avtomatik olaraq itirilmiş kimi işarələməyin və yeni çatdırılma tarixi vəd etməyin.

İzləmə API-si sifariş idarəetmə sistemimizi əvəz edirmi?

Xeyr. İzləməni göndəriş məlumatı mənbəyi kimi qəbul edin. Sifariş idarəetməsi və dəstək iş axınlarınız sifariş identikliyinə, müştəri ilə kommunikasiya qaydalarına, geri ödənişlərə, əvəzləmələrə və eskalasiya qərarlarına görə məsuliyyəti saxlamalıdır.

Mənbələr

• 17TRACK Tracking API — API inteqrasiyasını qiymətləndirmək üçün rəsmi məhsul istinadı.
• 17TRACK API sənədləri — tətbiq tələblərini və dəstəklənən davranışı yoxlamaq üçün texniki istinad.
• Correios — daşıyıcı məlumatları və alıcıya yönəlmiş xidmətlər üçün rəsmi başlanğıc nöqtəsi.
• Autoridade Nacional de Proteção de Dados — məxfilik yoxlaması üçün Braziliyanın rəsmi məlumatların mühafizəsi qurumu.