# Služby, popis všech polí

Každé pole seznamu služeb a detailu služby včetně cenových variant a toho, které pole platí u kterého typu rezervací.

## Kde to je

V panelu otevřete Služby. Seznam je na adrese `/Admin/Procedures`. Novou službu založíte tlačítkem + Přidat službu, existující otevřete v nabídce Detail / Upravit. Detail služby je na adrese `/Admin/Procedures/Detail/{číslo}`.

## K čemu stránka slouží

Služba je to, co si zákazník ve formuláři vybírá: střih, hodina na kurtu, pokoj, vstupenka. U služby nastavujete délku, cenu, zálohu, pauzu mezi zákazníky, kapacitu a viditelnost ve formuláři. Nový účet nemá žádnou službu, první musíte vytvořit.

## Která pole se zobrazují u kterého typu rezervací

Typ rezervací nastavujete v Nastavení, Rezervace (viz [Nastavení rezervací](https://obsadto.cz/napoveda/reference/nastaveni-rezervace.md)).

| Pole | Termín | Časová rezervace | Ubytování |
|---|---|---|---|
| Typ | ne | ne | ano |
| Typ služby | ano | ne | ne |
| Trvání (minuty) a Cena (Kč) | ano (u typu služby Skupinové akce ne) | ne, délka a cena jsou ve variantách | ne |
| Buffer čas (minuty) a Krok slotů (minuty) | ano (u Skupinových akcí ne) | ano | ne |
| Cena za noc (Kč), Check-in čas, Check-out čas, Max. nocí | ne | ne | ano, jen když je typ služby Ubytování |
| Zdrojů z poolu | jen když je nastaven pool | jen když je nastaven pool | jen když je nastaven pool |
| Cenové varianty | ano | ano | ne |
| Ostatní pole | ano | ano | ano |

## Pole

### Typ

- **Co dělá:** Rozlišuje obyčejnou službu a ubytovací objekt.
- **Výchozí hodnota:** Služba.
- **Povolené hodnoty:** Služba, Ubytování.
- **Platí pro:** jen účet s typem rezervací Ubytování. U ostatních typů se pole nezobrazuje a vždy platí Služba.
- **Na co má vliv:** Které další pole se zobrazí. Ubytování ukáže cenu za noc, časy příjezdu a odjezdu a počet nocí, a schová trvání, cenu, buffer a krok.

### Typ služby

- **Co dělá:** Určuje, jestli zákazník rezervuje termín, nebo kupuje vstupenku na akci.
- **Výchozí hodnota:** Rezervace termínu.
- **Povolené hodnoty:** Rezervace termínu, Skupinové akce a vstupenky. Jiná hodnota vrátí chybu „Neplatný typ služby.“
- **Platí pro:** jen Termín. U Časové rezervace a Ubytování se pole nezobrazuje.
- **Na co má vliv:** U Skupinových akcí a vstupenek zákazník ve formuláři uvidí seznam akcí, ne kalendář. Systém přitom nastaví trvání na 60 minut, cenu na prázdnou, buffer na 0, krok na 0 a zapne Použít ve workshopech. Pole trvání, ceny, bufferu a kroku se skryjí.

### Název

- **Co dělá:** Název služby, který vidí zákazník i vy.
- **Výchozí hodnota:** Prázdné, povinné.
- **Povolené hodnoty:** Neprázdný text. Prázdný název vrátí chybu „Název procedury je povinný.“
- **Platí pro:** všechny typy.
- **Na co má vliv:** Formulář, e-maily, kalendář a přehledy.

### Slug (URL identifikátor)

- **Co dělá:** Krátký identifikátor služby pro přímý odkaz. Do vložení na web se zapisuje jako `?procedure=` nebo `data-item`.
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** Malá písmena bez diakritiky, číslice a pomlčky, 3 až 64 znaků. Velká písmena se převedou na malá. V rámci účtu musí být jedinečný, jinak chyba „Slug je již použit jinou procedurou.“
- **Platí pro:** všechny typy. U Ubytování je povinný, u ostatních nepovinný.
- **Na co má vliv:** Jen přímý vstup na konkrétní službu přes odkaz. Na volné termíny nemá vliv. Pozor, dopad: změna slugu zneplatní odkazy `?procedure=` a `data-item` už vložené na webu a v tiskovinách. Po změně je přepište a vyzkoušejte.

### Popis

- **Co dělá:** U služby je to text popisu. U cenové varianty je to krátký název varianty (například „1 hod“).
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** Libovolný text.
- **Platí pro:** všechny typy. Popis služby se ukazuje ve formuláři a v seznamu služeb. Popis varianty se ukazuje zákazníkovi při výběru délky.
- **Na co má vliv:** Pouze zobrazení.

### Trvání (minuty)

- **Co dělá:** Jak dlouho služba trvá. Určuje, kolik času se zákazníkovi v kalendáři blokuje.
- **Výchozí hodnota:** 60 při vytvoření nové služby. V detailu se u služby s trváním 0 nabídne 30.
- **Povolené hodnoty:** 30 až 4320 minut (3 dny). Mimo rozsah chyba „Trvání musí být 30 až 4320 minut.“ Formulář pro novou službu povolí od 5, server ale vyžaduje alespoň 30.
- **Platí pro:** Termín. U Časové rezervace se používá hodnota 60 (nebo dříve uložená) a skutečnou délku určují varianty a nastavení v Nastavení, Rezervace. U Ubytování se trvání spočítá z Max. nocí.
- **Na co má vliv:** Volné termíny, konec rezervace, automatický krok slotů. Služba delší než 1 den (1440 minut) se řídí pravidly vícedenní rezervace (kontrola dnů volna, krok 60 minut).
- **Časté omyly:** Je-li vybraná cenová varianta, počítá se délka varianty, ne trvání služby.

### Cena (Kč)

- **Co dělá:** U služby je to cena v celých korunách. U cenové varianty je to cena této varianty.
- **Výchozí hodnota:** Prázdné, tedy cena dohodou.
- **Povolené hodnoty:** Celé číslo od 0. Záporná hodnota vrátí chybu „Cena nesmí být záporná.“ U varianty prázdné pole znamená 0.
- **Platí pro:** Termín a Časová rezervace (u Časové rezervace jen cena ve variantách). U Ubytování se cena služby neukládá, platí Cena za noc (Kč).
- **Na co má vliv:** Zobrazená cena a částka při platbě celé ceny předem. Cena varianty přebíjí cenu služby.

### Záloha (Kč)

- **Co dělá:** Částka, kterou zákazník při platbě předem zaplatí jako zálohu.
- **Výchozí hodnota:** Prázdné, tedy bez zálohy.
- **Povolené hodnoty:** Celé číslo od 0. Záporná hodnota vrátí chybu.
- **Platí pro:** všechny typy, ale uplatní se jen při nastavené platbě předem v Nastavení, Rezervace a režimu zálohy jiném než Vypnuto.
- **Na co má vliv:** Částka v e-mailu a QR kódu. Komu se záloha vyžaduje, určuje režim v Komu poslat v e-mailu údaje k platbě předem. Je-li zvoleno Celá cena služby, použije se cena místo zálohy.

### Barva v admin panelu

- **Co dělá:** Barva služby v kalendáři a přehledech panelu.
- **Výchozí hodnota:** Nevybráno, platí výchozí barva.
- **Povolené hodnoty:** Jedna z dvanácti barev v paletě.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Jen vzhled panelu, ne formulář zákazníka.

### Buffer čas (minuty)

- **Co dělá:** Pauza po službě, například na úklid nebo přípravu. Zákazník ji nevidí, kalendář ji zablokuje.
- **Výchozí hodnota:** 0.
- **Povolené hodnoty:** Formulář povolí 0 až 120. Server záporné číslo uloží jako 0.
- **Platí pro:** Termín a Časová rezervace. U Ubytování a Skupinových akcí se nastaví na 0.
- **Na co má vliv:** Volné termíny. Další rezervace může začít až po konci služby a bufferu. Buffer musí také vejít do otevírací doby.

### Krok slotů (minuty)

- **Co dělá:** Kolik minut je mezi dvěma nabízenými časy začátku této služby.
- **Výchozí hodnota:** 0, tedy automaticky.
- **Povolené hodnoty:** Celé číslo od 0, formulář povolí 0 až 1440. 0 znamená, že rozhoduje Výchozí krok slotů (minuty), případně automatika podle délek služeb.
- **Platí pro:** Termín a Časová rezervace.
- **Na co má vliv:** Mřížka začátků v kalendáři. Krok služby má přednost před krokem z nastavení.

### Kapacita (souběžné rezervace)

- **Co dělá:** Kolik rezervací téže služby může probíhat ve stejný čas.
- **Výchozí hodnota:** 1.
- **Povolené hodnoty:** Celé číslo od 1, formulář povolí do 999.
- **Platí pro:** Termín a Časová rezervace. Neuplatní se, když rezervace obsluhuje zaměstnanec nebo pracoviště (tam je kapacita 1 na osobu a na pracoviště), nebo když je nastaven pool zdrojů či Max. souběžných rezervací.
- **Na co má vliv:** Volné termíny. Termín se přestane nabízet, až počet překrývajících se rezervací téže služby dosáhne kapacity. Při kapacitě 1 blokuje čas jakákoli překrývající se rezervace poskytovatele, i jiné služby.
- **Časté omyly:** Kapacita říká, kolik rezervací se vejde na jeden čas, ne kolik osob. Počet osob určuje Max. osob na rezervaci.

### Max. osob na rezervaci

- **Co dělá:** Kolik osob smí zákazník uvést v jedné rezervaci.
- **Výchozí hodnota:** 1.
- **Povolené hodnoty:** Celé číslo od 1, formulář povolí do 99.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Ve formuláři se pole „Počet osob“ ukáže jen tehdy, když je hodnota větší než 1 a zároveň je zapnuto Zákazník vybírá počet osob. Počet osob násobí cenu při platbě celé ceny předem.

### Zákazník vybírá počet osob

- **Co dělá:** Zapíná nebo skrývá výběr počtu osob ve formuláři.
- **Výchozí hodnota:** Zapnuto.
- **Povolené hodnoty:** Zapnuto nebo vypnuto.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Při vypnutí zákazník vždy rezervuje celý kus (loďku, kolo, pokoj). Pole se ve formuláři nezobrazí.

### Zdrojů z poolu

- **Co dělá:** Kolik sdílených zdrojů (dráhy, kurty) tato služba při rezervaci spotřebuje.
- **Výchozí hodnota:** 1.
- **Povolené hodnoty:** Celé číslo od 1 do počtu zdrojů nastaveného v Počet zdrojů v poolu (dráhy, kurty, místa...).
- **Platí pro:** jen když je pool nastaven. Bez poolu se pole nezobrazuje a platí 1.
- **Na co má vliv:** Volné termíny. Součet zdrojů překrývajících se rezervací nesmí přesáhnout pool.

### Max. souběžných rezervací

- **Co dělá:** Počet kusů, které máte k dispozici (5 loděk, 10 kol). Víc rezervací téže služby najednou systém nepustí.
- **Výchozí hodnota:** Prázdné, tedy bez omezení.
- **Povolené hodnoty:** Celé číslo od 1. Prázdné nebo 0 omezení vypne.
- **Platí pro:** Termín a Časová rezervace. Neuplatní se, když je nastaven pool zdrojů nebo rezervaci obsluhuje zaměstnanec.
- **Na co má vliv:** Volné termíny. Má přednost před Kapacita (souběžné rezervace).

### Pořadí

- **Co dělá:** Pořadí služeb v seznamu a ve formuláři.
- **Výchozí hodnota:** 0.
- **Povolené hodnoty:** Celé číslo od 0. Služby se řadí od nejnižšího čísla.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Jen pořadí zobrazení.

### Aktivní

- **Co dělá:** Zapíná a vypíná službu.
- **Výchozí hodnota:** Zapnuto při vytvoření.
- **Povolené hodnoty:** Zapnuto nebo vypnuto. V seznamu to lze přepnout i položkou Aktivovat nebo Deaktivovat.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Neaktivní služba se zákazníkovi nenabízí a její termíny se nevrací. Existující rezervace zůstávají.

### Zobrazit v rezervačním formuláři

- **Co dělá:** Určuje, jestli se služba nabízí zákazníkovi ve formuláři.
- **Výchozí hodnota:** Zapnuto.
- **Povolené hodnoty:** Zapnuto nebo vypnuto.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Seznam služeb ve formuláři obsahuje jen služby, které jsou aktivní a mají zapnuto toto pole. Veřejný přehled obsazenosti u skryté služby také nic neukáže.
- **Časté omyly:** Vypnutí neruší už vytvořené rezervace. Skrytá služba se také nezobrazí v přehledu obsazenosti.

### Použít ve workshopech

- **Co dělá:** Povoluje použít službu jako základ skupinové akce nebo workshopu.
- **Výchozí hodnota:** Zapnuto.
- **Povolené hodnoty:** Zapnuto nebo vypnuto. U typu Skupinové akce a vstupenky se zapne automaticky.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Nabídka služeb při zakládání skupinové akce.

### Cena za noc (Kč)

- **Co dělá:** Cena jedné noci v celých korunách.
- **Výchozí hodnota:** 0 u nového objektu.
- **Povolené hodnoty:** Celé číslo od 0.
- **Platí pro:** jen Ubytování.
- **Na co má vliv:** Cena pobytu. Sezónní ceny, pokud je máte, se počítají zvlášť.

### Check-in čas

- **Co dělá:** Hodina příjezdu u této služby.
- **Výchozí hodnota:** Formulář nabídne 14:00.
- **Povolené hodnoty:** Čas HH:mm.
- **Platí pro:** jen Ubytování.
- **Na co má vliv:** Začátek pobytu. Má přednost před Check-in čas (HH:mm) z nastavení rezervací.

### Check-out čas

- **Co dělá:** Hodina odjezdu u této služby.
- **Výchozí hodnota:** Formulář nabídne 10:00.
- **Povolené hodnoty:** Čas HH:mm.
- **Platí pro:** jen Ubytování.
- **Na co má vliv:** Konec pobytu. Má přednost před Check-out čas (HH:mm) z nastavení rezervací.

### Max. nocí

- **Co dělá:** Nejdelší pobyt v nocích. Z něj se spočítá trvání (noci krát 1440 minut).
- **Výchozí hodnota:** 14 u nového objektu.
- **Povolené hodnoty:** Celé číslo od 1.
- **Platí pro:** jen Ubytování.
- **Na co má vliv:** Délka služby uložená v systému. Chování formuláře vůči tomuto číslu: Neověřeno.

### Platforma zámku

- **Co dělá:** Vybírá značku chytrého zámku, odkud se načte seznam zámků.
- **Výchozí hodnota:** TTLock. Máte-li nastavenou jen Tuya, nabídne se Tuya.
- **Povolené hodnoty:** TTLock, Tuya. Přepnutí znovu načte stránku.
- **Platí pro:** jen tarif Pro+. V nižším tarifu se místo pole zobrazí odkaz na předplatné.
- **Na co má vliv:** Seznam zámků v dalším poli. To se jmenuje podle platformy TTLock zámek nebo Tuya zámek, je nepovinné (výchozí je Bez zámku) a přiřadí službě konkrétní zámek, jehož PIN se po potvrzení rezervace automaticky pošle zákazníkovi. Přihlašovací údaje zámků jsou v Nastavení, Zámky.

### Kód platí … minut před začátkem rezervace

- **Co dělá:** O kolik minut dřív začne kód platit.
- **Výchozí hodnota:** 15.
- **Povolené hodnoty:** 0 až 1440. 0 znamená přesně od začátku rezervace.
- **Platí pro:** jen tarif Pro+ a služba s přiřazeným zámkem.
- **Na co má vliv:** Platnost přístupového kódu.

### … minut po konci rezervace

- **Co dělá:** O kolik minut déle kód platí po konci rezervace. Zákazník tuto rezervu nevidí.
- **Výchozí hodnota:** 15.
- **Povolené hodnoty:** 0 až 1440.
- **Platí pro:** jen tarif Pro+ a služba s přiřazeným zámkem.
- **Na co má vliv:** Platnost přístupového kódu.

### Režim Tuya zámku

- **Co dělá:** Způsob vytváření PIN u zámku Tuya. Nabízí se jen Offline, kde se platnost zaokrouhlí na celé hodiny.
- **Výchozí hodnota:** Offline.
- **Povolené hodnoty:** Offline.
- **Platí pro:** jen tarif Pro+, platforma Tuya a služba s přiřazeným zámkem.
- **Na co má vliv:** Přesnost platnosti kódu. Minutové rezervy se neuplatní přesně.

### Délka (min)

- **Co dělá:** Délka cenové varianty. Zákazník si ve formuláři vybírá z variant.
- **Výchozí hodnota:** Prázdné, povinné pro přidání.
- **Povolené hodnoty:** Celé číslo od 1. Prázdné pole zobrazí upozornění.
- **Platí pro:** Termín a Časová rezervace.
- **Na co má vliv:** Pokud varianty existují, formulář přidá krok výběru délky. Délka varianty se použije místo trvání služby při výpočtu volných termínů. Variantu přidáte tlačítkem + Přidat a uloží se až stiskem Uložit. Smazání variantou ikonou × se také provede až při uložení.

### Uložit

- **Co dělá:** Uloží detail služby včetně přidaných a smazaných variant.
- **Výchozí hodnota:** Bez účinku, dokud se nestiskne.
- **Povolené hodnoty:** Tlačítko. Při chybě se neuloží nic a zobrazí se chyba.
- **Platí pro:** celou stránku detailu.
- **Na co má vliv:** Všechna pole služby.

### + Přidat službu

- **Co dělá:** Otevře okno pro novou službu. Uloží se potvrzením tlačítka Přidat službu v okně.
- **Výchozí hodnota:** Bez účinku, dokud se nestiskne.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Vznikne nová služba. Cenové varianty se přidávají až v detailu hotové služby.

### Detail / Upravit

- **Co dělá:** Otevře detail služby. V nabídce Akce jsou ještě Aktivovat nebo Deaktivovat a Smazat.
- **Výchozí hodnota:** Bez účinku.
- **Povolené hodnoty:** Položka nabídky.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Smazat nejde u služby, která má aktivní rezervace.

## Jak spolu pole souvisí

- Délka rezervace je trvání služby, nebo délka vybrané varianty. Čas blokovaný v kalendáři je délka plus Buffer čas (minuty).
- Kolik rezervací se vejde na jeden čas, určuje v tomto pořadí: pool zdrojů v Nastavení, Rezervace, pak Max. souběžných rezervací, pak Kapacita (souběžné rezervace), jinak jedna rezervace poskytovatele najednou. Při zaměstnancích a pracovištích se kapacita počítá na osobu a na pracoviště. Podrobně v souboru [Jak se počítají volné termíny](https://obsadto.cz/napoveda/reference/jak-se-pocitaji-volne-terminy.md).
- Krok začátků: Krok slotů (minuty) u služby, jinak Výchozí krok slotů (minuty), jinak automatika z délek služeb.
- Služba je ve formuláři jen tehdy, když je Aktivní a zároveň má zapnuto Zobrazit v rezervačním formuláři.
- Počet osob ve formuláři: Max. osob na rezervaci větší než 1 a zapnuto Zákazník vybírá počet osob.

## Příklady nastavení

**Kadeřnictví, střih.** Typ rezervací Termín, Název Střih, Trvání (minuty) 45, Cena (Kč) 450, Buffer čas (minuty) 10, Kapacita (souběžné rezervace) 1. Zákazník vybere čas, který se vejde, i s desetiminutovou pauzou. Další střih začne nejdřív 55 minut po začátku předchozího.

**Půjčovna loděk.** Typ rezervací Časová rezervace, služba Loďka s Max. souběžných rezervací 5 a Max. osob na rezervaci 4. Varianty: 60 minut za 300, 120 minut za 500. V kalendáři jde rezervovat, dokud nejsou obsazené všechny čtyři kusy, pátý zákazník už stejný čas nedostane.

**Penzion, pokoj.** Typ rezervací Ubytování, Typ Ubytování, Slug (URL identifikátor) pokoj-1, Cena za noc (Kč) 1200, Check-in čas 15:00, Check-out čas 10:00, Kapacita (souběžné rezervace) 1. Pokoj lze rezervovat po nocích, den odjezdu zůstává volný pro příjezd dalšího hosta.

## Technická poznámka

Informace jsou převzaté ze zdrojového kódu (`Procedures.cshtml`, `Procedures.cshtml.cs`, `Procedures/Detail.cshtml`, `Procedures/Detail.cshtml.cs`, `Procedure.cs`, `ProcedureRepository.cs`, `SlotsController.cs`, `ProvidersController.cs`, `AvailabilityService.cs`, `BookingService.cs`, `PrepaymentRules.cs`, JavaScript rezervačního formuláře). Kde chování nebylo ověřeno, je to napsáno výslovně slovem Neověřeno.

Verze nápovědy: 1.0.2.74, 2026-11-22
