Skip to main content
Ana səhifəBloqBələdçilərGöndəriş izləmə məlumatlarını Oms-ə qoşmaq: sifarişlərin uyğunlaşdırılması və sinxronizasiya qaydaları

Göndəriş izləmə məlumatlarını Oms-ə qoşmaq: sifarişlərin uyğunlaşdırılması və sinxronizasiya qaydaları

17TRACK

Göndəriş izləmə məlumatlarını sifariş idarəetmə sisteminə (OMS) qoşmaq üçün izlənən hər bir bağlamanı daxili göndəriş qeydi ilə əlaqələndirin, sonra həmin göndərişi sifariş və icra sətirləri ilə bağlayın. İzləmə yeniləmələrini provayderin dəstəklədiyi interfeys vasitəsilə qəbul edin, ilkin hadisələri qoruyun və dublikatlar, gecikmiş yeniləmələr, göndəriş statusu və sifarişin tamamlanması üçün açıq qaydalar tətbiq edin. Yalnız izləmə nömrəsindən sifariş identifikatoru kimi istifadə etməyin və tək bir çatdırılma hadisəsinin çoxbağlamalı sifarişi avtomatik bağlamasına imkan verməyin.

Göndəriş izləmə məlumatlarını OMS sifarişinə necə qoşmaq olar

Bu təlimat həmin əlaqəni həyata keçirən inteqrasiya mühəndisləri və elektron ticarət əməliyyatları komandaları üçündür. Tövsiyə olunan dizayn daşıyıcı müşahidələrini biznes qərarlarından ayırır: izləmə məlumatları bağlamanın səyahətini təsvir edir, OMS isə bu səyahətin icra, müştəri kommunikasiyası və sifarişin bağlanması baxımından nə demək olduğunu müəyyənləşdirir.

Hər qeydin hansı sistemə məxsus olduğunu müəyyənləşdirin

API bağlantısı yaratmazdan əvvəl OMS administratoru, icra komandası və müştəri xidmətləri komandası ilə sahiblik məsələsini razılaşdırın. Əks halda texniki cəhətdən uğurlu inteqrasiya belə düzgün biznes məlumatlarının üzərinə yaza bilər.

  • OMS: Sifarişlərə, sifariş sətirlərinə, tələb olunan miqdarlara, ləğvlərə və sifarişin tamamlanması qaydalarına sahibdir.
  • İcra sistemi: Yaratdığı göndəriş və ya bağlama qeydlərinə, o cümlədən qablaşdırma bölgülərinə və etiket təyinatlarına sahibdir. Bu sistem OMS-in özü və ya ayrıca anbar sistemi ola bilər.
  • İzləmə provayderi: İzləmə müşahidələrini və provayder tərəfindən müəyyən edilmiş status təsnifatlarını təqdim edir.
  • İnteqrasiya qatı: İdentifikatorlararası uyğunluqları, hadisələrin işlənməsini, normallaşdırmanı, təkrar cəhdlərin idarə edilməsini və sinxronizasiya audit qeydlərini idarə edir.

Bunları proqram təminatınızla bağlı fərziyyələr deyil, tövsiyə olunan sərhədlər kimi qəbul edin. İstisnaları sənədləşdirin. Məsələn, anbar göndəriş etiketini dəyişə bilirsə, inteqrasiya yeni müşahidə olunan nömrənin köhnəsini əvəz etdiyini təxmin etmək əvəzinə həmin sistemdən açıq yeniləmə tələb etməlidir.

Statusları sinxronlaşdırmazdan əvvəl sifarişdən bağlamaya uyğunluğu qurun

Praktik əlaqə belədir: sifariş → icra → bağlama → izləmə təyinatı. OMS-iniz fərqli adlardan istifadə edə və ya bu qeydlərin bəzilərini birləşdirə bilər. Verilənlər bazasının strukturu fərqli olsa belə, əlaqələri qoruyun.

Bir sifarişin bir neçə icrası, bir icranın isə bir neçə bağlaması ola bilər. Bağlama həmçinin əvəzedici izləmə təyinatı və ya əlaqəli son mil identifikatoru əldə edə bilər. Bu identifikatorlar əlavə sifariş miqdarları yaratmamalıdır.

QeydTövsiyə olunan sahələrMəqsəd
SifarişTenant və ya mağaza ID-si, dəyişməz OMS sifariş ID-siSatıcıları ayırır və nümayiş olunan sifariş nömrələrindən asılılığın qarşısını alır.
İcraİcra ID-si, sifariş ID-si, ayrılmış sətir ID-ləri və miqdarlarAlınmış məhsullardan hansılarının icra edildiyini müəyyənləşdirir.
BağlamaDaxili bağlama ID-si, icra ID-si, mümkün olduqda bağlama bölgüləriİzləmə etiketlərindən asılı olmayan sabit identifikasiya təmin edir.
İzləmə təyinatıTəyinat ID-si, bağlama ID-si, provayder hesabı, daşıyıcı identifikatoru, izləmə nömrəsi, aktiv müddətDaxil olan izləmə müşahidələrini düzgün bağlama və təyinat həyat dövrü ilə əlaqələndirir.

Yeniləmələri saxlanılmış uyğunluq vasitəsilə tutuşdurun

Göndəriş yaradıldıqda onu izləmə üçün qeydiyyatdan keçirməzdən əvvəl daxili ID-lərini saxlayın. Sənədləşdirilmiş qeydiyyat prosesinin qaytardığı provayder tərəfindən verilmiş izləmə qeyd ID-sini saxlayın. Provayder satıcı istinadını dəstəkləyirsə, şəffaf olmayan daxili istinaddan istifadə edin və uyğunluğu yerli olaraq qoruyun.

Daxil olan yeniləmələr üçün əvvəlcə saxlanılmış provayder qeyd ID-sini düzgün provayder hesabı və tenant daxilində həll edin. Bu identifikator mövcud deyilsə, izləmə nömrəsi, daşıyıcı identikliyi, hesab konteksti və təyinat tarixçəsindən ibarət sənədləşdirilmiş kombinasiyadan istifadə edin. Bunu axtarış strategiyası kimi qəbul edin, həmin kombinasiyanın qlobal miqyasda unikal olduğuna zəmanət kimi yox.

Müştərinin adı, e-poçt ünvanı və ya əhatə dairəsi olmayan nümayiş sifariş nömrəsi əsasında uyğunlaşdırma aparmayın. İlkin sıfırların qorunması üçün izləmə nömrələrini sətir kimi saxlayın. Müvafiq daşıyıcı və ya provayder müqaviləsi belə normallaşdırmaya icazə vermədikcə simvolları silməkdən və ya registri dəyişməkdən çəkinin.

Axtarış heç bir uyğunluq və ya bir neçə mümkün uyğunluq qaytararsa, yeniləməni araşdırma üçün karantinə alın. Həll edilməmiş hadisə yanlış müştərinin sifarişinə əminliklə tətbiq edilən yeniləmədən daha təhlükəsizdir.

Bölünmüş sifarişləri bağlama bölgüləri uydurmadan idarə edin

Üç vahiddən ibarət nümunəvi sifarişi nəzərdən keçirək. A bağlaması iki vahid, B bağlaması isə bir vahid daşıyır. A bağlamasının çatdırılması iki vahid üçün çatdırılma sübutunun olması deməkdir; bu, bütün sifarişin çatdırıldığı anlamına gəlmir.

İcra sistemi yalnız hər iki bağlamanın eyni icraya aid olduğunu qeyd edirsə, vahid səviyyəsində bölgülər uydurmayın. Bütün tələb olunan bağlamaların çatdırılıb-çatdırılmadığını yenə də hesablaya bilərsiniz, lakin bölgü məlumatları mövcud olana qədər məhsul səviyyəsində çatdırılma hesabatı əlçatan olmamalı və ya açıq şəkildə qeyri-müəyyən göstərilməlidir.

İzləmə API-sini davamlı məlumat qəbul etmə qatı vasitəsilə qoşun

Provayderlə kommunikasiyanı OMS yazılarından ayrı saxlayan konveyerdən istifadə edin:

Göndərişin yaradılması → izləmə qeydiyyatı → daxil olan yeniləmə və ya planlaşdırılmış məlumat əldə etmə → davamlı hadisə yaddaşı → uyğunlaşdırma və normallaşdırma → OMS yeniləməsi → üzləşdirmə

17TRACK tətbiqi üçün Tracking API məhsul səhifəsi və rəsmi API sənədləri müvafiq başlanğıc nöqtələridir. Adapteri tətbiq etməzdən əvvəl tətbiq olunan qeydiyyat interfeysini, daşıyıcı identifikatorlarını, yeniləmələrin çatdırılma seçimlərini, autentifikasiya tələblərini, status təriflərini və hesab limitlərini təsdiqləyin. Bu təlimatdakı məlumat modeli inteqrasiya tövsiyəsidir; 17TRACK-in bu sahə adlarından istifadə etdiyini və ya OMS-iniz üçün yerli konnektor təqdim etdiyini iddia etmir.

Seçdiyiniz provayder vebhukları dəstəkləyirsə, daxil olan sorğuları onun sənədləşdirilmiş mexanizmi ilə autentifikasiya edin və qəbul edilmiş mesajları təsdiqləməzdən əvvəl davamlı şəkildə saxlayın. Yavaş OMS işlərini sorğu yolundan kənarda saxlayın. Müəyyən cavab məzmunu və ya vaxt aşımı olduğunu fərz etmək əvəzinə provayderin faktiki təsdiqləmə və təkrar cəhd müqaviləsinə əməl edin.

Sorğulama tələb olunursa, API-nin dəstəklədiyi yerdə məlumat əldə etmə irəliləyişini saxlayın, paralelliyi idarə edin və sənədləşdirilmiş tezlik limitlərinə əməl edin. Nə vebhuk qəbul edilməsi, nə də uğurlu sorğulama OMS-in yeniləndiyini sübut edir; bu nəticələri ayrıca qeyd edin.

Təkrar cəhdlərə və gecikmiş hadisələrə davam gətirən sinxronizasiya qaydalarını müəyyənləşdirin

1. Emalı idempotent edin

Eyni müşahidənin iki dəfə işlənməsi göndərişi təkrarlamamalı, miqdarları iki dəfə irəlilətməməli və eyni müştəri bildirişini yenidən göndərməməlidir. HTTP ixtiyari POST əməliyyatını idempotent etmir; inteqrasiya dublikatların qorunmasını özü həyata keçirməlidir. RFC 9110 HTTP metodlarının idempotentliyini izah edir.

Sənədləşdirildiyi və mövcud olduğu halda sabit provayder hadisə ID-sindən istifadə edin. Əks halda təyinat ID-si və hadisənin vaxtı, mənbə statusu və məkan kimi müvafiq hadisə sahələrindən barmaq izi müəyyənləşdirin. Toqquşmaların və ya dəyişdirilmiş hadisə təsvirlərinin mümkünlüyünü sənədləşdirin. Əlavə OMS əməliyyatına səbəb olmasa belə, xam müşahidəni saxlayın.

Hər yan təsiri ayrıca qoruyun. Məsələn, OMS status yazısı və e-poçt bildirişi üçün öz dublikatdan təmizləmə nəzarətləri olmalıdır. Prosesin çökməsinin qəbul edilmiş hadisəni planlaşdırılmış yeniləmə olmadan saxlamaması üçün tranzaksiyalı outbox və ya ekvivalent davamlı iş qeydindən istifadə edin.

2. Hadisə vaxtını və qəbul vaxtını ayrıca saxlayın

Hadisənin baş verdiyi vaxt və inteqrasiyanızın onu qəbul etdiyi vaxt fərqli suallara cavab verir. İlkin vaxt göstəricisi təqdimatını və verilmiş saat qurşağı ofsetini də daxil etməklə hər ikisini saxlayın. Saat qurşağı məlum olmayan hadisəyə anbarın saat qurşağını səssizcə tətbiq etməyin.

Gecikmiş yolda hərəkət skanı adətən daha yeni çatdırılmış vəziyyəti əvəz etmədən tarixçəni zənginləşdirməlidir. Bununla belə, yalnız vaxt göstəriciləri kifayət etmir: provayder düzəliş verə bilər və hadisələrdə vaxt məlumatı natamam ola bilər. Mövcud olduqda sənədləşdirilmiş ardıcıllıq və ya reviziya sahələrindən, həmçinin açıq düzəliş siyasətindən istifadə edin.

3. Mənbə təfərrüatlarını silmədən statusları normallaşdırın

OMS-in başa düşdüyü kiçik daxili lüğət yaradın; məsələn, daşıyıcının qəbulunu gözləyir, tranzitdədir, çatdırılma üçün çıxıb, çatdırılıb, istisna və geri qaytarılır. Provayderin sənədləşdirilmiş statuslarını bu lüğətə uyğunlaşdırın. Bunlar təklif olunan daxili kateqoriyalardır, universal daşıyıcı tərifləri deyil.

İlkin status kodunu, təsviri, hadisə məkanını, provayder qeyd istinadını və uyğunlaşdırma qaydasının versiyasını saxlayın. Uyğunlaşdırılmamış dəyər çatdırılıb və ya uğursuz olaraq standartlaşdırılmaq əvəzinə nəzərdən keçirilə bilən vəziyyət yaratmalıdır. Etiketin yaradılması mənbə hadisəsi bunu açıq şəkildə dəstəkləmədikcə daşıyıcının fiziki qəbulunun sübutu kimi qəbul edilməməlidir.

4. Sadə rəqəmsal sıralama deyil, keçid qaydalarından istifadə edin

Göndəriş vəziyyətləri həmişə düz xətt üzrə inkişaf etmir. İstisnadan sonra normal tranzit davam edə bilər və çatdırılma cəhdi çatdırılma demək deyil. Geri qaytarılma hərəkəti əvvəlki çatdırılma hadisəsindən sonra başlaya bilər.

  • Sonrakı sübutlar hərəkətin bərpa olunduğunu göstərdikdə istisnanın aradan qalxmasına icazə verin.
  • Adi tarixi skanın çatdırılmış vəziyyəti səssizcə əvəz etməsinin qarşısını alın.
  • Sənədləşdirilmiş düzəlişə nəzarət olunan reviziya yolu ilə icazə verin.
  • OMS bunu dəstəklədikdə geri qaytarılma hərəkətini çıxış göndərişinin tamamlanmasından ayrıca izləyin.
  • Qeyri-müəyyən və ya ziddiyyətli sübutları əməliyyat növbəsinə yönləndirin.

Bu qaydaları versiyalaşdırın. Uyğunlaşdırma dəyişdikdə onun yalnız yeni hadisələrə tətbiq ediləcəyinə, yoxsa tarixi qeydlərin nəzarətli şəkildə yenidən hesablanacağına qərar verin.

Sifariş statusunu tələb olunan icra öhdəlikləri əsasında hesablayın

Bağlama statusu və sifariş statusu ayrı sahələr olmalıdır. Çatdırılmış kimi işarələnmiş bağlama həmin bağlama üçün sübut təqdim edir; sifarişin tamamlanması isə qalan tələb olunan miqdarlardan və biznes siyasətinizdən asılıdır.

Faydalı standart yanaşma sifarişi yalnız bütün çatdırılması tələb olunan miqdarların bağlama səviyyəsində etibarlı çatdırılma sübutu olduqda və heç bir tələb olunan bölgü həll olunmamış qalmadıqda tam çatdırılmış kimi işarələməkdir. Ləğv edilmiş miqdarları OMS-in ləğv qaydalarına uyğun olaraq istisna edin. Rəqəmsal məhsulları, götürmə sifarişlərini və digər daşınma tələb etməyən öhdəlikləri öz tamamlanma şərtləri ilə idarə edin.

Əvəzedici göndərişlər açıq əlaqələr tələb edir. İtmiş bağlama əvəz edilirsə, əvəzedicinin ilkin çatdırılma öhdəliyini əvəz edib-etmədiyinə qərar verin. Əks halda ilkin bağlama tamamlanmanı qeyri-müəyyən müddətə bloklaya və ya hər iki bağlama icraya hesablana bilər. Qərarı yalnız izləmə statusundan çıxarmaq əvəzinə qeyd edin.

Çatdırılmanın tamamlanmasını maliyyə bağlanmasından, geri ödəniş hüququndan və mübahisələrin həllindən ayrı saxlayın. Daşıyıcının çatdırılma hadisəsi avtomatik olaraq geri ödənişə icazə verməməli və müştəri iddiasını həll etməməlidir.

Audit izini itirmədən xətalardan bərpa olun

Keçici xətaları məhdudlaşdırılmış geriyəçəkilmə və sənədləşdirilmiş təkrar cəhd təlimatlarından istifadə etməklə yenidən sınayın. Müvəqqəti bağlantı xətalarını etibarsız identifikatorlardan, vaxtı keçmiş etimadnamələrdən, icazə xətalarından və sxem uyğunsuzluqlarından ayırın. Sonuncular sonsuz təkrar cəhd deyil, düzəldici tədbir tələb edir.

Təsirə məruz qalan tenantı, bağlamanı, hadisə istinadını, cəhd edilmiş əməliyyatı, xəta təsnifatını və növbəti addımı ehtiva edən uğursuz iş növbəsi saxlayın. Qeydlərə araşdırma üçün kifayət qədər kontekst daxil edin, lakin lazımsız müştəri məlumatlarını və ya etimadnamələri köçürməyin.

Adi yeniləmə yoluna əlavə olaraq üzləşdirmə aparın. Köhnəlmiş izləmə məlumatı olan aktiv göndərişləri, OMS yazıları uğursuz olan qəbul edilmiş hadisələri, uyğunlaşdırılmamış müşahidələri və inteqrasiyanın hesabladığı vəziyyətlə OMS arasındakı fərqləri nəzərdən keçirin. Nəzərdən keçirmə tezliyini ixtiyari universal cədvəl tətbiq etmək əvəzinə çatdırılma öhdəlikləri, API limitləri və əməliyyat riski əsasında seçin.

Sahiblik təyin edin: mühəndislik komandası məlumat qəbulunu və yazma xətalarını idarə edir; icra əməliyyatları çatışmayan bağlama əlaqələrini həll edir; müştəri xidmətləri müştəri kommunikasiyası tələb edən istisnaları nəzərdən keçirir. Məsul sahibi olmayan növbə sadəcə saxlama məkanıdır.

İşə salmazdan əvvəl uyğunlaşdırmanı və biznes qaydalarını sınaqdan keçirin

Nəzarət olunan test məlumatlarından və məhdud istehsal buraxılışından istifadə edin. Aşağıdakı halları həm hadisə tarixçəsi, həm də nəticədə yaranan OMS qeydi ilə müqayisə edərək sınaqdan keçirin:

  • Təkbağlamalı sifariş normal şəkildə çatdırılmaya qədər irəliləyir.
  • Bölünmüş sifarişdə bir bağlama çatdırılıb, digəri isə hələ hərəkətdədir.
  • Eyni hadisə dublikat yan təsirlər olmadan dəfələrlə qəbul edilir.
  • Daha köhnə tranzit skanı çatdırılmadan sonra gəlir.
  • Naməlum daşıyıcı və ya status nəzərdən keçirmə növbəsinə daxil olur.
  • Yeni icra öhdəliyi yaratmadan etiket dəyişdirilir.
  • Təsdiqlənmiş qaydaya əsasən əvəzedici göndəriş ilkin bağlamanı əvəz edir.
  • Hadisə qəbul edildikdən sonra OMS əlçatmaz olur.
  • Proses OMS yazısı ilə onun təsdiqi arasında yenidən başlayır.
  • Eyni nümayiş sifariş nömrəsi iki mağazada mövcuddur və tenantlararası uyğunlaşdırma aparılmır.

Hər qəbul edilmiş hadisənin izlənilə bilən emal nəticəsi olduqda, qeyri-müəyyən uyğunluqlar sifarişləri avtomatik yeniləyə bilmədikdə və operatorlar uğursuz işləri təhlükəsiz şəkildə yenidən icra edə bildikdə sistemi işə salın. Bunlar sadəcə API sorğusunun uğurlu olduğunu nümayiş etdirməkdən daha faydalı qəbul meyarlarıdır.

Tez-tez verilən suallar

İzləmə nömrələrini birbaşa sifarişlərə qoşa bilərəmmi?

Ciddi şəkildə təkbağlamalı iş axını üçün ilkin mərhələdə birbaşa əlaqə kifayət edə bilər. Bununla belə, sifarişlə izləmə təyinatı arasında daxili göndəriş identifikatorundan istifadə edin. Bu, sifariş qeydinin mənasını dəyişmədən bölünmüş göndərişlər, yenidən etiketləmə və əvəzetmələr üçün miqrasiya yolu təmin edir.

İnteqrasiya vebhuklardan, yoxsa sorğulamadan istifadə etməlidir?

Provayderin dəstəklədiyi və infrastrukturunuzla uyğun olan çatdırılma mexanizmindən istifadə edin. Vebhuklar təkrar məlumat əldə etməni azalda bilər, sorğulama isə mövcud olduqda məlumat əldə etməyə əsaslanan iş axınlarını və üzləşdirməni dəstəkləyə bilər. Heç bir yanaşma davamlı yaddaş, dublikatların idarə edilməsi və bərpa ehtiyacını aradan qaldırmır.

İzləmə hadisəsi uyğun sifariş tapmadıqda nə baş verməlidir?

Onu uyğunlaşdırılmamış hadisələr növbəsində saxlayın və qeydiyyat qeydini, tenant kontekstini, daşıyıcı identikliyini və göndərişin yaradılma vaxtını araşdırın. Avtomatik olaraq sifariş yaratmayın və hadisəni inandırıcı görünən müştəriyə bağlamayın. Uyğunluq düzəldildikdən sonra hadisəni yenidən icra edin.

Çatdırılma bildirişləri OMS-dən, yoxsa izləmə sistemindən gəlməlidir?

Hər bildiriş növü və tətik üçün bir sahib seçin. İki sistem eyni mesajı göndərə bilirsə, yollardan birini deaktiv edin və ya davamlı bildiriş reyestrini paylaşın. Həmçinin mesajın bir bağlamaya, yoxsa tam sifarişə aid olduğunu, xüsusilə bölünmüş icra zamanı müəyyənləşdirin.

İstisna statusu sifarişin uğursuz olduğu anlamına gəlirmi?

Xeyr. İstisna şərh tələb edən müşahidədir və mütləq daimi nəticə demək deyil. Səbəbi qoruyun, sonrakı hadisələri izləyin və əməliyyatların nə vaxt müdaxilə etməli olduğunu müəyyənləşdirmək üçün eskalasiya siyasətinizdən istifadə edin.

Mənbələr