Ceny, dostupnosť a rezervácie

Verzia z 19:22, 27. jún 2024, ktorú vytvoril Horecabase (diskusia | príspevky) (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…“)
(rozdiel) ← Staršia verzia | Aktuálna úprava (rozdiel) | Novšia verzia → (rozdiel)

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/chmbase/?type=hotelinfo

Galéria - gallery

Povinné parametre: type (gallery)

https://demo.ellipsecloud.com/api/chmbase/?type=gallery

Odpoveď:

[{
   "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"
  ]
}]

Základné info o izbách - roomtypes

Povinné parametre: type (roomtypes)

https://demo.ellipsecloud.com/api/chmbase/?type=roomtypes

Odpoveď:

{
   "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": {
      . . .
  }
}

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)

https://demo.ellipsecloud.com/api/chmbase/?type=roomcount&from=2020-05-01&to=2020-05-10

Odpoveď:

{
   "2020-05-01": {
       "1": 8,
       "2": 18,
       "3": 3
  },
   "2020-05-02": {
       "1": 8,
       "2": 18,
       "3": 3
  } ...
}

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)

https://demo.ellipsecloud.com/api/chmbase/?type=roomstdrate&from=2020-05-01&to=2020-05-10

Odpoveď:

{
   "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
      }
  }
}

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é - )

https://demo.ellipsecloud.com/api/chmbase/?type=stayprices&from=2020-05-01&to=2020-05-10&adults=2&children=4-6

Odpoveď:

[{
   "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":...
  }]
}]

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)

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