Manuál k webovému klientovi hotelového systému Qasida Horec. Je určený naraz pre dve cieľové
skupiny a podľa toho je aj členený:
- Koncový používateľ (recepcia, prevádzka) — kapitoly 1 – 6. Ako sa prihlásiť a ako viesť dennú
prevádzku hotela: mapa obsadenosti, rezervácie, pobyty, účty, faktúry, kartotéka hostí, ceny.
- Administrátor (správca hotela / IT) — kapitoly 7 – 11. Nastavenie číselníkov, predajných
kanálov, externých systémov, roly a oprávnenia a technické predpoklady prevádzky.
- Prihlásenie a prvé kroky
- Orientácia v aplikácii
- Prehľad (dashboard)
- Denná prevádzka — mapa obsadenosti
- Rezervácie, pobyty a účty
- Kartotéka hostí, faktúry a cenový kalendár
- Nastavenia — číselníky
- Predajné kanály
- Externé systémy a konfigurácia
- Roly a oprávnenia
- Riešenie problémov a technické predpoklady
🖼️ [Obrázok: prihlasovacia obrazovka IAM a stránka „Prístup zamietnutý".]
- Ak prihlásenie zlyhá, zobrazí sa stránka „Prihlásenie zlyhalo" s tlačidlom Skúsiť znova.
- Ak ste prihlásený, ale nemáte pridelené oprávnenie na aplikáciu, zobrazí sa „Prístup
zamietnutý — Nemáte oprávnenie na aplikáciu QASIDA HOREC. Obráťte sa na správcu." V tomto
prípade musí oprávnenie doplniť administrátor (pozri kapitolu 10).
- Relácia sa po čase automaticky obnovuje. Ak vyprší (napr. po dlhej nečinnosti), aplikácia vás
pri ďalšej akcii vyzve na opätovné prihlásenie.
🖼️ [Obrázok: hlavička s prepínačom hotela, prevádzky, jazyka, tmavého režimu a menu účtu.]
Vpravo hore v hlavičke sú ovládače, ktoré platia pre celú aplikáciu:
| Ovládač |
Čo robí |
| Hotel / Tenant |
Prepínač hotela. Zobrazí sa, len ak má vaše konto priradených viac hotelov; pri jedinom sa hotel vyberie automaticky a prepínač sa skryje. Voľba sa pamätá. |
| Prevádzka |
Prepínač prevádzky (pobočky). Zobrazí sa, keď existuje aspoň jedna prevádzka. Aktívna prevádzka určuje, do ktorého hotela zapisuje Channel Manager a odkiaľ sa berú niektoré prevádzkové údaje. Voľba sa pamätá. |
| Tmavý režim |
Prepnutie svetlého a tmavého vzhľadu. |
| Jazyk |
Jazyk rozhrania — SK, CS, EN, DE, PL, HU. Predvolený je slovenčina. |
| Účet |
Meno prihláseného používateľa a Odhlásiť sa. |
Dôležité: Výber prevádzky si väčšina obrazoviek nevyžaduje — bez vybranej prevádzky fungujú
rovnako. Prevádzku vyžaduje najmä modul Channel Manager. Ak v Channel Manageri narazíte na
hlášku „Pobočka nie je vybraná / pridelená", pozri kapitolu 11.
V menu Účet (vpravo hore) zvoľte Odhlásiť sa. Tým sa odhlásite z aplikácie.
- Ľavé menu (sidebar) — hlavná navigácia. Má tri režimy podľa šírky okna: plný stĺpec,
úzka ikonová lišta a vysúvacia zásuvka na úzkych obrazovkách. Menu je stromové — skupiny
(napr. Nastavenia → Izby a lôžka → Typy izieb) sa rozbaľujú klikom.
- Hlavička (navbar) — ovládače z kapitoly 1.2 a tlačidlo na prepnutie menu.
- Telo stránky — nadpis obrazovky, drobčeková cesta (ukazuje, kde v strome sa nachádzate)
a akcie vpravo hore (napr. Nový, Uložiť).
🖼️ [Obrázok: typický zoznam s hľadaním, filtrom v stĺpci, stránkovaním a prepínačom hustoty.]
Väčšina zoznamov používa jednotnú tabuľku s rovnakými ovládačmi:
- Hľadanie — pole Hľadať… nad tabuľkou prehľadáva naraz viac stĺpcov.
- Filter v stĺpci — v hlavičke stĺpca (napr. Áno/Nie, výber stavu).
- Triedenie — klik na názov stĺpca.
- Stránkovanie — počet riadkov na stranu a navigácia medzi stranami dole.
- Hustota riadkov — Kompaktná / Komfortná.
- Obnoviť — znovu načíta údaje.
- Zrušiť hľadanie a filtre — vráti tabuľku do východiskového stavu.
Rozlišujú sa dva druhy zoznamov podľa toho, kde prebieha filtrovanie:
- Číselníky (nastavenia) sa načítajú celé a filtrovanie prebieha v prehliadači — sú to desiatky
až stovky riadkov.
- Prevádzkové zoznamy (hostia, rezervácie, pobyty, faktúry) stránkuje, triedi a filtruje
server, lebo riadkov môžu byť tisíce.
- Povinné polia sú označené; pri chybnom vyplnení sa zobrazí hláška pod poľom.
- Neuložené zmeny — ak opustíte rozrobený formulár (klik do menu, tlačidlo Späť v prehliadači),
aplikácia sa spýta „Formulár obsahuje neuložené zmeny. Naozaj ho chcete zavrieť?" s voľbami
Zahodiť zmeny / Pokračovať v úprave.
- Súbežná zmena (optimistický zámok) — ak záznam medzitým zmenil niekto iný, uloženie skončí
hláškou „Záznam medzičasom zmenil niekto iný. Načítajte ho znovu." Zmena sa neprepíše ticho —
načítajte si aktuálny stav a posúďte ho.
- Potvrdzovacie dialógy sa používajú pri nevratných a dôležitých akciách (mazanie, zrušenie
rezervácie, vystavenie faktúry).
- Toasty (krátke hlášky v rohu) potvrdzujú úspešné akcie alebo hlásia chybu.
🖼️ [Obrázok: dlaždice Obsadenosť, Dnešné príchody, Dnešné odchody, V hoteli.]
Úvodná obrazovka po prihlásení (Prehľad). Ukazuje prevádzkový stav hotela k dnešnému dňu:
- Obsadenosť — koľko izieb je obsadených, s informáciou Voľné izby: X z Y.
- Dnešné príchody a Dnešné odchody — plánované vs. skutočné.
- V hoteli — obývané izby na dnešnú noc vrátane hostí bez rezervácie.
Ak hotel ešte nemá zavedenú ani jednu izbu, dlaždica obsadenosti to oznámi. Pri chybe načítania je
k dispozícii tlačidlo Skúsiť znova.
🖼️ [Obrázok: celá mapa obsadenosti — izby po poschodiach, pruhy pobytov nad dňami, panel Prehľad dňa, pás „pod čiarou".]
Mapa obsadenosti je hlavný nástroj recepcie — izby po poschodiach, pobyty ako farebné pruhy nad
dňami a nepriradené rezervácie „pod čiarou". Nájdete ju v menu hneď pod Prehľadom.
- Riadky sú izby, zoskupené podľa poschodí (a prevádzok). Stĺpce sú dni.
- Pruh nad dňami je pobyt alebo rezervácia; jeho farba zodpovedá stavu: Dopyt, Potvrdená,
Ubytovaná, Odhlásená.
- Pod čiarou sú rezervácie, ktoré ešte nemajú pridelenú izbu.
- Blokácie (Mimo prevádzky, Mimo predaja) sú vyznačené samostatne.
- Šírka zobrazenia sa prepína medzi Deň, Mesiac a 3 mesiace. Obdobie posúvate tlačidlami
Predchádzajúce / Nasledujúce obdobie, prípadne veľkým skokom; Dnes vás vráti na aktuálny deň.
- Celá obrazovka skryje okolie a zväčší mriežku.
- Mapa sa živo aktualizuje — zmeny z iných staníc sa premietnu bez obnovenia.
Nad mapou je panel ukazovateľov k vybranému dňu: Obsadenosť, Príchody, Odchody, Voľné izby,
ADR, RevPAR, Mimo prevádzky. Ak v daný deň nie je ani jedna nočná položka, ADR a RevPAR sa
nevypočítajú (oznámi to hláška).
- Filtre zúžia zobrazené izby podľa prevádzky, poschodia, typu izby, cenového rozpätia (s menou)
či textu (meno hosťa / číslo rezervácie).
- Vyhľadať voľnú kapacitu — zadáte termín, počet hostí (dospelí/deti/bábätká), prípadne cenové
rozpätie a kvalitatívne parametre; aplikácia ukáže, koľko a akých izieb je voľných, s orientačnou
cenou, a umožní rovno Založiť rezerváciu.
🖼️ [Obrázok: panel „Nová rezervácia z recepcie" a panel walk-in ubytovania s rozložením lôžok.]
Tlačidlo Vytvoriť (alebo označenie buniek priamo v mriežke) ponúka:
- Nová rezervácia — označíte izbu a noci, vyberiete cenový plán, zadáte hosťa (meno,
priezvisko, e-mail, telefón, vek. hladina) a počty osôb. Banner priebežne ukazuje Nocí a
Predpokladanú cenu. Potvrdíte Založiť rezerváciu.
- Nová skupinová rezervácia — viac izieb naraz pod jedného kontaktného hosťa skupiny; pre každý
typ izby sa vyberie cenový plán. Izby bez menovaného hosťa sa vedú na kontaktného hosťa skupiny.
- Ubytovanie bez rezervácie (walk-in) — na bunke dnešného dňa založí pobyt s príchodom
„teraz" a hlavný účet. Hosťa vyberiete z kartotéky alebo zadáte nového; voliteľne číslo
dokladu totožnosti a poznámku. Po založení môžete rovno Otvoriť účet. Ak už hosť s rovnakým
menom, priezviskom a e-mailom v kartotéke je, použije sa existujúci.
- Skupinový walk-in — viac izieb naraz, každá s vlastným hlavným hosťom a vlastným účtom; údaje
sa dajú kopírovať do ďalšej izby.
- Rozloženie na lôžka — pri type izby s prístelkami vyberiete typ lôžka pre každého hosťa
(pevné lôžka sú predvolené, prístelku možno obsadiť až po pevnom lôžku).
- Pridelenie izby — rezervácii „pod čiarou" priradíte izbu; ponúkajú sa len vhodné (voľné,
rovnakého typu, tej istej prevádzky).
- Presun (drag & drop) — pruh potiahnete na inú izbu alebo iný termín. Aplikácia odmietne
neplatný presun (obsadená či blokovaná izba, iný typ izby, iná prevádzka, prihlásený hosť).
- Zmena termínu ťahaním okraja — potiahnutím za začiatok/koniec pruhu zmeníte deň príchodu
alebo odchodu (predĺženie/skrátenie).
- Zrušiť priradenie — odpojí rezerváciu od izby, vráti ju pod čiaru.
- Blokovať izbu — vytvorí blokáciu (Mimo prevádzky / Mimo predaja) na zvolený počet
nocí s dôvodom (napr. údržba).
Všetky akcie majú potvrdenie a zrozumiteľné chybové hlášky (napr. „Izba je v tom termíne už
obsadená. Vyberte inú.").
Vlastné zobrazovacie voľby (riadok s mesiacom, dátumová lišta pri prejdení myšou, nepriehľadnosť
a rozmazanie „skla") sa nastavujú v Nastavenia → Konfigurácia systému → Mapa obsadenosti a
ukladajú sa per prehliadač. Farebné zvýraznenie období a víkendov je tiež tam (pozri 9.3).
🖼️ [Obrázok: zoznam rezervácií s filtrom a stavmi; detail rezervácie s akciami potvrdiť/prihlásiť/odhlásiť.]
Menu Rezervácie je prehľad rezervácií prijatých z webu hotela a z OTA. Rezervácie v PMS
nevznikajú ručným zápisom v tomto zozname — vznikajú v predajných kanáloch (web, OTA) alebo
z mapy obsadenosti; tu ich recepcia spravuje.
Zoznam je zoradený podľa dátumu príchodu. Nad tabuľkou zadáte rozsah príchodu, v hlavičke
stĺpca vyberiete stav. Stĺpce: Číslo, Príchod, Odchod, Nocí, Izieb, Hostí, Cena, Kontakt,
Stav, Kanál (Web / OTA / Recepcia / Skupina).
Detail rezervácie zobrazuje všetky údaje, hostí s kontaktom a pridelené izby a ponúka akcie
(životný cyklus rezervácie):
| Akcia |
Význam |
| Potvrdiť rezerváciu |
Z dopytu spraví potvrdenú; od potvrdenia drží izbu a termín prestáva byť v predaji. |
| Prihlásiť hosťa (check-in) |
Vznikne pobyt. Vyžaduje menovaného hosťa aj pridelenú izbu. |
| Odhlásiť hosťa (check-out) |
Ukončí pobyt, izba sa označí za špinavú. Dá sa vrátiť do dňa odchodu vrátane. |
| Vrátiť odhlásenie |
Vráti hosťa medzi ubytovaných. |
| Označiť nepríchod (no-show) |
Termín sa vráti do predaja, rezerváciu už nemožno prihlásiť. Dá sa až v deň príchodu. |
| Pridať hosťa |
Doplní hosťa k rezervácii (prípadne nahradí zástupného hosťa z webu). |
| Zrušiť rezerváciu |
Vyžaduje dôvod; zrušenie sa tu nedá vrátiť. |
| Otvoriť účet |
Otvorí hlavný účet rezervácie/pobytu. |
🖼️ [Obrázok: detail pobytu — hostia, izby a účty pobytu, akcie Predĺžiť/skrátiť a Pridať hosťa.]
Menu Pobyty — hostia, ktorí sa reálne ubytovali (z rezervácie aj walk-in). Predvolene sa
zobrazujú pobyty, ktoré sú v hoteli v dnešný deň prevádzky; filtrovať sa dá podľa stavu
(Ubytovaný / Odhlásený), dňa „v hoteli", prevádzky a rozsahu príchodu.
Detail pobytu ukazuje hostí, pridelené izby a účty pobytu. Akcie:
- Predĺžiť / skrátiť pobyt — zmena plánovaného odchodu (najskôr dnes, najviac 365 nocí od
príchodu). Aplikácia odmietne termín, ak izbu v nových nociach drží iný pobyt, je blokovaná,
obmedzuje ho cenový plán alebo chýba cena/dostupnosť.
- Pridať hosťa — hosťa vyberiete z kartotéky (nového najprv založte v kartotéke).
- Nastaviť ako hlavného / Odobrať hosťa — v zozname hostí pobytu; hlavného hosťa nemožno
odobrať, kým nenastavíte iného.
🖼️ [Obrázok: účet so zaúčtovanými položkami, rozpis DPH a dialóg Zaúčtovať službu/balíček.]
Účet sa neotvára zo samostatného menu — otvoríte ho od rezervácie alebo pobytu (tlačidlo
Otvoriť účet, prípadne z detailu pobytu, ktorý vypisuje všetky účty). Účet obsahuje zaúčtované
položky a ich súčet, stav (Otvorený / Zatvorený), druh (Hlavný / Vedľajší) a vlastníka.
Akcie na otvorenom účte:
- Zaúčtovať položku — ručná položka: popis, množstvo, jednotková cena (vrátane dane), prípadne
daň. Deň doplní server podľa prevádzkového dňa.
- Pridať službu / tovar — položka z katalógu služieb a tovarov (s možnosťou filtrovať podľa
kategórie a druhu); cena z katalógu sa dá prepísať.
- Zaúčtovať balíček — balíček služieb; pri zaúčtovaní sa rozbalí na samostatné riadky, každý
s cenou a daňou svojej položky. Zadáte počet balíčkov.
- Vystaviť faktúru — z celého účtu. Vystavením sa účet zatvorí, faktúra sa potom už nemení
a na účet sa ďalej neúčtuje (pozri 6.2). Ak už účet faktúru má, aplikácia ponúkne jej otvorenie.
Zatvorený účet ďalšie položky neprijme. Pri každej položke sa zobrazuje rozpis DPH.
🖼️ [Obrázok: zoznam hostí a detail hosťa so sekciami Osobné údaje, Adresa, Ostatné, Mestská daň.]
Menu Hostia — kontaktné a osobné údaje hostí hotela. Je to prevádzkový zoznam (stránkuje
server). Stĺpce: Priezvisko, Meno, E-mail, Telefón, Dátum narodenia, Mesto, Nežiadúci, Aktívny.
Detail hosťa je členený na sekcie:
- Osobné údaje — titul/oslovenie, meno, priezvisko, e-mail, telefón, dátum narodenia, rodné
číslo (osobný údaj — v zozname sa nezobrazuje).
- Adresa — ulica, číslo popisné/orientačné, mesto, PSČ, krajina.
- Ostatné — Nežiadúci hosť (príznak sa nezobrazí ako skrytie záznamu, ale je viditeľný
v zoznamoch a na rezerváciách), Aktívny, interná Poznámka (hosťovi sa nezobrazuje).
- Mestská daň — ručné oslobodenia od mestskej dane priradené hosťovi (automatické podľa
veku a pobytu vyhodnotí systém sám).
Nového hosťa založíte tlačidlom Nový hosť.
🖼️ [Obrázok: detail faktúry — dodávateľ, odberateľ, položky, rozpis DPH a celky.]
Menu Faktúry — vystavené faktúry. Faktúra vzniká z účtu akciou Vystaviť faktúru a po
vystavení sa už nemení. Filtrovať sa dá podľa rozsahu dátumu vystavenia, čísla faktúry a prípadne
jedného účtu.
Detail faktúry je snímka účtu v okamihu vystavenia: doklad (dátumy vystavenia, dodania,
splatnosti), dodávateľ, odberateľ (hosť alebo firma vrátane IČO/DIČ/IČ DPH/IBAN), položky, rozpis
DPH a celky. Z detailu sa dá otvoriť pôvodný účet.
Aby sa dala faktúra vystaviť, musí byť v Nastavenia → Číslovanie dokladov zavedený číselný
rad pre typ dokladu Faktúra (pozri 7.8).
🖼️ [Obrázok: mesačná mriežka cien pre cenový plán, formulár Nastaviť rozsah a Kopírovať rozsah.]
Menu Cenový kalendár — denné ceny a predajné obmedzenia pre cenové plány. Nie je to číselník:
nespravuje záznamy, ale rozsahy dní.
- Vyberiete cenový plán a mesiac.
- Nastaviť rozsah — pre obdobie Od – Do zadáte cenu za noc a prípadne obmedzenia:
minimálny pobyt pri príchode / priebežne, maximálny pobyt, zatvorené pre príchod, zatvorené pre
odchod, zastavený predaj. Obmedzenia sa menia len pri zapnutej voľbe Meniť obmedzenia — inak
zostanú nedotknuté.
- Kopírovať rozsah — prenesie ceny (a voliteľne aj obmedzenia) zo zdrojového obdobia do cieľového.
Tieto ceny a obmedzenia sa posielajú aj na OTA kanály a používajú sa pri rezervácii cez vlastný web.
Vetva Nastavenia v menu obsahuje konfiguráciu hotela. Číselníky majú jednotné správanie:
zoznam (s hľadaním a mriežkou), Nový záznam, detail/formulár a mazanie s potvrdením. Spoločné
polia väčšiny číselníkov sú Kód (skratka, veľkými písmenami, jedinečná), Názov, Aktívny
(neaktívny záznam sa už neponúka v nových dátach, na existujúcich zostáva) a Poradie (nižšie
číslo je vyššie v ponuke).
Záznam, ktorý sa už niekde používa, zvyčajne nejde zmazať — namiesto toho ho vypnite
(Aktívny = nie). Záznam založený v Channexe sa pred zmazaním musí najprv odobrať z Channexu.
🖼️ [Obrázok: detail prevádzky — mena, adresa, kontakt, súradnice, časové pásmo.]
Prevádzka je hotel sám. Jej údaje idú do Channexu ako objekt (property), takže bez nej sa
nedá spustiť predaj cez OTA. Okrem kódu a názvu: mena, adresa (krajina — posiela sa dvojznakový
kód, mesto, ulica, PSČ), kontaktný e-mail a telefón, súradnice (šírka a dĺžka sa vypĺňajú
spolu) a časové pásmo. Menu, adresu a súradnice si vyžiada onboarding do Channexu.
🖼️ [Obrázok: detail typu izby so zoznamom lôžok; detail izby s typom izby a kvalitatívnymi parametrami.]
- Typy lôžok — kapacita (pre koľko osôb), poradie a rozlíšenie pevné lôžko / prístelka /
detská postieľka. Postieľka sa nepočíta do kapacity pre dospelých.
- Typy izieb — kód, názov a lôžka, z ktorých sa typ izby skladá (typ lôžka, počet, poradie).
Typ izby musí mať aspoň jedno lôžko. Ďalej druh izby (Izba / Spoločná spálňa) a max. počet detí.
- Izby — číslo izby, typ izby (povinný — určuje kapacitu, cenu aj distribúciu), prevádzka,
poschodie, výmera (m²), poradie, interná poznámka, kvalitatívne parametre (zaškrtnete, čo
izba má) a stav upratovania (Čistá / Špinavá / Skontrolovaná — ukladá sa hneď po kliknutí).
- Kvalitatívne parametre — číselník vlastností izby (balkón, výhľad na hory, klimatizácia),
ktoré sa potom na izbe zaškrtávajú.
🖼️ [Obrázok: číselník DPH s obdobím platnosti a detail cenového plánu (typ izby, stravovanie, spôsob predaja).]
- Meny — podľa ISO 4217. Kód, názov, symbol a kód pre e-fakturáciu sú globálne (len na čítanie);
hotel nastavuje, ktoré meny používa, ich poradie a domácu menu (práve jedna — mena, v
ktorej hotel účtuje).
- DPH — sadzby DPH: kategória, sadzba (%), zahrnutá v cene / pripočítavaná, fiškálna hladina
(A–Z) a obdobie platnosti. Dve sadzby rovnakej kategórie nesmú mať prekrývajúce sa obdobie.
- Mestská daň — logika výpočtu (za osobu a noc / za izbu a noc), sadzba, zahrnutie v cene,
predvolená (najviac jedna), obdobie platnosti a pravidlá uplatnenia (dôvody oslobodenia).
- Dôvody oslobodenia — od mestskej dane: spôsob vyhodnotenia (podľa veku / podľa pobytu —
automaticky; ručne — priraďuje sa na karte hosťa) a prípadný vekový interval.
- Stravovacie plány — typ stravovania (Bez stravy, Raňajky, Polpenzia, Plná penzia, All
inclusive) a poradie. Typ sa posiela do Channexu.
- Vekové hladiny — vekový interval a percento z ceny dospelého. Intervaly sa nesmú prekrývať.
- Cenové plány — typ izby (po založení sa nemení), stravovanie, spôsob predaja (za izbu /
za osobu), cena za dieťa (% z ceny dospelého), poradie. Plán sa páruje s cenníkom v Channexe a
zadávajú sa nad ním denné ceny v cenovom kalendári.
- Oslovenia — pán, pani, tituly.
- Kategórie hostí — napr. firemný, stály, VIP.
- Typy dokladov totožnosti — len na čítanie, spravuje dodávateľ.
- Zdroje rezervácií — recepcia, web, OTA kanál; externý kód (na mapovanie) a východiskový
stav rezervácie z tohto kanála (Potvrdená / Dopyt).
- Spôsoby platby — a kde sa smú použiť (na účte, na doklade, na mestskú daň, do dennej tržby).
- Pracovné stanice — fiškálny typ a či na stanici smú vznikať účty a faktúry. Príznaky sa
zatiaľ len ukladajú — kontrola práv ich ešte nečíta.
- Kategórie služieb — zoskupenie ponuky (wellness, minibar, reštaurácia…).
- Služby a tovary — účtované položky: druh (Služba / Tovar — po založení sa nemení), merná
jednotka, cena (vrátane dane), daň (len DPH počítaná percentom), kategória.
- Balíčky služieb — pomenované zostavy položiek s množstvom. Balíček nemá vlastnú cenu — pri
zaúčtovaní sa rozbalí na samostatné riadky.
- Krajiny — podľa ISO 3166-1 (249 záznamov). Kód a názov sú globálne; hotel nastavuje vízovú
povinnosť, poradie, priradenú menu a dostupnosť.
- Jazyky — globálny číselník, len na čítanie.
🖼️ [Obrázok: detail číselného radu s predponou, počtom číslic, nulovaním a ukážkou prvého čísla.]
Číselné rady dokladov — predpona, rok, poradové číslo (počet číslic), prípona a nulovanie (bez /
ročne / mesačne) pre každý typ dokladu. Rad bez prevádzky je predvolený a platí pre každú
prevádzku, ktorá nemá vlastný. Bez číselného radu sa doklad (faktúra) nedá vystaviť. Keď už
boli z radu pridelené čísla, kľúčové prvky čísla sa nedajú meniť a rad sa nedá zmazať — namiesto
toho sa vypne a založí nový. Formulár zobrazuje ukážku prvého čísla.
Qasida Horec predáva dvoma rovnocennými kanálmi nad tým istým jadrom: OTA portály cez Channel
Manager (Channex) a vlastný web hotela cez Rezervačný engine.
🖼️ [Obrázok: obrazovka Pripojenie so stavom integrácie; mapovanie izieb a cenníkov; log synchronizácie.]
Vetva Channel Manager. Spravuje napojenie hotela na OTA portály cez službu channex.io.
Vyžaduje vybranú prevádzku a jej pridelenie prihlásenému účtu.
- Pripojenie — pripojenie prevádzky na Channex: prostredie (Staging / Produkcia), referencie
na kľúče v Key Vaulte, zapnutie/vypnutie synchronizácie a stav integrácie (fáza onboardingu,
semafor synchronizácie, ID pobočky v Channexe, webhook, posledná plná synchronizácia). Akcie:
- Spustiť onboarding — vytvorí pobočku v Channexe, prenesie typy izieb, cenníky a dane a
zaregistruje webhook. Opakované spustenie pokračuje tam, kde sa zastavilo.
- Spustiť plnú synchronizáciu — odošle celú dostupnosť a ceny do Channexu.
- Mapovanie izieb — priradenie typov izieb Qasida Horec k typom izieb v Channexe; zapínanie
distribúcie cez OTA a ručné spárovanie.
- Mapovanie cenníkov — priradenie cenových plánov k cenníkom v Channexe (kľúč je trojica
cenový plán × typ izby × typ stravy). Umožňuje spárovať existujúci cenník, vytvoriť nový
v Channexe alebo zrušiť spárovanie.
- OTA kanály — pripojenie a nastavenie jednotlivých OTA kanálov priamo v rozhraní Channexu
(vložené cez zabezpečený rámec). Zmeny urobené v Channexe sa k nám neohlásia samy — stav si
overte na Pripojení a v Logu synchronizácie.
- Nastavenia synchronizácie — informačná obrazovka: zapnutie/vypnutie, prostredie a kľúče sa
nastavujú na Pripojení; interval synchronizácie, cenové limity a nastavenia per kanál zatiaľ
serverové rozhranie Channexu nemá.
- Log synchronizácie — história odosielania dostupnosti, cien a obmedzení do Channexu (čas,
typ, počet položiek, trvanie, stav).
- Log rezervácií — rezervácie prijaté z OTA kanálov vrátane stavu potvrdenia (ACK) a spracovania.
Poznámka: Semafor synchronizácie (zelená/žltá/červená) a jeho dôvody (odložené zmeny,
zaostávanie, neopraviteľné rezervácie…) nájdete na Pripojení a v detailoch logov.
🖼️ [Obrázok: nastavenie rezervačného enginu — ponuka izieb a plánov, branding, povolené originy.]
Menu Rezervačný engine — nastavenie vlastného predajného kanála na webe hotela:
- Predaj cez web zapnutý — vypnutý engine neponúkne hosťovi nič.
- Typy izieb a cenové plány v ponuke — buď Všetky, alebo Len vybrané.
- Storno podmienky — text, ktorý hosť uvidí pred potvrdením.
- Branding — logo, hlavná a doplnková farba, jazyky verejných stránok.
- Povolené originy webu hotela — odkiaľ smie web volať engine (bez nich sa web k enginu
z prehliadača nedostane).
- Platobná brána — pripravuje sa, hodnota sa zatiaľ len zobrazuje.
🖼️ [Obrázok: verejná stránka hotela — vyhľadanie termínu, ponuka izieb a plánov, potvrdenie rezervácie.]
Hosť rezervuje na verejnej adrese hotela (/book/<hotel>), bez prihlásenia. Zadá termín a počty
hostí, vyhľadá voľné ubytovanie, vyberie typ izby a cenový plán, rozloženie na lôžka, zadá
kontakt (e-mail, telefón) a záväzne rezervuje. Po potvrdení dostane číslo rezervácie.
Rezervácia sa objaví v menu Rezervácie s kanálom Web hotela.
🖼️ [Obrázok: nastavenie Zámkových systémov (VConnect) a stav pripojenia s testom spojenia.]
Nastavenia → Externé systémy → Zámkové systémy — pripojenie prevádzky na zámky ASSA ABLOY cez
VConnect (kľúčové karty a mobilné kľúče). Zadáte údaje VConnectu, ktoré pridelila ASSA ABLOY
(adresa API, property, chain, používateľ, heslo, čakanie). Po uložení dostanete adresu a
prihlásenie pre webhook, ktoré zadáte vo VConnecte, aby posielal udalosti do systému. K dispozícii
je Otestovať spojenie, obnovenie stavu a vygenerovanie nového hesla webhooku.
Heslo webhooku sa pri generovaní zobrazí iba raz — odovzdajte ho hneď kontaktu vo VConnecte.
Nastavenia → Externé systémy → PayTV — in-room funkcie cez to isté pripojenie ako Zámkové
systémy: účtovanie z televízora (minibar, filmy), Nerušiť (DND) a budenie cez TV. Vyžaduje, aby
bolo najprv nastavené pripojenie v Zámkových systémoch.
Nastavenia → Konfigurácia systému → Mapa obsadenosti:
- Zobrazovacie voľby mapy (riadok s mesiacom, dátumová lišta, nepriehľadnosť a rozmazanie skla)
— ukladajú sa per prehliadač.
- Zvýraznenie období a víkendov — farebné zvýraznenie na mape, zdieľané pre celý podnik:
jedna farba pre víkendy a ľubovoľné obdobia (sezóny, sviatky, podujatia) s farbou, dátumom
alebo rozsahom, prípadne každoročným opakovaním, priradené vybraným prevádzkam.
IAM udeľuje pre aplikáciu QASIDAHOREC dve role — ADMIN a USER. Rola je viazaná na hotel,
takže to isté konto môže byť v jednom hoteli ADMIN a v inom USER.
Aby používateľ aplikáciu vôbec použil, musia platiť naraz dve nezávislé podmienky:
- Licencia (v systéme ALIS) hovorí, či daný hotel modul má.
- Oprávnenie (v IAM) hovorí, či ho daný používateľ smie použiť.
Dôležité upozornenie pre administrátorov. V aktuálnom stave rozdiel medzi rolami ADMIN a
USER vynucuje iba používateľské rozhranie — server pri volaniach overuje podpis prihlásenia,
príslušnosť k aplikácii a členstvo v hoteli, ale samotnú rolu zatiaľ žiadny endpoint nekontroluje.
Kontrola v prehliadači preto nie je bezpečnostná hranica. Pri prideľovaní prístupov s tým počítajte.
| Hláška |
Význam a riešenie |
| Prístup zamietnutý — nemáte oprávnenie na QASIDA HOREC |
Konto nemá pridelené oprávnenie. Rieši administrátor v IAM. |
| Vaša relácia vypršala. Prihláste sa znova. |
Prihlásenie vypršalo — prihláste sa nanovo. |
| Server je nedostupný |
Výpadok spojenia alebo servera; skúste znova. Pri vývoji zvyčajne ide o chýbajúcu dev proxy / CORS (pozri 11.3). |
| Záznam medzičasom zmenil niekto iný |
Súbežná úprava. Načítajte aktuálny stav a zmenu zopakujte. |
| Pobočka nie je vybraná / pridelená (Channel Manager) |
V hlavičke vyberte prevádzku; ak sa žiadna neponúka alebo pretrváva „nie je pridelená", pridelenie prevádzky musí doplniť administrátor. |
| Pripojenie pobočky na Channex ešte nie je dokončené |
Najprv spustite onboarding na obrazovke Channel Manager → Pripojenie. |
| Záznam sa používa v iných dátach, nedá sa zmazať |
Namiesto mazania ho vypnite (Aktívny = nie). |
Aby bola webová aplikácia použiteľná, musí byť na strane infraštruktúry zabezpečené:
- IAM AsolAuth — zavedená aplikácia
QASIDAHOREC, registrovaný SPA klient (prihlasovací
klient s Authorization Code Flow + PKCE) a pridelené oprávnenia (ADMIN/USER) používateľom.
- Licencia na
QASIDAHOREC v ALIS pre daný hotel.
- Prístup k API na tej istej doméne ako frontend (v TEST/PROD).
- Pre Channel Manager navyše platný Channex účet a claim členstva v pobočke z IAM.
Webový klient sa konfiguruje súborom public/config.json (načíta sa pri štarte, mení sa per
prostredie bez rebuildu):
apiBaseUrl — origin, kde stojí API.auth.authority a auth.clientId — napojenie na IAM (prihlasovací server a klient).
Pri lokálnom vývoji musia volania API ísť cez dev proxy (apiBaseUrl = dev server na porte
4200), inak preflight CORS skončí chybou a mriežky hlásia „Server je nedostupný". Podrobnosti
a postup lokálneho rozbehnutia sú v clients/horec-pms/README.md.
Tento manuál bol vytvorený z kódu aplikácie (frontend clients/horec-pms). Pri zmene obrazoviek
alebo textov rozhrania ho treba aktualizovať — zdrojom pravdy pre názvy položiek sú prekladové
katalógy public/i18n/*.json a navigácia src/app/layout/nav-items.ts.