Rezervácie v Ellipse pre RMS systémy

Účel

Endpoint typu rmsbookings slúži na export agregovaných údajov o rezerváciách pre revenue management systémy (RMS). Neobsahuje osobné údaje hostí (mená, e-maily, adresy). Vracajú sa obchodné a prevádzkové polia: dátumy pobytu, typ izby, počet osôb, anonymizovaná krajina (ISO kód), kanály predaja, stav rezervácie, súčty z hotelového účtu a rozpad cien po nociach tam, kde to dáva zmysel.

Overenie spojenia

Používa sa HTTP Basic autentifikácia rovnako ako pri ďalších API volaniach Ellipse založených na tabuľke api_connections. Meno a heslo nastavuje administrátor v systéme. Ak je v konfigurácii používateľa vyplnená povolená IP adresa, musí sa zhodovať so zdrojovou IP volania, inak server odpovie chybou prístupu.

Metóda a adresa

Volanie je GET. Povinné sú parametre from a to vo formáte YYYY-mm-dd. Výsledok sa filtruje podľa prekrývania pobytu s daným intervalom (riadky izieb, ktoré majú časť pobytu v rozsahu).

https://demo.ellipsecloud.com/api/rms/?type=rmsbookings&from=2026-01-01&to=2026-01-31

Hlavička Authorization

Odosielajte štandardnú hlavičku Authorization s hodnotou Basic a kódovaním base64 z reťazca používateľskémeno:heslo.

Vylúčené záznamy

Do výstupu nepatria dočasné rezervácie (draft), záznamy so stornodátumom ani rezervácie v stave storno podľa predvoleného storno stavu v systéme.

Úspešná odpoveď (HTTP 200)

Koreň JSON obsahuje generatedAt (čas vygenerovania v ISO 8601), filter (opakovanie použitého from a to) a pole items. Každý prvok items zodpovedá jednému riadku izby v rezervácii (jedna fyzická položka pobytu).

{
  "generatedAt": "2026-04-15T12:00:00+02:00",
  "filter": {
    "from": "2026-01-01",
    "to": "2026-01-31"
  },
  "items": [
    {
      "uniqueId": "12345-678",
      "ellipseReservationId": 12345,
      "ellipseRoomLineId": 678,
      "bookingMethodName": "Web booking",
      "bookingSource": "online",
      "currencyId": "EUR",
      "exchangeRate": 1,
      "checkInDate": "2026-01-10T14:00:00+01:00",
      "checkOutDate": "2026-01-12T10:00:00+01:00",
      "roomTypeId": "1",
      "roomTypeName": "Dvojlôžková izba",
      "guests": 2,
      "nationality": "SK",
      "priceTotal": 240.5,
      "tripPurpose": "",
      "status": "Potvrdená",
      "statusId": 2,
      "bookingDate": "2025-12-01T09:15:00+01:00",
      "isGroup": false,
      "clienteleTypeId": 0,
      "clienteleTypeName": "",
      "distributionChannelId": 3,
      "distributionChannelName": "Booking.com",
      "rateKey": "1-0-0",
      "nights": [
        {
          "roomTypeId": "1",
          "day": "2026-01-10T12:00:00+00:00",
          "price": 120.25
        }
      ]
    }
  ]
}

Význam vybraných polí v items

uniqueId spája interné ID rezervácie a ID riadku izby.
bookingMethodName môže byť Web booking pri rezervácii cez web,
názov distribútora ak je vyplnený distribučný kanál, inak zjednodušene Direct.
bookingSource rozlišuje online a offline podľa webového zdroja.
clienteleType a distributionChannel odkazujú na číselník distribútorov v administrácii (segment klientely a kanál).
nationality je dvojpísmenový kód krajiny z číselníka štátov,
priceTotal je súčet položiek hotelového účtu pre danú izbu.
nights obsahuje denné čiastky z kalendárových položiek účtu;
ak detail po dňoch chýba, celková suma sa rozdelí rovnomerne na počet nocí pobytu.

Chyby

Pri chýbajúcom alebo neplatnom from alebo to server odpovie HTTP 400 a JSON s polem error. Pri neplatnom prihlásení 401. Pri nepovolenej IP 403.

{ "error": "Bad request - from and to (YYYY-mm-dd) are required" }

{ "error": "Not authorized" }

{ "error": "Remote Addr - 203.0.113.10" }

Súvisiaci článok

Všeobecný prehľad API pre ceny, dostupnosť a rezervácie vrátane iných typov volaní je v samostatnom návode na dokumentačnom webe.

https://docs.ellipsecloud.com/ceny-dostupnost-a-rezervacie/