Müştəri yanlış link göndərdikdə API sifarişinin ləğvi

Əvvəlcə sifarişin təchizatçıya ötürülüb-ötürülmədiyini yoxlayın

Yanlış link həmişə irəliləyişin artıq başladığı anlamına gəlmir. Daxili bazada sifariş yaradılmış ola bilər, amma hələ API vasitəsilə göndərilməyib. Bu halda ləğv yalnız sizin emal məntiqinizdən asılıdır: sifarişi ləğv edilmiş kimi qeyd etmək, avtomatik ödənişi dayandırmaq və ötürülməni başlatmamaq kifayətdir.

Sifarişin identifikatorunu, yaradılma vaxtını, linki, xidmətin növünü və API sorğularının jurnalını yoxlayın. Təchizatçıya sorğu getməyibsə, köhnə sifarişin üzərinə yeni sifariş yaratmayın. Əvvəlcə ilkin müraciətin ləğvini qeydə alın, əks halda müştəri müxtəlif linklərə iki başlatma ala bilər.

Sifarişin təchizatçıdakı statusunu müəyyən edin

Əgər API sorğusu artıq göndərilibsə, təchizatçıdan cari statusu sorğu edin. Statusların adları fərqlidir, amma adətən onları bir neçə qrupa bölmək olar: gözləmə, emal, qismən icra, tamamlanma və ləğv. Qərar üçün panelinizdəki status deyil, xidməti başladan tərəfin cavabı vacibdir.

• Gözləmə: sifariş hələ ləğvə icazə verə bilər.
• Emal: dayandırma bəzən mümkündür, amma həcmin bir hissəsi artıq başladılmış ola bilər.
• Qismən icra: yalnız qalığı ləğv etmək olar, əgər təchizatçı belə əməliyyatı dəstəkləyirsə.
• Tamamlanma: linki ləğvlə artıq düzəltmək mümkün deyil.

Yalnız daxili statusla yoxlamağın çatışmazlığı ondadır ki, o, gecikmə ilə yenilənə bilər. Son API cavabına və onun alınma vaxtına əsaslanın.

Xidmət başlamazdan əvvəl sifarişi ləğv edin

Növbədə olan sifariş üçün, əgər təchizatçının sənədləşməsində nəzərdə tutulubsa, ləğv metodundan istifadə edin. Daxili nömrəniz deyil, sifariş yaradılarkən alınan identifikatoru ötürün, əgər bunlar fərqli dəyərlərdirsə. Tam cavabı saxlayın: əməliyyat kodu, status, xəta mətni və sorğu vaxtı.

API ləğvi təsdiqləməyənə qədər sifarişi ləğv edilmiş hesab etməyin. Sorğunun qəbul edilməsi cavabı və xidmətin faktiki dayandırılması fərqli hadisələr ola bilər. Bəzi inteqrasiyalarda əvvəlcə qəbul təsdiqi gəlir, yekun status isə sonra dəyişir.

Bu variantın çatışmazlığı ondadır ki, təchizatçı sifarişi emaldan çıxarmağa vaxt tapmaya bilər. Onda ləğv imtina qaytaracaq və ya yalnız icra olunmamış hissə üçün işləyəcək.

Təsdiq olmadan artıq yaradılmış sifarişdə linki dəyişməyin

Bir çox API-də link sifarişin yaradılması anında fiksasiya olunur. Yeni linki eyni identifikatorla ötürmək cəhdi nəzərə alınmaya, xəta kimi emal oluna və ya gözlənilməz vəziyyət yarada bilər. Sorğunun təkrar göndərilməsinin ünvanı avtomatik əvəz edəcəyinə ümid etməyin.

Əgər sənədləşmə linkin redaktə edilməsini birbaşa dəstəkləyirsə, əvvəlcə xidmətin hələ icraya başlamadığına əmin olun. Sonra köhnə dəyəri, yeni dəyəri və API cavabını saxlayın. Bu, müştəri və ya təchizatçı ilə mübahisə zamanı lazım olacaq.

Redaktənin çatışmazlığı ondadır ki, metod mövcud olsa belə, bəzi əməliyyatlar yenilənməzdən əvvəl köhnə səhifəyə gedə bilərdi. Düzəldilmiş link artıq alınmış nəticəni köçürmür.

Qismən icra zamanı nə etməli

Yanlış link üzrə irəliləyiş artıq başlayıbsa, qalığın ləğvini sorğu edin. Təchizatçıya müraciətdə sifarişin identifikatorunu, yanlış linki, düzgün linki, cari statusu və xətanın aşkar edilmə vaxtını göstərin. Müraciətin detallarını bir neçə dəfə dəyişməyin: bu, tarixçənin yoxlanmasını çətinləşdirir.

Qalığın ləğvi təsdiqlənibsə, artıq icra olunmuş həcmi qeydə alın. Geri qaytarma, əgər təchizatçının qaydalarında nəzərdə tutulubsa, adətən yalnız icra olunmamış hissəyə aiddir. İcra olunmuş həcmi texniki olaraq bir kanaldan, videodan və ya profildən digərinə köçürmək mümkün deyil.

Qismən ləğvin çatışmazlığı aydındır: müştəri artıq yanlış səhifədə nəticə ala bilər, bu hissə üçün büdcə isə həmişə qaytarılmır.

Sifariş tamamlanıbsa, düzəlişi ayrı müraciətlə rəsmiləşdirin

Tamamlanmış sifarişi adətən API vasitəsilə ləğv etmək mümkün deyil. Belə vəziyyətdə qeydi silməyin və tarixçədə linki dəyişməyin: ilkin məlumatlar yoxlama üçün lazımdır. Xidmətin həqiqətən səhv ünvana göstərildiyini, yoxsa sadəcə gecikmə ilə göstərildiyini yoxlayın.

Sonra iki yol var: təchizatçı ilə onun qaydalarına uyğun kompensasiyanı müzakirə etmək və ya müştəri ilə razılaşdıqdan sonra düzgün linkə yeni sifariş yaratmaq. Yeni sifarişin ayrı identifikatoru, məbləği və yaradılma səbəbi ilə bağlı aydın qeydi olmalıdır.

Yeni başlatmanın çatışmazlığı — əlavə büdcə tələb edir, tamamlanmış xidmət üçün kompensasiya isə mövcud olmaya bilər.

Təkrar başlatmadan əvvəl müştəriyə vəziyyət barədə məlumat verin

Əgər link müştəriyə aiddirsə və xəta onun tərəfindən gəlibsə, əvəzləməni öz mülahizənizlə başlatmayın. Ona ilkin linki, sifarişin statusunu, ləğv imkanını və hər variantın nəticələrini göndərin. Bu, xüsusilə xidmətin bir hissəsi artıq icra olunubsa, vacibdir.

• Sifariş ötürülməyibsə, düzgün linki sorğu edin və köhnə müraciətin ləğvini təsdiqləyin.
• Sifariş növbədədirsə, ləğvin göndərildiyini, amma təchizatçının cavabının gözlənildiyini bildirin.
• Qismən icra varsa, yalnız qalığın dayandırıla biləcəyini qeyd edin.
• Sifariş tamamlanıbsa, yeni başlatmanı və ya digər həll yolunu razılaşdırın.

Uzun razılaşmanın çatışmazlığı — bu müddətdə növbədəki sifariş emala keçə bilər. Buna görə, əgər imkan varsa, əvvəlcə ləğv üçün texniki sorğu göndərin, sonra sonrakı addımları dəqiqləşdirin.

Əməliyyat üzrə loqları və sübutları saxlayın

Hər mübahisəli sifariş üçün müştərinin ilkin linkini, alınma tarixini, daxili nömrəni, təchizatçıdakı identifikatoru, API sorğularını və cavablarını saxlayın. Əgər müştəri linki yazışmada göndəribsə, orijinalı saxlamadan sifariş kartındakı mesajı redaktə edilmiş variantla əvəz etməyin.

Xətanı kimin və nə vaxt aşkar etdiyini ayrıca qeyd edin. Bu, səhv ötürülmüş məlumatları menecerin, sifariş formasının və ya avtomatik doldurmanın xətasından ayırmağa kömək edir. Təchizatçıya təkrar müraciətlərdə ziddiyyət yaranmaması üçün vahid məlumat zəncirindən istifadə edin.

Loqların əl ilə aparılmasının çatışmazlığı — vaxt aparır. Amma tarixçə olmadan ləğv statusunu təsdiqləmək və müştəriyə vəsaitin niyə tam qaytarıla bilmədiyini izah etmək çətindir.

İnteqrasiyada xəta emalını yoxlayın

Belə bir hadisədən sonra sistemin linkləri API-yə necə ötürdüyünü yoxlayın. Xəta təkcə müştəri üzündən yarana bilməz: bəzən forma parametrləri kəsir, keşdən köhnə dəyəri əvəz edir, publikasiya linki əvəzinə profil linkini qəbul edir və ya artıq simvolları olan linki buraxır.

Sifariş yaradılmazdan əvvəl format yoxlaması əlavə edin: platformaya, xidmətin növünə və gözlənilən obyektə uyğunluq. Video xidmətləri üçün sistem video linkini kanal linkindən, sosial şəbəkələr üçün isə profili ayrı publikasiyadan fərqləndirməlidir. Yoxlama linkin düzgünlüyünə zəmanət vermir, amma aşkar xətaların bir hissəsini süzür.

Sifarişin ötürülməsini onun yaradılmasından qısa məlumat yoxlaması ilə ayırmaq daha yaxşıdır. Əlavə addımın çatışmazlığı — sifariş dərhal işə getməyəcək, amma yanlış ünvanı görmək üçün vaxtınız olacaq.

Komanda üçün aydın ləğv ssenarisi qurun

Vahid fəaliyyət qaydasını təsvir edin: avtomatik göndərməni dayandırmaq, təchizatçıda statusu yoxlamaq, ləğvi göndərmək, cavabı saxlamaq, müştəriyə məlumat vermək və yalnız sonra təkrar başlatmanı razılaşdırmaq. Belə ssenari formalıq üçün deyil, müxtəlif əməkdaşların bir-birini istisna edən əməliyyatlar etməməsi üçün lazımdır.

Ləğvə hüquqların məhdudlaşdırılması və əməliyyatlar jurnalı olmadan giriş verməyin. Bir neçə menecer eyni sifarişlə eyni vaxtda işləyirsə, biri ləğvi sorğu edə, digəri isə cavab alınmazdan əvvəl əvəzləmə yarada bilər. Bu, artıq xərclərə və hesablaşmalarda qarışıqlığa səbəb olur.

Sərt ssenarinin çatışmazlığı — təcili hallarda daha az çeviklik. Amma API sifarişləri üçün ayrıca əməliyyatın sürəti deyil, hansı linkin faktiki olaraq işə getdiyinə nəzarət daha vacibdir.