# Pokladna pro Android: instalace a režimy zařízení

Nápověda ProfiREST › Pokladní systém (POS) › Instalace a režimy (Android) · https://www.mujprofirest.cz/help/pokladna/instalace · aktualizováno 2026-10-09

Instalace jednoho zařízení trvá pár minut: **jméno účtu → kód do administrace → režim → PIN**. Stejně se instaluje pokladna na baru i telefon číšníka. Nahoře je postup, níž podrobnosti, výjimky a co dělat, když se něco nedaří.

**Kde to najdu:** Aplikace · Boční menu → Správce → Nastavení API · Přihlašovací obrazovka → ⋮ → Nastavit API · **Přidává se v:** [Nastavení → Správa PC / zařízení](https://www.mujprofirest.cz/help/administrace/zarizeni#cisnik)

- **Mám jedno zařízení** – Pokladna na baru bez telefonů pro číšníky. Projděte [instalaci v pěti krocích](https://www.mujprofirest.cz/help/pokladna/instalace#instalace) a ve čtvrtém kroku zvolte *Samostatná pokladna*.
- **Pokladna a telefony číšníků** – Nejdřív nainstalujte pokladnu jako *Hlavní pokladnu*. Pak každý telefon jako *Mobilního číšníka* a [připojte ho k ní](https://www.mujprofirest.cz/help/pokladna/instalace#cisnik).
- **K pokladně přibývají číšníci** – Pokladna už prodává jako samostatná? Neinstalujte ji znovu, stačí [zapnout server pro číšníky](https://www.mujprofirest.cz/help/pokladna/instalace#prepnuti). Data jí zůstanou.
- **Něco nejde** – Telefon se nepřipojí, nebo instalace skončila hláškou? [Postup a hlášky](https://www.mujprofirest.cz/help/pokladna/instalace#problemy).

> **Než začnete**
>
> - Přístup do administrace – majitel, nebo zaměstnanec s oprávněním [Nastavení restaurace](https://www.mujprofirest.cz/help/administrace/zamestnanci#prava-web). Jen ten zařízení přidá.
> - [Licence, která pokladny dovoluje](https://www.mujprofirest.cz/help/administrace/zarizeni#licence), a [kredit](https://www.mujprofirest.cz/help/administrace/nastaveni#kredit) – každá pokladna i telefon číšníka nad počet v ceně se hned platí poměrnou částí ceny.
> - [Zaměstnanci s oprávněním Bar](https://www.mujprofirest.cz/help/administrace/zamestnanci#provozovny) a [PINem](https://www.mujprofirest.cz/help/administrace/zamestnanci#karta) – jinak se po instalaci nemá kdo přihlásit.
> - [Sortiment připnutý k provozovně](https://www.mujprofirest.cz/help/administrace/sortiment#sortimenty), případně [mapa stolů](https://www.mujprofirest.cz/help/administrace/mapa_provozovny) a [předdefinované poznámky](https://www.mujprofirest.cz/help/administrace/predefinovane_poznamky) – pokladna si je stáhne při dokončení instalace.
>
> Jak se zařízení počítají do ceny a kdo se na pokladně přihlásí, popisuje [První spuštění a PINy](https://www.mujprofirest.cz/help/pokladna/prihlaseni).

## Instalace v pěti krocích

Stejně na pokladně i na telefonu. Každé zařízení se v administraci přidává zvlášť.

  ![Obrazovka Nastavení aplikace s polem Vaše uživatelské jméno do administrace a tlačítkem Pokračovat](https://www.mujprofirest.cz/help/assets/images/api_20261008_184017_c1f2ab.png)

***Krok 2.** Jméno účtu a Pokračovat.*

   ![Obrazovka Přidejte zařízení s výzvou Přihlašte se do administrace a přidejte zařízení a velkým čtyřmístným kódem](https://www.mujprofirest.cz/help/assets/images/api_20261008_184028_d3a7ce.png)

***Krok 3.** Tenhle kód opíšete do administrace.*

   ![Obrazovka Nastavení API na telefonu se třemi režimy, zvolený Mobilní číšník / další pokladna s IP adresou a portem](https://www.mujprofirest.cz/help/assets/images/api_20261008_184028_e79a44.png)

***Krok 4.** Režim. Telefon číšníka chce i adresu pokladny.*

1. **Stáhněte aplikaci a otevřete ji** – V administraci: **Nastavení → Stažení software**, karta *Pokladna pro Android*.
2. **Napište uživatelské jméno a klepněte na Pokračovat** – Jméno, pod kterým se [přihlašujete do administrace](https://www.mujprofirest.cz/help/administrace/zakladni_pojmy#pojmy) – ne e-mail.
3. **Kód z aplikace opište v administraci** – V upozornění na nový požadavek klikněte na **Přidat zařízení**, pojmenujte zařízení a do pole pro PIN opište kód. Pak v aplikaci klepněte na **Pokračovat**.
4. **Vyberte režim a klepněte na Dokončit nastavení API** – Jediné zařízení: *Samostatná pokladna*. Pokladna pro číšníky: *Hlavní pokladna, ke které se připojí další zařízení*. Telefon: *Mobilní číšník / další pokladna* a [adresa pokladny](https://www.mujprofirest.cz/help/pokladna/instalace#cisnik).
5. **Přihlaste se PINem** – Vyberte se v *Seznamu uživatelů* a zadejte svůj PIN.

**Dobré vědět ke krokům**

- **Krok 1** – Máte-li stránku *Stažení software* otevřenou na počítači, tlačítko s QR kódem vedle odkazu ukáže kód. Načtěte ho fotoaparátem tabletu a stažení začne přímo v něm. Při prvním spuštění se Android zeptá na povolení *Zařízení v okolí* (kvůli tiskárnám přes Bluetooth) a na novějších verzích i na oznámení. Povolte je.
- **Krok 2** – Jméno má 5 až 32 písmen a číslic, bez mezer. Aplikace tím v administraci vytvoří [požadavek na přidání zařízení](https://www.mujprofirest.cz/help/administrace/zarizeni#cisnik). Internet je potřeba na každém zařízení, i na telefonu číšníka.
- **Krok 3** – Upozornění v administraci svítí 10 minut, kód platí 20 minut. Název zařízení má aspoň 5 znaků. Zařízení vznikne pro provozovnu, kterou máte v administraci [právě vybranou](https://www.mujprofirest.cz/help/administrace/dashboard#provozovna). Tlačítko **Otevřít administraci** otevře formulář přímo v zařízení. Když zařízení v administraci ještě není, aplikace po **Pokračovat** napíše *„Zařízení nebylo přidáno v administraci“*.
- **Krok 4** – Pokladna si stáhne [sortiment](https://www.mujprofirest.cz/help/pokladna/prodej#co-vidi), zaměstnance a nastavení provozovny. Rozdíly mezi režimy jsou [níž](https://www.mujprofirest.cz/help/pokladna/instalace#rezimy).
- **Krok 5** – V seznamu jsou zaměstnanci s [oprávněním Bar](https://www.mujprofirest.cz/help/administrace/zamestnanci#provozovny). Kdo se v něm objeví a odkud se bere PIN, popisuje [První spuštění a PINy](https://www.mujprofirest.cz/help/pokladna/prihlaseni).

## Který režim zvolit

*Obrázek: Hlavní pokladna komunikuje se serverem ProfiREST přes internet, mobilní číšníci a další pokladny se k ní připojují přes wifi provozovny*

*Mobilní číšníci a další pokladny posílají objednávky a platby hlavní pokladně přes wifi provozovny. Se serverem ProfiREST za ně komunikuje hlavní pokladna.*

| Režim | Kdy ho zvolit | Co dělá |
| --- | --- | --- |
| Samostatná pokladna | Na provozovně je jediné zařízení. | Prodává a komunikuje přímo se serverem ProfiREST. Žádné jiné zařízení se k ní připojit nemůže. |
| Hlavní pokladna | Pokladna na baru, ke které se připojují mobilní číšníci nebo další tablet. | V aplikaci *Hlavní pokladna, ke které se připojí další zařízení*. Umí totéž co samostatná pokladna a navíc v zařízení spustí **server pro číšníky**. Pod volbou ukáže svou adresu (*IP adresa serveru*), kterou pak napíšete do telefonů číšníků. |
| Mobilní číšník / další pokladna | Telefon číšníka nebo další tablet na stejné provozovně. | Připojí se k hlavní pokladně přes wifi provozovny. [Stoly, účty](https://www.mujprofirest.cz/help/pokladna/stoly#android) i [platby](https://www.mujprofirest.cz/help/pokladna/platba#android) sdílí s ní, takže co namarkuje číšník, uvidí hned i pokladna. Jak spolu fungují v provozu, popisuje [Mobilní číšník a hlavní pokladna](https://www.mujprofirest.cz/help/pokladna/cisnik_a_kasa). |

  ![Obrazovka Nastavení API na tabletu se zvoleným režimem Hlavní pokladna, ke které se připojí další zařízení, a s IP adresou serveru](https://www.mujprofirest.cz/help/assets/images/api_20261007_183735_e659a2.png)

*Volba režimu na hlavní pokladně. Pod zvoleným režimem je adresa, kterou napíšete do telefonů číšníků.*

## Připojení telefonu číšníka

Na hlavní pokladně musí běžet server pro číšníky: režim *Hlavní pokladna*, nebo zapnutý přepínač [Aktivovat lokální API](https://www.mujprofirest.cz/help/pokladna/instalace#prepnuti).

1. **Na hlavní pokladně si najděte její adresu** – V bočním menu pod číslem verze, řádek *IP: …:3331*. Vypadá třeba jako *192.168.1.20*.
2. **Připojte telefon k wifi provozovny** – Ke stejné síti jako pokladnu. Přes mobilní data se k ní nepřipojí.
3. **V režimu Mobilní číšník / další pokladna napište adresu pokladny** – Do pole *IP adresa serveru*. *Port* nechte 3331 a políčko *Připojení na windows lokální API* nezaškrtávejte.
4. **Klepněte na Dokončit nastavení API** – Telefon si stáhne data z pokladny a ukáže [přihlášení](https://www.mujprofirest.cz/help/pokladna/prihlaseni#android).

  ![Obrazovka Nastavení API na telefonu: zvolený režim Mobilní číšník / další pokladna, vyplněná IP adresa serveru, port 3331 a nezaškrtnuté Připojení na windows lokální API](https://www.mujprofirest.cz/help/assets/images/api_20261008_184028_5880ac.png)

*Telefon číšníka: adresa hlavní pokladny, port 3331 a nezaškrtnuté připojení na Windows.*

**Dobré vědět**

- **Adresa pokladny** – Kromě bočního menu ji pokladna ukazuje i v **Správce** pod přepínačem *Aktivovat lokální API* a v oznámení Androidu *„ProfiREST – server pro číšníky běží“* (řádek *IP adresa kasy*). Do telefonu pište jen čtyři čísla s tečkami, bez *:3331*.
- **Předvyplněná adresa** – Při první instalaci aplikace předvyplní začátek adresy podle wifi, ve které telefon je. Obvykle stačí doplnit poslední číslo.
- **Windows** – Políčko *Připojení na windows lokální API* vypne šifrování spojení a hodí se jen k hlavní pokladně na počítači s Windows. Když se nastavení telefonu a pokladny liší, spojení se naváže, ale žádné zprávy neprojdou. Vypadá to jako výpadek sítě. Aplikace se proto před zaškrtnutím ještě ptá.
- **Připojování** – Telefon zkusí pokladnu zastihnout až třikrát a ukazuje *Počet pokusů*. Pokus jde přerušit tlačítkem **Zrušit**.
- **Jiná pokladna** – Telefon patří vždy k jedné hlavní pokladně. Když ho připojíte k jiné pokladně nebo k jiné provozovně, smaže data té předchozí, odhlásí obsluhu a stáhne si data nové.

> **Dejte hlavní pokladně pevnou adresu**
>
> Telefony si adresu pokladny pamatují. Když router po restartu nebo výpadku proudu přidělí pokladně jinou adresu, číšníci se nepřipojí, dokud ji v telefonech neopravíte ([Nastavení API](https://www.mujprofirest.cz/help/pokladna/instalace#zmena)). Nejjistější je nastavit pokladně v routeru **pevnou (rezervovanou) IP adresu**. Zvládne to ten, kdo vám síť spravuje.

## Jak poznáte, že všechno běží

- **Na hlavní pokladně** – V **Správce** je pod přepínačem *Aktivovat lokální API* adresa pokladny se zatržítkem, *Počet připojení* a *Připojená zařízení*: u každého zkrácené ID a [verze aplikace](https://www.mujprofirest.cz/help/administrace/zarizeni#sprava).
- **Na telefonu číšníka** – V **Nastavení → Stav zařízení** svítí zeleně *Připojeno ke kase* a *Připojeno k wifi*. Tlačítko **Otestovat spojení** prověří síť i pokladnu krok za krokem.

  ![Část obrazovky Správce na hlavní pokladně: zapnutý přepínač Aktivovat lokální API, adresa kasy, počet připojení a jedno připojené zařízení s verzí aplikace](https://www.mujprofirest.cz/help/assets/images/api_20261007_183735_a18895.png)

*Správce na hlavní pokladně: server běží a jeden telefon je připojený.*

   ![Horní část obrazovky Stav zařízení na telefonu: Připojeno ke kase, Připojeno k wifi, adresa kasy a poslední komunikace](https://www.mujprofirest.cz/help/assets/images/api_20261008_184028_645f66.png)

*Stav zařízení na telefonu: spojení s pokladnou je v pořádku.*

Tlačítkem **Vyzvat zařízení k aktualizaci** v **Správce** pošle hlavní pokladna připojeným telefonům výzvu, aby se aktualizovaly na její verzi. Na obou zařízeních je ve **Správce** i oddíl *Systémové informace*; řádek *Režim* tam ukazuje třeba *Globální (hlavní kasa)* nebo *Lokální (mobilní číšník)*.

## Když se nedaří

Nejčastější potíž je telefon, který se nepřipojí k hlavní pokladně. Projděte otázky shora dolů:

*Obrázek: Postup, když se telefon nepřipojí k hlavní pokladně: zkontrolovat stejnou wifi, běžící server pro číšníky, správnou adresu a nezaškrtnuté připojení na Windows, potom Otestovat spojení*

*Telefon se nepřipojí k hlavní pokladně: čtyři kontroly, které vyřeší většinu případů.*

| Hláška v aplikaci | Co dělat |
| --- | --- |
| „Špatný formát uživatelského jména“ | Jméno musí mít 5 až 32 znaků a obsahovat jen písmena bez diakritiky a číslice. E-mail ani mezery aplikace nepřijme. |
| „Neplatné přihlášení“ | Server uživatelské jméno nepřijal. Zkontrolujte jméno, pod kterým se [přihlašujete do administrace](https://www.mujprofirest.cz/help/administrace/zamestnanci#prihlaseni). |
| „Chyba sítě“ | Zařízení není připojené k internetu. Zadání jména a ověření kódu internet potřebuje na každém zařízení, tedy i na telefonu číšníka. |
| „Chyba API“ | Server odpověděl chybou. Zkuste to za chvíli znovu, a když chyba trvá, kontaktujte podporu. |
| „Zařízení nebylo přidáno v administraci“ | V administraci jste [zařízení ještě nepřidali](https://www.mujprofirest.cz/help/administrace/zarizeni#cisnik), nebo jste opsali jiný kód. Když kód mezitím vypršel (platí 20 minut), vraťte se v aplikaci zpět a zadejte uživatelské jméno znovu. Dostanete nový kód. |
| „Špatný formát IP adresy“ / „Špatný formát IP portu“ | Adresu pište jako čtyři čísla oddělená tečkami (např. 192.168.1.20), bez *:3331* na konci. Port je 3331. |
| „Všechny pokusy (3) o připojení selhaly“ | Telefon pokladnu nezastihl. Projděte [čtyři kontroly výše](https://www.mujprofirest.cz/help/pokladna/instalace#problemy). |

Další potíže v provozu (tisk, platby, přihlášení) řeší [Když něco nefunguje](https://www.mujprofirest.cz/help/pokladna/kdyz_nefunguje).

## Přibyli číšníci k samostatné pokladně

> **Ze samostatné pokladny uděláte hlavní bez ztráty dat**
>
> Neměňte režim přes *Nastavení API* – to by pokladnu vymazalo. Stačí v **Správce** (boční menu, vidí ho jen [správce](https://www.mujprofirest.cz/help/pokladna/prihlaseni#opravneni)) zapnout přepínač **Aktivovat lokální API**. Pokladna spustí server pro číšníky, ukáže pod přepínačem svou adresu a všechna data jí zůstanou. Vypnutím přepínače se server zase zastaví.

## Změna režimu a reset

Režim jde změnit dvěma cestami:

- **Boční menu → Správce → Nastavení API.** Položku *Správce* vidí jen zaměstnanec s oprávněním [*Bar - správce*](https://www.mujprofirest.cz/help/pokladna/prihlaseni#opravneni). Když to provozovna vyžaduje, aplikace se před otevřením zeptá na jeho [PIN](https://www.mujprofirest.cz/help/pokladna/prihlaseni#android).
- **Přihlašovací obrazovka → ⋮ → Nastavit API.** Chce PIN zaměstnance s oprávněním *Bar - správce* (když v zařízení žádný správce není, PIN nechce). Při jiném PINu napíše *„Špatný PIN — přístup má jen správce“*. Tahle cesta se hodí, když se telefon nepřipojí k pokladně, a proto se ani nedostanete dál než na přihlášení.

> **Změna režimu vymaže data v zařízení**
>
> Po potvrzení **Dokončit nastavení API** se aplikace zeptá *„Změna nastavení API“* a varuje, že přijdete o data. Zařízení pak smaže účty, zaplacené objednávky i stažený sortiment a stáhne si je znovu. Nastavení tiskáren zůstane. U samostatné pokladny jde potvrzovací tlačítko stisknout až po odpočtu. Na hlavní pokladně proto režim měňte jen **po [uzávěrce](https://www.mujprofirest.cz/help/pokladna/uzaverka#android), se [zavřenými účty](https://www.mujprofirest.cz/help/pokladna/stoly#android) a se zapnutým internetem**, aby žádná zaplacená objednávka nezůstala [neodeslaná](https://www.mujprofirest.cz/help/pokladna/prihlaseni#offline). Pro přidání číšníků použijte raději [přepínač Aktivovat lokální API](https://www.mujprofirest.cz/help/pokladna/instalace#prepnuti).

| Akce | Co udělá |
| --- | --- |
| Reset | Zařízení smaže data provozovny a vrátí se na začátek instalace, tedy na zadání uživatelského jména a kódu. Nastavené tiskárny zůstanou. Vrátí se ale část přepínačů tisku (třeba vypnutý tisk účtenek nebo tisk jen na hlavní tiskárnu) a platební terminál: Teyu je potřeba znovu zapnout a spárovat. |
| Kompletní reset | Totéž, ale smaže úplně všechno, včetně tiskáren. Zařízení je jako po nové instalaci. |

Obě akce najdete v **Správce** i v menu ⋮ na přihlašovací obrazovce. Z přihlašovací obrazovky chtějí PIN správce. Po resetu je potřeba zařízení [znovu přidat v administraci](https://www.mujprofirest.cz/help/administrace/zarizeni#cisnik).

## Kam dál

- [První spuštění a PINy](https://www.mujprofirest.cz/help/pokladna/prihlaseni) – Kdo se na pokladně přihlásí, co odemyká správce a jak pokladna posílá data na server.
- [Mobilní číšník a hlavní pokladna](https://www.mujprofirest.cz/help/pokladna/cisnik_a_kasa) – Co se mezi nimi sdílí, co dělat při výpadku spojení a jak se telefony aktualizují.
- [Správa PC, tabletů a KDS](https://www.mujprofirest.cz/help/administrace/zarizeni#cisnik) – Přidání zařízení v administraci, licence a mazání starých zařízení.
- [EET 2.0 – evidence tržeb](https://www.mujprofirest.cz/help/administrace/eet2) – Certifikát do pokladny nepatří – tržby eviduje server.


## Pro vývojáře: totéž v API v2

- [Párování zařízení](https://api.mujprofirest.cz/v2/docs#tag/OAuth/operation/oauthDeviceAuthorization)
- [Verze aplikací](https://api.mujprofirest.cz/v2/docs#tag/API/operation/listAppVersions)
- [Celá dokumentace Profirest API v2](https://api.mujprofirest.cz/v2/docs), přehled pro jazykové modely: https://api.mujprofirest.cz/llms.txt