Integrace odeslala objednávku do externího systému, ale nedostala odpověď. Automatické opakování vytvořilo druhou objednávku s novým číslem. Zákazníkovi může vzniknout dvojí zpracování a sklad rezervuje zboží navíc. Problém není jen v rychlosti sítě: jeden obchodní úkon nebyl rozpoznán při opakovaném přenosu. Je třeba stabilní identifikátor operace, evidence výsledku a možnost párování.
Idempotence objednávky není totéž jako unikátní SKU, aktualizační klíč při importu či prevence dvojkliku. Dvě síťová volání mohou patřit jedné operaci, zatímco dva samostatné nákupy stejné osoby mohou být legitimní.
Nejprve zaznamenejte reprodukovatelný požadavek, výchozí stav a očekávaný výsledek. Oddělte chybu rozhraní, přenosu a obchodního pravidla. Ověřujte i stornování, neplatná oprávnění, opakování a výpadek externí služby.
Ověřte, zda konkrétní metoda bezpečně rozpoznává opakovaná volání, jaký klíč vyžaduje a jak dlouho jej uchovává. Funkce jednoho endpointu automaticky neplatí pro celé API. Zapište verzi, oprávnění a postup po výpadku.
Propojte ID místní objednávky, typ úkonu, kontrolní otisk parametrů, externí ID a stav zpracování. Při opakování nejprve vyhledejte původní výsledek. Paralelní pracovníci nesmějí provést jednu operaci dvakrát.
Při nestabilní komunikaci použijte omezená opakování, rozlišení dočasných a trvalých chyb a záznam nejasných výsledků k ruční kontrole. Chybné obchodní údaje nelze napravit nekonečným opakováním.
Integrace se oceňují individuálně, pro Shopify, Shoptet a WooCommerce agentura využívá odborné partnery. Hotový doplněk nemusí vyřešit všechny výjimky.
Následující scénáře jsou vymyšlené, nikoliv skutečné provozní záznamy či záruka fungování každého API. Výsledek se vždy musí ověřit na konkrétní metodě.
Ke každému testu zaznamenejte vstupní ID, krok obsluhy, odpověď serveru, protokol, rozhodnutí a odpovědnou osobu. Původní důkaz chyby zachovejte před opakováním.
Otestujte i chybějící identifikátory, přerušení sítě, nesprávná práva a neplatné vstupy. Účetní a smluvní pravidla potvrzují odpovědní odborníci.
Potřebujete schéma obou systémů, anonymizované události, dokumentaci API, logy, čísla duplicit, časové limity, autentizační model a testovací přístup. Tajné údaje nesdílejte veřejně. Dokumentace Shopify k idempotentním požadavkům poskytuje výchozí informace, ale záruky se vztahují na konkrétní metody a verze.
Technická podpora stojí 30 €/hod. Vývoj a integrace se oceňují individuálně. Pošlete odkaz na e-shop a popis chyby pro nabídku podle skutečného rozsahu.
Klíč se váže ke konkrétnímu záměru vytvořit objednávku, nikoliv jen k datu či zákazníkovi. Nové UUID při každém síťovém pokusu problém neřeší. Evidence může obsahovat místní ID objednávky, typ úkonu, otisk parametrů, čas, stav a externí číslo. Pokud externí systém uchovává klíč jen omezenou dobu, pozdější opakování vyžaduje jiné ověření.
„Nedostali jsme odpověď“ nedokazuje, že nedošlo k uložení objednávky. Spojení se mohlo přerušit po rezervaci zboží či dokončení transakce. Bezpečný postup nejprve hledá původní výsledek. Naopak trvalou validační chybu nelze opravit odesláním stejných chybných dat. Personál musí rozlišovat stavy čeká, výsledek neznámý, potvrzeno a vyžaduje ruční prověření.
Dvě fronty mohou zpracovat stejnou událost zároveň. Pouhé „vyhledej a potom vytvoř“ nepostačuje, pokud oba procesy uvidí prázdný výsledek. Systém odpovědný za operaci potřebuje sjednané záruky unikátnosti a atomické aktualizace. Testujte paralelní volání, rozdílné parametry při jednom klíči, opakování další den a nedostupné vyhledávání. Kontrolujte počet skutečných externích objednávek a vedlejších dokladů, nikoliv jen HTTP odpovědi.