Hotel už ví, kdo přijede. Ať to ví i technologie.

Recepce má rezervaci v PMS, topení vlastní rozvrh a zámky další správu. Pokud se pobyt prodlouží nebo host změní pokoj, je třeba stejnou informaci přenést na více míst. Právě tyto opakované zásahy může převzít automatizace.

Ellipse PMS zpřístupňuje prostřednictvím API údaje o pobytech, obsazenosti a aktuálně platných PIN kódech. Integrační služba je pravidelně načítá a převádí na příkazy pro konkrétní přístupový systém, regulaci topení nebo systém chytré domácnosti.

Propojit lze jakýkoli systém, který umožňuje externí ovládání prostřednictvím vhodného rozhraní nebo brány. Po jednorázovém nastavení může výměna dat probíhat automaticky. Kompatibilitu a rozsah ovládání je třeba ověřit u konkrétního zařízení; samotné API Ellipse nenahrazuje ovladač od jeho výrobce.

Pro hotel to znamená méně ručního přepisování, jednotný zdroj informací a možnost připravit pokoj podle typu pobytu. Skutečnou úsporu energie či času je třeba vyhodnotit v provozu. API poskytuje podklady, konkrétní teploty a provozní pravidla nastavuje integrátor společně s hotelem.

Čtyři volání, jeden zdroj dat

Integrace čte data z hotelové adresy https://hotel.example.com/api/stays/. Doména je pouze příkladová; při nasazení bude nahrazena adresou konkrétního hotelu. Všechna popsaná volání používají metodu GET, autentizaci HTTP Basic a oprávnění stays:read. Úspěšná odpověď má stav 200 a typ application/json.

Stávající integrace načítá heatmap, pinmap a list každou minutu, mapu pokojů roompairs jednou za hodinu. Jedná se o doporučený způsob použití, nikoli o záruku okamžitého doručení. Změna se projeví při dalším úspěšném načtení a zpracování v cílovém systému.

curl --fail --silent --show-error \
  --connect-timeout 5 --max-time 15 \
  --user "$ELLIPSE_USER:$ELLIPSE_PASSWORD" \
  "https://hotel.example.com/api/stays/?type=roompairs"

Proměnné prostředí v příkladu zastupují přidělené přihlašovací údaje. Volání směřují na server nebo integrační bránu přes HTTPS. Přihlašovací údaje nepatří do veřejného JavaScriptu ani do URL.

Nejdůležitější je přiřazení pokojů. Klíč „12“ v odpovědi je ID konkrétní jednotky v hotelovém plánu. name: „202“ je číslo pokoje a id_room: „2“ označuje kategorii pokoje. Kategorie není ID zámku. V integraci tak vznikne vazba: jednotka 12 → pokoj 202 → konkrétní zámek a termostat.

Vytápění: plánujte podle obsazených nocí

Volání heatmap vrátí všechny aktivní jednotky a plán na dnešek plus dalších šest dní. Hodnota status: 1 označuje obsazenou noc, status: 0 volnou noc. Den, kdy host již pouze odjíždí, se nepovažuje za obsazenou noc.

GET /api/stays/?type=heatmap

Ukázka odpovědi je omezena na jednu jednotku; zachovává všech sedm dat:

{
  "12": {
    "id": "12", "name": "202", "id_room": "2",
    "statuses": [
      { "date": "2026-10-08", "status": 1 },
      { "date": "2026-10-09", "status": 0 },
      { "date": "2026-10-10", "status": 1 },
      { "date": "2026-10-11", "status": 1 },
      { "date": "2026-10-12", "status": 1 },
      { "date": "2026-10-13", "status": 0 },
      { "date": "2026-10-14", "status": 0 }
    ]
  }
}

Praktický scénář: regulace připraví na základě budoucí obsazenosti komfortní režim před příjezdem a útlum po odjezdu. Předstih i teploty jsou pravidly cílové regulace, nikoli hodnotami vracenými tímto API.

Pozor na ráno v den odjezdu: status: 0 neznamená, že host již odjel. Pro časová rozhodnutí použijte také údaje o délce pobytu a čase odjezdu. Heatmap není senzor přítomnosti osoby v pokoji; světla ani topení proto nevypínejte pouze na základě jedné hodnoty obsazenosti.

Přístupy: aktuálně platný PIN

Volání pinmap vrací aktuální PIN pro každou jednotku. PIN se aktivuje v den příjezdu až od času příjezdu uvedeného v rezervaci; pokud rezervace vlastní čas neuvádí, použije se výchozí čas hotelu. V den odjezdu platí do času odjezdu.

GET /api/stays/?type=pinmap
{
  "12": {
    "id": "12", "name": "202",
    "id_room": "2", "pin": "1234"
  },
  "13": {
    "id": "13", "name": "203",
    "id_room": "2", "pin": "5678"
  },
  "14": {
    "id": "14", "name": "204",
    "id_room": "2", "pin": "0"
  }
}

PIN „0“ znamená volný pokoj bez platného přístupu pro hosty. Integrace musí zrušit příslušné oprávnění pro hosty; nesmí nastavit číslici 0 jako přístupový kód. Ostatní PIN kódy jsou čtyřmístné řetězce. Zachovejte je jako text, aby se neztratila případná nula na začátku.

Výměna hostů v tentýž den: pokud čas příjezdu nového hosta již uplynul, API vrátí PIN nové rezervace. Integrační služba musí změnu promítnout do správného zámku a ověřit výsledek zápisu. Úspěšné načtení z API ještě nepotvrzuje úspěšné nastavení zařízení.

Toto volání poskytuje aktuální stav, nikoli budoucí harmonogram platnosti kódů. Podklad neuvádí podmínku zaplacení ani dokončeného online check-inu. Pokud hotel takové podmínky vyžaduje, musí být zvlášť ověřeny a vyřešeny v procesu vydávání přístupu.

Pobyty a mapa pokojů: kontext pro automatizaci

Pokud integrace potřebuje data a časy pobytu, použije seznam. Parametr date je povinný a má formát YYYY-MM-DD. S acmd=1 se vrátí všechny pobyty uvedené v seznamu v daný den, i před check-inem. Bez něj, tedy při acmd=0, zůstanou pouze pokoje, ve kterých je host již ubytován.

GET /api/stays/?type=list&date=2026-10-08&acmd=1
[
  {
    "room": "13", "roomname": "203",
    "reservation": "100001", "lang": "sk",
    "name": "Jméno", "surname": "Příjmení",
    "arrival": "2026-10-07",
    "departure": "2026-10-09",
    "a-time": "15:00:00", "d-time": "10:00:00",
    "pin": "5678", "phone": "+421900000000",
    "out_of_order": false
  }
]

room identifikuje jednotku. a-time a d-time jsou časy příjezdu a odjezdu daného pokoje. out_of_order: true označuje technickou uzavírku, nikoli teplotu. PIN v seznamu pobytů nepoužívejte jako důkaz aktuální platnosti; k tomu slouží pinmap.

V případě chybějícího nebo nesprávného data vrátí API stav 400 a odpověď {"error":"Date"}. Při pravidelném načítání se datum musí měnit; vzorové datum nesmí zůstat pevně nastaveno v produkční integraci.

Mapa roompairs přiřadí ID jednotky k číslu pokoje. Následuje výňatek z odpovědi:

GET /api/stays/?type=roompairs
{ "12": "202", "13": "203", "14": "204", "21": "303" }

Mapu načtěte při spuštění a následně ji aktualizujte. Při přesunu hosta nebo změně konfigurace hotelu ověřte také vazby na fyzická zařízení.

Jak z dat vznikne spolehlivá automatizace

Na straně Ellipse stačí číst jednotné API. Integrační služba poté porovná přijatý stav s posledním úspěšně aplikovaným stavem a prostřednictvím rozhraní výrobce provede potřebné změny. Opakované načítání stejného stavu by nemělo vytvářet duplicitní přístupové kódy ani zbytečné příkazy.

Doporučený postup integrátora:

  1. Získat přístup k hotelovému API s oprávněním stays:read a ověřit HTTPS připojení.
  2. Namapovat jednotky z roompairs na konkrétní zámky a regulátory.
  3. Načítat požadované stavy, kontrolovat HTTP odpověď i strukturu JSON.
  4. Vyhodnotit rozdíly a aplikovat je prostřednictvím rozhraní cílového systému.
  5. Potvrdit provedení, uložit čas poslední úspěšné synchronizace a upozornit na chybu.

Výpadek API není volný pokoj. Chybu, časový limit ani neúplnou odpověď nepřevádějte na pin: „0“ ani na příkaz k vypnutí topení. Předem nastavte maximální stáří dat, pravidla pro případ výpadku a ruční zásah. Při přístupech musí provoz zajistit také ukončení platnosti v případě nedostupné synchronizace; aktuální pinmap sám o sobě neobsahuje čas vypršení platnosti.

Při vytápění dodržujte místní zabezpečení zařízení a provozní minimum. Při přístupech hostovská synchronizace nemění servisní ani nouzová oprávnění. Hesla API a PIN kódy neukládejte do běžných protokolů. Z endpointu list zpracovávejte pouze údaje, které integrace potřebuje.

Před spuštěním otestujte dřívější příjezd, pozdější odjezd, prodloužení pobytu, změnu pokoje, výměnu hostů v rámci jednoho dne, technickou uzávěrku i výpadek sítě. S implementátorem API si ověřte časové pásmo, časové limity a chování při zrušení pobytu; dodaný podklad je podrobně nespecifikuje.

Stejné údaje mohou být základem dalších scénářů pro chytrou domácnost, například pro přípravu komfortního režimu pokoje. Jejich realizace závisí na funkcích cílového systému. Popsané API čte pobyty; příkazy pro zařízení provádí integrační vrstva.

Chcete propojit své technologie se systémem Ellipse? Zašlete nám název a model přístupového systému nebo regulace a kontakt na vašeho integrátora. Společně ověříme rozhraní, mapování pokojů a vhodný pilot. Domluvte si konzultaci nebo si prohlédněte hotelový systém Ellipse.

Ako vás tento článok oslovil?