Prečo sa jedna objednávka objaví v sklade dvakrát?
Zákazník objednal dve klávesnice. E-shop odoslal požiadavku do skladu, sklad ju zapísal a spojenie sa prerušilo tesne pred odpoveďou. Z pohľadu e-shopu vypršal čas. Z pohľadu skladníka už čaká práca na zabalenie.
Pozrieť modelovú ukážku rozhrania
Ako sklad rozpozná ten istý pokyn?
Pri vytvorení objednávky si e-shop uloží jedinečný identifikátor operácie. Keď opakuje ten istý prenos, pošle pôvodný identifikátor. Sklad ho musí vedieť rozpoznať aj po reštarte. Pri opakovanom prijatí vráti číslo už vytvorenej objednávky. Programátori toto správanie označujú ako idempotenciu.
Overte, ktoré rozhranie takúto funkciu podporuje a ako dlho si identifikátor pamätá. Uviesť v poznámke číslo objednávky nestačí, pokiaľ prijímajúci systém podľa neho duplicitu nekontroluje. Dve súčasné požiadavky musia viesť k jedinému dokladu aj vtedy, keď obe dorazia skôr než prvá dostane odpoveď.
Čo ak zákazník pridá tretiu klávesnicu?
Zmenu množstva zapíšte ako samostatnú úpravu existujúcej objednávky. Ak príde rovnaký identifikátor pôvodnej operácie s iným množstvom, prepojenie má rozpor oznámiť. Vedúci skladu tak vie odlíšiť opakovaný pokus od novej požiadavky zákazníka.
Oddelte aj čiastočnú expedíciu. Ak dnes sklad odošle jednu klávesnicu a zajtra druhú, má jednu objednávku a dva výdaje. Každý pohyb potrebuje vlastnú stopu. Vyhľadanie podľa čísla zákazníka alebo rovnakej sumy by mohlo skryť úplne legitímny druhý pohyb.
Čo overiť na oboch stranách prepojenia?
V skúšobnej prevádzke nechajte sklad zapísať objednávku a zadržte jeho odpoveď. Spustite opakovanie a porovnajte počet objednávok, rezervovaných kusov i úloh na balenie. Pri pôvodnej objednávke dvoch kusov má zostať jeden doklad, dva rezervované kusy a jedna úloha.
Nakoniec odošlite skutočnú zmenu množstva. V histórii musí byť zrejmé, kto množstvo zmenil a kedy sklad zmenu prijal. Pri reklamácii potom viete rekonštruovať, čo zákazník očakával v okamihu balenia.
Príklad pravidiel opakovaného volania v dokumentácii API Stripe
Ako odlíšiť druhý pokus od skutočne ďalšej objednávky
Dve objednávky s rovnakým zákazníkom, položkami, cenou aj sekundou vytvorenia môžu byť samostatné nákupy. Na rozlíšenie preto potrebujete identitu zámeru vytvorenú v zdrojovom systéme. Pri opakovaní neúspešného prenosu sa zachová. Ak zákazník skutočne odošle ďalšiu objednávku, vznikne nový identifikátor.
Prijímateľ by mal kontrolu identity a zápis vykonať spôsobom, ktorý obstojí aj pri dvoch súbežných pokusoch. Test má pokryť aj rovnaký identifikátor s pozmeneným množstvom. Namiesto tichej zmeny už evidovanej objednávky musí byť z výsledku jasné, že prišiel rozporný obsah a kto ho má posúdiť.
Ako dlho si príjemca pamätá výsledok prvého pokusu
Ak je možné zopakovať odoslanie aj po niekoľkých dňoch, krátkodobá pamäť posledných požiadaviek nemusí stačiť. V dohode rozhrania určte obdobie, počas ktorého sa má opakovanie bezpečne rozpoznať, a postup pri staršom prípade. Pri skúške zopakujte známu objednávku po reštarte aplikácie a pri oneskorenom obnovení spojenia. Spoľahlivosť potvrdenia sa potom dá posúdiť aj za hranicou jedného krátkeho testovacieho behu.
Časový limit pri zápise vytvára neistotu na strane odosielateľa
Predstavte si, že prijímajúci systém vytvorí objednávku a jeho odpoveď sa cestou stratí. Odosielateľ pozná len vypršanie času. Pri prenose preto potrebuje vopred dohodnutý identifikátor, podľa ktorého si po prerušení overí výsledok pôvodnej požiadavky.
Súčasťou návrhu má byť aj prípad, keď ďalší pokus obsahuje rovnaký identifikátor, ale zmenenú dodaciu adresu. Taká požiadavka potrebuje výslovné rozhodnutie o oprave. Výstup má rozlíšiť pôvodný úspešný zápis od zmeny už existujúcej objednávky.
Otázky z praxe
Môžu mať dve platné objednávky úplne rovnaký obsah?
Áno, zákazník môže vedome zopakovať rovnaký nákup. Pri integrácii preto pracujte s identifikátorom obchodnej požiadavky vytvoreným v zdrojovom programe. Pri opätovnom technickom pokuse zostáva rovnaký, pri ďalšom samostatnom nákupe vzniká nový. Porovnanie súm a položiek je užitočným kontrolným signálom.
Čo má obsluha vidieť pri rovnakom identifikátore s inou cenou?
Označte rozpor a sprístupnite pôvodnú prijatú verziu aj zmenený obsah oprávnenému pracovníkovi. Tichý prepis by mohol zmeniť už rezervovaný alebo vyfakturovaný doklad. V dohode rozhrania preto stanovte, ako má zdroj označiť riadnu zmenu objednávky a ako sa potvrdí jej spracovanie.
Ako zistíme, či ochrana pred opakovaním vydrží reštart?
Vytvorte oprávnenú skúšobnú objednávku, potvrďte jej prevzatie a rovnakú požiadavku zopakujte po opätovnom spustení integračnej služby. Skontrolujte počet skutočných objednávok aj výsledok vrátený odosielateľovi. Dôležité je tiež dohodnúť, ako dlho má príjemca vedieť pôvodné spracovanie dohľadať.
Súvisiace stránky
-
Integrácie
Integrácia firemných systémov prepojí e-shop, sklad a účtovníctvo. Pozrite si, čo sa prenáša pri objednávke a ako systém rieši výpadok či duplicitný záznam.
Otvoriť -
Skladový systém s rezerváciami
Skladník pri každej položke vidí, koľko kusov má fyzicky na regáli, koľko už niekomu prisľúbil a koľko smie vydať.
Otvoriť