Rozvoz a osobní odběr7 min čtení
Objednávky z WooCommerce, Woltu a POS: jak předcházet duplicitám
Duplicita není chyba kanálu, ale dvou záznamů pro jednu objednávku hosta.
Kde napojení chybí, musí duplicitám bránit provozní pravidla, ne software.

Duplicitní objednávka vzniká, když jedna objednávka hosta skončí v provozu jako dva záznamy: dva bony v kuchyni, dvě položky v pokladně nebo dvě objednávky k vyřízení. Restaurace, které přijímají objednávky z vlastního webu, z e-shopu na WooCommerce, z rozvozové platformy a k tomu účtují v pokladně, mají takových míst víc, než se zdá. Článek je pro provozní a majitele, kteří obsluhují víc kanálů najednou. Ukazuje, kde duplicity vznikají, jak jim předejít jedním zdrojem pravdy a externím číslem objednávky a jak daleko je u jednotlivých kanálů napojení RestoCraftu.
Kanál není objednávka
Nejdřív rozlišení, bez kterého se o duplicitách nedá mluvit. Kanál je cesta, kudy objednávka přišla: web, e-shop, rozvozová platforma, pokladna, telefon. Objednávka je to, co host chce: položky, způsob převzetí, čas a platba. Jedna objednávka může mít stopy v několika systémech a je to v pořádku. Duplicita nastává teprve tehdy, když z ní vzniknou dva samostatné záznamy, se kterými provoz pracuje jako se dvěma objednávkami.
Duplicity mají tři zdroje a každý potřebuje jiné opatření:
- Technický: tatáž notifikace přijde dvakrát, nebo změna stavu založí nový záznam místo úpravy stávajícího. Řeší ho integrace.
- Provozní: někdo objednávku z jednoho systému ručně přepíše do druhého, a pak ještě jednou. Řeší ho pravidla.
- Lidský: host objedná přes web a pro jistotu ještě zavolá. Řeší ho komunikace s hostem.
Kde duplicity vznikají podle kanálu
Kanály, typické duplicity a stav napojení
| Kanál | Typická cesta k duplicitě | Stav napojení v RestoCraftu |
|---|---|---|
| Vlastní web | Host odešle formulář dvakrát nebo web odeslání po chybě zopakuje | Přes API: rozhraní pro založení objednávky existuje, napojení konkrétního webu je práce v projektu |
| WooCommerce | Notifikace o změně se zpracuje jako nová objednávka; ruční přepis do pokladny | Dnes placené rezervace a zálohy; objednávky jídla z e-shopu jsou ve vývoji |
| Wolt | Opakovaná notifikace; ruční přepis z tabletu platformy do pokladny | Pilot: příchozí objednávky s ověřením a odfiltrováním opakovaných událostí |
| Pokladna (POS) | Objednávka z jiného kanálu se do pokladny namarkuje ručně | Ve vývoji: převod účtu do modelu objednávky je připravený, automatická synchronizace zatím ne |
| QR u stolu | Host si objedná u obsluhy a zároveň jinou cestou | Objednávání z QR menu je v plánu |
| Telefon | Host volá kvůli objednávce, kterou už odeslal online | Bez napojení, řeší se provozním pravidlem |
Z tabulky je vidět to podstatné: kanály nejsou napojené stejně daleko. Kde napojení chybí, musí duplicitám bránit provozní pravidla. U telefonu stačí jedna otázka obsluhy: „Neodesílali jste už objednávku přes web?“
Ruční přepis: nejčastější zdroj dvojitých bonů
Když objednávka z platformy nebo z e-shopu nemá vlastní cestu do kuchyně, obsluha ji přepíše do pokladny, aby vyjel bon. Každý přepis je příležitost k duplicitě: bon se nevytiskne, objednávka se namarkuje znovu a první bon se mezitím objeví, nebo tutéž objednávku na tabletu vidí dva lidé a namarkují ji oba.
- Přepisuje jen jedna role na směně, typicky ten, kdo má na starosti rozvoz.
- Ke každé přepsané objednávce se do poznámky v pokladně zapíše externí číslo z kanálu.
- Objednávka se v kanálu označí jako převzatá hned po přepisu, ne až po odeslání.
- Když bon nevyjede, nejdřív se v pokladně hledá podle externího čísla, teprve potom se markuje znovu.
Ruční přepis ale není jediná možnost. Volba přístupu závisí hlavně na tom, kolik objednávek z jiných kanálů máte a kolik lidí s nimi pracuje.
Tři přístupy k objednávkám z více kanálů
| Přístup | Kde hrozí duplicita | Kdy dává smysl |
|---|---|---|
| Každý kanál na svém tabletu, ruční přepis do pokladny | Při každém přepisu a opakovaném tisku bonu | Málo objednávek z jiných kanálů a jedna odpovědná osoba |
| Jeden hlavní systém, ostatní kanály se do něj přepisují podle pravidel | Tam, kde pravidla nikdo nehlídá | Přechodné období, než se kanály napojí |
| Kanály napojené do jednoho objednávkového jádra s externími čísly | V integraci bez idempotentního zpracování | Více kanálů a objem, u kterého se ruční přepis nevyplácí |
Jedno číslo, které drží objednávku pohromadě
Proti duplicitám nejlépe funguje externí číslo objednávky, tedy identifikátor, který objednávce přidělil kanál, odkud přišla. Když každý další systém ukládá toto číslo vedle svého vlastního, dá se kdykoli zjistit, zda objednávka už existuje. Bez něj se duplicity hledají podle času a částky, a to při plném večeru nefunguje.
Druhým principem je jeden zdroj pravdy. U každé objednávky má být jasné, který systém o ní rozhoduje: kde se mění stav, kde se ruší a kde se eviduje platba. Ostatní systémy stav přebírají a nezakládají vlastní kopii. Proč se přitom stav objednávky nesmí plést se stavem platby, vysvětluje článek o stavu objednávky a stavu platby.
Třetím principem je idempotentní zpracování: když stejná zpráva přijde dvakrát, výsledek je stejný, jako kdyby přišla jednou. Druhá kopie objednávku nezaloží. U každé integrace se na tuto vlastnost ptejte dodavatele výslovně.
Co v tom dnes dělá RestoCraft
RestoCraft Orders staví na jednom záznamu objednávky. Kanály jsou jen vstupy: jádro drží položky, zákazníka, způsob převzetí, adresu, požadovaný čas, stav objednávky, stav platby, historii stavů a externí reference na systémy, ze kterých objednávka přišla. Neplatný přechod stavu jádro odmítne, takže objednávka nemůže přeskočit z „nová“ rovnou na „dokončeno“. RestoCraft Orders se zavádí jako implementační projekt a jednotlivé kanály mají různou zralost.
U Woltu, který RestoCraft nabízí v pilotním režimu, integrační vrstva ověří podpis příchozí notifikace, opakované události i objednávky odfiltruje, načte celou objednávku a převede ji do jádra. Další změny stavu z Woltu posouvají tutéž objednávku, nová nevzniká. Opačným směrem se zatím nic neposílá: menu ani změny stavu do Woltu nejdou. Dostupnost v konkrétní instalaci závisí na aktivaci integrace a jiné rozvozové platformy napojené nejsou.
Z WooCommerce dnes do RestoCraftu přicházejí placené rezervace a zálohy, objednávky jídla z e-shopu jsou ve vývoji. Jak propojení s WordPressem a WooCommerce funguje u rezervací, popisuje článek o rezervacích přes WordPress a WooCommerce. U pokladen je převod účtu do modelu objednávky připravený, automatická synchronizace objednávek je ve vývoji a zákazníka pokladna nepředává. Ve vývoji je i obrazovka provozu, ve které by se objednávka posouvala mezi stavy.
Druhá strana: neztratit objednávku
Ochrana proti duplicitám nesmí vést k opačné chybě, tedy k objednávce, která se ztratí. Typicky se to stane, když integrace notifikace odmítá a nikdo to nesleduje. WooCommerce například ukládá záznamy o všech událostech, které spouštějí webhook, a webhook vypne po více než pěti po sobě jdoucích neúspěšných doručeních (dokumentace WooCommerce k webhookům). Kdo e-shop napojuje, má tyto záznamy po spuštění sledovat a vypnutý webhook řešit ještě týž den.
Časté otázky
Porovnejte za den počet a součet objednávek každého kanálu s tím, co je v pokladně tomuto kanálu přiřazené. Rozdíl pak dohledejte podle externích čísel. Bez nich zbývá jen porovnávání času a částky.
Ne. Integrace s Woltem v pilotním režimu zpracovává příchozí objednávky a jejich změny stavu. Menu ani změny stavu se do Woltu zatím neposílají.
Architektura počítá s více poskytovateli, každý ale potřebuje vlastní hotový a nasazený adaptér. Dnes je implementovaný jen Wolt, a to v pilotním režimu.
Shrnutí
Kanál je cesta, objednávka je to, co host chce; duplicita jsou dva záznamy jedné objednávky.
Nejčastějším zdrojem duplicit je ruční přepis do pokladny.
Externí číslo objednávky a jeden zdroj pravdy jsou základ každé prevence.
Kanály v RestoCraftu mají různou zralost: Wolt v pilotu, WooCommerce u rezervací, pokladny ve vývoji.
Ochrana proti duplicitám nesmí vést ke ztraceným objednávkám.
Závěr
Duplicitám nejlépe předejdete, když u každé objednávky víte, odkud přišla, pod jakým číslem a který systém o ní rozhoduje. Kde integrace chybí, pomohou jasná pravidla pro přepis a kontrolu. Kde existuje, ptejte se na opakované notifikace a sledujte i ty, které nedorazily. Jak do sebe zapadají další moduly RestoCraftu, ukazuje přehled digitálního ekosystému RestoCraft HUB.

