Prepojenie prístupových systémov, kúrenie a smart home s Ellipse PMS

Hotel už vie, kto príde. Nech to vie aj technológia.

Recepcia má rezerváciu v PMS, kúrenie vlastný rozvrh a zámky ďalšiu administráciu. Keď sa pobyt predĺži alebo hosť zmení izbu, rovnakú informáciu treba preniesť na viac miest. Práve tieto opakované zásahy môže prevziať automatizácia.

Ellipse PMS sprístupňuje cez API údaje o pobytoch, obsadenosti a aktuálne platných PIN kódoch. Integračná služba ich pravidelne načíta a prevedie na príkazy pre konkrétny prístupový systém, reguláciu kúrenia alebo smart home.

Prepojiť možno ľubovoľný systém, ktorý umožňuje externé ovládanie cez vhodné rozhranie alebo bránu. Po jednorazovom nastavení môže výmena údajov prebiehať automaticky. Kompatibilitu a rozsah ovládania treba overiť pri konkrétnom zariadení; samotné API Ellipse nenahrádza ovládač jeho výrobcu.

Pre hotel to znamená menej prepisovania, jednotný zdroj informácií a možnosť pripraviť izbu podľa pobytu. Reálnu úsporu energie či času treba vyhodnotiť v prevádzke. API poskytuje podklady, konkrétne teploty a prevádzkové pravidlá nastavuje integrátor s hotelom.

Štyri volania, jeden zdroj údajov

Integrácia číta údaje z hotelovej adresy https://hotel.example.com/api/stays/. Doména je vzorová; pri nasadení sa nahradí adresou konkrétneho hotela. Všetky popísané volania používajú metódu GET, autentifikáciu HTTP Basic a oprávnenie stays:read. Úspešná odpoveď má stav 200 a typ application/json.

Existujúca integrácia načítava heatmap, pinmap a list každú minútu, mapu izieb roompairs raz za hodinu. Je to doložený spôsob použitia, nie garancia okamžitého doručenia. Zmena sa prejaví pri ďalšom úspešnom načítaní a spracovaní v cieľovom systéme.

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

Premenné prostredia v príklade zastupujú pridelené prihlasovacie údaje. Volania patria na server alebo integračnú bránu, cez HTTPS. Prihlasovacie údaje nepatria do verejného JavaScriptu ani do URL.

Najdôležitejšie je mapovanie izieb. Kľúč "12" v odpovedi je ID konkrétnej jednotky na hotelovej plachte. name: "202" je číslo izby a id_room: "2" označuje kategóriu izby. Kategória nie je ID zámku. V integrácii preto vznikne väzba: jednotka 12 → izba 202 → konkrétny zámok a termostat.

Kúrenie: plánujte podľa obsadených nocí

Volanie heatmap vráti všetky aktívne jednotky a plán na dnes plus šesť ďalších dní. Hodnota status: 1 označuje obsadenú noc, status: 0 voľnú noc. Deň, keď hosť už len odchádza, sa nepovažuje za obsadenú noc.

GET /api/stays/?type=heatmap

Ukážka odpovede je obmedzená na jednu jednotku; zachováva všetkých sedem dátumov:

{
  "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ý scenár: regulácia si podľa budúcej obsadenosti pripraví komfortný režim pred príchodom a útlm po odchode. Predstih aj teploty sú pravidlá cieľovej regulácie, nie hodnoty vracané týmto API.

Pozor na ráno v deň odchodu: status: 0 neznamená, že hosť už odišiel. Na časové rozhodnutia použite aj údaje o pobyte a čase odchodu. heatmap nie je senzor prítomnosti človeka v izbe; svetlá ani kúrenie preto nevypínajte iba podľa jednej hodnoty obsadenosti.

Prístupy: PIN platný práve teraz

Volanie pinmap vracia aktuálny PIN pre každú jednotku. PIN sa aktivuje v deň príchodu až od času príchodu rezervácie; ak rezervácia vlastný čas nemá, použije sa predvolený čas hotela. V deň odchodu platí do času odchodu.

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á voľnú izbu bez platného hosťovského prístupu. Integrácia má zrušiť príslušné hosťovské oprávnenie; nesmie nastaviť číslicu 0 ako prístupový kód. Ostatné PIN kódy sú štvorciferné reťazce. Zachovajte ich ako text, aby sa nestratila prípadná nula na začiatku.

Výmena hostí v ten istý deň: ak čas príchodu nového hosťa už prešiel, API vráti PIN novej rezervácie. Integračná služba musí premietnuť zmenu do správneho zámku a overiť výsledok zápisu. Úspešné načítanie API ešte nepotvrdzuje úspešné nastavenie zariadenia.

Toto volanie poskytuje aktuálny stav, nie budúci harmonogram platnosti kódov. Podklad neuvádza podmienku zaplatenia ani dokončeného online check-inu. Ak hotel takéto podmienky vyžaduje, musia byť osobitne overené a vyriešené v procese vydávania prístupu.

Pobyty a mapa izieb: kontext pre automatizáciu

Keď integrácia potrebuje dátumy a časy pobytu, použije list. Parameter date je povinný a má formát YYYY-MM-DD. S acmd=1 sa vrátia všetky pobyty umiestnené na plachte v daný deň, aj pred check-inom. Bez neho, teda pri acmd=0, zostanú len izby, kde je hosť už ubytovaný.

GET /api/stays/?type=list&date=2026-10-08&acmd=1

[
  {
    "room": "13", "roomname": "203",
    "reservation": "100001", "lang": "sk",
    "name": "Meno", "surname": "Priezvisko",
    "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 sú časy príchodu a odchodu danej izby. out_of_order: true označuje technickú uzávierku, nie teplotu. PIN v zozname pobytov nepoužívajte ako dôkaz aktuálnej platnosti; na to slúži pinmap.

Pri chýbajúcom alebo nesprávnom dátume vráti API stav 400 a odpoveď {"error":"Date"}. Pri pravidelnom načítavaní sa dátum musí meniť; vzorový dátum nesmie zostať napevno v produkčnej integrácii.

Mapa roompairs priradí ID jednotky k číslu izby. Nasleduje výrez odpovede:

GET /api/stays/?type=roompairs

{ "12": "202", "13": "203", "14": "204", "21": "303" }

Mapu načítajte pri štarte a následne ju obnovujte. Pri presune hosťa alebo zmene konfigurácie hotela overte aj väzby na fyzické zariadenia.

Ako z údajov vznikne spoľahlivá automatizácia

Na strane Ellipse stačí čítať jednotné API. Integračná služba potom porovná prijatý stav s posledným úspešne aplikovaným stavom a cez rozhranie výrobcu vykoná potrebné zmeny. Opakované načítanie rovnakého stavu nemá vytvárať duplicitné prístupové kódy ani zbytočné príkazy.

Odporúčaný postup integrátora:

1. Získať prístup k hotelovému API s oprávnením stays:read a overiť HTTPS pripojenie.
2. Namapovať jednotky z roompairs na konkrétne zámky a regulátory.
3. Načítavať požadované stavy, kontrolovať HTTP odpoveď aj štruktúru JSON.
4. Vyhodnotiť rozdiely a aplikovať ich cez rozhranie cieľového systému.
5. Potvrdiť vykonanie, uložiť čas poslednej úspešnej synchronizácie a upozorniť na chybu.

Výpadok API nie je voľná izba. Chybu, timeout alebo neúplnú odpoveď neprekladajte na pin: "0" ani na pokyn vypnúť kúrenie. Vopred nastavte maximálny vek údajov, pravidlá pri výpadku a manuálny zásah. Pri prístupoch musí mať prevádzka vyriešené aj ukončenie platnosti pri nedostupnej synchronizácii; aktuálny pinmap sám neobsahuje čas expirácie.

Pri kúrení rešpektujte lokálnu ochranu zariadení a prevádzkové minimum. Pri prístupoch nemení hosťovská synchronizácia servisné ani núdzové oprávnenia. API heslá a PIN kódy neukladajte do bežných logov. Z endpointu list spracúvajte iba údaje, ktoré integrácia potrebuje.

Pred spustením otestujte skorší príchod, neskorší odchod, predĺženie pobytu, presun izby, výmenu hostí v jeden deň, technickú uzávierku aj výpadok siete. S implementátorom API si potvrďte časové pásmo, hraničné časové okamihy a správanie pri zrušení pobytu; dodaný podklad ich podrobne nešpecifikuje.

Rovnaké údaje môžu byť základom ďalších smart home scenárov, napríklad prípravy komfortného režimu izby. Ich realizácia závisí od funkcií cieľového systému. Popísané API číta pobyty; príkazy zariadeniam vykonáva integračná vrstva.

Chcete prepojiť vaše technológie s Ellipse? Pošlite nám názov a model prístupového systému alebo regulácie a kontakt na vášho integrátora. Spolu preveríme rozhranie, mapovanie izieb a vhodný pilot. Dohodnite si konzultáciu alebo si pozrite hotelový systém Ellipse.