Dolores - Popis testovacieho klienta

Webovú rezerváciu Dolores je možné otestovať pomocou testovacieho klienta, ktorý je k dispozícii v každej inštalácii Dolores. Tento testovací klient sa updatuje zároveň s updatom Dolores a teda umožňuje otestovať najnovšiu verziu funkčností.

Logovanie prichádzajúcich SOAP správ.

<handler name="log" type="java:org.apache.axis.handlers.LogHandler" >
   <parameter name="LogHandler.fileName" value="soapmessages.log"/>
</handler>

Aktuálne popísaný klient vo verzii 10.15.01 - pre testovacie účely

Dolores - vydaná verzia 10.14.10

Testovací klient sa nachádza v adresári ...tomcat-dolores\bin\run-test-client.bat.

Pre spustenie odporúčam skontrolovať nastavenie JAVA_HOME priamo v .bat súbore. Pokiaľ nie je nastavený JAVA_HOME priamo na pracovnej stanici, potom pomôže, pokiaľ nasmerujete JAVA_HOME napríklad do inštalácie systému Horec.

set JAVA_HOME="D:\DatalockHotel\SystemHorec01\java\jre_win32\" 

Test connection

Otestovanie pripojenia na aplikačný server Horec.

Po zavolaní dotazu sa zobrazí okno, kde je možné zadať ľubovolnú testovaciu správu. Po stlačení tlačidla OK s správa odošle. V prípade úspešného spojenia sa zobrazí okno, kde je vypísaný dotaz a odpoveď.

• REQUEST

testovacia sprava

• RESPONSE

avarps aicavotset

Get advetising

Stiahne aktuálny číselník náboru.

RESPONSE

• ID - id náboru
• NAME - názov náboru
• DESCRIPTION - poznámka ku náboru (viditeľná v Horci od HV_10.14.xx)

Get countries

Stiahne aktuálny číselník štátov.

RESPONSE

• CODE OF STATE - kód štátu
• NAME - názov štátu
• CURRENCY - mena
• VISA - vízová povinnosť T/F

Get hotel info

Stiahne základne údaje o ubytovacom ziariadení.

RESPONSE

• Hotel name: Hotel **** GRAND
• Company: Tatry mountain resorts, a.s.
• Address: Demänovská Dolina 72
• City: Liptovský Mikuláš
• E-mail: hotel@grandjasna.sk
• Phone: +421 44 523 19 00
• Fax: +421 44 523 19 07
• Web: www.grandjasna.sk

Get room types

Stiahne aktuálny číselník typov izieb.

RESPONSE

• CODE - kód služby pre typ izby
• NAME - názov typu izby
• TYPE - kód typu
• NUMBER - id typu izby
• BEDS - pčet postelí
• ADDITIONAL BEDS - počet pevných prístelok, plavajúce prístelky sa nezapočítavajú.
• ALL BEDS - celkový počet lôžok, plavajúce prístelky sa nezapočítavajú.

Get services

Stiahne aktuálny číselník služieb.

RESPONSE

• ID - id služby
• NAME - názov služby
• CODE - kód služby
• RASTER - názov rastra
• AFTER MIDNIGHT - príznak služby poskytovanej po polnoci
• PRICE - jednotková cena služby
• VAT - sadzba DPH v percentách

Get payment type list

Stiahne aktuálny číselník platieb.

RESPONSE

• ID - id spôsobu platby
• CODE - kód spôsobu platby
• NAME - názov spôsobu platby
• FISCAL - príznak, či ide o fiskáln spôsob platby
• ENABLED - príznak povoleného spôsobu platby

Get service package list

Stiahne aktuálny zoznam balíkov služieb povolených pre DOLORES. Do zoznamu balíkov sa nedostanú balíky typu Služby samostatne - tieto nie je ani možné povoliť pre DOLORES.

RESPONSE

• CODE - kód balíka služieb
• NAME - názov balíka služieb
• LENGTH OF VALIDITY - počet dní balíka - dĺžka trvania
• PRICE OF ALL - cena za cený balík (cena neobsahuje externé služby) - výpočet ceny záleží od typu balíka a je popísaný nižšie v texte.
• SERVICES - služby v balíku - POZOR nie sú zasielané externé služby
  • CODE - kód služby
  • NAME - názov služby
  • NUM. OF SERVICES - počet služieb v balíku - počet služieb sa počíta pre každú službu osobitne, zoberie sa počet služieb v balíku a v prípade trvalej služby sa prenásobí počtom dní trvania balíka. Ak služba nie je nastavená ako trvalá, tak sa počet služieb v balíku prenásobí počtom dní trvania služby. Tento počet následne ovplyvňuje výpočet ceny za balík. Pri balíkoch s veľkou dĺžkou trvania môže cena nadobúdať vysoké sumy.
  • UNIT PRICE - jednotková cena

Výpočet ceny balíka:

• Jednorazová cena - cena zadefinovaná užívateľom za celý balík bez ohľadu na dĺžku trvania a počet a ceny služieb v balíku.
• Cena za pobytový deň - cena zadefinovaná užívateľom za pobytový deň sa prenásobí počtom dní trvania balíka.
• Suma cien služieb - každej službe v balíku sa vypočíta jej cena za celý balík - podľa počtu služieb za deň a počtu dní, koľko služba v balíku trvá a následne sa tieto celkové ceny služieb za balík sčítajú do koncovej ceny za celý balík.

Get categories

Stiahne aktuálny číselník kategórií hosťa.

RESPONSE

• CODE - kód kategórie
• NAME - názov kategórie

Get marketing categories

Stiahne aktuálny číselník marketingových kategorizácií.

RESPONSE

• CODE - kód marketingovej kategórie
• NAME - názov marketingovej kategórie
• TYPE CODE - kód marketingovej kategórizácie (druh pobytu, nábor)
• TYPE NAME - názov marketingovej kategórizácie

Get age categories - verzia 10.15

Stiahne aktuálny číselník vekových hladín.

RESPONSE

• CODE - kód vekovej hladiny
• NAME - názov vekovej hladiny
• AGE FROM - vek od - spodná hranica vekovej hladiny
• AGE TO - vek do - horná hranica vekovej hladiny

Check

Overenie dostupnosti izieb v zadanom intervale. Metóda vracia sumár voľných izieb podľa typov. Za voľné izby sú považované len neobsadené a nerezervované izby a izby bez kontraktov. Do sumáru sa nezapočítajú izby mimo prevádzky.

Vstupné parametre

• Date from (YYYY-MM-DD) - dátum od v príslušnom formáte v zátvorkach
• Date to (YYYY-MM-DD) - dátum do v príslušnom formáte v zátvorkach
• Number of persons - počet osôb pre rezerváciu
• Booking type (1-Single, 2-Group) - parameter, ktorý určuje, či pôjde o sólo (1) alebo skupinovú (2) rezerváciu

Odpoveď

REQUEST

• Date from: 2013-02-13
• Date to: 2013-02-14
• Persons: 2
• Booking type: 1

RESPONSE

• TYPE - kód typu izby
• NAME - názov typu izby
• BEDS - počet postelí
• ADDITIONAL BEDS - počet pevných prístelok
• FREE - počet voľných izieb daného typu

Check_2

Overenie dostupnosti izieb po dňoch v zadanom intervale. Za obsadené izby sa považujú izby, kde sú ubytovaní hostia a potom aj všetky objednávky v stave AP a AZ, ktoré majú dátum Rezervované do rovnaký ako dátum nástupu. Metóda vždy vráti informácie pre daný typ príp. všetky typy izieb. Pri obsadenej kapacite hotela (ubytovanými hosťami) je počet voľných nula. Pokiaľ je kapacita obsadená objednávkami a v danom intervale sú aj objednávky na typ, potom môže byť počet voľných izieb záporný. Príznak Izba mimo prevádzky sa neberie do úvahy. Blokované izby sú považované za volné.

Vstupné parametre

• Date from (YYYY-MM-DD) - dátum od v príslušnom formáte v zátvorkach
• Date to (YYYY-MM-DD) - dátum do v príslušnom formáte v zátvorkach
• Room type code - kód požadovaného typu izbu. Toto pole je nepovinné, pokiaľ nie je zadaný kód typu izby, systém vráti všetky voľné typy izieb.

Odpoveď

REQUEST

• Date from: 2013-02-13
• Date to: 2013-02-15
• Room type code zvolený typ alebo žiadna hodnota, pokiaľ nebol typ zadaný pri dopyte

RESPONSE

• DATE - dátum zo zadaného intervalu, každému dňu zo zadaného rozsahu prislúcha osobitný riadok
• ROOM TYPE CODE - kód typu izby
• NUMBER OF FREE - počet voľných izieb daného typu pre daný deň

Check_3

Overenie dostupnosti izieb po dňoch v zadanom intervale s využitím špeciálnych koeficient pre Overbooking.

Tieto koeficienty sú v systéme Horec dostupné len v prípade platnej licencie pre modul FlexiRate (zatiaľ využíva zákazník TMR, a.s.) Ide o nastavenie koeficientov pre tzv. overbooking - tj. možné dovolené prebookovanie kapacít potvrdenými nezaplatenými objednávkami a nepotvrdenými objednávkami. Predbežne koeficient OBK1 prislúcha potvrdeným nezaplateným objednávkam a koeficient OBK2 prislúcha nepotvrdeným objednávkam. Každý typ izby má vlastné koeficienty pre overbooking, čím je zabezpečené, že prebookovanie je možné riadiť po typoch izieb - napr. pre luxusné izby je možné prebookovanie celkom zakázať nastavením koeficientu na hodnotu 1. Koeficienty sa zadávajú priamo na úvodnej stránke formulára zvoleného typu izby v číselníku typov izieb. Po update systému Horec na verziu minimálne HV_10.14.06 sú oba koeficienty nastavené na 1.

Výpočet dostupných izieb pre prebookovanie sa vykonáva podľa nižšie uvedeného vzorca. Počet izieb sa zaokrúhľuje na celé číslo nadol.

• Dostupná kapacita OBK1 pre zadaný typ izby sa vypočíta:

OBK1 ×(Celkový počet izieb - izby mimo prevádzky - obsadené - potvrdené_zaplatené_objednávky)- potvrdené_nezaplatené_objednávky - nepotvrdené_objednávky - kontrakty

• Dostupná kapacita OBK2 pre zadaný typ izby sa vypočíta:

OBK2 ×(Celkový počet izieb - izby mimo prevádzky - obsadené - potvrdené_zaplatené_objednávky)- potvrdené_nezaplatené_objednávky - nepotvrdené_objednávky - kontrakty

Vstupné parametre

• Date from (YYYY-MM-DD) - dátum od v príslušnom formáte v zátvorkach
• Date to (YYYY-MM-DD) - dátum do v príslušnom formáte v zátvorkach
• Room type code - kód požadovaného typu izbu. Toto pole je nepovinné, pokiaľ nie je zadaný kód typu izby, systém vráti informácie pre všetky voľné typy izieb.
• Coefficient - koeficient 1 alebo 2. Toto pole je nepovinné, pokiaľ nie je zadaný koeficient, systém vykoná výpočet tak, ako keby hodnota koeficientu bola 1, teda zobrazí reálne dostupné izby.

Odpoveď

REQUEST

• Date from: 2013-02-13
• Date to: 2013-02-15

zvolený typ alebo žiadna hodnota, pokiaľ nebol typ zadaný pri dopyte

• Coefficient - zvolený koeficient alebo riadok chýba, ak nebol v dopyte zadaný

RESPONSE

• DATE - dátum zo zadaného intervalu, každému dňu zo zadaného rozsahu prislúcha osobitný riadok
• ROOM TYPE CODE - kód typu izby
• NUMBER OF FREE - počet voľných izieb daného typu pre daný deň

Booking

Zadanie rezervácie na typ izby. Ide o pôvodnú najstaršiu metódu, ktorá je dnes takmer nevyužívaná.

Vstupné parametre

Krok 1

• Surname - priezvisko - povinný údaj
• Name - meno - povinný údaj
• Company -
• Street - ulica
• Postal code - PSČ
• City - mesto
• Country - štát
• Phone number - telefónne číslo
• Fax - fax
• E-mail - email
• Accomodation time (HH:MM) - predpokladaný čas príchodu
• Payment type (HO, KR, SE, FA, VA) - predpokladaný spôsob platby
• Appendix -
• Date from (YYYY-MM-DD) - dátum od v príslušnom formáte (v zátvorkach) - povinný údaj
• Date to (YYYY-MM-DD) - dátum do v príslušnom formáte (v zátvorkach) - povinný údaj

Krok 2

• Booking count - počet rezervácií, ktoré sa majú nahrať. Všetky rezervácie budú mať totožné údaje o hosťovi.

Krok 3

• Room type - kód typu izby
• Number of rooms - počet izieb daného typu

Odpoveď

REQUEST

...

RESPONSE

• Booking ID: - ID externej rezervácie
• Evidence number of booking: - evidenčné číslo objednávky
• Variable symbol: - variabilný symbol, slúži na párovanie objednávky s platbou

Booking_2

Zadanie rezervácie na typ izby.

Vstupné parametre

Krok 1

• Surname - priezvisko - povinný údaj
• Name - meno - povinný údaj
• Company -
• Street - ulica
• Postal code - PSČ
• City - mesto
• Country - štát
• Phone number - telefónne číslo
• Fax - fax
• E-mail - email
• Accomodation time (HH:MM) - predpokladaný čas príchodu
• Payment type (HO, KR, SE, FA, VA) - predpokladaný spôsob platby
• Appendix - poznámka - povinný údaj
• Record booking type (T, R) - parameter, ktorý určuje, či pôjde o rezerváciu na konkrétnu izby (R - room) alebo na typ izby (T - type) - povinný údaj
• Advertising ID - id náboru - povinný údaj
• Date from (YYYY-MM-DD) - dátum od v príslušnom formáte (v zátvorkach)
• Date to (YYYY-MM-DD) - dátum do v príslušnom formáte (v zátvorkach)

Krok 2

• Booking count - počet rezervácií podľa typov izieb. Pokiaľ je zadaná hodnota 1, rezerváciu je možné vykonať len na jden typ izby (počet izieb je neobmedzený). Pre hodnoty 2 a viacej sa opakujú kroky 3 a 4 a teda je možné zadať rezervácie na rôzne typy izieb.

Krok 3

• Room type - kód typu izby
• Number of rooms - počet izieb daného typu

Krok 4

• Beds-Booking type (1, 2, 3) - parameter, ktorý určuje, na koľko lôžok sa robí rezervácia
  • 1 - plný počet lôžok (POZOR - len postele a pevné prístelky)
  • 2 - plný počet postelí
  • 3 - voliteľný počet lôžok, počet lôžok sa zadáva o riadok nižšie
• Custom number of all beds - pri parametri 3 v riadku vyššie je možné definovať vlastný počet lôžok pre izbu. Počet je ohraničený max. kapacitou izby.

Odpoveď

REQUEST ...

RESPONSE

• Booking ID: - ID externej rezervácie
• Evidence number of booking: - evidenčné číslo objednávky
• Variable symbol: - variabilný symbol, slúži na párovanie objednávky s platbou

Booking_3

Metóda totožná s Booking2, líši sa len v jednom návratovom parametri - Reservation number.

Vstupné parametre

Krok 1 - Údaje hosťa

• Surname - priezvisko
• Name - meno
• Company -
• Street - ulica
• Postal code - PSČ
• City - mesto
• Country - štát
• Phone number - telefónne číslo
• Fax - fax
• E-mail - email
• Accomodation time (HH:MM) - predpokladaný čas príchodu
• Payment type (HO, KR, SE, FA, VA) - predpokladaný spôsob platby
• Appendix -
• Record booking type (T, R) - parameter, ktorý určuje, či pôjde o rezerváciu na konkrétnu izby (R - room) alebo na typ izby (T - type)
• Advertising ID - id náboru
• Date from (YYYY-MM-DD) - dátum od v príslušnom formáte (v zátvorkach)
• Date to (YYYY-MM-DD) - dátum do v príslušnom formáte (v zátvorkach)

Krok 2 - Počet typov izieb objednávky

• Booking count - počet rezervácií podľa typov izieb. Pokiaľ je zadaná hodnota 1, rezerváciu je možné vykonať len na jeden typ izby (počet izieb je neobmedzený). Pre hodnoty 2 a viacej sa opakujú kroky 3 a 4 a teda je možné zadať rezervácie na rôzne typy izieb.

Krok 3 - Špecifikácia typu izby a počtu izieb

• Room type - kód typu izby
• Number of rooms - počet izieb daného typu

Krok 4 - Nastavenie lôžok objednávky

• Beds-Booking type (1, 2, 3) - parameter, ktorý určuje, na koľko lôžok sa robí rezervácia
  • 1 - plný počet lôžok (POZOR - len postele a pevné prístelky)
  • 2 - plný počet postelí
  • 3 - voliteľný počet lôžok, počet lôžok sa zadáva o riadok nižšie
• Custom number of all beds - pri parametri 3 v riadku vyššie je možné definovať vlastný počet lôžok pre izbu. Počet je ohraničený max. kapacitou izby.

Odpoveď

REQUEST

...

RESPONSE

• Booking ID: - ID externej rezervácie
• Evidence number of booking: - evidenčné číslo objednávky
• Reservation number - rezervačné číslo objednávky
• Variable symbol: - variabilný symbol, slúži na párovanie objednávky s platbou

Booking_4

Metóda totožná s Booking3, avšak umožňuje zadať manuálne ceny FlexiRate za izbu a prístelky a objednať balíky služieb. Na testovacom klientovi slúži výhradne pre interné testovacie účely. Pokiaľ nie je zadaná cena FlexiRate ani za jeden deň, systém Horec zapíše objednávku s predvoleným cenovým profilom, tak ako pri predchádzajúcich metódach Booking3, 2 a 1 (webrezv.properties)

Vstupné parametre

Krok 1 - Údaje hosťa

• Surname - priezvisko
• Name - meno
• Company -
• Street - ulica
• Postal code - PSČ
• City - mesto
• Country - štát
• Phone number - telefónne číslo
• Fax - fax
• E-mail - email
• Accomodation time (HH:MM) - predpokladaný čas príchodu
• Payment type (HO, KR, SE, FA, VA) - predpokladaný spôsob platby
• Appendix -
• Record booking type (T, R) - parameter, ktorý určuje, či pôjde o rezerváciu na konkrétnu izby (R - room) alebo na typ izby (T - type)
• Advertising ID - id náboru
• Price profile ID - id cenového profilu. Ak nie je zadané a nie je definovaná ani cena FlexiRate, potom systém Horec objednávke priradí predvolený cenový profil.
• Date from (YYYY-MM-DD) - dátum od v príslušnom formáte (v zátvorkach)
• Date to (YYYY-MM-DD) - dátum do v príslušnom formáte (v zátvorkach)

Krok 2 - Počet typov izieb objednávky

• Booking count - počet rezervácií podľa typov izieb. Pokiaľ je zadaná hodnota 1, rezerváciu je možné vykonať len na jeden typ izby (počet izieb je neobmedzený). Pre hodnoty 2 a viacej sa opakujú kroky 3 a 4 a teda je možné zadať rezervácie na rôzne typy izieb.

Krok 3 - Špecifikácia typu izby a počtu izieb

• Room type - kód typu izby
• Number of rooms - počet izieb daného typu

Krok 4 - Nastavenie lôžok objednávky

• Beds-Booking type (1, 2, 3) - parameter, ktorý určuje, na koľko lôžok sa robí rezervácia
  • 1 - plný počet lôžok (POZOR - len postele a pevné prístelky)
  • 2 - plný počet postelí
  • 3 - voliteľný počet lôžok, počet lôžok sa zadáva o riadok nižšie
• Custom number of all beds - pri parametri 3 v riadku vyššie je možné definovať vlastný počet lôžok pre izbu. Počet je ohraničený max. kapacitou izby.

Krok 5 - Zadanie ceny FlexiRate za izbu a deň

Zadanie ceny FlexiRate za izbu a pobytový deň

• Date [yyyy-MM-dd] - dátum pobytového dňa (vždy len dátum pobytového dňa. Pre pobyt na dve noci od 3/4 do 5/4 sa zadávajú ceny za 3/4 a za 4/4.)
• Price [N.NN] - cena za izbu, číslo s dvoma desatinnými miestami

Krok 6 Zadanie ceny FlexiRate za typ lôžka

Zadanie ceny FlexiRate za prístelku

• Bed code - kód typu lôžka
• Price [N.NN] - cena za lôžko, číslo s dvoma desatinnými miestami

Kroky 5 a 6 sa opakujú dookola. Je to z dôvodu dlhších pobytov, aby bolo možné zadať cenu za celý pobyt po jednotlivých dňoch. Po zadaní ceny za izbu a pobytový deň sa otvorí zadávanie ceny prísteliek. Zadajte postupne ceny za jednotlivé typy prísteliek (typ lôžka okrem BED) alebo, ak nie je potrebné zadávať cenu za prístelku, stačí stlačiť tlačidlo Cancel. Systém otvorí zadanie ceny FlexiRate za izbu za ďalší deň. Po zadaní ceny za izbu sa opätovne zobrazí zadanie ceny za prístelku. Tieto kroky sa opakujú, až kým nie je zadávanie cien prerušené tlačidlom Cancel. Systém následne prechádza do kroku 7.

Upozorňujem - je to len pre naše účely, vyzerá to byť krkolomné zadávanie, ale robili sme test klienta s obmedzeným počtom hodín.

Krok 7 - Objednanie balíkov

Priobjednanie balíka služieb

• Service package code - kód balíku služieb z číselníka. Zoznam dostupných balíkov vracia metóda Get service package list. Po zadaní je nutné kód odsúhlasiť tlačidlom OK, následne sa zobrazí ten istý formulár a je možné zadať ďalší balík služieb. Toto sa opakuje až kým zadávanie balíka služieb nie je prerušené stlačením tlačidla Cancel.

Po tomto kroku prebieha zápis dát do Horca - môže padnúť na validácii cien, pokiaľ nie sú zadané ceny FlexiRate za každý deň pobytu.

Odpoveď

REQUEST

...

RESPONSE

• Booking ID: - ID externej rezervácie
• Evidence number of booking: - evidenčné číslo objednávky
• Reservation number - rezervačné číslo objednávky
• Variable symbol: - variabilný symbol, slúži na párovanie objednávky s platbou

Booking_5

Metóda kopíruje booking4 s drobnými úpravami. Pribudla možnosť definovať kategóriu hosťa a oslovenie hosťa cez kód. Určenie náboru hosťa bolo zrušené. Miesto toho pribudla možnosť definovať ľubovolnú marketingovú kategorizáciu hosťa.

Vstupné parametre

Krok 1 - Údaje hosťa

• Surname - priezvisko
• Name - meno
• Company -
• Street - ulica
• Postal code - PSČ
• City - mesto
• Country - štát
• Phone number - telefónne číslo
• Fax - fax
• E-mail - email
• Accomodation time (HH:MM) - predpokladaný čas príchodu
• Payment type (HO, KR, SE, FA, VA) - predpokladaný spôsob platby
• Appendix -
• Record booking type (T, R) - parameter, ktorý určuje, či pôjde o rezerváciu na konkrétnu izby (R - room) alebo na typ izby (T - type)
• Pride profile ID - id cenového profilu. Ak nie je zadané a nie je definovaná ani cena FlexiRate, potom systém Horec objednávke priradí predvolený cenový profil. (webrezv.properties)
• Salutation code - kód oslovenia
• Category code - kód kategórie hosťa
• Date from (YYYY-MM-DD) - dátum od v príslušnom formáte (v zátvorkach)
• Date to (YYYY-MM-DD) - dátum do v príslušnom formáte (v zátvorkach)

Krok 2 - Marketingové kategorizácie hosťa

• Marketing category type code - kód marketingovej kategorizácie
• Marketing category code - kód marketingovej kategórie

Krok 2 sa opakuje dookola, vždy zostávajú predplnené posledné zadané údaje. Je to kvôli tomu, aby bolo možné zadať viaceré marketingové kategorizácie hosťa. Zadávanie marketingových údajov hosťa je možné prerušiť stlačením tlačidla Cancel. Systém prechádza do kroku 3.

Krok 3 - Počet typov izieb objednávky

• Booking count - počet rezervácií podľa typov izieb. Pokiaľ je zadaná hodnota 1, rezerváciu je možné vykonať len na jeden typ izby (počet izieb je neobmedzený). Pre hodnoty 2 a viacej sa opakujú kroky 4 a 5 a teda je možné zadať rezervácie na rôzne typy izieb.

Krok 4 - Špecifikácia typu izby a počtu izieb

• Room type - kód typu izby
• Number of rooms - počet izieb daného typu

Krok 5 - Nastavenie lôžok objednávky

• Beds-Booking type (1, 2, 3) - parameter, ktorý určuje, na koľko lôžok sa robí rezervácia
  • 1 - plný počet lôžok (POZOR - len postele a pevné prístelky)
  • 2 - plný počet postelí
  • 3 - voliteľný počet lôžok, počet lôžok sa zadáva o riadok nižšie
• Custom number of all beds - pri parametri 3 v riadku vyššie je možné definovať vlastný počet lôžok pre izbu. Počet je ohraničený max. kapacitou izby.

Krok 6 - Zadanie ceny FlexiRate za izbu a deň

Zadanie ceny FlexiRate za izbu a pobytový deň

• Date [yyyy-MM-dd] - dátum pobytového dňa (vždy len dátum pobytového dňa. Pre pobyt na dve noci od 3/4 do 5/4 sa zadávajú ceny za 3/4 a za 4/4.)
• Price [N.NN] - cena za izbu, číslo s dvoma desatinnými miestami

Krok 7 Zadanie ceny FlexiRate za typ lôžka

Zadanie ceny FlexiRate za prístelku

• Bed code - kód typu lôžka
• Price [N.NN] - cena za lôžko, číslo s dvoma desatinnými miestami

Kroky 6 a 7 sa opakujú dookola. Je to z dôvodu dlhších pobytov, aby bolo možné zadať cenu za celý pobyt po jednotlivých dňoch. Po zadaní ceny za izbu a pobytový deň sa otvorí zadávanie ceny prísteliek. Zadajte postupne ceny za jednotlivé typy prísteliek (typ lôžka okrem BED) alebo, ak nie je potrebné zadávať cenu za prístelku, stačí stlačiť tlačidlo Cancel. Systém otvorí zadanie ceny FlexiRate za izbu za ďalší deň. Po zadaní ceny za izbu sa opätovne zobrazí zadanie ceny za prístelku. Tieto kroky sa opakujú, až kým nie je zadávanie cien prerušené tlačidlom Cancel. Systém následne prechádza do kroku 7.

Upozorňujem - je to len pre naše účely, vyzerá to byť krkolomné zadávanie, ale robili sme test klienta s obmedzeným počtom hodín.

Krok 8 - Objednanie balíkov

Priobjednanie balíka služieb

• Service package code - kód balíku služieb z číselníka. Zoznam dostupných balíkov vracia metóda Get service package list. Po zadaní je nutné kód odsúhlasiť tlačidlom OK, následne sa zobrazí ten istý formulár a je možné zadať ďalší balík služieb. Toto sa opakuje až kým zadávanie balíka služieb nie je prerušené stlačením tlačidla Cancel.

Po tomto kroku prebieha zápis dát do Horca - môže padnúť na validácii cien, pokiaľ nie sú zadané ceny FlexiRate za každý deň pobytu.

Odpoveď

REQUEST

...

RESPONSE

• Booking ID: - ID externej rezervácie
• Evidence number of booking: - evidenčné číslo objednávky
• Reservation number - rezervačné číslo objednávky
• Variable symbol: - variabilný symbol, slúži na párovanie objednávky s platbou

Booking_6 DOPISAT verzia 10.15

Metóda totožná s Booking2, líši sa len v jednom návratovom parametri - Reservation number.

Vstupné parametre

Krok 1 - Interval pobytu

• Date from (YYYY-MM-DD) - dátum od v príslušnom formáte (v zátvorkach)
• Date to (YYYY-MM-DD) - dátum do v príslušnom formáte (v zátvorkach)

Krok 2 -

• Accomodation time (HH:MM) - predpokladaný čas príchodu
• Payment type (HO, KR, SE, FA, VA) - predpokladaný spôsob platby
• Group appendix - poznámka pre skupinu
• Record booking type (T, R) - parameter, ktorý určuje, či pôjde o rezerváciu na konkrétnu izby (R - room) alebo na typ izby (T - type)
• Number of rooms (1+) - počet izieb objednávky

Krok 3 - Room 1/1

• Room type - kód typu izby
• Beds-Booking type (1, 2, 3) - parameter, ktorý určuje, na koľko lôžok sa robí rezervácia
  • 1 - plný počet lôžok (POZOR - len postele a pevné prístelky)
  • 2 - plný počet postelí
  • 3 - voliteľný počet lôžok, počet lôžok sa zadáva o riadok nižšie
• Custom number of all beds - pri parametri 3 v riadku vyššie je možné definovať vlastný počet lôžok pre izbu. Počet je ohraničený max. kapacitou izby.
• Guest count - počet hostí

Krok4 - Údaje hosťa

• Surname - priezvisko
• Name - meno
• Company -
• Street - ulica
• Postal code - PSČ
• City - mesto
• Country - štát
• Phone number - telefónne číslo
• Fax - fax
• E-mail - email
• Appendix
• Price profile ID
• Salutation code
• Category code
• Age interval code

Krok 6 - Balík služieb hosťa

Kroky 4,5 a 6 sa opakujú toľkokrát, koľko je počet v poli Guest count - pokiaľ nie je potrebné zadávať údaje o ďalších hosťoch, je možné zadávanie údajov prerušiť stlačením tlačidla Cancel. POZOR - Nestláčajte Cancel v kroku 3 - pri zadávaní základných údajov o hosťovi. Celý proces zadávania objednávky bude zrušený.

• Advertising ID - id náboru

Krok 2

• Booking count - počet rezervácií podľa typov izieb. Pokiaľ je zadaná hodnota 1, rezerváciu je možné vykonať len na jeden typ izby (počet izieb je neobmedzený). Pre hodnoty 2 a viacej sa opakujú kroky 3 a 4 a teda je možné zadať rezervácie na rôzne typy izieb.

Krok 3

• Number of rooms - počet izieb daného typu

Odpoveď

REQUEST

...

RESPONSE

• Booking ID: - ID externej rezervácie
• Evidence number of booking: - evidenčné číslo objednávky
• Reservation number - rezervačné číslo objednávky
• Variable symbol: - variabilný symbol, slúži na párovanie objednávky s platbou

Accept payment

Párovanie platby ku externej/webovej rezervácii.

Vstupné parametre

Krok 1

• Booking ID - id externej rezervácie

Krok 2

• Variable symbol - variabilný symbol objednávky

Krok 3

• Amount (NNN.NN) - suma, ktorá má byť naťažená na účet objednávky, táto je zapísaná na účet ako záloha

zaplatená typom platby SE (šekom)

Odpoveď

REQUEST

• Booking ID: 91
• Variable symbol: 1
• Amount: 520.2

RESPONSE

• Payment accepted - true al. false - príznak, ktorý hovorí, či bola platba úspešne zapísaná na účet

Accept payment_2

Párovanie platby ku externej/webovej rezervácii.

Vstupné parametre

Krok 1

• Booking ID - id externej rezervácie

Krok 2

• Variable symbol - variabilný symbol objednávky

Krok 3

• Amount (NNN.NN) - suma, ktorá má byť naťažená na účet objednávky, táto je zapísaná na účet ako záloha

zaplatená typom platby SE (šekom)

Krok 4

• Notice - poznámka ku účtu do rozsahu 24 znakov ???preveriť, či sa zobrazuje???

Odpoveď

REQUEST

• Booking ID: 92
• Variable symbol: 91
• Amount: 320.2
• Notice: poznámka

RESPONSE

• Payment accepted - true al. false - príznak, ktorý hovorí, či bola platba úspešne zapísaná na účet

Accept payment_3

Párovanie platby ku externej/webovej rezervácii.

Vstupné parametre

Krok 1

• Booking ID - id externej rezervácie

Krok 2

• Variable symbol - variabilný symbol objednávky

Krok 3

• Amount (NNN.NN) - suma, ktorá má byť naťažená na účet objednávky, táto je zapísaná na účet ako záloha

zaplatená typom platby zvoleným v ďalšom kroku

Krok 4

• Payment type ID (NNNNN) - voľba spôsobu platby, ktorým bude uhradená záloha na účte rezervácie. Platí, že pokiaľ ide o fiskálny spôsob platby, potom je účet bežná faktúra (ZU). Pokiaľ ide o nefiskálny spôsob platby, doklad je odberateľská faktura FA alebo FZ, v závislosti od nastavenia systému Horec.

Krok 5

• Notice - poznámka ku účtu do rozsahu 24 znakov ???preveriť, či sa zobrazuje???

Odpoveď

REQUEST

• Booking ID: 92
• Variable symbol: 91
• Amount: 320.2
• Payment type ID 5
• Notice: poznámka

RESPONSE

• Payment accepted - true al. false - príznak, ktorý hovorí, či bola platba úspešne zapísaná na účet

Booking services

Priradenie služieb webovej objednávke.

Vstupné parametre

Krok 1

• Booking ID - id externej rezervácie

Krok 2

• Count - počet služieb

Krok 3

• Service ID - id služby
• Date from [dd.MM.yyyy] - dátum od
• Date to [dd.MM.yyyy] - dátum do
• After midnight - príznak služby Po polnoci, začiarnutý checkbox je true, default je false
• Is paid - príznak platenej služby, začiarnutý checkbox je true, default je false

Odpoveď

REQUEST

...

RESPONSE

• true al. false - príznak, ktorý hovorí, či bola služba úspešne objednaná

Booking status

Overenie stavu externej rezervácie.

Vstupné parametre

• Booking ID - id externej rezervácie

Odpoveď

REQUEST

RESPONSE

• Variable symbol: 97
• Payment accepted: true
• Booking rooms:
  • TYPE - kód typu izby
  • NAME - názov typu izby
  • ROOM NUMBER - číslo izby, ak išlo o rezerváciu na konkrétnu izbu
  • FLOOR - poschodie
  • STATUS - stav izby objednávky
    • 1 - CONFIRMED - má priradenú izbu (AZ)
    • 2 - NOT_CONFIRMED - nemá priradenú izbu (na typ - AP)
    • 3 - CANCELLED - zrušená

Arrival booking

Metóda zabezpečí overenie, či daná objednávka, alebo niektorý jej hosť, už nastúpili na pobyt. - VRAJ

Vstupné parametre

• Booking ID - id externej rezervácie

Odpoveď

REQUEST

RESPONSE

• Arrival booking: true al. false - význam presne nepoznám, ale vygooglim