Tento návod je pro vás, kdo doplněk spravujete v administraci. Najdete tu, co si můžete nastavit, jak doplněk pracuje a co dělat, když něco nehraje. Není potřeba žádná technická znalost.
Co doplněk dělá
Firemní benefity hlídají, aby firemní slevové kódy uplatnil jen ten, kdo na ně má nárok. Při každé nové objednávce doplněk automaticky zkontroluje použitý slevový kód proti pravidlům vaší kampaně a podle výsledku objednávku buď schválí, nebo označí (případně rovnou stornuje) jako neoprávněnou.
Vše běží na pozadí — jakmile vznikne objednávka, doplněk ji během chvíle vyhodnotí sám.
Rychlý start
- Zadejte API klíč (jednorázově) — propojí doplněk s vaším e-shopem. Viz sekce API klíč.
- Vytvořte kampaň pro konkrétní firemní spolupráci — přiřaďte slevové kódy a nastavte limity.
- Volitelně nastavte notifikace — kam vám má doplněk hlásit problémové objednávky.
- Hotovo. Od této chvíle se objednávky vyhodnocují automaticky. Výsledky sledujete v Logu a Analytice.
API klíč
Aby doplněk viděl na vaše objednávky a slevové kódy, potřebuje Privátní API token vašeho Shoptetu.
Kde ho získáte:
- V administraci Shoptetu otevřete sekci s API / doplňky.
- Vygenerujte Privátní API token.
- Token zkopírujte.
Kam ho zadáte:
- V doplňku otevřete stránku API klíč a token vložte.
- Token se uloží bezpečně (šifrovaně) a nikde se už nezobrazuje.
💡 Token můžete kdykoli vyměnit — stačí vložit nový a uložit.
⚠️ Token nikomu neposílejte a nevkládejte do e-mailů. Je to klíč k vašemu e-shopu.
Kampaně
Kampaň = jedna firemní spolupráce. Pro každou firmu (nebo skupinu), které dáváte slevu, si vytvoříte vlastní kampaň s vlastními pravidly.
Co u kampaně nastavíte
| Nastavení | K čemu slouží |
|---|---|
| Název kampaně | Jen pro vaši orientaci (např. „Zaměstnanci ABC s.r.o."). |
| Slevové kódy | Které kódy do kampaně patří. Můžete přiřadit jeden i víc kódů. |
| Limit na zákazníka | Kolikrát smí jeden zákazník (e-mail) slevu využít. Např. 1 = každý jen jednou. |
| Limit unikátních zákazníků | Kolik různých zákazníků smí kampaň celkem obsloužit. Když je vyčerpán, další objednávky se zamítnou. |
| Reakce na neoprávněnou objednávku | Co se stane, když objednávka pravidlům neodpovídá — viz níže. |
| Stav | Aktivní / pozastavená. Pozastavená kampaň se nevyhodnocuje. |
Co se stane s neoprávněnou objednávkou
Podle nastavení kampaně doplněk u objednávky, která neprošla, může:
- jen ji označit a zaznamenat do logu (vy ji pak vyřešíte ručně), nebo
- stornovat ji přímo ve Shoptetu a přidat k ní poznámku s důvodem.
💡 Doporučení: než si na vyhodnocování zvyknete, nechte nejdřív jen „označit" a teprve po pár dnech zapněte automatické storno.
Slevové kódy — na co si dát pozor
Doplněk páruje kód z objednávky s kódy, které máte v kampani. Tady je jeden důležitý detail Shoptetu, který je dobré znát:
Shoptet u objednávky neukládá přímo kód, který zákazník napsal, ale jen název slevového kuponu, např.:
„Slevový kupon č. firma-abc - Sleva 30 %"
Doplněk si proto váš kód v tomto názvu vyhledá jako samostatné slovo. Aby párování spolehlivě fungovalo:
- ✅ Mějte kód jako samostatné slovo v názvu kuponu (např.
firma-abc). Tak ho doplněk vždy najde. - ✅ Funguje i napříč jazykovými mutacemi e-shopu.
- ⚠️ Pokud kupon přejmenujete tak, že kód v názvu „splyne" s jiným textem, párování ho nemusí najít.
💡 Pravidlo palce: kdyby si název kuponu přečetl člověk, musí v něm jasně poznat váš kód jako oddělené slovo. Pak ho pozná i doplněk.
Notifikace (volitelné)
Chcete být upozorněni, když přijde problémová objednávka? Nastavte si vlastní adresu (URL), kam doplněk pošle zprávu o vyhodnocení.
Kde to nastavíte: v nastavení doplňku do pole pro notifikační URL.
Požadavky na adresu:
- musí to být veřejná HTTPS adresa (např. endpoint vašeho interního systému, ERP, nebo most do Slacku),
- z bezpečnostních důvodů doplněk odmítne vnitřní/lokální adresy (např.
localhost,192.168.x.x,10.x.x.x) — ty zvenčí stejně nejsou dostupné.
Co se odešle: informace o vyhodnocené objednávce (kód objednávky, výsledek, kampaň, sleva). Pokud se zprávu nepodaří doručit, doplněk to automaticky zopakuje (celkem 3 pokusy s rostoucím odstupem).
Log
Stránka Log je kompletní historie všech vyhodnocení.
Co u každého záznamu uvidíte:
- kód objednávky a e-mail zákazníka,
- použitý slevový kód a kampaň,
- výsledek (schváleno / zamítnuto a proč),
- vypočtenou slevu,
- čas vyhodnocení.
K dispozici je vyhledávání a stránkování, takže i ve velkém objemu rychle dohledáte konkrétní objednávku.
💡 Log slouží k dohledávání jednotlivých případů — „proč zrovna tahle objednávka neprošla?".
Analytika
Stránka Analytika ukazuje souhrn podle jednotlivých kampaní — tedy podle firemních spoluprací.
Co z ní vyčtete:
- kolik objednávek v kampani prošlo a kolik bylo zamítnuto,
- celkovou hodnotu uplatněných slev,
- celkový obrázek o tom, jak je daná spolupráce využívaná.
💡 Analytika je váš podklad pro vyhodnocení spolupráce s firmou — třeba když s ní jednáte o pokračování nebo o podmínkách.
Časté situace (FAQ)
Objednávka se vůbec nevyhodnotila. Zkontrolujte, že je kampaň ve stavu Aktivní a že je zadaný platný API klíč. Pokud jste token nedávno měnili v Shoptetu, vložte do doplňku nový.
Doplněk nenašel slevový kód, i když ho zákazník použil. Podívejte se na název slevového kuponu ve Shoptetu — kód v něm musí být jako samostatné slovo (viz Slevové kódy).
Nechci, aby se objednávky rovnou stornovaly. V nastavení kampaně přepněte reakci na „jen označit a zaznamenat". Storno pak řešíte ručně podle logu.
Stejná objednávka se v logu neobjevila dvakrát, i když Shoptet hlásil dvě události. To je v pořádku — doplněk záměrně vyhodnotí každou objednávku jen jednou (chrání to před duplicitami).
Notifikace nedorazila. Ověřte, že je adresa veřejná HTTPS a že váš systém na ní zprávy přijímá. Doplněk doručení 3× zopakuje; pokud ani pak neprojde, najdete událost v logu.
Co doplněk (zatím) neumí / omezení
- Párování stojí na názvu kuponu. Pokud kupon výrazně přejmenujete mimo standardní formát, kód se nemusí najít.
- Logy a kampaně se odinstalací nemažou — historie zůstává zachovaná.
- Vyhodnocují se jen nové objednávky od chvíle, kdy je kampaň aktivní. Zpětně se starší objednávky nepřepočítávají.