Sign in Book a demo
Back to the help

Storyous – příjem účtenek z pokladen (Loyalty API)

This article is not translated yet; the Czech version is shown.

Storyous posílá do Lunchdrive účtenky z pokladen přes svoje Loyalty API. Po každém účtu zavolá Storyous naše webhooky a my z nich založíme prodej. Aby Lunchdrive tato příchozí volání přijal, musí u účtu sedět sdílený tajný klíč, který je nastavený i na straně Storyous. Bez něj webhooky odmítáme a účtenky nedorazí.

Propojení se Storyous si nastavíte sami v nastavení svého účtu.

Jak to funguje

  1. Obsluha terminálu založí novou objednávku a vybere položky, které si strávník objednává.

    Terminál Storyous – nová objednávka s vybranými položkami

  2. Strávník přiloží svůj čip k terminálu. Terminál zobrazí, že čip byl správně načten. V případě, že čip nebyl správně načten, je zobrazena chyba.

    Terminál Storyous – načtení strávníkova čipu

  3. Obsluha terminálu si může ověřit zůstatek kreditu strávníka.

    Terminál Storyous – zůstatek kreditu strávníka

  4. V případě, že je potřeba objednávku doplatit, vybere obsluha formu doplatku (hotově nebo kartou). Na závěr obsluha objednávku odešle.

  5. Detail objednávky je vidět v systému Storyous.

    Detail objednávky v systému Storyous

  6. Detail objednávky je vidět v Lunchdrive – ve Vyúčtování u klienta strávníka, částku zaplacenou na pokladně najdete ve sloupci Zaplaceno na POS.

    Vyúčtování klienta v Lunchdrive – objednávka ze Storyous se sloupcem Zaplaceno na POS

Kde propojení nastavit

  1. Otevřete Nastavení účtu a přepněte se na Integrace.
  2. Sjeďte na box Storyous. Tlačítko Nastavení v boxu otevře tento návod.
  3. Do pole Tajný klíč pro příjem účtenek z pokladen (Loyalty API) vložte klíč dohodnutý se Storyous.
  4. Ve stejném boxu vyplňte ID obchodníka, ID místa a ID Klienta. Podle ID obchodníka a místa příchozí webhook váš účet dohledá a ID Klienta se vrací Storyous v odpovědi.
  5. Klikněte na Uložit.

Box Storyous v Nastavení účtu → Integrace s polem pro tajný klíč k příjmu účtenek

Na co si dát pozor

  • Klíč je per účet (dvojice ID obchodníka / ID místa). Každý provozovatel má svůj.
  • Je to jiný údaj než ostatní pole Storyous ve stejném boxu. Secret slouží jen k volání směrem ke Storyous (odchozí). ID obchodníka, ID místa a ID Klienta používá Lunchdrive v obou směrech – podle ID obchodníka a místa příchozí webhook dohledá účet, ID Klienta se vrací Storyous v odpovědi na příchozí volání a všechna tři se posílají i při volání ke Storyous. Tenhle klíč pak ověřuje, že příchozí volání je opravdu od Storyous.
  • Jakmile vyplníte cokoli ze Storyous, musí být ID Klienta, ID obchodníka i ID místa vyplněné všechny – bez nich nastavení neuložíte. Samotný Secret (odchozí) povinný není, takže lze nastavit jen příjem účtenek.
  • Klíč se musí přesně shodovat s hodnotou nastavenou na straně Storyous. Když se účtenky nezakládají, je nejčastější příčinou právě rozdílný nebo prázdný klíč.

Další propojení najdete ve stejné sekci, například Propojení s docházkou Dayswaps.