Přeskočit na obsah
Zpět na blog
Vývoj

Datový model vratek v e-shopu: odstoupení vs reklamace

Jak oddělit odstoupení, reklamaci, fyzickou vratku a refundaci do stavů, které lze napojit na sklad, podporu i platební bránu.

Roman Mrózek
5 min čtení
Regály s kartonovými zásilkami ve skladu e-shopu
Datový model a stavový automat pro připravovanou online funkci odstoupení, oddělený od reklamacíFoto: CHUTTERSNAP / Unsplash

Datový model vratek v e-shopu musí rozlišit čtyři různé skutečnosti: zákazník projevil vůli odstoupit, zboží je na cestě zpět, sklad zásilku převzal a obchodník provedl refundaci. Připravovaná online funkce pro snadné odstoupení přidává nový vstup do tohoto procesu. Pokud se její formulář napojí přímo na tabulku reklamací, e-shop získá nejasné stavy, chybné notifikace a obtížně dohledatelnou odpovědnost.

Řešením není postavit další izolovaný formulář. Řešením je oddělit doménové případy a propojit je událostmi. Následující návrh ukazuje, jak připravit zákaznické rozhraní, administraci, sklad a platby bez zásahu do funkčních reklamačních cest. Právní rozsah, výjimky a přesnou textaci vždy ověřte podle aktuální české úpravy s právníkem.

Která pravidla jsou potvrzená a která jsou návrhem architektury?

Potvrzený je evropský rámec, nikoli každý detail vašeho budoucího formuláře. Směrnice EU 2023/2673 stanoví pro vymezené smlouvy uzavírané přes online rozhraní výraznou a snadno dostupnou funkci pro odstoupení. Počítá s elektronickým prohlášením a s potvrzením zaslaným bez zbytečného odkladu na trvalém nosiči. Potvrzení má obsahovat obsah podání i datum a čas přijetí. Evropský harmonogram stanovil použití přijatých pravidel od 19. června 2026.

Návrhem architektury jsou naopak názvy interních stavů, způsob ověření zákazníka, členění databáze a integrační události popsané níže. Ty mají pomoci splnit provozní cíl, nejsou právními požadavky samy o sobě. Před implementací zkontrolujte aktuální znění občanského zákoníku v e-Sbírce a právní výklad pro sortiment, smluvní režim a výjimky konkrétního e-shopu.

Proč nemá být odstoupení jen dalším typem reklamace?

Protože jde o jiný případ s jiným spouštěčem a jinou sadou rozhodnutí. Reklamace řeší tvrzenou vadu nebo nesoulad plnění. Odstoupení zachycuje jednoznačný projev vůle zákazníka. Fyzická vratka popisuje pohyb zásilky a refundace finanční operaci. Jedna univerzální tabulka s polem typ_pripadu obvykle začne bobtnat o výjimky, prázdné hodnoty a přechody, které nedávají smysl všem případům.

  • WithdrawalCase ukládá podání, jeho rozsah, čas přijetí, právní stav a komunikaci.
  • ComplaintCase zůstává pro reklamace a zachová dnešní pravidla i historii.
  • ReturnShipment sleduje dopravce, zásilku, přijetí a kontrolu vrácených položek.
  • Refund sleduje částku, měnu, platební metodu, schválení, pokusy a výsledek brány.

Tyto entity odkazují na stejnou objednávku a její položky, ale nevlastní stejný stav. Sklad tak může přijmout balík, aniž by automaticky označil refundaci za dokončenou. Podpora může řešit podání, aniž by změnila reklamační případ. Účetní nebo oprávněná role může schválit částku s dohledatelným důvodem.

Jak má fungovat vstup od tlačítka až k potvrzení?

Zákazník přihlášený do účtu začne na detailu objednávky. Hostující nákup potřebuje cestu přes číslo objednávky a ověření kontaktního údaje, například jednorázovým odkazem na e-mail použitý při nákupu. Formulář nesmí před ověřením prozradit, zda cizí objednávka existuje. Po ověření zobrazí položky, dostupné množství a kontaktní údaj pro potvrzení.

Při odeslání API nejprve vytvoří případ a append-only auditní událost. Až poté vrátí zákazníkovi číslo případu. Do záznamu patří vazba na objednávku, vybrané položky, přijaté prohlášení, čas serveru, verze formuláře, jazyk a cíl pro potvrzení. Důvod podání lze sbírat jako nepovinný analytický údaj, pokud právní kontrola neurčí jinak. Přehled evropského rámce udržuje také Evropská komise.

Potvrzení zákazníkovi je samostatný krok, ne důkaz vytvoření případu. Komunikační záznam proto potřebuje stavy připraveno, předáno poskytovateli, doručeno, doručení nepotvrzeno a chyba. Při výpadku e-mailu se případ neztratí a systém založí úkol obsluze. Opakované kliknutí nesmí vytvořit duplicitní podání, endpoint proto přijímá idempotentní klíč svázaný s bezpečným tokenem formuláře.

Jaké události mají propojit podporu, sklad a platby?

Integrace mají reagovat na dokončené obchodní události, nikoli číst náhodné změny řádků v databázi. Po vytvoření případu vznikne událost withdrawal.submitted. Po odeslání potvrzení communication.dispatched. Sklad po načtení zásilky publikuje return.received a po kontrole jednotlivých kusů return.inspected. Platební část používá refund.requested, refund.approved a refund.completed nebo refund.failed.

Každá událost má vlastní identifikátor, čas, verzi schématu, původce a odkaz na případ. Spotřebitel události ukládá jako zpracované, takže opakované doručení neprovede refundaci dvakrát ani nenaskladní položku podruhé. Zápisové akce s finančním dopadem mají oprávněnou roli a auditní záznam. Automatizace může připravit návrh částky a podklady, manuální výjimku potvrzuje člověk.

Auditní stopa má zaznamenat starý a nový stav, identitu uživatele nebo služby, důvod, korelační identifikátor a čas. Citlivé údaje do logu nekopírujte bez potřeby. Přístup omezte rolemi a běžným uživatelům nedovolte historii přepisovat. Takový mechanismus dává provozu konkrétní dohledatelnost bez vágního slibu, že systém vyřeší každou výjimku automaticky.

Jaký technický checklist použít před nasazením?

Nejdřív zdokumentujte dnešní reklamační cestu a zmrazte její očekávané chování automatickými testy. Potom přidejte nové entity a události vedle ní. Sdílet můžete ověření objednávky, službu notifikací, upload příloh nebo napojení skladu, nikoli doménové stavy a šablony komunikace.

  • Sepište vlastníka každého stavu a povolené přechody stavového automatu.
  • Oddělte WithdrawalCase, ComplaintCase, ReturnShipment a Refund.
  • Přidejte idempotenci na veřejné API i na spotřebitele integračních událostí.
  • Verzujte formulář, e-mailové šablony a schéma událostí.
  • Otestujte hostující nákup, částečné podání, více kusů, dvojklik a prošlý token.
  • Simulujte výpadek e-mailu, skladu a platební brány bez ztráty původního podání.
  • Nasaďte změnu za feature flagem a sledujte chyby i čekající případy.

Pro návrh hlídání navazujících kroků se hodí také článek Monitoring obchodních procesů: formuláře a platby. LucidMark staví prémiové weby a custom systémy jako jeden provozní celek. Pokud změna zasahuje zákaznický účet, sklad i platební bránu, je vhodné ji navrhnout jako malý produkt se stavy, rolemi a testy. Více o tomto přístupu najdete na lucidmark.cz.

Co má být výsledkem přípravy?

Výsledkem nemá být pouze viditelné tlačítko. Datový model vratek v e-shopu musí uchovat původní podání, potvrdit je zákazníkovi, propojit je s pohybem zboží a refundací a přitom nesmí změnit význam stávajících reklamací. Právní kontrola určí povinný rozsah a texty. Technický návrh zajistí, že se jednotlivé kroky nezamění a chyba jedné služby nesmaže důkaz o kroku předchozím.

Začněte mapou entit, stavů a událostí, ne obrazovkou formuláře. Tlačítko je vstupní bod. Skutečná kvalita změny se ukáže až ve chvíli, kdy podpora dohledá případ, sklad správně přiřadí balík, oprávněná role provede refundaci a auditní stopa vysvětlí celý sled událostí.

Mohlo by Vás zajímat

Všechny články
Spolupráce

Řešíte něco podobného?

Krátký hovor, žádná prezentace. Řekneme, co bychom postavili, a také kdy to nedává smysl.

Newsletter

Nové články rovnou do e-mailu.

Posíláme jen nové články. Odhlásíte se jedním klikem.

Zpět nahoru