Integrace: účetnictví, rozvozové platformy a připojené aplikace
Stránka popisuje tři skupiny napojení: účetní systémy Pohoda a Money S3, pro které ProfiREST připraví doklady v XML (v menu jsou v sekci Účetnictví), rozvozové služby Foodora, Wolt, Bolt Food a Choice, od kterých přijímá objednávky do kuchyně, a připojené aplikace – třeba váš vlastní e-shop –, které jste k účtu připojili tlačítkem „Připojit přes Profirest“. Účetní systémy a rozvozové služby se nastavují pro provozovnu, kterou máte v administraci právě vybranou; připojené aplikace pro celý účet. Vývojářům je k dispozici veřejné REST API v2 s dokumentací, návody a knihovnami pro deset programovacích jazyků.
Než začnete
- Licence provozovny – účetní exporty i rozvozové platformy se otevřou jen s licencí, která je obsahuje.
- Kuchyňský systém – objednávky z platforem i z připojených aplikací chodí do jeho fronty, musí tedy běžet.
- Otevírací doba a příjem objednávek – bez nich aplikace, ve kterých objednávají zákazníci, nic nepřijmou; bez rozvozových zón nenabídnou rozvoz.
Zaměstnanec sekci vůbec nevidí
Celá skupina Integrace i účetní exporty Pohoda a Money S3 jsou jen pro majitele účtu. Zaměstnanec je v menu nevidí a neotevře je ani s oprávněním Plný přístup. Stránka Objednávky z aplikací, popsaná níže, je v sekci Nastavení a otevře ji i zaměstnanec s oprávněním Nastavení restaurace.
Na této stránce
Účetní systémy
Vyžaduje licenci s účetními exporty
Bez ní se stránky Pohoda a Money S3 neotevřou: zobrazí se „Vaše licence neobsahuje účetní exporty“ a nabídka licencí, které propojení s účetnictvím obsahují (viz Když obrazovku nepustí licence).
Stránky Pohoda a Money S3 mají každá vlastní nastavení i vlastní token pro stahování. Pohoda umí víc: agendu podle formy úhrady, členění DPH a předkontace, pokladní knihu, obědy zaměstnanců zvlášť a stejná data v Excelu.
Pohoda: nastavení
Všechno se ukládá tlačítkem Uložit nastavení. Nahoře stránka jednou větou řekne, jestli je export zapnutý a do které agendy jde která forma úhrady. Odkazy do číselníků Pohody se zadávají jako zkratky (např. UD, HP), ne jako interní čísla – zkratky zůstávají stejné i v dalším účetním roce. Prázdné pole se do souboru vůbec nepošle a Pohoda použije své výchozí nastavení.
| Část stránky | Co se v ní nastavuje |
|---|---|
| Základní nastavení | Aktivovat integraci povolí stahování přes odkaz (ruční stažení funguje i bez něj).
IČO účetní jednotky v POHODĚ – když ho necháte prázdné, použije se IČO z fakturačních údajů
účtu (Uživatel, kredit a faktury); musí sedět
s účetní jednotkou, do které se importuje. Doklady v exportu: doklad za každou účtenku, nebo
souhrnný doklad za každou uzávěrku – podle toho se řídí odkaz
bez parametru export. |
| Formy úhrady | Pro každou formu úhrady (hotově, kartou, stravenkou, na účet podniku, fakturou) agenda Pohody – Ostatní pohledávky, Vydané faktury, Pokladní doklady, Prodejky, nebo Neexportovat – a forma úhrady pro Pohodu. Ta je buď hodnota z výčtu Pohody (cash, creditcard, draft = příkazem, delivery, postal, advance, encashment, cheque, compensation; velikost písmen nevadí), nebo zkratka z vašeho číselníku forem úhrady, např. Stravenky (výčet Pohody stravenky nemá). Platba kartou kurýrovi nebo při výdeji se počítá jako karta. Výchozí je: faktury do vydaných faktur, všechno ostatní do ostatních pohledávek. |
| Nastavení agend | Záložka pro každou agendu (pod názvem je, které formy úhrady do ní teď jdou): Členění DPH (výchozí UD – bez něj Pohoda dosadí členění, které nemusí vstoupit do přiznání k DPH; prodejky ho v hlavičce nemají), Předkontace dokladu, Středisko, Činnost, Zakázka, Prefix číselné řady, u pohledávek a faktur Bankovní účet, u faktur Splatnost (dní) (výchozí 14; když je splatnost vyplněná v Nastavení faktur, platí ta) a u pokladních dokladů povinná Pokladna – bez ní Pohoda pokladní doklad nevytvoří; stránka na to po uložení upozorní a export pro Pohodu (XML) s pokladními doklady skončí hláškou místo souboru – Excel ke kontrole se stáhne i bez ní. Pokladní doklady mají navíc Prefix řady výdajových dokladů pro výdaje, výběry a záporné rozdíly z pokladní knihy (Pohoda čísluje příjmy a výdaje jinými řadami). Dál Položka spropitného (text, sazba DPH, předkontace a u všech kromě prodejek členění DPH) a Posílat stav EET 2.0. |
| Co do exportu nepatří | Nevyvážet účty (stoly) s názvem – výchozí ODPISY, víc názvů oddělte čárkou, velikost písmen nehraje roli. Hodí se pro odpisy ze skladu, které nejsou pohledávky. Obědy zaměstnanců: v běžném exportu, nebo vynechat (viz Obědy zaměstnanců). |
| Pokladní kniha v POHODĚ | Předkontace a členění DPH pro každý druh pohybu pokladní knihy – příjem hotovosti za účtenky, spropitné v hotovosti, vklad, jiný příjem, výběr, výdaj a rozdíl při kontrole. Pokladnu, středisko, činnost, zakázku a prefix řady berou ze záložky Pokladní doklady. |
Co export do Pohody obsahuje
- Jen zaplacené účtenky. Bon, který pokladna pošle do kuchyně ještě před zaplacením (v Pohodě by se ukázal jako doklad za 0 Kč s číslem místo čísla objednávky), se nevyváží – doklad vzniká až z placené účtenky. Smazané objednávky také ne, stornodoklady ano (záporné). Vynechají se účty ze seznamu „nevyvážet“, podle nastavení obědy zaměstnanců a formy úhrady nastavené na Neexportovat.
- Jeden doklad za účtenku v agendě podle formy úhrady. Číslo dokladu se neposílá – Pohoda doklad očísluje výchozí řadou, nebo řadou s nastaveným prefixem. Číslo z pokladny (denně se nuluje) je v textu dokladu „Objednávka č. 62 - Terasa 6“. Variabilní symbol je ID dokladu v ProfiRESTu (Interní ID v detailu objednávky), které se nikdy neopakuje. Pokladní doklad a prodejka variabilní symbol nemají – ID je u pokladního dokladu v poli Doklad, u prodejky v interní poznámce. Výjimka: když faktury vystavuje ProfiREST (Nastavení faktur), jde vystavená faktura do Pohody s naším číslem (Pohoda hlídá, aby se neopakovalo) a variabilním symbolem z čísla faktury – stejně jako na PDF.
- Datum vystavení, zdanitelného plnění i účetního případu je den zaplacení. Splatnost je den zaplacení; jen u vydané faktury placené Fakturou nebo Na účet podniku je to den vystavení + Splatnost (dní). U platby Fakturou ji jde u konkrétní faktury změnit v detailu objednávky. Účtenka zaplacená na místě, která jde do vydaných faktur, je splatná v den zaplacení. U faktury vystavené ProfiRESTem je datum vystavení den, kdy jste ji vystavili, datum zdanitelného plnění zůstává den zaplacení účtu.
- Odběratel – údaje, které pokladna zapíše při placení na fakturu (firma, jméno, adresa, IČO, DIČ, e-mail), nebo údaje opravené u faktury na stránce Faktury vystavené. Prázdné údaje se neposílají; bez nich zůstane „Běžný zákazník“.
- Položky mají cenu za kus s DPH včetně obalu a sazbu podle objednávky; základ a DPH dopočítá Pohoda. Sleva na celý účet, Úprava ceny a doprava (Doprava / Rozvoz) jsou samostatné položky rozdělené do sazeb jako v rozpisu DPH na účtence, Zaokrouhlení je položka mimo DPH. Součet dokladu tak sedí s kopií účtenky na haléř. Název položky delší než 90 znaků se zkrátí (víc Pohoda nepřijme). Dárkový voucher je položka bez DPH Prodej dárkového voucheru … (nepodléhá DPH), platba voucherem záporná položka Úhrada dárkovým voucherem … (nepodléhá DPH).
- Spropitné je samostatná položka s textem, sazbou, předkontací a členěním z nastavení agendy – jen u dokladů, kde bylo; ostatní položky převezmou předkontaci dokladu. Storno celé účtenky spropitné odečte (záporná položka), storno jen části účtenky ho nechá – spropitné hostu zůstává. Spropitné se teď zaznamenává z pokladen připojených přes API v2; přehled je ve Spropitném. Souhrnné doklady za uzávěrky spropitné neobsahují.
- Stav EET 2.0 – u dokladů od 1. 1. 2027, když provozovna eviduje tržby v ProfiRESTu (EET 2.0) a u agendy je zapnuté Posílat stav EET 2.0: tržba přijatá finanční správou nebo zaevidovaná jiným systémem provozovny = externally (zaevidováno mimo Pohodu, Pohoda ji znovu neodešle); čekající, odmítnutá, ručně vynechaná nebo platba na místě (i kartou na kiosku), ke které tržba zatím chybí = notSend (k řešení); platba, která do evidence nevstupuje (faktura, účet podniku, zaplaceno online předem, objednávka rozvozové platformy), objednávka zrušená dřív, než se zaevidovala, a doklad s nulovou částkou = notEnter. Stornodoklad bez vlastní tržby dostane stav tržby původní účtenky. Potvrzovací kód, evidenční jednotka, pokladní zařízení a pořadové číslo jdou do interní poznámky dokladu. Podrobný blok EET Pohoda zatím zná jen pro původní EET (vyžaduje PKP a BKP), proto se posílá jen stav.
- Souhrnné doklady za uzávěrky – jeden doklad za uzávěrku s položkou tržby za každou sazbu DPH (součet rozpisů DPH účtenek uzávěrky), Zaokrouhlením mimo DPH a zvlášť Prodejem dárkových voucherů a záporně Úhradami dárkovými vouchery. Jdou do agendy, kterou má nastavená platba hotově, s formou úhrady hotovosti – ale nikdy do pokladních dokladů (uzávěrka obsahuje i karty, faktury a stravenky): při Pokladních dokladech nebo Neexportovat jdou do ostatních pohledávek.
- Pokladní kniha – každý vklad, výběr, výdaj, jiný příjem a rozdíl při kontrole jako pokladní doklad (příjem nebo výdej) s popisem a číslem dokladu. Počáteční stav se neposílá. Hotovost za účtenky a spropitné v hotovosti jdou každé jedním dokladem za den – ale jen když účtenky placené hotově nejdou samy do pokladních dokladů (export po účtenkách s hotovostí do pokladních dokladů), jinak by byly v Pohodě dvakrát. Při souhrnném dokladu za uzávěrku jdou vždy.
- Faktury přijaté – faktury od dodavatelů zapsané na stránce
Faktury přijaté s DUZP v období, každá jako přijatá faktura
bez položek se souhrnem po sazbách – základ a DPH přesně podle zápisu, POHODA je nepřepočítává (10 % jako druhá
snížená, 12 % a 15 % jako snížená sazba). Odkaz pro automatický import s
days(bezfromato) bere místo DUZP faktury zapsané v posledních N dnech – i ty, které jste zapsali se zpožděním. Číslo dodavatele jde jako původní doklad, variabilní symbol, datum vystavení, DUZP a splatnost z faktury, dodavatel jako partner; členění DPH (výchozí PD), předkontace, prefix řady a středisko z Nastavení faktur. - Účtenka placená zčásti hotově a zčásti kartou (pokladny připojené přes API v2) jde do Pohody jedním dokladem celá s hlavní formou úhrady (tou s největší částkou). Pokladní kniha v ProfiRESTu počítá jen hotovou část – když hotovostní účtenky jdou do pokladních dokladů, liší se pokladna v Pohodě od pokladní knihy o kartovou část takových účtenek.
Ruční export a odkaz pro automatický import
Ruční export stáhne soubor za zvolené období (výchozí je minulý měsíc) – XML pro import, nebo stejná data v Excelu ke kontrole (list Doklady s rozpisem základu a DPH, list Položky). Když za období a filtry nic není, stránka to řekne a nic se nestáhne. Automatický import (odkaz): tlačítkem Vygenerovat nový API token vznikne odkaz, ze kterého se doklady stahují bez přihlášení; funguje jen se zapnutým Aktivovat integraci. Pod ručním exportem se ukazuje odkaz se stejným výběrem, jaký máte ve formuláři. Jeden export je nejvýš za 92 dní.
| Parametr odkazu | Co dělá |
|---|---|
| from, to | Období podle dne zaplacení, např. ?from=2026-09-01&to=2026-09-30. |
| days | Místo období počet dní zpět; bez obojího 7 dní. |
| paymentType | Jen dané formy úhrady, víc oddělených čárkou – forma úhrady v ProfiRESTu
velkými písmeny (CASH, CREDIT_CARD včetně karty při převzetí, TICKET,
ENTERPRISE_ACCOUNT, INVOICE), nebo hodnota, se kterou doklad jde do Pohody
(cash, creditcard, draft …) – ta zahrne všechny formy úhrady, které mají
v nastavení tuto hodnotu (když mají stravenky také cash, vrátí cash i je);
cash a creditcard vždy zahrnou i platby Hotově, resp. Kartou. Místo kódů
jdou i názvy card, ticket, enterprise, invoice,
kartou, stravenky … Neznámá hodnota skončí hláškou, ne prázdným souborem. |
| invoiceType | Jen agenda: receivable (ostatní pohledávky), issuedInvoice
(vydané faktury), voucher (pokladní doklady), prodejka. |
| nonZero=1 | Bez dokladů s nulovou částkou. |
| employees | exclude bez obědů zaměstnanců, only jen ony,
include se vším; bez parametru podle nastavení. |
| export | documents doklady za účtenky, summary souhrny uzávěrek,
cashbook pokladní kniha, received faktury přijaté (s from/to podle DUZP, s days podle data zápisu;
s changed=1 jen faktury, které účetní ještě nemá – neexportované nebo změněné po exportu, bez ohledu na období – viz
Co už účetní má v POHODĚ), employees přehled obědů zaměstnanců (vždy Excel); bez parametru
podle Doklady v exportu. |
| format=xlsx | Stejná data v Excelu místo XML. |
Tlačítko Export Pohoda v Seznamu objednávek vezme vyfiltrované objednávky a složí z nich doklady podle stejného nastavení (agendy, členění, předkontace, odpisy a obědy zaměstnanců). Doklady pro Pohodu umí vydat i API v2 (účetní export pro připojené aplikace): tam invoices dá všechno jako vydané faktury, receipts jako prodejky, bez filtrů odkazu.
Obědy zaměstnanců
Obědem zaměstnance je účet (stůl), který se jmenuje jako zaměstnanec provozovny ze
Správy zaměstnanců – stejné pravidlo, podle kterého pokladna účtuje
zaměstnaneckou cenu. Kód v hranaté závorce na konci názvu účtu („Nováková Jana [Z0001-01]“) nevadí, i když ho
zaměstnanec ve jméně nemá. Počítají se i zaměstnanci, kteří už byli smazáni. S volbou Vynechat jdou obědy
z běžného exportu pryč a exportujete je zvlášť parametrem employees=only. Přehled obědů
zaměstnanců (export=employees) je Excel s listem po lidech – počet účtenek, počet placených
položek, počet všech položek a částka – pro mzdy; bere všechny obědy zaměstnanců v období, i placené formou úhrady,
která se do Pohody nevyváží, a filtry formy úhrady, agendy a nulových dokladů na něj neplatí.
S odkazem zacházejte jako s heslem
Kdo odkaz zná, stáhne si vaše doklady i údaje odběratelů bez přihlášení. Když unikne, vygenerujte nový token – potvrzovací dotaz upozorní, že starý odkaz přestane fungovat, a v účetním programu pak musíte zadat nový. Stahování přes odkaz zastavíte také vypnutím Aktivovat integraci.
Zkratky si domluvte s účetní
Členění DPH, předkontace, pokladnu a formy úhrady musí účetní mít založené v Pohodě pod stejnou zkratkou. Než začnete exportovat naostro, stáhněte krátké období a nechte ho naimportovat nanečisto. Doklady už naimportované s jiným nastavením se samy neopraví.
Money S3
Nastavení uložíte tlačítkem Uložit konfiguraci.
| Pole | Co dělá |
|---|---|
| Aktivovat integraci | Povolí stahování dokladů přes odkaz (viz níže). Stav ukazuje věta nahoře na stránce (Integrace je aktivní / Integrace je neaktivní). Ruční stažení souboru funguje i bez zapnutí. |
| Firma / IČO pro exporty | IČO účetní jednotky, do které se XML importuje (v souboru jako ICAgendy) – Money podle něj
pozná, že doklady patří do správné firmy. Prázdné = IČO z fakturačních údajů majitele. |
| Typ generovaných XML dokladů | Vydané faktury, prodejky, nebo souhrnné doklady za uzávěrky. Podle tohoto nastavení se řídí stahování přes odkaz; při ručním stažení typ vybíráte zvlášť. |
| Mapování platebních metod | Text, který se u dokladu zapíše jako způsob úhrady – zvlášť pro hotovost, platební kartu, stravenky, faktury a podnikový účet. Výchozí texty jsou Hotově, Kartou, Stravenka, Převodem, Převodem. |
Ruční export (Od data, Do data, Typ exportovaných dat,
Generovat a stáhnout XML) i odkaz s tokenem (7 dní zpětně, nebo
?from=…&to=…) fungují stejně jako dřív. Faktury a prodejky obsahují jeden doklad za každou zaplacenou
účtenku provozovny ze zvoleného období, ze všech zdrojů a včetně stornodokladů, s částkami stejnými jako na kopii
účtenky – bon, který pokladna pošle do kuchyně před zaplacením, ne;
souhrnné doklady jednu položku tržby za každou sazbu DPH uzávěrky. Když v období nic není, stáhne se prázdný soubor.
Co v souboru je
- Formát XML přenosů Money S3: vydané faktury jako faktury vydané, prodejky jako prodejky (položky bez skladu), uzávěrky podle nastaveného typu.
- U faktury souhrn DPH po sazbách přesně jako rozpis DPH na kopii účtenky; zaokrouhlení a dárkové vouchery jdou mimo DPH.
- Ceny položek jsou s DPH. Texty mají v Money nejvýš 50 znaků, delší název se zkrátí.
Čísla dokladů
Číslo účtenky z pokladny se každý den počítá od začátku, proto ho export neposílá jako číslo dokladu
(Money by jím přepsalo starší doklad se stejným číslem). Číslo přidělí číselná řada v Money, číslo účtenky
je v popisu dokladu a variabilní symbol je ID objednávky. Souhrnný doklad za uzávěrku má číslo
U + číslo uzávěrky. Prodejka v Money nemá způsob úhrady – ten je v popisu (např.
Účtenka č. 12 - Kartou).
Stejné období naimportované dvakrát založí doklady znovu – importujte každé období jen jednou.
Rozvozové platformy
Vyžaduje licenci s rozvozovými integracemi
Bez ní se stránky neotevřou: zobrazí se „Vaše licence neobsahuje rozvozové integrace“ a nabídka licencí, které Wolt, Bolt, Foodoru a Choice obsahují.
Stránky Foodora API, Wolt API, Bolt Food API a Choice Delivery ve skupině Rozvozové služby mají stejnou stavbu. Objednávky přijímá adresa webhooku: platforma na ni objednávku pošle a ProfiREST ji založí v kuchyňském systému. Nic dalšího se s platformou nevyměňuje.
| Na stránce | Co dělá |
|---|---|
| Aktivovat … integraci | Přepínač a stav Aktivní / Neaktivní nahoře na stránce. Příjem objednávek neřídí – adresa webhooku přijímá objednávky i při vypnutém přepínači. |
| Přístupové údaje | Wolt: Wolt API Merchant Key (Token) a Venue ID (Pobočka ve Woltu); Bolt Food: Bolt Food API Key a Provider ID (Pobočka v Bolt Food); Foodora: Client ID, Client Secret a Shop ID (Restaurant ID v systému Foodora); Choice: Choice API Key (Token) a Shop ID (ID pobočky v Choice). Údaje se uloží, ale k příjmu objednávek se nepoužívají a vyplňovat je nemusíte. |
| Adresa pro Webhook (Webhook URL) | Adresa, na kterou má platforma posílat objednávky, s tlačítkem Kopírovat. Obsahuje tajný token provozovny. |
| Regenerovat token | Vytvoří nový token, a tím nové adresy webhooků – viz upozornění níže. |
| Simulovat testovací objednávku | Pošle na adresu webhooku vymyšlenou objednávku – viz upozornění níže. |
| Uložit konfiguraci | Uloží přepínač a přístupové údaje. Tlačítka Regenerovat token a Simulovat testovací objednávku rozepsané změny neuloží. |
| Historie přijatých objednávek a webhooků | Sloupce Čas, Typ události, Stav, Zpráva a tlačítko Zobrazit JSON s daty, která přišla. Ukazuje nejvýš 15 posledních záznamů této platformy; systém si drží 50 posledních záznamů za všechny platformy dohromady. Požadavky se špatným tokenem se do historie nezapisují. |
Jak integraci zapojit
Zkopírujte adresu webhooku
Tlačítkem Kopírovat u Adresa pro Webhook (Webhook URL).
Vložte ji do portálu platformy
Podle pokynu na stránce ji vložte v portálu platformy do nastavení webhooků. To se dělá u platformy, ne v ProfiRESTu.
Zkontrolujte první objednávku
ProfiREST z objednávky přebírá jen číslo objednávky, jméno a telefon zákazníka, položky s názvem, cenou a počtem, celkovou cenu, cenu dopravy, adresu, poznámku a způsob platby – v jednom pevně daném tvaru. Jestli je platforma posílá právě tak, stránka neověří. První skutečnou objednávku proto zkontrolujte v historii na stránce i ve frontě kuchyňského systému.
Testovací objednávka je skutečná objednávka
Simulovat testovací objednávku pošle ze serveru na vaši adresu webhooku vymyšlenou objednávku: náhodné jméno, telefon a jídlo, adresa ve Svitavách a doprava 39 Kč. Platforma se toho neúčastní, ověříte jen příjem v ProfiRESTu. Vznikne ale ostrá objednávka – objeví se ve frontě kuchyně, v seznamu objednávek a ve statistikách a do databáze zákazníků přibude zákazník. Telefon je náhodně vygenerované číslo, takže při zapnutých notifikačních SMS by zpráva mohla odejít cizímu člověku. Testovací objednávku v kuchyňském systému stornujte, nedokončujte ji ani ji nedávejte do trasy.
Nový token zneplatní adresy všech platforem
Token je jeden pro všechny čtyři platformy provozovny. Když ho vygenerujete na stránce kterékoli z nich, přestanou fungovat dosavadní adresy webhooků u všech – i když potvrzovací dotaz jmenuje jen jednu platformu. Nové adresy pak musíte vložit do portálů všech platforem, které používáte; požadavky se starým tokenem systém odmítne.
Adresu webhooku nesdílejte
Kdo adresu zná, může do vaší kuchyně poslat objednávku. Příjem nezastaví vypnutý přepínač, otevírací doba, neuhrazená licence ani deaktivace provozovny. Když chcete příjem zastavit, zrušte webhook v portálu platformy, nebo vygenerujte nový token – tím ale zastavíte všechny platformy najednou.
Co objednávka z platformy udělá
Co objednávka z platformy neudělá
Sklad a porce
Položky nejsou spárované s produkty sortimentu. Sklad se podle receptur neodepíše a neodečtou se ani porce.
Marže
Objednávka se nezapočítá do přehledu Příjmy a výdaje – viz Administrace systému → Příjmy a výdaje.
Nabídka na platformě
ProfiREST na platformy neposílá nabídku, ceny ani dostupnost jídel. Menu spravujete v portálu platformy; nastavení viditelnosti v sortimentu ho neovlivní.
Odpověď platformě
Kromě odpovědi na samotné doručení objednávky ProfiREST platformě nic neposílá – přípravu, storno ani dokončení se jí nehlásí. Stav objednávky na platformě řešíte v jejím portálu nebo aplikaci.
Připojené aplikace
Aplikace jiné firmy, třeba váš vlastní e-shop, se k ProfiRESTu připojí přes veřejné rozhraní API v2. Nepotřebuje k tomu vaše heslo: připojení spustíte v aplikaci tlačítkem Připojit přes Profirest a souhlas dáte u nás v administraci. Starší napojení přístupovým klíčem provozovny popisuje Nastavení provozovny → Webové API.
Jak připojení proběhne
V aplikaci klikněte na „Připojit přes Profirest“
Aplikace vás pošle do administrace ProfiRESTu. Pokud nejste přihlášení, přihlásíte se obvyklým způsobem.
Zkontrolujte, co bude aplikace smět
Stránka Připojení aplikace vypíše oprávnění, o která aplikace žádá, například vidět sortiment a ceny nebo posílat objednávky do kuchyně.
Vyberte provozovny a povolte přístup
Zaškrtněte provozovny, které má aplikace vidět, a potvrďte tlačítkem Povolit přístup. Pak se vrátíte zpět do aplikace. Tlačítkem Zamítnout se vrátíte bez připojení.
Žádost platí 15 minut a povolit ji smí jen majitel
Když stránku necháte otevřenou déle, spusťte připojení v aplikaci znovu. Zaměstnanec místo formuláře uvidí vysvětlení, že aplikaci připojit nemůže.
Aplikace, která má od ProfiRESTu jen testovací přístup, se připojí jen k veřejnému ukázkovému účtu. U vás stránka místo formuláře napíše, že ji připojit nejde – k vašim provozovnám ji připojíte, až její vývojář dostane ostrý přístup.
Co na stránce Připojené aplikace najdete
Každá připojená aplikace má vlastní kartu. Nahoře vidíte, kdy jste ji připojili a kdy byla naposledy aktivní.
Provozovny
Aplikace vidí a obsluhuje jen zaškrtnuté provozovny. Provozovnu můžete kdykoli přidat nebo odebrat. U aplikací se zařízeními (pokladna, kuchyňský displej, píchačka) se odebráním provozovny odpárují i zařízení této aplikace v ní – hláška po uložení řekne kolik a v Zařízeních už nebudou.
Co aplikace smí
Odškrtnutím aplikaci oprávnění vezmete. Vrátit ho jde jen novým připojením z aplikace, proto se stránka před uložením zeptá.
Zprávy zákazníkům
Jen u aplikací, které smí posílat objednávky. Vyberete, jestli zákazníkům píše o objednávce sama aplikace, nebo jim ProfiREST pošle SMS z vašeho kreditu.
Zrušit připojení
Aplikace hned ztratí přístup ke všem provozovnám. Objednávky, které už poslala, zůstanou. Znovu ji připojíte jen z aplikace.
Změny v provozovnách, oprávněních a zprávách se uloží společně tlačítkem Uložit změny a platí hned. Zrušená připojení najdete dole v rozbalovacím seznamu Zrušená připojení.
E-shop podle příjmu objednávek, aplikace pro personál kdykoli
Aplikace, ve kterých objednávají zákazníci sami (e-shop), se řídí příjmem objednávek (bez vlastních časů otevírací dobou), časy rozvozu zón a nastavením objednávek na čas. Aplikace pro váš personál (pokladna, kuchyně) mohou objednávat kdykoli, i mimo otevírací dobu. Na souhlasové stránce je u nich věta, která to říká.
„Profirest tuto aplikaci dočasně zastavil“
Aplikaci můžeme zastavit, například když se chová chybně. Připojení se tím nezruší. Po odblokování aplikace funguje jako dřív a nic nemusíte nastavovat znovu.
Objednávky z aplikací
Pravidla pro připojené aplikace, ve kterých objednávají zákazníci sami, třeba e-shop jiné firmy. Nastavují se pro provozovnu, kterou máte v administraci vybranou, a nezávisí na nastavení našeho e-shopu. Nahoře stránka jednou větou řekne, co aplikace zákazníků teď přijímají, a upozorní, co jim brání (chybějící otevírací doba a příjem objednávek, žádná aktivní rozvozová zóna, licence bez webu).
Příjem objednávek
Vypínačem Přijímat objednávky z aplikací příjem pozastavíte, třeba když kuchyně nestíhá. Aplikace zákazníků pak objednávku neodešlou.
Rozvoz a osobní odběr
Každý jde vypnout zvlášť. Rozvoz jde jen na adresy v aktivních rozvozových zónách provozovny.
Objednávky na pozdější čas
Kolik dní dopředu, jestli i na dnešek a na víkend, od kdy do kdy, po kolika minutách se časy nabízejí a jaký je nejkratší předstih. Zákazník si vybírá jen z časů, které aplikaci spočítá ProfiREST.
Uložení
Tlačítkem Uložit. Platí hned a připojené aplikace se o změně dozvědí.
Příjem objednávek platí vždy
Objednávku na „co nejdřív“ i na pozdější čas jde odeslat jen v době příjmu objednávek (bez vlastních časů v otevírací době) a čas objednávky musí být v ní. Stejně to dělá náš e-shop. Samostatný kiosek v provozovně se řídí otevírací dobou.
Aplikací personálu se pravidla netýkají
Pokladna, kuchyňský displej a další aplikace, ve kterých objednává váš personál, objednávají kdykoli, i když příjem z aplikací pozastavíte nebo máte zavřeno.
Samoobslužný kiosek
Kiosek ProfiREST, na kterém si hosté objednávají v provozovně sami, má na stránce vlastní část Samoobslužný kiosek. Pravidla výše (pozastavení aplikací, rozvoz, objednávky na čas) se ho netýkají a licenci s webem nepotřebuje. Část se na stránce objeví po úpravě databáze; do té doby kiosek objednává podle pravidel aplikací zákazníků. Kiosek připojíte kódem v Zařízeních.
| Volba | Co dělá |
|---|---|
| Přijímat objednávky z kiosků | Vypnutím zastavíte jen kiosky, třeba když kuchyně nestíhá. E-shop, aplikace zákazníků ani pokladna se tím nezastaví. Platí v obou režimech níže. |
| Samostatně | Kiosek přijímá jen v otevírací době a jen objednávky „co nejdřív“ s vyzvednutím v provozovně – rozvoz ani objednávky na pozdější čas ne. Akce pro aplikace se počítají. |
| Jako obsluha | Kiosek objednává kdykoli a bez časových pravidel, stejně jako pokladna – i když máte podle otevírací doby zavřeno. Akce pro aplikace se nepočítají. |
V obou režimech je objednávka z kiosku objednávkou hosta: v kuchyni je označená Z webu, ukáže se na vyvolávacím monitoru a kuchyň k ní položky nepřidává. Porce se hlídají jako na pokladně, tedy i tehdy, když je provozovna hlídá jen na pokladnách.
- „Tady“ a „S sebou“. Objednávka „Tady“ jde do kuchyně jako na místě, bez ceny obalu a se sazbou DPH produktu na místě. „S sebou“ je osobní odběr i s obalem, stejně jako z e-shopu.
- Platba kartou na kiosku. Když host zaplatí kartou přímo na platebním terminálu kiosku, přijde objednávka do kuchyně jako zaplacená (v poznámce Zaplaceno kartou na kiosku, nic nevybírat, v uzávěrce v řádku Kartou) a tržbu do EET 2.0 zaeviduje server. Při placení až u výdeje se platí jako u osobního odběru z e-shopu.
- Bez kontaktu. Host na kiosku jméno ani telefon zadávat nemusí – čeká na číslo objednávky. Bez jména je objednávka v kuchyni pod jménem Kiosek; bez telefonu jí nepřijde žádná SMS a do databáze zákazníků se nezapíše.
- Velikosti jídel. Jídlo se sadou velikostí ukáže kiosek jako jednu dlaždici s cenou základní velikosti; velikost host zvolí v detailu jídla a objedná ji za její vlastní cenu, vyprodanou velikost zvolit nejde. Pizzu půl na půl skládá jen ze stejné velikosti.
Jak objednávka z aplikace vypadá v kuchyni
Objednávka z aplikace přijde do kuchyně stejně jako objednávka z našeho e-shopu: s číslem pro kuchyň, se jménem a telefonem zákazníka a u rozvozu s adresou na mapě (viz Obrazovka objednávek). Na displeji je označená Z webu (z aplikace personálu Z kuchyně) a na konci poznámky je název aplikace, například Aplikace: Pizza Online. Zaplaceno předem online se ukáže jako Placeno online, platba kartou při převzetí jako Kartou při převzetí (v uzávěrce v řádku Kartou). Voucher a platba kartou kurýrovi jsou napsané i v poznámce stejně jako u e-shopu.
Jídlo ve více velikostech (sady velikostí) přijde do kuchyně jako zvolená velikost s celým názvem, například Ø42cm Margherita – každá velikost je samostatný produkt s vlastní cenou a recepturou, stejně jako z e-shopu nebo pokladny. Aplikace dostanou v sortimentu u každé velikosti i název jídla a velikosti zvlášť, takže je mohou ukázat jako jedno jídlo s přepínačem velikostí jako e-shop; jak to udělají, záleží na aplikaci.
Čeká na platbu
Objednávka placená online přijde do kuchyně, až aplikace potvrdí zaplacení. Když to do 30 minut neudělá, objednávka se sama zruší a voucher i porce se vrátí.
Zrušení z aplikace
Aplikace smí objednávku zrušit, jen dokud ji nikdo nezačal připravovat: nikdo nedal PŘÍPRAVA, výroba ji nevzala a nic z ní není hotové. Pak zmizí z displeje a v tržbách ji vyrovná stornovací doklad. Vytištěný bon zůstane – když podle bonů vaříte, dejte u rozdělané objednávky PŘÍPRAVA, aplikace ji pak zrušit nemůže. Peníze za online platbu zákazníkovi vrací aplikace.
Zrušení u vás
Objednávku z aplikace stornujete v kuchyni tlačítkem STORNO jako každou jinou a aplikace se to dozví. Stornovanou objednávku už žádné tlačítko nevrátí do přípravy.
Zprávy zákazníkům
Když zprávy posílá ProfiREST (volba u aplikace v Připojených aplikacích), zákazník dostane po přijetí objednávky potvrzovací SMS jako z e-shopu a SMS z kuchyně, pokud je máte zapnuté. Když je posílá aplikace, ProfiREST zákazníkovi nepošle nic. SMS chodí na česká a slovenská čísla.
Aplikace se o průběhu dozví do minuty
Když v kuchyni dáte PŘÍPRAVA nebo HOTOVO, předáte objednávku kurýrovi nebo ji stornujete, ProfiREST to aplikaci předá obvykle do minuty. Zákazník tak v aplikaci vidí, jestli se jeho objednávka připravuje, je hotová nebo už jede.
Zákazníci aplikací
Aplikace může svého zákazníka propojit s vaší databází klientů podle telefonního čísla. Jeho objednávky z aplikace se pak počítají stejnému klientovi jako objednávky v restauraci. Nového klienta založí až jeho první objednávka, samotné propojení vám do databáze nic nepřidá. Aplikace nikdy neuvidí, co o klientovi víte vy (jméno, e-mail, historii), jen to, co sama poslala.
Za objednávku propojeného zákazníka dostane klient věrnostní body: 1 bod za každou celou korunu ceny položek před vouchery – doprava ani doplatek do minima se nepočítají, stejně jako na pokladně (body v databázi zákazníků). Zrušená objednávka body vrátí. Stav bodů aplikace uvidí jen u zákazníka s ověřeným telefonem. Uplatnit body přes aplikace zatím nejde.
Ověřovací SMS se platí z vašeho kreditu
Aplikace může telefon zákazníka ověřit kódem z SMS. Ta se platí z vašeho kreditu jako ostatní SMS. Jeden telefon dostane od jedné aplikace nejvýš 5 kódů za den (ze všech aplikací dohromady nejvýš 15) a každá aplikace má denní limit, který nastavuje ProfiREST. Kódy chodí na česká a slovenská čísla.
API pro vývojáře
Připojené aplikace komunikují s ProfiRESTem přes veřejné REST API v2 na adrese
https://api.mujprofirest.cz/v2/. Jeho dokumentace je veřejná, česky i anglicky, a popisuje každou
operaci s ukázkami v curl a v oficiálních knihovnách pro JavaScript, TypeScript, PHP, Javu, Kotlin, C#, Python,
Swift, Dart a Go. Pokud vám e-shop nebo jinou aplikaci programuje dodavatel, pošlete mu odkaz na dokumentaci.
| Oblast API | Co v ní aplikace najde |
|---|---|
| Objednávky | Kalkulace košíku a odeslání objednávky do kuchyně, potvrzení online platby, storno a stav objednávky. |
| Sortiment a ceny | Kategorie, produkty a ceny provozovny, zbývající porce, akce a slevové kódy, denní menu. |
| Provozovny a přehledy | Otevírací doba, rozvozové zóny a časy, na které jde objednat; účetní export pro Pohodu a Money, uzávěrky směn, souhrn tržeb, prodej položek, spropitné, DPH podle sazeb, prodejní doklady a pokladní kniha. |
| Zákazníci | Propojení zákazníků aplikace s vaší databází klientů, ověření telefonu a věrnostní body; ověření dárkového voucheru. |
| Události | Proud změn po stránkách nebo živě (Server-Sent Events); stejné události doručují i webhooky. |
| Vlastní ID | Vlastní identifikátory a metadata aplikace u provozoven, kategorií, produktů, objednávek a zákazníků. |
| Zařízení Profirestu | Pokladna a účtenky, kuchyňský displej, rozvoz a kurýři, docházka, inventura, objednávání od stolu, zálohy a diagnostika. Kdo tyto oblasti smí používat, popisuje dokumentace v oddílu Vlastní zařízení Profirestu. |
Dokumentace a návody
Referenční dokumentace všech operací, návody s celými scénáři napojení, changelog a strojově čitelná specifikace OpenAPI.
Vyzkoušení bez programování
V playgroundu jde každou operaci spustit v prohlížeči nad příklady z dokumentace, nebo naostro s vlastním přístupem.
Testovací přístup
Testovací přístup dostane vývojář hned po potvrzení e-mailu, bez schválení. Připojí se s ním jen k veřejnému ukázkovému účtu, ne k vašim provozovnám.
Ostrý přístup
O přístup k ostrým účtům žádá vývojář na vývojářském portálu formulářem Žádost o přístup; žádost schvaluje ProfiREST. K vašemu účtu se jeho aplikace připojí až s vaším souhlasem, jak popisuje Jak připojení proběhne.
Starší napojení přístupovým klíčem provozovny (Webové API v1) dál funguje, popisuje ho Nastavení provozovny → Webové API; přechod na API v2 popisuje dokumentace v oddílu Přechod z API v1.