Ceny, dostupnosť a rezervácie - História úprav

Horecabase: /* Overenie spojenia */

2024-07-08T10:48:05Z

Overenie spojenia

Horecabase na 19:32, 27. jún 2024

2024-06-27T19:32:06Z

Zobraziť rozdiely

Horecabase: Vytvorená stránka „ == Overenie spojenia == Pre overenie spojenia sa používa Base HTTP Autentifikácia. Parametre pre prihlásenie (meno a heslo) nastavuje používateľ systému Ellipse v administrácii. Pre produkčné prostredie je potrebné v administrácii povoliť IP adresu pre vzdialený dopyt. Podpora je dostupná na office@horecagroup.sk == Detail hotela - hotelinfo == Povinné parametre: type (hotelinfo) https://demo.ellipsecloud.com/api/chmb…“

2024-06-27T19:22:04Z

Vytvorená stránka „ == Overenie spojenia == Pre overenie spojenia sa používa Base HTTP Autentifikácia. Parametre pre prihlásenie (meno a heslo) nastavuje používateľ systému Ellipse v administrácii. Pre produkčné prostredie je potrebné v administrácii povoliť IP adresu pre vzdialený dopyt. Podpora je dostupná na office@horecagroup.sk == Detail hotela - hotelinfo == Povinné parametre: type (hotelinfo)<syntaxhighlight lang="html"> https://demo.ellipsecloud.com/api/chmb…“

Nová stránka

== Overenie spojenia ==
Pre overenie spojenia sa používa Base HTTP Autentifikácia. Parametre pre prihlásenie (meno a heslo) nastavuje používateľ systému Ellipse v administrácii. Pre produkčné prostredie je potrebné v administrácii povoliť IP adresu pre vzdialený dopyt. Podpora je dostupná na office@horecagroup.sk

== Detail hotela - hotelinfo ==
Povinné parametre: type (hotelinfo)<syntaxhighlight lang="html">
https://demo.ellipsecloud.com/api/chmbase/?type=hotelinfo
</syntaxhighlight>

== Galéria - gallery ==
Povinné parametre: type (gallery)<syntaxhighlight lang="html">
https://demo.ellipsecloud.com/api/chmbase/?type=gallery
</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">
[{
"name": "Demo Hotel",
"order": "1",
"images": [
"https:\/\/demo.ellipsecloud.com\/img\/gallery\/1-1.jpg",
"https:\/\/demo.ellipsecloud.com\/img\/gallery\/1-1-01.jpg",
"https:\/\/demo.ellipsecloud.com\/img\/gallery\/1-1-02.jpg"
]
}]
</syntaxhighlight>

== Základné info o izbách - roomtypes ==
Povinné parametre: type (roomtypes)<syntaxhighlight lang="html">
https://demo.ellipsecloud.com/api/chmbase/?type=roomtypes
</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">
{
"1": {
"id": "1",
"name": "Jednolôžková izba",
"text": "Ubytovanie s raňajkami pre vybraný počet osôb, parkovanie, wifi. ",
"largetext": "<p>Lorem ipsum..."
"image": "https:\/\/demo.ellipsecloud.com\/img\/rooms\/1-37-01.jpg",
"beds": "1",
"extrabeds": "0",
"allocated": 3,
"pictograms": {
"1": {
"name": "Max. obsadenie",
"value": "2+2"
},
"2": {
"name": "Rozloha",
...
},
"2": {
"id": "2",
"name": "Apartmán Comfort",
"beds": "2",
"extrabeds": "2"
},
"3": {
. . .
}
}
</syntaxhighlight>id - typ izby, name - názov, text - základný popis izby, largetext - rozšírený popis, image - ilustračný obrázok (0-00.jpg - plná veľkosť, 0-00-01.jpg, 0-00-02.jpg), beds - počet pevných lôžok, extrabeds - počet prístelkov, allocated - počet pridelených izieb pre rezervácie cez API, pictograms - vybavenie izby

== Počet dostupných jednotiek podľa typu izby - roomcount ==
Povinné parametre: type (roomcount), from ( YYYY-mm-dd), to ( YYYY-mm-dd)<syntaxhighlight lang="html">
https://demo.ellipsecloud.com/api/chmbase/?type=roomcount&from=2020-05-01&to=2020-05-10
</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">
{
"2020-05-01": {
"1": 8,
"2": 18,
"3": 3
},
"2020-05-02": {
"1": 8,
"2": 18,
"3": 3
} ...
}
</syntaxhighlight>Pole pre každý deň v zadanom období, kľúč = typ izby, hodnota = počet voľných izieb

== Dostupné jednotky podľa typu a cena - roomstdrate ==
Povinné parametre: type (roomstdrate), from ( YYYY-mm-dd), to ( YYYY-mm-dd)<syntaxhighlight lang="html">
https://demo.ellipsecloud.com/api/chmbase/?type=roomstdrate&from=2020-05-01&to=2020-05-10
</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">
{
"2020-08-01": {
"1": {
"items": 2,
"stdrate": "200.000",
"minstay": 0
},
"2": {
"items": 2,
"stdrate": "230.000",
"occ-1": "60.000",
"minstay": 0
},
"3": {
"items": 1,
"stdrate": "280.000",
"occ-1": "150.000",
"occ-2": "160.000",
"occ-3": "170.000",
"minstay": 0
}
}
}
</syntaxhighlight>Pole pre každý deň v zadanom období, kľúč - typ izby, items - počet voľných izieb, stdrate - standard rate pre kompletne obsadenú izbu, occ - ceny podľa počtu osôb ak sú dostupné, minstay - minimálna dĺžka pobytu

== Overenie dostupnosti a cena - stayprices ==
Povinné parametre: type (roomcount), from ( YYYY-mm-dd), to ( YYYY-mm-dd), adults (number, číslo > 0) Voliteľné parametre: children (string, čísla oddelené - )<syntaxhighlight lang="html">
https://demo.ellipsecloud.com/api/chmbase/?type=stayprices&from=2020-05-01&to=2020-05-10&adults=2&children=4-6
</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">
[{
"room": "3",
"persons": {
"adults": "2",
"1": 4,
"2": 6
},
"from": "2020-06-10",
"to": "2020-06-15",
"datetime": "2020-05-03 11:25:02",
"langs": ["sk", "en", "de", "pl", "ru", "hu"],
"openprice": {
"hash": "VUxxeUEyRldJdGNyVGZqRE83S2ZhSlZBZU8rZ1FaczQzMWtPM0tsOGJh..."
},
"base": {
"name": "Ubytovanie s raňajkami",
"price": 412.5,
"cancellation": 1,
"hash": "RnNJOTNULzNtNWF1QWFyQm1lSXlHRzVvU1NRMm1UR1hGSWhlMS9rTDR..."
},
"variant": [{
"id": "9",
"name": "Pobyt s polpenziou",
"price": 1012.5,
"cancellation": 2,
"hash": ...
}, {
"id": "10",
"name": "Non-refundable",
"price": 337.5,
"hash": ...
}],
"offer": [{
"id": "42",
"name": "Wellness hýčkanie",
"price": 779.5,
"cancellation": 1,
"hash":...
}]
}]
</syntaxhighlight>'''Všeobecné:''' room - typ izby, persons - pole osôb zadané pri dopyte, from - dátum príchodu, to - dátum odchodu, datetime - čas kedy bola odpoveď vygenerovaná, langs - pole s jazykom dostupným v systéme

'''Základná cena (base), variant (variant), balík (offer):'''

openprice: umožňuje vytvoriť rezerváciu s cenou nezávislou od ceny v Ellipse base: name - názov, cancellation - id storno podmienok, price - cena, hash - kľúč pre rezerváciu variant: id - id cenového variantu, name - názov, cancellation - id storno podmienok, price - cena, hash - kľúč pre rezerváciu offer: id - id pobytového balíka, name - názov, cancellation - id storno podmienok, price - cena, hash - kľúč pre rezerváciu

== Nová rezervácia - newbooking ==
'''Povinné parametre:''' type (newbooking), rel (number, unikátny identifikátor), name (string, meno hosťa), surname (string, priezvisko hosťa), email (string, emailová adresa), hash (string, hash z odpovede stayprices), price (float 10.2) - len v prípade openprice hash, ratename - (string) názov, len pre openprice

'''Voliteľné parametre:''' lang (string), commisionamount (number, provízia), phone (string), street (string), city (string), zip (string), country (string), note (string)<syntaxhighlight lang="html">
https://demo.ellipsecloud.com/api/chmbase/?type=newbooking&rel=220&name=Peter&surname=Tester&lang=sk&commissionamount=22&email=peter@horecagroup.sk&phone=0907854854&street=Ulicka&city=Mestecko&zip=08045&country=Slovensko¬e=Poznamka&hash=a0RnY2RWUDBPWmlaSFdKWHZjM2dNclFXN2cvWEVkQVFpc3AwbElkMi9zTWZUWVhKVlQ4WDUxcmVJeTRkZ1Zja1hnVy9kejdSaXlUZEZCV0VHTVJEZy9oaEFpWllOTDNISEpWVXBOTFI1Mzg9
</syntaxhighlight>

← Staršia verzia		Verzia z 10:48, 8. júl 2024
Riadok 156:		Riadok 156:

	== Nová rezervácia - newbooking ==		== Nová rezervácia - newbooking ==
	'''Povinné parametre:''' type (newbooking), rel (~~number~~, unikátny identifikátor), name (string, meno hosťa), surname (string, priezvisko hosťa), email (string, emailová adresa), hash (string, hash z odpovede stayprices), price (float 10.2) - len v prípade openprice hash, ratename - (string) názov, len pre openprice		'''Povinné parametre:''' type (newbooking), rel (string, unikátny identifikátor), name (string, meno hosťa), surname (string, priezvisko hosťa), email (string, emailová adresa), hash (string, hash z odpovede stayprices), price (float 10.2) - len v prípade openprice hash, ratename - (string) názov, len pre openprice

	'''Voliteľné parametre:''' lang (string), commisionamount (number, provízia), phone (string), street (string), city (string), zip (string), country (string), note (string)<syntaxhighlight lang="html">		'''Voliteľné parametre:''' lang (string), commisionamount (number, provízia), phone (string), street (string), city (string), zip (string), country (string), note (string)<syntaxhighlight lang="html">
Riadok 167:		Riadok 167:
	Vzhľadom na flexi ceny je zmena v rezervácii vlastne zrušením predchádzajúcej a vytvorenie novej s rovnakým parametrom rel a resid. Pred požiadavkou na editáciu je potrebné vykonať dopyt stayprices a hash odpovede použiť v dopyte edit. Pre zmenu údajov o registrácii bez zmeny izby je vhodné použiť editdata.		Vzhľadom na flexi ceny je zmena v rezervácii vlastne zrušením predchádzajúcej a vytvorenie novej s rovnakým parametrom rel a resid. Pred požiadavkou na editáciu je potrebné vykonať dopyt stayprices a hash odpovede použiť v dopyte edit. Pre zmenu údajov o registrácii bez zmeny izby je vhodné použiť editdata.

	'''Povinné parametre:''' type (edit), resid (number, unikátny identifikátor v systéme Ellipse), rel (~~number~~, unikátny identifikátor), name (string, meno hosťa), surname (string, priezvisko hosťa), email (string, emailová adresa), hash (string, hash z odpovede stayprices), price (float 10.2) - len v prípade openprice hash, ratename - (string) názov, len pre openprice		'''Povinné parametre:''' type (edit), resid (number, unikátny identifikátor v systéme Ellipse), rel (string, unikátny identifikátor), name (string, meno hosťa), surname (string, priezvisko hosťa), email (string, emailová adresa), hash (string, hash z odpovede stayprices), price (float 10.2) - len v prípade openprice hash, ratename - (string) názov, len pre openprice

	'''Voliteľné parametre:''' lang (string), commisionamount (number, provízia), phone (string), street (string), city (string), zip (string), country (string), note (string)<syntaxhighlight lang="html">		'''Voliteľné parametre:''' lang (string), commisionamount (number, provízia), phone (string), street (string), city (string), zip (string), country (string), note (string)<syntaxhighlight lang="html">
Riadok 181:		Riadok 181:
	Slúži na zmenu, posun dátumu rezervácie v jednom kroku.		Slúži na zmenu, posun dátumu rezervácie v jednom kroku.

	'''Povinné parametre:''' type (resdate), resid (number, unikátny identifikátor v systéme Ellipse), rel (~~number~~, unikátny identifikátor), from ( YYYY-mm-dd), to ( YYYY-mm-dd)		'''Povinné parametre:''' type (resdate), resid (number, unikátny identifikátor v systéme Ellipse), rel (string, unikátny identifikátor), from ( YYYY-mm-dd), to ( YYYY-mm-dd)

	'''Voliteľné parametre:''' openprices (string, room_key - price_room_key - price ... ), commisionamount (number, provízia)		'''Voliteľné parametre:''' openprices (string, room_key - price_room_key - price ... ), commisionamount (number, provízia)
Riadok 201:		Riadok 201:

	== Zmena základných informácií v rezervácii - editdata ==		== Zmena základných informácií v rezervácii - editdata ==
	'''Povinné parametre:''' type (edit), resid (number, unikátny identifikátor v systéme Ellipse), rel (~~number~~, unikátny identifikátor), name (string, meno hosťa), surname (string, priezvisko hosťa), email (string, emailová adresa)		'''Povinné parametre:''' type (edit), resid (number, unikátny identifikátor v systéme Ellipse), rel (string, unikátny identifikátor), name (string, meno hosťa), surname (string, priezvisko hosťa), email (string, emailová adresa)

	'''Voliteľné parametre:''' lang (string), commisionamount (number, provízia), phone (string), street (string), city (string), zip (string), country (string), note (string)<syntaxhighlight lang="html">		'''Voliteľné parametre:''' lang (string), commisionamount (number, provízia), phone (string), street (string), city (string), zip (string), country (string), note (string)<syntaxhighlight lang="html">
Riadok 213:		Riadok 213:

	== Storno rezervácie - cancel ==		== Storno rezervácie - cancel ==
	'''Povinné parametre:''' type (cancel), rel (~~number~~, unikátny identifikátor), resid (number, unikátny identifikátor v systéme Ellipse)<syntaxhighlight lang="html">		'''Povinné parametre:''' type (cancel), rel (string, unikátny identifikátor), resid (number, unikátny identifikátor v systéme Ellipse)<syntaxhighlight lang="html">
	https://demo.ellipsecloud.com/api/chmbase/?type=cancel&rel=215&resid=377		https://demo.ellipsecloud.com/api/chmbase/?type=cancel&rel=215&resid=377
	</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">		</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">
Riadok 222:		Riadok 222:

	== Pridanie ďalších izieb - addroom ==		== Pridanie ďalších izieb - addroom ==
	'''Povinné parametre:''' type (addroom), rel (~~number~~, unikátny identifikátor), resid (number, unikátny identifikátor v systéme Ellipse), hash (string, hash z odpovede stayprices), price (float 10.2) - len v prípade openprice hash, ratename - (string) názov, len pre openprice<syntaxhighlight lang="html">		'''Povinné parametre:''' type (addroom), rel (string, unikátny identifikátor), resid (number, unikátny identifikátor v systéme Ellipse), hash (string, hash z odpovede stayprices), price (float 10.2) - len v prípade openprice hash, ratename - (string) názov, len pre openprice<syntaxhighlight lang="html">
	https://demo.ellipsecloud.com/api/chmbase/?type=addroom&rel=219&resid=384&price=333.50&ratename=OpenpriceRateName&hash=UCtpdVRmMy83QlBBNmxMWGpNeWk5YVMxVzVVdExmVU1nQkY3K3pjV2JmRDhHdHdyWitFc3o0Uk1vTkw5WElWNUY2M243b0FpRU1NT3Jrb09iUlAwMGJQejdrVFlUK0JJVElPN1lTMTEyejV5K1RGSkdnSVdWaWRjeEVNQzNWUGo%3D		https://demo.ellipsecloud.com/api/chmbase/?type=addroom&rel=219&resid=384&price=333.50&ratename=OpenpriceRateName&hash=UCtpdVRmMy83QlBBNmxMWGpNeWk5YVMxVzVVdExmVU1nQkY3K3pjV2JmRDhHdHdyWitFc3o0Uk1vTkw5WElWNUY2M243b0FpRU1NT3Jrb09iUlAwMGJQejdrVFlUK0JJVElPN1lTMTEyejV5K1RGSkdnSVdWaWRjeEVNQzNWUGo%3D
	</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">		</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">
Riadok 233:		Riadok 233:

	== Odstránenie izby - deleteroom ==		== Odstránenie izby - deleteroom ==
	Povinné parametre: type (deleteroom), rel (~~number~~, unikátny identifikátor), resid (number, unikátny identifikátor v systéme Ellipse), room_key - kľúč pre odstránenie izby<syntaxhighlight lang="html">		Povinné parametre: type (deleteroom), rel (string, unikátny identifikátor), resid (number, unikátny identifikátor v systéme Ellipse), room_key - kľúč pre odstránenie izby<syntaxhighlight lang="html">
	https://demo.ellipsecloud.com/api/chmbase/?type=deleteroom&rel=219&resid=384&room_key=4		https://demo.ellipsecloud.com/api/chmbase/?type=deleteroom&rel=219&resid=384&room_key=4
	</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">		</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">
Riadok 244:		Riadok 244:

	== Detail rezervácie - resinfo ==		== Detail rezervácie - resinfo ==
	Povinné parametre: type (cancel), rel (~~number~~, unikátny identifikátor), resid (number, unikátny identifikátor v systéme Ellipse)<syntaxhighlight lang="html">		Povinné parametre: type (cancel), rel (string, unikátny identifikátor), resid (number, unikátny identifikátor v systéme Ellipse)<syntaxhighlight lang="html">
	https://demo.ellipsecloud.com/api/chmbase/?type=resinfo&rel=228880&resid=392		https://demo.ellipsecloud.com/api/chmbase/?type=resinfo&rel=228880&resid=392
	</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">		</syntaxhighlight>Odpoveď:<syntaxhighlight lang="json">