# Ellipse Cloud Documentation - Full Corpus
Generated: 2026-05-20T17:44:51+02:00
Source: https://docs.ellipsecloud.com/
Articles: 110, Changelog entries: 0, FAQ items: 0
Tento súbor obsahuje plný text všetkých publikovaných článkov, changelog záznamov a FAQ z dokumentácie Ellipse Cloud. Určené pre LLM/AI retrieval. Pre štruktúrovaný prehľad (s linkami) viď https://docs.ellipsecloud.com/llms.txt.
==============================================================================
# Články
## Aktualizačný proces - Ellipse Cloud Docs
URL: https://docs.ellipsecloud.com/aktualizacny-proces/
Modified: 2026-05-20T17:24:04+02:00
Summary: Postup aktualizácie a referenčná dokumentácia admin záložiek.
Ako prebieha aktualizácia Ellipse Cloud, na čo si dať pozor, a kde nájdeš detailnú dokumentáciu jednotlivých admin záložiek.
O čom je táto sekcia
Sekcia Aktualizačný proces je sprievodca tým, ako Ellipse Cloud udržiavame, vyvíjame a aktualizujeme. Tu nájdeš:
Postupy ako zaviesť novú verziu na produkcii
Referenčnú dokumentáciu každej admin záložky (automaticky generovanú AI a manuálne schválenú redaktorom)
Prepojenie na changelog kde vidíš všetky publikované zmeny
Štruktúra dokumentácie admin záložiek
Každá z približne 370 záložiek v admine má (alebo bude mať) vlastný článok, ktorý obsahuje:
Na čo záložka slúži - krátky úvod
Kde ju nájdeš - cesta v hlavnom menu admina
Krok za krokom - typický pracovný postup
Popis polí a nastavení - vysvetlenie každého poľa formulára
Typické scenáre použitia
Časté chyby a riešenia
Ako funguje generovanie
Drafty článkov generuje cron pb=admin-docs raz za 6 hodín z PHP zdrojákov modulu manager/show_admin/. Redaktor draft prečíta, doladí, schváli a publikuje. Pri každej zmene zdrojáku admin súboru sa môže článok regenerovať tlačidlom Regenerovať z kódu priamo v admine.
Ako sa aktualizácie nasadzujú
Tím vývoja pracuje v gite HorecaGroup/ellipse_2019. Pri každom merge na master:
Denný cron stiahne nové commity a vytvorí changelog drafty
Redaktor schvaľuje drafty a publikuje ich
LLM linker po publikovaní nájde dotknuté články dokumentácie a vytvorí TODO úlohu
Po update všetkých článkov sa preklady automaticky odošlú do DeepL (SK → EN)
Detailný zoznam zmien je vždy v sekcii Changelog.
------------------------------------------------------------------------------
## Vernostný systém CRM
URL: https://docs.ellipsecloud.com/vernostny-system-crm/
Modified: 2026-05-12T15:56:45+02:00
Overenie spojenia
Pre čítanie a zápis údajov CRM sa používa HTTP Basic Authentication. Prihlasovacie meno a heslo nastavuje používateľ systému Ellipse v administrácii v časti Nastavenia → Pripojenia. Pri konkrétnom API spojení je potrebné v časti Detail API povoliť Povoliť CRM API a jednotlivé operácie podľa typu volania.
Pre produkčné prostredie je potrebné v administrácii povoliť IP adresu pre vzdialený dopyt (prázdne pole IP znamená prístup bez obmedzenia podľa adresy). Podpora je dostupná na office@horecagroup.sk.
Hlavička požiadavky:
Authorization: Basic base64(username:password)
Základná adresa a formát odpovede
Všetky odpovede sú JSON (Content-Type: application/json; charset=utf-8). Operácia sa vyberá query parametrom type.
https://demo.ellipsecloud.com/?pa=api&pb=crm&type={operácia}&…
Oprávnenia podľa parametru type
Okrem zapnutého CRM API musí byť pri spojení povolená aj konkrétna operácia:
users — zoznam kontaktov
profile — detail profilu kontaktu
insight — kredit, tagy, úroveň, obraty (pobyty / služby / podujatia), posledný pohyb na kredite
credit_add — pripísanie kreditu (POST)
credit_sub — odpočet kreditu (POST)
user_add — pridanie kontaktu do CRM (POST)
user_remove — odobratie kontaktu z CRM (POST)
HTTP návratové kódy
200 — úspech
201 — vytvorený kontakt (user_add)
400 — neplatné parametre alebo telo
401 — chýba alebo nie je platná autentifikácia
403 — zakázaná IP, nedostatočné oprávnenie alebo blokovaný e-mail
404 — kontakt sa nenašiel
405 — nesprávna HTTP metóda
409 — konflikt (napr. duplicitný e-mail pri user_add)
500 — chyba servera
Zoznam používateľov CRM — users
Metóda: GET. Povinný parameter: type (= users). Voliteľné: limit (predvolene 100, max. 500), offset (predvolene 0).
https://demo.ellipsecloud.com/?pa=api&pb=crm&type=users&limit=50&offset=0
Vzorová úspešná odpoveď:
{
"ok": true,
"users": [
{
"id": 757,
"name": "Ján",
"surname": "Novák",
"email": "jan.novak@example.com",
"phone": "+421900111222",
"crm_tags": { "3": "Rodina" },
"registered_at": "2025-06-01 12:34:56"
}
],
"limit": 50,
"offset": 0
}
Detail profilu — profile
Metóda: GET. Povinné parametre: type (= profile), idcrm (číslo kontaktu).
https://demo.ellipsecloud.com/?pa=api&pb=crm&type=profile&idcrm=757
Odpoveď obsahuje kompletnú kartu kontaktu (meno, e-mail, telefón, adresa, kategórie CRM, poznámky a ďalšie polia podľa nastavenia).
Vzorová odpoveď (skrátená):
{
"ok": true,
"profile": {
"id": 757,
"email": "jan.novak@example.com",
"residence": { "street": "…", "city": "…", "zip": "…" },
"categories": [{ "id": 2, "name": "Hotelový hosť" }]
}
}
Kredit, tagy a obraty — insight
Metóda: GET. Povinné parametre: type (= insight), idcrm.
https://demo.ellipsecloud.com/?pa=api&pb=crm&type=insight&idcrm=757
V objekte turnover sú položky stays (pobyty), services (služby), events (podujatia) a total. Pole last_credit_movement obsahuje posledný pohyb na účte kreditu alebo hodnotu null.
Vzorová úspešná odpoveď:
{
"ok": true,
"insight": {
"idcrm": 757,
"credit": 125.5,
"currency": "EUR",
"crm_level_hint": "standard",
"turnover": {
"stays": 980,
"services": 120.5,
"events": 0,
"total": 1100.5
},
"last_credit_movement": {
"amount": 50,
"balance_after": 125.5,
"datetime": "2026-05-10 14:22:01"
}
}
}
Pripísanie kreditu — credit_add
Metóda: POST. Obsah: application/json. Telo požiadavky je JSON objekt s poľami idcrm (číslo kontaktu) a amount (kladná suma).
https://demo.ellipsecloud.com/?pa=api&pb=crm&type=credit_add
Vzorová úspešná odpoveď:
{
"ok": true,
"idcrm": 757,
"amount": 25.5,
"credit": 151
}
Odpočet kreditu — credit_sub
Metóda: POST, rovnaká štruktúra JSON ako pri credit_add; v tele zadávate kladnú hodnotu amount, systém vykoná odpočet. Pri nedostatku kreditu vráti HTTP 400 s popisom chyby.
https://demo.ellipsecloud.com/?pa=api&pb=crm&type=credit_sub
Vzorová úspešná odpoveď:
{
"ok": true,
"idcrm": 757,
"amount": -10,
"credit": 141
}
Pridanie kontaktu — user_add
Metóda: POST. JSON telo:
email (povinné) — platný a v systéme zatiaľ nepoužitý e-mail
name, surname (voliteľné)
lang (voliteľné)
send_registration_mail (voliteľné, boolean) — ak je true, zaradí sa odoslanie registračného e-mailu
https://demo.ellipsecloud.com/?pa=api&pb=crm&type=user_add
Vzorová úspešná odpoveď (HTTP 201):
{
"ok": true,
"idcrm": 12041,
"email": "nova.hostka@example.com",
"registration_mail_enqueued": false
}
Odobratie kontaktu — user_remove
Metóda: POST. JSON telo musí obsahovať idcrm. Ide o nevratné zmazanie kontaktu z CRM a súvisiacich záznamov v rozsahu ako pri mazaní v administrácii.
https://demo.ellipsecloud.com/?pa=api&pb=crm&type=user_remove
Vzorová úspešná odpoveď:
{
"ok": true,
"idcrm": 12041,
"message": "CRM contact removed"
}
Poznámky
Názvy vernostných skupín a CRM tagov závisia od konfigurácie hotela. Obraty v insight používajú rovnakú logiku ako manažérska časť CRM. Pre vlastné nasadenie nahraďte v adresách doménu demo.ellipsecloud.com doménou vášho hotela.
Súvis s cenami a rezerváciami pobytov je popísaný samostatne v časti dokumentácie Ceny, dostupnosť a rezervácie.
------------------------------------------------------------------------------
## Rezervácie v Ellipse pre RMS systémy
URL: https://docs.ellipsecloud.com/rezervacie-v-ellipse-pre-rms-systemy/
Modified: 2026-04-15T21:57:58+02:00
Úč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/
------------------------------------------------------------------------------
## Aktualizácia flexi cien z RMS systémov
URL: https://docs.ellipsecloud.com/aktualizacia-flexi-cien-z-rms-systemov/
Modified: 2026-04-15T21:35:04+02:00
Overenie spojenia
Pre zápis cien a minimálnej dĺžky pobytu (minstay) sa používa rovnaký spôsob overenia ako pri ostatných volaniach Channel Manager base API: Base HTTP autentifikácia. Prihlasovacie údaje nastavuje používateľ v administrácii Ellipse. Pre produkčné prostredie je potrebné povoliť IP adresu pre vzdialený dopyt. Podpora je dostupná na office@horecagroup.sk.
Zmena denných cien a minstay – changeprice
Endpoint umožňuje hromadne zapisovať alebo upravovať predajnú cenu (sale), cenu pre OTA kanály (price) a minimálnu dĺžku pobytu v kalendári pre vybrané typy izieb a dni. Telo požiadavky musí byť JSON pole objektov; každý objekt reprezentuje jeden deň a jeden typ izby.
Metóda: POST. Obsah: application/json. Parametre v query reťazci ovplyvňujú synchronizáciu na prepojené izby (skupiny izieb alebo legacy isbase/isconn podľa nastavenia hotela).
Endpoint (základná adresa)
https://demo.ellipsecloud.com/api/chmbase/?type=changeprice
Voliteľné parametre URL
updateconnectedprices – ak je 1, po úspešnej zmene na „hlavnej“ izbe sa podľa pravidiel hotela prepočítajú a zapíšu ceny aj na prepojené izby. updateconnectedminlos – ak je 1, pri prepojených izbách sa môže aktualizovať aj minimálna dĺžka pobytu podľa logiky prepojenia; ak je 0, pri nových záznamoch na prepojených izbách sa často použije minstay z hlavnej izby.
Príklad adresy s parametrami prepojených izieb
https://demo.ellipsecloud.com/api/chmbase/?type=changeprice&updateconnectedprices=1&updateconnectedminlos=1
Štruktúra jedného objektu v tele požiadavky
Date – deň vo formáte YYYY-mm-dd (musí byť dnes alebo budúcnosť).
RoomTypeId – číselné ID typu izby v systéme Ellipse.
Price – predajná cena pre web booking (sale v databáze).
PriceOTA – cena pre OTA / kanál (price v databáze).
IsClosed – súčasť požiadavky a odpovede (v odpovedi sa vracia; správanie voči zatvoreniu závisí od konfigurácie a prepojení).
Minstay – minimálna dĺžka pobytu v nociach (0 znamená bez obmedzenia podľa tohto poľa).
Vzorové JSON teleso (pole dvoch dní)
[{
"Date": "2026-08-25",
"Price": 200,
"PriceOTA": 100.5,
"IsClosed": 0,
"Minstay": 2,
"RoomTypeId": 1
},
{
"Date": "2026-08-26",
"Price": 200,
"PriceOTA": 100.5,
"IsClosed": 0,
"Minstay": 0,
"RoomTypeId": 11
} ]
Úspešná odpoveď (HTTP 200)
Odpoveď je JSON objekt. Pole Data obsahuje záznamy o vykonaných operáciách (insert alebo update) so známou pečiatkou, dátumom, cenami, Minstay, RoomTypeId a poľom Method. Ak niektoré ID izby alebo dátum neprešli validáciou, môžu sa v odpovedi objaviť polia NotFoundRooms alebo BadDates.
Vzorová úspešná odpoveď
{ "Data": [ { "Stamp": "2026-04-15 10:30:00", "Date": "2026-08-25", "Price": 200, "PriceOTA": 100.5, "IsClosed": 0, "Minstay": 2, "RoomTypeId": 1, "Method": "update" } ] }
Chyba – prázdne alebo neplatné JSON (HTTP 400)
{ "error": "Invalid or empty JSON payload. Expected array of price change objects.", "Data": [] }
Súvis s čítaním cien
Na čítanie cien a minstay pre zobrazenie na webe alebo výpočet pobytu slúžia samostatné typy volaní (napríklad roomstdrate, stayprices) popísané v článku Ceny, dostupnosť a rezervácie na docs.ellipsecloud.com. Volanie changeprice slúži na zápis do kalendára cien, nie na výpočet pobytu.
https://docs.ellipsecloud.com/ceny-dostupnost-a-rezervacie/
------------------------------------------------------------------------------
## Ako umiestniť Booking engine lištu na webovú stránku
URL: https://docs.ellipsecloud.com/ako-umiestnit-booking-engine-listu-na-webovu-stranku/
Modified: 2026-03-03T18:02:15+01:00
Booking Panel je fixná lišta v spodnej časti stránky, ktorá návštevníkom umožňuje rýchlo vyhľadať dostupnosť izieb a kúpiť darčekové poukazy. Obsahuje výber dátumov príchodu a odchodu, výber počtu osôb a detí, a tlačidlá pre rezerváciu aj darčekové poukazy. Inštalácia vyžaduje vloženie jedného riadku kódu na váš web.
Vzorový script: https://chamoisapartments.com/
Základná inštalácia
Krok 1: Pripravte si údaje
Pre inštaláciu budete potrebovať:
Base URL - adresa vášho Ellipse systému (napr. https://grandhotel.ellipsecloud.com)
Booking URL - adresa vášho rezervačného systému / booking engine
Gift URL - adresa stránky s darčekovými poukazmi (voliteľné)
Krok 2: Skopírujte kód scriptu
Základný kód pre vloženie na web:
Nahraďte VASA-DOMENA názvom vášho hotela v systéme Ellipse. Príklad pre hotel Grand:
Krok 3: Vložte kód na váš web
Kód vložte do HTML vašej stránky pred uzatvárací tag