# REST API - Rezervace

# KASA FIK REST API – Rezervace

Tento dokument popisuje, jak pomocí REST API KASA FIK vytvořit a spravovat **rezervace** (tabulka `reservations`) a **kapacitní sloty** (tabulka `reservation_capacity`).

## 1. Základní informace

| Položka | Hodnota |
|---|---|
| Base URL | `https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/` |
| Endpoint pro rezervace | `POST /data/reservations` (vytvoření / aktualizace) |
| Endpoint pro kapacitní sloty | `POST /data/reservation_capacity` |
| Endpoint pro čtení | `GET /data/reservations`, `GET /data/reservation_capacity` |
| Autentizace | HTTP hlavička `Authorization: A|xxxxx` (API token z Backoffice → Nastavení → Systém) |
| Content-Type | `application/json` |
| Formát ID | BigInt – v JSONu posílejte jako **číslo** nebo **string**, ale konzistentně v celé integraci |
| Formát času | Unix timestamp v **milisekundách** (např. `1735689600000`) |

> Generování nových ID je popsáno v hlavní dokumentaci REST API (sekce _Funkce pro práci s id_). Pro vytvoření nového záznamu můžete vždy poslat `id = 0` a server přidělí nové ID sám.

### 1.1 Společná pravidla

- **Verze (`_v`)** – pokaždé, když záznam posíláte, musíte poslat **novější** `_v` (např. aktuální `Date.now()` v ms). Server záznam aktualizuje jen tehdy, pokud je příchozí `_v` vyšší než stávající. **Čas nesmí být v budoucnosti.**
- **Smazání** – nastavte `_d = 1` (místo mazání fyzického).
- **Viditelnost** – `visible = false` skryje záznam bez smazání.
- **Peníze** – všechny monetární hodnoty v JSONu jsou vynásobené 1000 (cena 23,50 Kč → `23500`).
- **Globální ID zákazníka (`id_c`)** – všechny objekty patří do tenanta identifikovaného `id_c`. Toto ID dostanete při registraci v Backoffice.
- **User-Agent** – vkládejte identifikaci své aplikace (název, verze, kontaktní e-mail), aby KASA FIK mohl v případě potřeby kontaktovat vývojáře.
- **Rate limit** – při chybě `429` snižte frekvenci požadavků.

---

## 2. Objekt `ReservationsModel` (rezervace)

### 2.1 Struktura JSON

| Pole | Typ | Povinné | Výchozí | Popis |
|---|---|---|---|---|
| `id` | int64 (BigInt) | **ano** | – | ID záznamu. Pro nový záznam nastavte na `0` – server přidělí nové ID. Pro aktualizaci stávajícího zadejte jeho ID. |
| `_t` | string | **ano** | `"reservations"` | Identifikátor tabulky. **Vždy odešlete `reservations`.** |
| `_v` | int64 | **ano** | – | Verze (Unix ms). Musí být vyšší než předchozí verze. Nesmí být v budoucnosti. |
| `_d` | int (0/1) | **ano** | `0` | Příznak smazání. `0` = aktivní, `1` = smazáno. |
| `id_c` | int64 | ne | – | Globální ID zákazníka (tenanta). Doporučujeme vyplnit. |
| `id_shop` | int64 | **ano** | `0` | ID pobočky. `0` = bez vazby na pobočku (pro všechny). |
| `id_customer` | int64 | ne | `null` | ID zákazníka (z tabulky `customers`). |
| `id_product` | int64 | ne | `null` | ID produktu (z tabulky `products`), ke kterému se rezervace vztahuje. |
| `id_park_location` | int64 | ne | `null` | ID parkovacího místa (z tabulky `park_locations`), pokud rezervace zahrnuje parkování. |
| `id_employee_added` | int64 | ne | `null` | ID zaměstnance, který rezervaci vytvořil. |
| `id_employee_accepted` | int64 | ne | `null` | ID zaměstnance, který rezervaci přijal. |
| `id_reservation_capacity` | int64 | ne | `null` | ID kapacitního slotu (viz sekce 3), ke kterému rezervace patří. |
| `date_start` | int64 | ne | `null` | Začátek rezervace (Unix ms). |
| `date_end` | int64 | ne | `null` | Konec rezervace (Unix ms). |
| `date_expires` | int64 | ne | `null` | Platnost rezervace do (Unix ms). Po tomto čase server rezervaci automaticky odmítne. |
| `date_updated` | int64 | ne | – | Čas poslední aktualizace (Unix ms). |
| `quantity_request` | double | ne | `null` | Požadovaný počet (osob, kusů, míst…). |
| `reservation_type` | int (smallint) | **ano** | `0` | Typ rezervace (číselník – viz sekce 2.3). |
| `reservation_bitmask` | int (int32) | **ano** | `0` | Bitová maska příznaků rezervace (viz sekce 2.4). |
| `accepted` | bool | **ano** | `false` | `true` = rezervace byla přijata personálem. |
| `visible` | bool | **ano** | `true` | `false` = skryto, ale nesmazáno. |
| `note_request` | string | ne | `null` | Poznámka od zákazníka k rezervaci (max 128 znaků). |
| `note_external` | string | ne | `null` | Poznámka viditelná zákazníkem (max 128 znaků). |
| `note_internal` | string | ne | `null` | Interní poznámka personálu (max 128 znaků). |
| `tags` | string | ne | `null` | Štítky (čárkou oddělený seznam, max 128 znaků). |
| `url` | string (URI) | ne | `null` | URL odkazující na detail rezervace (např. ve vašem systému). |

### 2.2 Minimální payload pro vytvoření rezervace

```json
{
  "id": 0,
  "_t": "reservations",
  "_v": 1735689600000,
  "_d": 0,
  "id_shop": 492696696397774,
  "id_customer": 3665795354036044,
  "id_product": 6555921856010421,
  "date_start": 1735689600000,
  "date_end": 1735693200000,
  "quantity_request": 2.0,
  "reservation_type": 0,
  "reservation_bitmask": 0,
  "accepted": false,
  "visible": true,
  "note_request": "Dvě osoby, sauna + whirpool"
}
```

### 2.3 Číselník `reservation_type`

Hodnota je malé celé číslo (smallint). Sada hodnot není v současné verzi plně formalizovaná, nicméně z praxe:

| Hodnota | Význam |
|---|---|
| `-1` | `RESERVATION_TYPE_NOT_SET` – nedefinováno (interní konstanta, na API neposílejte) |
| `0` | výchozí / obecná rezervace |
| `1` | rezervace stolu / místa |
| `2` | rezervace slotu / časového okna |
| `3` | rezervace produktu (vstupenka, vstup, služba) |
| `4+` | další typy dle konfigurace tenanta |

> Konkrétní číselník pro vašeho tenanta si ověřte u KASA FIK podpory.

### 2.4 Bitová maska `reservation_bitmask`

Bitové pozice (lowest bit = 1) pro rezervace:

| Bit | Hodnota | Význam |
|---|---|---|
| 0 | `1` | rezervace vyžaduje potvrzení |
| 1 | `2` | rezervace je opakující se (rekurzentní) |
| 2 | `4` | rezervace je blokována (drží místo) |
| 3 | `8` | rezervace s platbou předem |
| 4 | `16` | rezervace s upomínkou (SMS / e-mail) |
| 5+ | `32+` | další příznaky dle konfigurace tenanta |

Příklady:
- `0` – běžná rezervace bez zvláštních příznaků
- `1` – vyžaduje potvrzení
- `3` – vyžaduje potvrzení a je opakující se
- `8` – s platbou předem
- `24` – `8 | 16` – s platbou předem a upomínkou

---

## 3. Objekt `ReservationCapacityModel` (kapacitní sloty)

Kapacitní slot definuje **opakovatelný blok** (např. "sauna pro 6 osob každý pátek 18:00 – 19:30"), ke kterému se pak vážou jednotlivé rezervace přes `id_reservation_capacity`.

### 3.1 Struktura JSON

| Pole | Typ | Povinné | Výchozí | Popis |
|---|---|---|---|---|
| `id` | int64 | **ano** | – | ID záznamu. `0` pro nový. |
| `_t` | string | **ano** | `"reservation_capacity"` | Vždy `"reservation_capacity"`. |
| `_v` | int64 | **ano** | – | Verze (Unix ms). |
| `_d` | int (0/1) | **ano** | `0` | Příznak smazání. |
| `id_c` | int64 | ne | – | Globální ID tenanta. |
| `id_shop` | int64 | **ano** | – | ID pobočky. |
| `id_cash_register` | int64 | **ano** | – | ID pokladny, na které se slot spravuje. |
| `id_product` | int64 | ne | `null` | ID produktu, se kterým slot souvisí. |
| `id_park_location` | int64 | ne | `null` | ID parkovacího místa, pokud slot popisuje parkování. |
| `id_employee_req` | int64 | ne | `null` | ID zaměstnance odpovědného za slot. |
| `name` | string | ne | `null` | Název slotu (např. "Sauna 18:00 pátek"). |
| `date_start` | int64 | ne | `null` | Začátek prvního výskytu slotu (Unix ms). |
| `date_end` | int64 | ne | `null` | Konec prvního výskytu slotu (Unix ms). |
| `date_updated` | int64 | ne | – | Čas poslední aktualizace. |
| `quantity_max` | double | ne | `null` | Maximální počet jednotek, které slot pojme (např. 6 osob). |
| `quantity_units` | double | ne | `null` | Počet jednotek na jednu rezervaci (např. 1 osoba). |
| `unit` | int (smallint) | **ano** | – | Jednotka (`0` = osoby, `1` = místa, `2` = kusy…). |
| `capacity_type` | int (smallint) | **ano** | `0` | Typ kapacity (číselník – viz 3.2). |
| `capacity_bitmask` | int (int32) | **ano** | `0` | Bitová maska příznaků slotu. |
| `dow_bitmask` | int (int32) | **ano** | `0` | Bitová maska dnů v týdnu, kdy se slot opakuje (viz 3.3). |
| `visible` | bool | **ano** | `true` | Viditelnost. |
| `note_external` | string | ne | `null` | Poznámka pro zákazníka. |
| `note_internal` | string | ne | `null` | Interní poznámka. |
| `tags` | string | ne | `null` | Štítky. |
| `internal_extra` | string | ne | `null` | Interní dodatečná data (libovolný JSON string). |

### 3.2 Číselník `capacity_type`

| Hodnota | Význam |
|---|---|
| `0` | obecný / výchozí slot |
| `1` | časový slot (opakovaný v čase) |
| `2` | místo / stůl (např. konkrétní sauna) |
| `3` | zdroj (např. whirpool, lehátko) |
| `4+` | další typy dle konfigurace tenanta |

### 3.3 Bitová maska `dow_bitmask` (den v týdnu)

| Bit | Den |
|---|---|
| 0 | neděle |
| 1 | pondělí |
| 2 | úterý |
| 3 | středa |
| 4 | čtvrtek |
| 5 | pátek |
| 6 | sobota |

Příklady:
- `0` – žádný den (jednorázový slot, řídí se jen `date_start` / `date_end`)
- `2` – pouze pondělí
- `96` – `32 | 64` – pouze pátek a sobota
- `127` – `1+2+4+8+16+32+64` – každý den

### 3.4 Příklad vytvoření slotu

```json
{
  "id": 0,
  "_t": "reservation_capacity",
  "_v": 1735689600000,
  "_d": 0,
  "id_shop": 492696696397774,
  "id_cash_register": 49269669639111,
  "id_product": 6555921856010421,
  "name": "Sauna A – 18:00",
  "date_start": 1735689600000,
  "date_end": 1735693200000,
  "quantity_max": 6.0,
  "quantity_units": 1.0,
  "unit": 0,
  "capacity_type": 1,
  "capacity_bitmask": 0,
  "dow_bitmask": 32,
  "visible": true
}
```

---

## 4. Endpointy

### 4.1 Vytvoření nebo aktualizace jedné rezervace

```
POST /data/reservations
```

Tělo může být buď jeden objekt, nebo pole objektů pro dávkové vložení.

**cURL – jedna rezervace:**

```bash
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations' \
  -H 'Authorization: A|xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: MojAplikace/1.0 (kontakt@firma.cz)' \
  -d '{
    "id": 0,
    "_t": "reservations",
    "_v": 1735689600000,
    "_d": 0,
    "id_shop": 492696696397774,
    "id_customer": 3665795354036044,
    "id_product": 6555921856010421,
    "id_reservation_capacity": 9007199254740992,
    "date_start": 1735689600000,
    "date_end": 1735693200000,
    "date_expires": 1735603200000,
    "quantity_request": 2.0,
    "reservation_type": 3,
    "reservation_bitmask": 1,
    "accepted": false,
    "visible": true,
    "note_request": "2 osoby, sauna + whirpool"
  }'
```

**cURL – dávka (array):**

```bash
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations' \
  -H 'Authorization: A|xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '[
    { "id": 0, "_t": "reservations", "_v": 1735689600000, ... },
    { "id": 0, "_t": "reservations", "_v": 1735689601000, ... }
  ]'
```

**Odpověď 200 OK:**

Server vrací pole uložených objektů včetně serverem přiděleného `id`:

```json
[
  {
    "id": 11154058202189370,
    "_t": "reservations",
    "_v": 1735689600000,
    "_d": 0,
    "id_shop": 492696696397774,
    "id_customer": 3665795354036044,
    "id_product": 6555921856010421,
    "date_start": 1735689600000,
    "date_end": 1735693200000,
    "quantity_request": 2.0,
    "reservation_type": 3,
    "reservation_bitmask": 1,
    "accepted": false,
    "visible": true,
    "note_request": "2 osoby, sauna + whirpool",
    "date_updated": 1735689600050,
    "id_c": 111111
  }
]
```

### 4.2 Vytvoření nebo aktualizace kapacitního slotu

```
POST /data/reservation_capacity
```

Payload odpovídá struktuře v sekci 3.4.

### 4.3 Čtení seznamu rezervací

```
GET /data/reservations
GET /data/reservations/{id}
```

S parametrem `id_start` můžete stránkovat (viz sekce 5).

### 4.4 Čtení seznamu kapacitních slotů

```
GET /data/reservation_capacity
GET /data/reservation_capacity/{id}
```

### 4.5 Zrušení rezervace

Rezervace se **nemaze fyzicky** – nastavte `_d = 1`:

```bash
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations' \
  -H 'Authorization: A|xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 11154058202189370,
    "_t": "reservations",
    "_v": 1735776000000,
    "_d": 1
  }'
```

> Poznámka: `reservation_bitmask` a `reservation_type` jsou v `_Fields` enumu definované jako `canBeNull = false` – při mazání je bezpečnější poslat je beze změny (tj. stejné jako u původního záznamu), aby server záznam skutečně přijal.

---

## 5. Stránkování

API vrací maximálně `limit` (1–400, výchozí 100) záznamů na stránku. Pro další stránku použijte `id_start` z posledního záznamu předchozí odpovědi.

| Parametr | Typ | Výchozí | Popis |
|---|---|---|---|
| `limit` | int | `100` | Počet záznamů (1–400). |
| `id_start` | int64 (string) | `0` | ID posledního záznamu z předchozí strany. |
| `direction` | string | `backward` | `forward` (od nejstarších) / `backward` (od nejnovějších). |
| `version_start` | int64 | `0` | Filtr na `_v >= version_start` (změnové stránkování). |

Příklad sekvenčního čtení:

```bash
# 1. strana – 100 nejnovějších rezervací
curl 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations?limit=100' \
  -H 'Authorization: A|xxxxxxxxxxxxxxxxxxxxxxxx'

# 2. strana – použijte id z posledního záznamu předchozí odpovědi
curl 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations?limit=100&id_start=11154058202189370' \
  -H 'Authorization: A|xxxxxxxxxxxxxxxxxxxxxxxx'
```

> **Pozor na přesnost:** `id` je BigInt, může přesáhnout 53bit limit JavaScriptu. Při předávání do `id_start` ho **vždy posílejte jako string**, jinak hrozí ztráta přesnosti.

---

## 6. Kompletní příklad – vytvoření rezervace krok za krokem

Níže je ucelený příklad, jak vytvořit rezervaci pro zákazníka na konkrétní slot. Předpokládáme, že již máte:

- API token z Backoffice (`A|…`),
- ID pobočky (`id_shop`),
- ID produktu (`id_product`),
- ID zákazníka (`id_customer`) – případně nejprve vytvořte přes `POST /data/customers`,
- ID kapacitního slotu (`id_reservation_capacity`) – případně nejprve vytvořte přes `POST /data/reservation_capacity`.

```bash
# --- 1. Vytvoření rezervace ---
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations' \
  -H 'Authorization: A|VAS_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: SaunofIntegrace/1.0 (dev@firma.cz)' \
  -d '{
    "id": 0,
    "_t": "reservations",
    "_v": '$(date +%s%3N)',
    "_d": 0,
    "id_shop": 492696696397774,
    "id_customer": 3665795354036044,
    "id_product": 6555921856010421,
    "id_reservation_capacity": 9007199254740992,
    "date_start": 1735689600000,
    "date_end": 1735693200000,
    "date_expires": 1735603200000,
    "quantity_request": 2,
    "reservation_type": 3,
    "reservation_bitmask": 1,
    "accepted": false,
    "visible": true,
    "note_request": "2 osoby, prosím připravit ručníky",
    "tags": "online,wellness"
  }'
# --- 2. Server odpoví 200 OK s uloženým objektem (včetně přiděleného id) ---

# --- 3. Později – potvrzení rezervace personálem ---
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations' \
  -H 'Authorization: A|VAS_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 11154058202189370,
    "_t": "reservations",
    "_v": '$(date +%s%3N)',
    "_d": 0,
    "id_shop": 492696696397774,
    "id_customer": 3665795354036044,
    "id_product": 6555921856010421,
    "id_reservation_capacity": 9007199254740992,
    "date_start": 1735689600000,
    "date_end": 1735693200000,
    "date_expires": 1735603200000,
    "quantity_request": 2,
    "reservation_type": 3,
    "reservation_bitmask": 1,
    "accepted": true,
    "visible": true,
    "id_employee_accepted": 9876543210123456
  }'

# --- 4. Zrušení rezervace (místo mazání) ---
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations' \
  -H 'Authorization: A|VAS_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 11154058202189370,
    "_t": "reservations",
    "_v": '$(date +%s%3N)',
    "_d": 1
  }'
```

---

## 7. Chybové stavy

| Kód | Význam | Řešení |
|---|---|---|
| `200` | OK – záznam vytvořen / aktualizován | pokračujte podle odpovědi |
| `400` | Neplatný `id_start`, chybějící povinné pole, apod. | zkontrolujte payload |
| `403` | Neplatný nebo chybějící API token | ověřte `Authorization: A|…` |
| `404` | Záznam s daným id neexistuje | ověřte `id` (případně přes `GET` seznamu) |
| `429` | Překročen rate limit | snižte frekvenci požadavků |
| `500` | Interní chyba serveru | opakujte požadavek po chvíli |

---

## 8. Nejčastější chyby integrace

1. **Zapomenuté `_v`** – server záznam odmítne. Vždy posílejte `Date.now()` (nebo jiné aktuální `now()` v ms).
2. **Budoucí `_v`** – timestamp `_v` nesmí být v budoucnosti. Server takové záznamy odmítá.
3. **`id = 0` pro update** – pokud chcete aktualizovat existující záznam, musíte poslat jeho skutečné `id`. `id = 0` vždy vytvoří nový.
4. **Smazání nastavením `visible = false`** – to záznam pouze skryje, ale nesmaže. Pro smazání použijte `_d = 1`.
5. **BigInt v JavaScriptu** – `id` přesahuje 53 bitů. Vždy ho posílejte jako string v URL (`id_start=…`) a parsujte s `BigInt` na straně klienta.
6. **Špatné ID pobočky** – `id_shop` musí existovat v tabulce `shops`. Nejdříve získejte seznam poboček přes `GET /data/shops`.
7. **Chybějící záznam zákazníka** – `id_customer` musí existovat v tabulce `customers`. Nejdříve vytvořte zákazníka přes `POST /data/customers` (viz dokumentace REST API).

---

## 9. Související endpointy

Pro úplnou integraci budete pravděpodobně potřebovat i tyto endpointy (podrobnosti v hlavní dokumentaci REST API):

- `GET /data/shops` – seznam poboček
- `GET /data/cash_registers` – seznam pokladen
- `GET /data/customers` / `POST /data/customers` – zákazníci
- `GET /data/products` – produkty (vstupenky, služby)
- `GET /data/park_locations` – parkovací místa

---

## 10. Kontakt a podpora

- E-mail podpory KASA FIK: **podpora@kasafik.cz**
- Dokumentace REST API: <https://manual.kasafik.cz/books/kasa-fik-pokladna/page/rest-api>
- Webhooky (doporučený způsob synchronizace): <https://manual.kasafik.cz/books/kasa-fik-pokladna/page/webhook-integrace-api>

---

## 11. Wellness / rezervační systém – kompletní příklad

Tento příklad ukazuje typický tok z pohledu wellness aplikace, která posílá do KASA FIK rezervaci sauny pro 2 osoby v konkrétním časovém okně na konkrétním místě.

Předpoklad: v KASA FIK již existuje produkt _"Sauna 60 minut"_ (`id_product`) a záznam zákazníka (`id_customer`).

### 11.1 Krok 1 – ujistěte se, že existuje kapacitní slot

Pokud máte v KASA FIK definované opakující se sloty (např. "Sauna A, 18:00–19:00, každý pátek"), použijte jejich `id` v kroku 2. Pokud ne, vytvořte slot jednorázově:

```bash
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservation_capacity' \
  -H 'Authorization: A|VAS_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: WellnessApp/1.0 (dev@wellness.cz)' \
  -d '{
    "id": 0,
    "_t": "reservation_capacity",
    "_v": 1735689000000,
    "_d": 0,
    "id_shop": 492696696397774,
    "id_cash_register": 49269669639111,
    "id_product": 6555921856010421,
    "name": "Sauna A – 18:00",
    "date_start": 1735689600000,
    "date_end": 1735693200000,
    "quantity_max": 6,
    "quantity_units": 1,
    "unit": 0,
    "capacity_type": 1,
    "capacity_bitmask": 0,
    "dow_bitmask": 32,
    "visible": true
  }'
```

> Všimněte si, že `id_product` je vyplněn i na slotu – díky tomu nemusíte při vytváření každé rezervace uvádět produkt znovu, stačí `id_reservation_capacity`. Viz 11.2 B).

Server odpoví pole s přiděleným `id` slotu, např. `9007199254740992`.

### 11.2 Krok 2 – vytvořte rezervaci

#### A) Kompletní varianta – doporučeno

V této variantě uvádíte **všechny tři vazby**: co, kdy/kde, kolik. Je to nejpřehlednější a nejméně chybové.

```bash
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations' \
  -H 'Authorization: A|VAS_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: WellnessApp/1.0 (dev@wellness.cz)' \
  -d '{
    "id": 0,
    "_t": "reservations",
    "_v": 1735689600000,
    "_d": 0,
    "id_shop": 492696696397774,
    "id_customer": 3665795354036044,
    "id_product": 6555921856010421,
    "id_reservation_capacity": 9007199254740992,
    "date_start": 1735689600000,
    "date_end": 1735693200000,
    "quantity_request": 2,
    "reservation_type": 3,
    "reservation_bitmask": 0,
    "accepted": false,
    "visible": true,
    "note_request": "Výročí – prosím tiché prostředí",
    "url": "https://wellness.example.com/bookings/42",
    "tags": "wellness,sauna,online"
  }'
```

Co zde jednotlivá pole znamenají v kontextu wellness:

| Pole | V tomto příkladu |
|---|---|
| `id_product` | Produkt _"Sauna 60 minut"_ z vašeho ceníku – toto se bude účtovat |
| `id_reservation_capacity` | Konkrétní slot _"Sauna A, 18:00–19:00, 6 míst"_ |
| `date_start` / `date_end` | Začátek a konec konkrétní návštěvy (zde 18:00–19:00) |
| `quantity_request` | Počet osob (2) |
| `url` | Odkaz zpět do vašeho wellness systému na detail této rezervace |
| `note_request` | Poznámka od zákazníka (zobrazí se personálu) |

#### B) Stručná varianta – když má slot vyplněný produkt

Pokud jste v kroku 1 vyplnili `id_product` na slotu, stačí poslat jen `id_reservation_capacity`. KASA FIK si produkt sám doplní ze slotu.

```bash
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations' \
  -H 'Authorization: A|VAS_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: WellnessApp/1.0 (dev@wellness.cz)' \
  -d '{
    "id": 0,
    "_t": "reservations",
    "_v": 1735689600000,
    "_d": 0,
    "id_shop": 492696696397774,
    "id_customer": 3665795354036044,
    "id_reservation_capacity": 9007199254740992,
    "date_start": 1735689600000,
    "date_end": 1735693200000,
    "quantity_request": 2,
    "reservation_type": 3,
    "reservation_bitmask": 0,
    "accepted": false,
    "visible": true
  }'
```

#### C) Minimální varianta – bez slotu

Pokud vám stačí **časová vazba** (rezervace na určitý časový úsek, ale bez konkrétního místa/zdroje), můžete `id_reservation_capacity` vynechat. Produkt a časové okno ale musíte vyplnit.

```bash
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations' \
  -H 'Authorization: A|VAS_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: WellnessApp/1.0 (dev@wellness.cz)' \
  -d '{
    "id": 0,
    "_t": "reservations",
    "_v": 1735689600000,
    "_d": 0,
    "id_shop": 492696696397774,
    "id_customer": 3665795354036044,
    "id_product": 6555921856010421,
    "date_start": 1735689600000,
    "date_end": 1735693200000,
    "quantity_request": 2,
    "reservation_type": 3,
    "reservation_bitmask": 0,
    "accepted": false,
    "visible": true
  }'
```

### 11.3 Krok 3 – server odpoví

Server vrací pole s uloženým objektem včetně přiděleného `id` rezervace (např. `11154058202189370`). Toto `id` si uložte – budete ho potřebovat pro pozdější aktualizace a zrušení.

### 11.4 Krok 4 – personál potvrdí rezervaci

Při příchodu zákazníka personál na pokladně změní `accepted` na `true`. Vy (wellness systém) o tom můžete vědět díky webhookům (viz hlavní dokumentace).

### 11.5 Krok 5 – zrušení rezervace

Rezervace se **nemaze fyzicky** – nastavte `_d = 1`:

```bash
curl -X POST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reservations' \
  -H 'Authorization: A|VAS_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 11154058202189370,
    "_t": "reservations",
    "_v": 1735776000000,
    "_d": 1
  }'
```

### 11.6 Nejčastější chyby v tomto scénáři

1. **Produkt neexistuje v KASA FIK** – ujistěte se, že `id_product` odpovídá produktu v ceníku pokladny. Pokud váš wellness systém používá vlastní ID, musíte si je předem namapovat na ID v KASA FIK. Koordinaci ID řešte s provozovatelem pokladny.
2. **Zákazník neexistuje** – před vytvořením rezervace musí zákazník existovat v tabulce `customers` (viz `POST /data/customers` v hlavní dokumentaci).
3. **Slot nemá kapacitu** – pokud `quantity_request` překročí zbývající `quantity_max` slotu, server může rezervaci odmítnout. Kapacitu slotu je třeba hlídat na straně wellness systému.
4. **`reservation_type` musíte zvolit správně** – typ `3` je _"rezervace produktu (vstupenka, vstup, služba)"_, což odpovídá wellness. Jiné typy konzultujte s podporou.
5. **Vždy posílejte aktuální `_v`** – pro update použijte nové `Date.now()` v ms, starší `_v` server odmítne.