# Profirest API v2

> Veřejné REST API restauračního systému Profirest. Profirest API v2 propojuje e-shopy, zařízení a partnerské systémy s restauracemi, které používají Profirest.

- Smlouva (verze API) 26.11.28 z 13. 11. 2026: Změna platby účtenky bez storna
- 217 operací v 25 oblastech, adresa API https://api.mujprofirest.cz/v2, JSON, texty česky i anglicky (Accept-Language)
- Oficiální knihovny: JavaScript, PHP, Java / Kotlin, C# / .NET, Python, TypeScript, Swift, Dart / Flutter, Go; ukázky v curl u každé operace
- Celá reference v Markdownu (všechny operace, parametry, pole, oprávnění): https://api.mujprofirest.cz/llms-full.txt
- Strojově čitelná specifikace OpenAPI: https://api.mujprofirest.cz/v2/openapi.json
- MCP server: https://api.mujprofirest.cz/mcp (dokumentace pro AI asistenty a vývojářské nástroje, jen čtení, bez přihlášení)
- **EET 2.0 eviduje Profirest – vaše aplikace tržby neeviduje.** Každou tržbu, která jde přes Profirest (objednávku vaší aplikace, účtenku pokladny), zaeviduje do EET 2.0 (elektronická evidence tržeb od 1. 1. 2027) server Profirestu: podepíše ji certifikátem provozovny a odešle, když zákazník zaplatí na místě – hotově nebo kartou kurýrovi či při odběru, v okamžiku předání. Platby přes internet (`online`) se…

## Co API umí – přehled

Celá stránka: https://api.mujprofirest.cz/v2/docs/capabilities (česky i anglicky, odkazy na referenci). Vygenerováno ze smlouvy 26.11.28.

| Funkce | Profirest API v2 | Co přesně |
|---|---|---|
| REST API | Ano – REST + JSON | REST nad HTTPS s JSON na `https://api.mujprofirest.cz/v2`, smlouva OpenAPI 3.1.0 ([openapi.json](https://api.mujprofirest.cz/v2/openapi.json)), 217 operací v 25 oblastech. Chyby jako `application/problem+json` (RFC 9457) se 118 stálými kódy. |
| OAuth / tokeny | Ano – OAuth 2.0 | OAuth 2.0 authorization code s PKCE (S256): majitel restaurace aplikaci připojí, vybere provozovny a potvrdí oprávnění. Access token platí 30 minut, refresh token 90 dní od posledního použití. Granty `POST /oauth/token`: `authorization_code` (authorization code s PKCE, e-shopy a partnerské aplikace), `refresh_token` (obnova tokenů), `urn:ietf:params:oauth:grant-type:device_code` (device authorization grant, RFC 8628, jen párování vlastních zařízení Profirestu), `urn:profirest:params:oauth:grant-type:v1-device` (výměna identity API v1, jen vlastní zařízení Profirestu při přechodu z API v1). Grant client credentials ani API klíče API nemá. 41 oprávnění (scopes), z toho 19 pro partnerské aplikace – [seznam](https://api.mujprofirest.cz/v2/docs/capabilities#opravneni). |
| Produkty – zápis | Ne – jen dostupnost | Produkty, kategorie a ceny se přes API nezakládají ani nemění – sortiment API jen čte ([`getCatalog`](https://api.mujprofirest.cz/v2/docs#tag/Catalog/operation/getCatalog), změnu hlásí událost `catalog.changed`). Zapisovat jde jen dostupnost: zbývající porce a vyprodáno ([`setProductAvailability`](https://api.mujprofirest.cz/v2/docs#tag/Catalog/operation/setProductAvailability), oprávnění `availability:write`). K produktům si navíc můžete uložit vlastní ID a metadata ([`putExternalRef`](https://api.mujprofirest.cz/v2/docs#tag/External-references/operation/putExternalRef)); otevírací dobu mění [`setOpeningHours`](https://api.mujprofirest.cz/v2/docs#tag/Restaurants/operation/setOpeningHours). |
| Objednávky – zápis | Ano | Kalkulace košíku ([`createQuote`](https://api.mujprofirest.cz/v2/docs#tag/Orders/operation/createQuote) – ceny, dopravu i DPH spočítá server), vytvoření objednávky rovnou do kuchyně ([`createOrder`](https://api.mujprofirest.cz/v2/docs#tag/Orders/operation/createOrder)), potvrzení online platby ([`confirmOrderPayment`](https://api.mujprofirest.cz/v2/docs#tag/Orders/operation/confirmOrderPayment)) a zrušení ([`cancelOrder`](https://api.mujprofirest.cz/v2/docs#tag/Orders/operation/cancelOrder), dokud ji kuchyně nezačala připravovat). Stav hlásí webhooky a proud změn. Aplikace vidí objednávky, které sama vytvořila; změnu položek už vytvořené objednávky API nenabízí. |
| Sklad – zápis | Jen inventura, jen vlastní zařízení | Jediný zápis do skladu je inventura ([`createStockTaking`](https://api.mujprofirest.cz/v2/docs#tag/Stock/operation/createStockTaking)), která nastaví stav skladu; položky k přepočítání čte [`listStockTakingItems`](https://api.mujprofirest.cz/v2/docs#tag/Stock/operation/listStockTakingItems). Oprávnění `stock:read` a `stock:write` jsou jen pro vlastní aplikace Profirestu – partnerská aplikace sklad nečte ani nezapisuje. Příjemky, výdejky ani jiné skladové pohyby API nemá; ze skladu odepisuje sama účtenka pokladny. |
| Webhooky | Ano + SSE | Na HTTPS adresu registrovanou u klienta, podpis podle Standard Webhooks (HMAC-SHA256; hlavičky `webhook-id`, `webhook-timestamp`, `webhook-signature`), opakování po 1 min, 5 min, 30 min, 2 h a 12 h. Tytéž události jsou v proudu změn s kurzorem ([`listEvents`](https://api.mujprofirest.cz/v2/docs#tag/Events/operation/listEvents)) a živě přes Server-Sent Events ([`streamEvents`](https://api.mujprofirest.cz/v2/docs#tag/Events/operation/streamEvents)). 29 typů událostí, každé připojení dostane ty, které dovolují jeho oprávnění. |
| Sandbox | Ne samostatný – testovací přístup ano | Samostatné pískoviště není: API běží jen na `https://api.mujprofirest.cz` nad skutečnými daty. Zkouší se **testovacím přístupem** ([/zadost/test](https://api.mujprofirest.cz/zadost/test) – `client_id` a tajemství hned po potvrzení e-mailu, jen k veřejnému ukázkovému účtu `profirestdemo`; SMS ani e-maily se neposílají, do EET 2.0 nic nejde, webhooky chodí jako obvykle a data se každou noc obnoví), na **testovacích provozovnách** (`Restaurant.is_test`, Profirest je přidá k vašemu připojení) a v **[playgroundu](https://api.mujprofirest.cz/v2/docs/playground)** nad příklady ze smlouvy bez přístupu. |
| Veřejná dokumentace | Ano | Zdarma a bez přihlášení, česky i anglicky: [reference](https://api.mujprofirest.cz/v2/docs) s ukázkami v curl a v 10 jazycích u každé operace, [návody](https://api.mujprofirest.cz/v2/docs/guides), [katalog chyb](https://api.mujprofirest.cz/v2/docs/errors), [changelog](https://api.mujprofirest.cz/v2/docs/changelog), [playground](https://api.mujprofirest.cz/v2/docs/playground), OpenAPI 3.1.0 ([openapi.json](https://api.mujprofirest.cz/v2/openapi.json)) a pro jazykové modely [llms.txt](https://api.mujprofirest.cz/llms.txt) a [llms-full.txt](https://api.mujprofirest.cz/llms-full.txt). |

Co API nemá:

- Zakládání a změny produktů, kategorií a cen – jen dostupnost (porce, vyprodáno).
- Zakládání, úpravy a mazání zaměstnanců – jen jejich seznam, přihlášení PINem a změna vlastního PINu, a to pro vlastní aplikace Profirestu.
- Skladové pohyby (příjemky, výdejky, převody) – jen inventura, a to jen pro vlastní aplikace Profirestu.
- Změna položek objednávky po jejím vytvoření – jen zrušení, dokud ji kuchyně nezačala připravovat.
- Grant client credentials a API klíče – partnerská aplikace se přihlašuje vždy přes OAuth 2.0 se souhlasem majitele restaurace, vlastní zařízení Profirestu párováním, které potvrdí vedoucí.
- Registrace webhooku přes API – adresu registruje Profirest u klienta (v žádosti o přístup).
- Samostatné pískoviště – testuje se testovacím přístupem k ukázkovému účtu, na testovacích provozovnách a v playgroundu.

## Dokumentace

- [Co API umí](https://api.mujprofirest.cz/v2/docs/capabilities): přehled schopností – co API umí a co ne, s odkazy do reference
- [Reference](https://api.mujprofirest.cz/v2/docs): všechny operace s příklady požadavků a odpovědí
- [Celá reference jako Markdown](https://api.mujprofirest.cz/llms-full.txt): stejný obsah pro jazykové modely
- [Návody](https://api.mujprofirest.cz/v2/docs/guides): celé scénáře napojení krok za krokem
- [Playground](https://api.mujprofirest.cz/v2/docs/playground): vyzkoušení operací v prohlížeči nad příklady nebo naostro
- [Katalog chyb](https://api.mujprofirest.cz/v2/docs/errors): všechny kódy chyb s vysvětlením
- [Changelog](https://api.mujprofirest.cz/v2/docs/changelog): co přinesla která verze, porovnání dvou verzí
- [OpenAPI](https://api.mujprofirest.cz/v2/openapi.json): specifikace (anglicky, české texty v x-description-cs)

## MCP server

MCP server: https://api.mujprofirest.cz/mcp – dokumentace API pro AI asistenty a vývojářské nástroje (Model Context Protocol, Streamable HTTP, jen čtení, bez přihlášení). Nástroje search_api, get_operation, get_schema, list_areas, get_capabilities, get_error, get_section; parametr lang=cs|en. Jak ho připojit:

- Claude: v Settings → Connectors → Add custom connector vložte adresu; v Claude Code `claude mcp add --transport http profirest-api https://api.mujprofirest.cz/mcp`
- ChatGPT: v nastavení Apps & Connectors zapněte režim vývojáře (Developer mode) a vytvořte konektor s touto adresou, bez ověření
- Cursor: do `.cursor/mcp.json` server `"profirest-api": {"url": "https://api.mujprofirest.cz/mcp"}`
- VS Code s Copilotem: do `.vscode/mcp.json` server `"profirest-api": {"type": "http", "url": "https://api.mujprofirest.cz/mcp"}`

## Oblasti API

- [API](https://api.mujprofirest.cz/v2/docs#tag/API): Kořen API a aktuální připojení. (4 operace: GET /, GET /app-versions, GET /connection, POST /devices/current/legacy-identity)
- [OAuth](https://api.mujprofirest.cz/v2/docs#tag/OAuth): Připojení klienta k účtu („Připojit přes Profirest“). (5 operací: GET /oauth/authorize, POST /oauth/device_authorization, POST /oauth/token, POST /oauth/revoke, GET /.well-known/oauth-authorization-server)
- [Restaurants](https://api.mujprofirest.cz/v2/docs#tag/Restaurants): Provozovny připojení, jejich otevírací doba, příjem objednávek, rozvozové zóny a časy, na které lze objednat. Otevírací doba říká, kdy má provozovna otevřeno (ukazujte ji hostům); příjem objednávek, kdy se přijímají objednávky aplikací `web` (e-shopů) – rozvoz i osobní odběr. Výchozí je obojí… (18 operací: GET /restaurants, GET /restaurants/{restaurant_id}, GET /restaurants/{restaurant_id}/opening-hours, PUT /restaurants/{restaurant_id}/opening-hours, GET /restaurants/{restaurant_id}/order-hours, GET /restaurants/{restaurant_id}/delivery-zones, …)
- [Catalog](https://api.mujprofirest.cz/v2/docs#tag/Catalog): Kategorie, produkty, ceny a dostupnost jedné provozovny. (5 operací: GET /restaurants/{restaurant_id}/catalog, GET /restaurants/{restaurant_id}/availability, PUT /restaurants/{restaurant_id}/availability/{product_id}, GET /restaurants/{restaurant_id}/promotions, GET /restaurants/{restaurant_id}/daily-menu)
- [Orders](https://api.mujprofirest.cz/v2/docs#tag/Orders): Kalkulace a objednávky, které jdou do kuchyňského displeje. (7 operací: POST /restaurants/{restaurant_id}/quotes, GET /restaurants/{restaurant_id}/quotes/{quote_id}, GET /restaurants/{restaurant_id}/orders, POST /restaurants/{restaurant_id}/orders, GET /restaurants/{restaurant_id}/orders/{order_id}, POST /restaurants/{restaurant_id}/orders/{order_id}/confirm-payment, …)
- [Customers](https://api.mujprofirest.cz/v2/docs#tag/Customers): Propojení vašich zákazníků s databází klientů účtu a věrnostní body. (8 operací: GET /customers, POST /customers, GET /customers/{customer_id}, PATCH /customers/{customer_id}, DELETE /customers/{customer_id}, POST /customers/{customer_id}/phone-verification, …)
- [Vouchers](https://api.mujprofirest.cz/v2/docs#tag/Vouchers): Dárkové vouchery vydané účtem. (1 operace: POST /restaurants/{restaurant_id}/vouchers/check)
- [Reservations](https://api.mujprofirest.cz/v2/docs#tag/Reservations): Rezervace stolů a služeb u pracovníků – volné časy, rezervace, změny, usazení a stav stolů v tuto chvíli. (23 operací: GET /restaurants/{restaurant_id}/reservation-settings, GET /restaurants/{restaurant_id}/reservation-services, GET /restaurants/{restaurant_id}/reservation-availability, GET /restaurants/{restaurant_id}/reservations, POST /restaurants/{restaurant_id}/reservations, GET /restaurants/{restaurant_id}/reservations/{reservation_id}, …)
- [Lodging](https://api.mujprofirest.cz/v2/docs#tag/Lodging): Ubytování – kdo je právě ubytovaný a účet jeho pokoje, aby pokladna mohla útratu zapsat na pokoj. (7 operací: GET /restaurants/{restaurant_id}/lodging/in-house, GET /restaurants/{restaurant_id}/lodging/stays/{stay_id}/folio, POST /restaurants/{restaurant_id}/lodging/stays/{stay_id}/charges, GET /restaurants/{restaurant_id}/lodging/packages, GET /restaurants/{restaurant_id}/lodging/stats, GET /restaurants/{restaurant_id}/lodging/reviews, …)
- [Reception](https://api.mujprofirest.cz/v2/docs#tag/Reception): Recepce hotelu – jen vlastní aplikace Profirestu (`lodging_desk:*`, na zařízení přihlášený zaměstnanec s rolí `reception`): pokoje, plán obsazenosti, pobyty s hosty a jejich doklady. (27 operací: GET /restaurants/{restaurant_id}/lodging/rooms, GET /restaurants/{restaurant_id}/lodging/availability, GET /restaurants/{restaurant_id}/lodging/registration-lists, GET /restaurants/{restaurant_id}/lodging/stays, POST /restaurants/{restaurant_id}/lodging/stays, GET /restaurants/{restaurant_id}/lodging/stays/{stay_id}, …)
- [Housekeeping](https://api.mujprofirest.cz/v2/docs#tag/Housekeeping): Úklid pokojů a jejich závady – úkoly dne po pokojích, odškrtávání a hlášení závad. Bez údajů hostů. S `Profirest-Staff-Token` se zaměstnanec zapíše jako ten, kdo úkol udělal nebo závadu nahlásil. Vlastní aplikace Profirestu pro pokojské a recepci ho posílat musí, se zaměstnancem s rolí… (6 operací: GET /restaurants/{restaurant_id}/housekeeping, POST /restaurants/{restaurant_id}/housekeeping/rooms/{room_id}/done, POST /restaurants/{restaurant_id}/housekeeping/rooms/{room_id}/undo, GET /restaurants/{restaurant_id}/room-issues, POST /restaurants/{restaurant_id}/room-issues, POST /restaurants/{restaurant_id}/room-issues/{issue_id}/fix)
- [Guest passes](https://api.mujprofirest.cz/v2/docs#tag/Guest-passes): QR kód ubytovaného hosta – čtečka u wellness, snídaní nebo parkoviště ověří, co host smí. (2 operace: POST /restaurants/{restaurant_id}/guest-passes/check, POST /restaurants/{restaurant_id}/guest-passes/checks/{check_id}/undo)
- [External references](https://api.mujprofirest.cz/v2/docs#tag/External-references): Vaše vlastní ID a metadata u provozoven, kategorií, produktů, objednávek a zákazníků. (4 operace: GET /external-refs/{object_type}, GET /external-refs/{object_type}/{object_id}, PUT /external-refs/{object_type}/{object_id}, DELETE /external-refs/{object_type}/{object_id})
- [Events](https://api.mujprofirest.cz/v2/docs#tag/Events): Proud změn s kurzorem – po stránkách nebo živě přes Server-Sent Events. Webhooky doručují stejné události. (2 operace: GET /events, GET /events/stream)
- [Staff](https://api.mujprofirest.cz/v2/docs#tag/Staff): Zaměstnanci na vlastních zařízeních Profirestu – kdo v provozovně pracuje a přihlášení PINem nebo čipem. (4 operace: GET /restaurants/{restaurant_id}/staff, POST /restaurants/{restaurant_id}/staff-sessions, DELETE /restaurants/{restaurant_id}/staff-sessions/current, POST /restaurants/{restaurant_id}/staff-sessions/current/pin)
- [Attendance](https://api.mujprofirest.cz/v2/docs#tag/Attendance): Příchody, odchody a přestávky z docházkových terminálů Profirestu a to, co tam vidí přihlášený zaměstnanec: své naplánované směny a své žádosti o volno. Jen u provozovny, jejíž licence zahrnuje modul Docházka, stejně jako docházka v administraci; jinak `403 module_not_licensed`. (8 operací: GET /restaurants/{restaurant_id}/attendance/terminal, GET /restaurants/{restaurant_id}/attendance/presence, POST /restaurants/{restaurant_id}/attendance/punches, POST /restaurants/{restaurant_id}/attendance/punches/batch, GET /restaurants/{restaurant_id}/attendance/my-schedule, GET /restaurants/{restaurant_id}/attendance/absence-requests, …)
- [Kitchen](https://api.mujprofirest.cz/v2/docs#tag/Kitchen): Kuchyňský displej – objednávky ze všech zdrojů (pokladna, e-shop, rozvozové platformy, aplikace). (20 operací: GET /restaurants/{restaurant_id}/kitchen/tickets, POST /restaurants/{restaurant_id}/kitchen/tickets, GET /restaurants/{restaurant_id}/kitchen/queue, GET /restaurants/{restaurant_id}/kitchen/stations/{station_id}/tickets, PUT /restaurants/{restaurant_id}/kitchen/stations/{station_id}/tickets/{ticket_id}/working, DELETE /restaurants/{restaurant_id}/kitchen/stations/{station_id}/tickets/{ticket_id}/working, …)
- [Deliveries](https://api.mujprofirest.cz/v2/docs#tag/Deliveries): Kurýři na směně, rozvozové trasy plánované v kuchyni, označení doručených objednávek a živá poloha a jízda kurýrů. (13 operací: GET /restaurants/{restaurant_id}/couriers, PUT /restaurants/{restaurant_id}/couriers/{employee_id}/shift, DELETE /restaurants/{restaurant_id}/couriers/{employee_id}/shift, GET /restaurants/{restaurant_id}/delivery-routes, POST /restaurants/{restaurant_id}/delivery-routes, GET /restaurants/{restaurant_id}/delivery-routes/{route_id}, …)
- [Receipts](https://api.mujprofirest.cz/v2/docs#tag/Receipts): Pokladna a mobilní číšník: účtenky spočítané serverem, storno vedoucím, směna zařízení a EET 2.0, které odesílá server. Jen pro vlastní zařízení Profirestu. (17 operací: POST /restaurants/{restaurant_id}/receipts/preview, GET /restaurants/{restaurant_id}/receipts, POST /restaurants/{restaurant_id}/receipts, GET /restaurants/{restaurant_id}/receipts/{receipt_id}, POST /restaurants/{restaurant_id}/receipts/{receipt_id}/storno, POST /restaurants/{restaurant_id}/receipts/{receipt_id}/payment-change, …)
- [Stock](https://api.mujprofirest.cz/v2/docs#tag/Stock): Inventura na vlastních zařízeních Profirestu – položky k přepočítání a výsledek, který nastaví stav skladu, jako v administraci (Sklad → Inventury). Jen pro vlastní zařízení Profirestu. (3 operace: GET /restaurants/{restaurant_id}/stock-taking/items, POST /restaurants/{restaurant_id}/stock-takings, GET /restaurants/{restaurant_id}/stock-takings/{stock_taking_id})
- [Backups](https://api.mujprofirest.cz/v2/docs#tag/Backups): Zálohy místní databáze pokladny – ZIP, který pokladna nahrává (pravidelně, na požádání, po uzávěrce) a stáhne při obnově, třeba na novém zařízení. Společné s pokladnami na API v1. Jen pro vlastní zařízení Profirestu. (4 operace: GET /restaurants/{restaurant_id}/backups, POST /restaurants/{restaurant_id}/backups, GET /restaurants/{restaurant_id}/backups/{backup_id}, GET /restaurants/{restaurant_id}/backups/{backup_id}/content)
- [Diagnostics](https://api.mujprofirest.cz/v2/docs#tag/Diagnostics): Stav, chyby a logy vlastních zařízení Profirestu pro provozovnu a podporu Profirestu. Zařízení každou minutu přihlásí stav (`checkInDevice`), chyby hlásí hned (`reportDeviceError`) a log si drží u sebe; celý log nahraje jen na vyžádání (příkaz `upload_logs`, `putLogUploadPart`). Hlášení chyb od… (8 operací: POST /restaurants/{restaurant_id}/device-logs, POST /restaurants/{restaurant_id}/bug-reports, POST /restaurants/{restaurant_id}/device-checkin, POST /restaurants/{restaurant_id}/device-errors, GET /log-uploads/{upload_id}, PUT /log-uploads/{upload_id}/parts/{part}, …)
- [Device settings](https://api.mujprofirest.cz/v2/docs#tag/Device-settings): Co vlastní zařízení Profirestu potřebují k práci – údaje firmy, tiskové šablony, tiskárny, stoly, licence. (1 operace: GET /restaurants/{restaurant_id}/device-settings)
- [Customer directory](https://api.mujprofirest.cz/v2/docs#tag/Customer-directory): Zákazníci celého účtu pro objednávky, které personál bere po telefonu – hledání podle telefonu nebo jména s jejich adresami a příchozí hovory. Jen pro vlastní zařízení Profirestu. (3 operace: GET /restaurants/{restaurant_id}/customer-directory, POST /restaurants/{restaurant_id}/calls, GET /restaurants/{restaurant_id}/calls/latest)
- [Table ordering](https://api.mujprofirest.cz/v2/docs#tag/Table-ordering): Hosté objednávají od stolu a volají obsluhu ze svého telefonu. O všem rozhoduje hlavní kasa podniku a hosty na Wi-Fi podniku obsluhuje sama (její místní API); tyto operace jsou záložní cesta přes internet pro telefony, které se k ní nedostanou (`/table/…`, s tokenem telefonu u stolu), a spojení… (17 operací: POST /table/sessions, GET /table/session, POST /table/session/join, GET /table/requests/{request_id}, GET /table/menu, GET /table/orders, …)

## Návody

- [Nastavení a chyby](https://api.mujprofirest.cz/v2/docs/guides#nastaveni): Kroky scénářů níže volají oficiální knihovnu vybraného jazyka (curl ukazuje čisté HTTP). Knihovna přidá token a obnoví ho, pošle a přečte JSON a chybu promění ve výjimku s code z katalogu chyb. Rozhodujte se podle code, ne podle HTTP stavu. Instalace a celá…
- [Opakování se stejným klíčem](https://api.mujprofirest.cz/v2/docs/guides#opakovani): Každý POST nese Idempotency-Key; při opakování stejného požadavku jde stejný klíč a server druhý záznam nezaloží. Knihovny to dělají samy: opakují výpadek sítě, 429, 409 idempotency_in_progress a stavy 500–504 a čekají podle Retry-After. Když požadavek…
- [Stránkování](https://api.mujprofirest.cz/v2/docs/guides#strankovani): Seznamy vrací {"data": [...], "next_cursor": "..."}. Knihovny projdou stránky samy – všechny položky najednou, nebo stránku po stránce; konec je stránka bez next_cursor nebo prázdná stránka. Kurzor nikdy neskládejte sami.
- [Proud událostí](https://api.mujprofirest.cz/v2/docs/guides#udalosti): GET /events vrací změny v pořadí, v jakém nastaly; next_cursor tu nikdy není null. Tytéž události posílá živě GET /events/stream (Server-Sent Events) – bez dotazování, se stejným kurzorem v id každé zprávy; když proud neběží (503, stream_url je null), čte se…
- [Objednávka z e-shopu](https://api.mujprofirest.cz/v2/docs/guides#eshop): Aplikace partnera připojí restauraci, ukáže sortiment, spočítá košík a založí objednávku zaplacenou online. Ceny, dopravu i DPH počítá vždy server – aplikace je jen ukazuje. Tržbu do EET 2.0 eviduje Profirest sám (online platba se neeviduje, hotovost a karta…
- [Pokladna](https://api.mujprofirest.cz/v2/docs/guides#pokladna): Pokladna se spáruje kódem, přihlásí obsluhu PINem, drží účty stolů, vystavuje účtenky a na konci dne uzavře směnu. Účtenky počítá i eviduje v EET 2.0 server – zařízení nepotřebuje certifikát.
- [Kuchyňský displej](https://api.mujprofirest.cz/v2/docs/guides#kuchyn): Displej ukazuje bony ze všech zdrojů – pokladna, e-shop, rozvozové platformy – a hlásí, co je hotové. Výroba se dá rozdělit na stanoviště (gril, pizza) a výdej.
- [Docházkový terminál](https://api.mujprofirest.cz/v2/docs/guides#dochazka): Terminál u vchodu: zaměstnanec se prokáže PINem nebo čipem a píchne příchod, přestávku nebo odchod. Bez sítě si záznamy podrží a pošle je dávkou.
- [Rozvoz](https://api.mujprofirest.cz/v2/docs/guides#rozvoz): Kurýr začne směnu, dispečink mu sestaví trasu z hotových objednávek a kurýr hlásí doručení.
- [Stav, chyby a logy zařízení](https://api.mujprofirest.cz/v2/docs/guides#logy): Zařízení si log drží u sebe (černá skříňka, 14 dní). Serveru každou minutu přihlásí stav, chyby pošle hned, a celý log nahraje jen na vyžádání – podpora nebo provozovna o něj požádá v administraci a soubory dorazí do pár minut.
- [Zákazníci, body a vouchery](https://api.mujprofirest.cz/v2/docs/guides#zakaznici): Zákazník se pozná podle ověřeného telefonu – bez hesel. Body a vouchery pak platí v e-shopu i na pokladně.
- [Rezervace stolů a služeb](https://api.mujprofirest.cz/v2/docs/guides#rezervace): Host si vybere den, počet osob nebo službu a volný čas, vy rezervaci založíte a server ohlídá kapacitu – stůl, pracovník ani místnost nejsou nikdy rezervované dvakrát. Změny z administrace a pokladen vám chodí jako události.
- [Útrata na pokoj (hotelová restaurace a bar)](https://api.mujprofirest.cz/v2/docs/guides#na-pokoj): Ubytovaný host si dá večeři nebo drink a neplatí hned – obsluha útratu zapíše na jeho pokoj a host ji zaplatí při odjezdu na recepci. Útrata se objeví v účtu pokoje na plachtě i na vyúčtování.
- [Turniket wellness a čtečka na snídani](https://api.mujprofirest.cz/v2/docs/guides#qr-host): Host má QR kód na stránce pobytu a na kartě hosta. Čtečka ho pošle serveru, ten podle účtu pokoje řekne, jestli host smí dovnitř (neomezeně, tolik osob denně, tolikrát za pobyt), a vstup zapíše.
- [Aplikace pro pokojské a údržbu](https://api.mujprofirest.cz/v2/docs/guides#uklid): Pokojská má v telefonu pokoje, které dnes uklízí, odškrtává hotové a hlásí závady. Recepce na plachtě hned vidí, který pokoj je uklizený, a pokoj se závadou se sám vyřadí z prodeje.
- [Účetnictví a přehledy](https://api.mujprofirest.cz/v2/docs/guides#ucetnictvi): Účetní nebo BI systém stahuje uzávěrky a doklady ze všech pokladen, webu i kuchyně, bere si přehledy jako Statistiky administrace a nové doklady mu chodí jako události. Částky a DPH sedí s kopií účtenky.

## Knihovny

- [JavaScript](https://api.mujprofirest.cz/v2/docs/js): balíček profirest-api.js
- [PHP](https://api.mujprofirest.cz/v2/docs/php): balíček profirest/api-client
- [Java / Kotlin](https://api.mujprofirest.cz/v2/docs/java): balíček cz.mujprofirest:profirest-api
- [C# / .NET](https://api.mujprofirest.cz/v2/docs/csharp): balíček Profirest.Api
- [Python](https://api.mujprofirest.cz/v2/docs/python): balíček profirest-api
- [TypeScript](https://api.mujprofirest.cz/v2/docs/typescript): balíček @profirest/api-types
- [Swift](https://api.mujprofirest.cz/v2/docs/swift): balíček ProfirestAPI (SwiftPM)
- [Dart / Flutter](https://api.mujprofirest.cz/v2/docs/dart): balíček profirest_api
- [Go](https://api.mujprofirest.cz/v2/docs/go): balíček github.com/profirest/profirest-api-go

## Přístup k API

- [Rozcestník pro vývojáře](https://api.mujprofirest.cz/)
- [Žádost o přístup](https://api.mujprofirest.cz/zadost): přístup ke skutečným restauracím, posuzuje se ručně
- [Testovací přístup](https://api.mujprofirest.cz/zadost/test): hned po potvrzení e-mailu, jen k veřejné ukázkové restauraci
- [Podmínky použití API](https://api.mujprofirest.cz/podminky)
- Kontakt: info@profirest.cz

## Profirest

- [Profirest pro jazykové modely](https://www.mujprofirest.cz/llms.txt): co restaurační systém Profirest umí
- [Uživatelská nápověda](https://www.mujprofirest.cz/help/): jak se systém ovládá (rozcestník pro AI: https://www.mujprofirest.cz/help/llms.txt)

## Optional

- [Sitemapa API](https://api.mujprofirest.cz/sitemap.xml)