Docs
API komunikácia
Dostupné API volania pre Ellipse Cloud

Dostupné API volania pre Ellipse Cloud

Každé prepojenie prostredníctvom API je viazané výhradným súhlasom poskytovateľa systému. Nižšie nájdete aktuálny prehľad všetkých verejných endpointov Ellipse Cloud (139 operácií, verzia 2026-07-07).

API referencia (skrátená URL)

API v2 · aktualizované 2026-07-07

Ellipse Cloud REST API

139 dokumentovaných operácií získaných priamo z kódu demo.ellipsecloud.com/api. OAuth2 Bearer (Auth v2) alebo legacy HTTP Basic.

Stiahnuť OpenAPI YAML Auth v2 YAML RS Content YAML

Autentifikácia

Odporúčame OAuth2 Bearer tokeny (Auth v2). Podrobný návod vrátane scopes a migrácie z Basic auth: Token-based autentifikácia.

OAuth2 Token API v2 odporúčané

V admin manageri vytvorte client_id + client_secret.
POST /api/auth/v2/token s grant_type=client_credentials.
Posielajte Authorization: Bearer <access_token> na modulové endpointy.
Pri exspirácii rotujte cez grant_type=refresh_token.

Request — token

HTTP Basic (legacy)

Stále podporované do 30.09.2026 (sunset 2026-10-01T00:00:00Z). Používateľ a heslo z tabuľky api_connections, IP whitelist voliteľný.

Authorization: Basic base64(username:password)

Demo dokumentácia: ellipse / demo na demo.ellipsecloud.com.

Filtrovať endpointy

Autentifikácia

OAuth2 token API v2 nahrádza priame HTTP Basic volania. Token získate cez client_credentials, potom posielate Authorization: Bearer.

5 operácií

POST /api/auth/v2/token/

Vystavenie access + refresh tokenu (client_credentials alebo refresh_token rotation)

Auth: client_id + client_secret (Basic alebo JSON body)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/auth/v2/token/' -H 'Content-Type: application/json' -d '{"grant_type":"client_credentials","client_id":"ak_…","client_secret":"…"}'

JSON príklady

Request

Response 200

POST /api/auth/v2/revoke/

Revokácia refresh alebo access tokenu (RFC 7009)

Auth: client credentials

cURL príklad

curl -sS -X POST 'https://{tenant}/api/auth/v2/revoke/' -H 'Content-Type: application/json' -d '{"token":"rt_…"}'

JSON príklady

Request

POST /api/auth/v2/introspect/

Overenie stavu tokenu (RFC 7662)

Auth: client credentials

JSON príklady

Request

Response 200

GET /api/auth/v2/discovery/

OAuth2 metadata (TTL tokenov, podporované granty)

Auth: verejné

cURL príklad

curl -sS 'https://{tenant}/api/auth/v2/discovery/'

GET /api/auth/v2/jwks/

JWKS (HS256 — kid, bez verejného kľúča)

Auth: verejné

cURL príklad

curl -sS 'https://{tenant}/api/auth/v2/jwks/'

Rezervácie a plachta (chmbase)

CRUD operácie nad rezerváciami, izbami, cenami a dostupnosťou. GET/POST s parametrom type alebo JSON body (POST). Scope chmbase:read / chmbase:write.

21 operácií

GET /api/chmbase/?type=roomtypes chmbase:read

Zoznam typov izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=roomtypes'

JSON príklady

Response 200

GET /api/chmbase/?type=roomcount&from=2026-07-08&to=2026-07-11 chmbase:read

Dostupnosť izieb podľa dátumu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=roomcount'

JSON príklady

Response 200

GET /api/chmbase/?type=stayprices&from=2026-07-08&to=2026-07-11&adults=2&children=4-6&lang=sk chmbase:read

Ceny pobytov

Poznámka: Hash v base/variant/offer/openprice platí 30 min od odpovede; datetime je čas generovania, nie expirácia. Pole price = ubytovanie + fees. V price_details: forsale = cena bez poplatkov, fees = súčet povinných poplatkov (vrátane miestnej dane; bez rozpisu po položkách). Promo zľava a cenový koeficient sa aplikujú len na ubytovanie, nie na fees.

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=stayprices&from=2026-07-08&to=2026-07-11&adults=2&children=4-6&lang=sk'

JSON príklady

Response 200

[
    {
        "room": "3",
        "room_name": "Dvojlôžková izba",
        "persons": {
            "adults": "2",
            "1": 4,
            "2": 6
        },
        "from": "2026-07-08",
        "to": "2026-07-11",
        "datetime": "2026-07-07 08:00:00",
        "langs": [
            "sk",
            "en",
            "de"
        ],
        "multiroom": 0,
        "available_for_multiroom": 2,
        "openprice": {
            "hash": "…"
        },
        "base": {
            "name": "Ubytovanie s raňajkami",
            "price": "412.50",
            "beforesale": "444.50",
            "cancellation": 1,
            "minstay": 2,
            "available": 2,
            "bookable": true,
            "hash": "…",
            "price_details": {
                "forsale": 400,
                "forsale_with_coef": 400,
                "forpercent": 432,
                "fees": 12.5,
                "total_calculation": 412.5,
                "final_price": 412.5,
                "price_type": "base_wb"
            },
            "cancellation_policy": {
                "policy_id": 2,
                "policy_type": "tiered",
                "tier_percent_by_days_before": {
                    "14": 0,
                    "4": 50,
                    "0": 100
                },
                "customer": {
                    "free_cancel_until": "2026-06-24",
                    "summary": "Bezplatné storno do 14 dní pred príchodom"
                }
            }
        },
        "variant": [
            {
                "id": "9",
                "name": "Pobyt s polpenziou",
                "price": "512.50",
                "beforesale": "552.50",
                "cancellation": 2,
                "minstay": 2,
                "available": 2,
                "bookable": true,
                "hash": "…",
                "price_details": {
                    "forsale": 500,
                    "forsale_with_coef": 500,
                    "forpercent": 540,
                    "fees": 12.5,
                    "total_calculation": 512.5,
                    "final_price": 512.5,
                    "price_type": "variant_wb"
                },
                "cancellation_policy": {
                    "policy_id": 2,
                    "policy_type": "tiered",
                    "tier_percent_by_days_before": {
                        "14": 0,
                        "4": 50,
                        "0": 100
                    },
                    "customer": {
                        "free_cancel_until": "2026-06-24",
                        "summary": "Bezplatné storno do 14 dní pred príchodom"
                    }
                }
            }
        ],
        "offer": [
            {
                "id": "42",
                "name": "Wellness hýčkanie",
                "price": "582.50",
                "beforesale": "622.50",
                "cancellation": 1,
                "minstay": 2,
                "available": 2,
                "bookable": true,
                "hash": "…",
                "price_details": {
                    "forsale": 450,
                    "forsale_with_coef": 450,
                    "forpercent": 486,
                    "fees": 12.5,
                    "total_calculation": 462.5,
                    "final_price": 462.5,
                    "price_type": "offer_wb",
                    "services": 120
                },
                "cancellation_policy": {
                    "policy_id": 2,
                    "policy_type": "tiered",
                    "tier_percent_by_days_before": {
                        "14": 0,
                        "4": 50,
                        "0": 100
                    },
                    "customer": {
                        "free_cancel_until": "2026-06-24",
                        "summary": "Bezplatné storno do 14 dní pred príchodom"
                    }
                }
            }
        ]
    }
]

GET /api/chmbase/?type=roomstdrate&from=2026-07-08&to=2026-07-11 chmbase:read

Štandardné sadzby izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=roomstdrate'

JSON príklady

Response 200

GET /api/chmbase/?type=offer&offer=30 chmbase:read

Detail balíka / ponuky

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=offer'

JSON príklady

Response 200

GET /api/chmbase/?type=variant&variant=1 chmbase:read

Varianty pobytov

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=variant'

JSON príklady

Response 200

GET /api/chmbase/?type=hotelinfo chmbase:read

Informácie o hoteli

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=hotelinfo'

GET /api/chmbase/?type=gallery chmbase:read

Galéria hotela / izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=gallery'

GET /api/chmbase/?type=pictograms chmbase:read

Piktogramy vybavenia

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=pictograms'

GET /api/chmbase/?type=bookingmeta chmbase:read

Meta dáta booking engine

Poznámka: Pozri BOOKING_API_META.md

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=bookingmeta'

GET /api/chmbase/?type=resinfo&rel=228880&resid=392 chmbase:read

Detail rezervácie (chmbase pohľad)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=resinfo'

JSON príklady

Response 200

GET /api/chmbase/?type=cancellation chmbase:read

Storno podmienky

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=cancellation'

JSON príklady

Response 200

POST /api/chmbase/?type=newbooking chmbase:write

Vytvorenie novej rezervácie

Poznámka: Parameter hash zo stayprices; po 30 min {"error":"Expired"}. POST s JSON body alebo query parametrami.

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=newbooking'

JSON príklady

Request

Response 200

POST /api/chmbase/?type=cancel chmbase:write

Zrušenie rezervácie

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=cancel'

JSON príklady

Response 200

POST /api/chmbase/?type=edit chmbase:write

Úprava rezervácie

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=edit'

JSON príklady

Response 200

POST /api/chmbase/?type=editdata chmbase:write

Úprava údajov hostí

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=editdata'

JSON príklady

Response 200

POST /api/chmbase/?type=addroom chmbase:write

Pridanie izby k rezervácii

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=addroom'

JSON príklady

Response 200

POST /api/chmbase/?type=deleteroom chmbase:write

Odstránenie izby z rezervácie

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=deleteroom'

JSON príklady

Response 200

POST /api/chmbase/?type=resdate chmbase:write

Zmena dátumov pobytu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=resdate'

JSON príklady

Response 200

POST /api/chmbase/?type=changeprice chmbase:write

Zmena ceny rezervácie

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=changeprice'

POST /api/chmbase/?type=edithotelbook chmbase:write

Úprava hotel book záznamu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=edithotelbook'

Pobyty a hostia (stays)

Operačné dáta hotelovej plachty — zoznam pobytov, detail rezervácie, check-in stav, hotelový účet. Scope stays:read; 1srchres vyžaduje stays:gdpr. Detail rezervácie vracia externé mapovanie: typ pobytu (`ext_stay_type_id`), služby (`mapping_code`), položky pokladne (`plu`).

24 operácií

GET /api/stays/?type=list stays:read

Zoznam pobytov / obsadenosť (anonymized=1 bez OÚ)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=list'

GET /api/stays/?type=getreservation stays:read

Detail rezervácie (resid+email/pin alebo altid)

Poznámka: Externé mapovanie: rooms[].ext_stay_type_id (manager/rooms/maping), stay_services[].mapping_code a persons[].services[].mapping_code (manager/services/maping), hotel_card_items[].plu (PLU z manager/register/items). Detail: getreservation.api.md

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=getreservation'

GET /api/stays/?type=getreservation_verified stays:read

Overený detail rezervácie

Poznámka: Rovnaké externé mapovanie ako getreservation (ext_stay_type_id, mapping_code, plu).

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=getreservation_verified'

GET /api/stays/?type=getonlinecheck stays:read

Stav online check-inu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=getonlinecheck'

GET /api/stays/?type=status stays:read

Stav rezervácie

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=status'

GET /api/stays/?type=roomstatus stays:read

Stav izby

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=roomstatus'

GET /api/stays/?type=roompairs stays:read

Mapovanie izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=roompairs'

GET /api/stays/?type=persons stays:read

Osoby na izbe

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=persons'

GET /api/stays/?type=resbyphone stays:read

Vyhľadanie rezervácie podľa telefónu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=resbyphone'

GET /api/stays/?type=card stays:read

Hotelový účet (karta)

Poznámka: Položky účtu obsahujú register_item_type, register_item_id a externé PLU (manager/register/items).

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=card'

POST /api/stays/?type=paybill stays:read

Úhrada účtu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=paybill'

POST /api/stays/?type=restopay stays:read

Platba cez reštauráciu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=restopay'

GET /api/stays/?type=offers stays:read

Ponuky pre pobyt

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=offers'

GET /api/stays/?type=vouchers stays:read

Poukazy hosta

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=vouchers'

GET /api/stays/?type=partner stays:read

Partner / firma

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=partner'

GET /api/stays/?type=heatmap stays:read

Heatmapa obsadenosti

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=heatmap'

GET /api/stays/?type=pinmap stays:read

PIN mapa izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=pinmap'

GET /api/stays/?type=afterstay stays:read

After-stay dotazník / follow-up

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=afterstay'

GET /api/stays/?type=sex stays:read

Číselník pohlaví

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=sex'

GET /api/stays/?type=board stays:read

Číselník stravovania

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=board'

GET /api/stays/?type=country stays:read

Číselník krajín

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=country'

GET /api/stays/?type=1srchres stays:gdpr

GDPR vyhľadávanie rezervácií

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=1srchres'

POST /api/stays/?type=cardpay stays:read

Platba hotelového účtu kartou (token z getreservation)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=cardpay'

GET /api/stays/?type=getreservation&altid=2008281 stays:read

Príklad: detail rezervácie podľa altid (demo)

Poznámka: Ukážka s ext_stay_type_id, mapping_code (služby) a plu (položky účtu). Kompletná schéma: api/stays/getreservation.api.md

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/stays/?type=getreservation&altid=2008281'

JSON príklady

Response 200

{
    "resinfo": {
        "id": "2008281",
        "token": "WU5SNC9EU0NtNC9QVVFVOFdSWVJNUT09",
        "email": "peter.sveter@example.com",
        "name": "Peter",
        "surname": "Sveter",
        "lang": "sk",
        "statusid": "12",
        "selfcheck": "https:\/\/selfcheckin.app\/JK7TBK",
        "statusname": "Neuhradená",
        "online_checkin_status": 0,
        "hotel_account": {
            "total_on_card_vat": 651.8,
            "balance_due_vat": 651.8,
            "currency": "EUR"
        },
        "stay_services": [
            {
                "id": 133,
                "title": "1 hodinový vstup",
                "line_price": 10,
                "source": "package",
                "in_package": true,
                "mapping_code": "WELL-1H",
                "currency": "EUR"
            },
            {
                "id": 120,
                "title": "Ajurvédska masáž 50 min.",
                "line_price": 90,
                "source": "package",
                "in_package": true,
                "mapping_code": "SPA-AYUR50",
                "currency": "EUR"
            },
            {
                "id": 146,
                "title": "Degustačná večera",
                "line_price": 30,
                "source": "package",
                "in_package": true,
                "mapping_code": "GAST-DEG30",
                "currency": "EUR"
            },
            {
                "id": 115,
                "title": "Fľaša vína",
                "line_price": 9,
                "source": "package",
                "in_package": true,
                "mapping_code": "FB-WINE750",
                "currency": "EUR"
            },
            {
                "id": 106,
                "title": "Masáž balíčková 20 Eur",
                "line_price": 20,
                "source": "package",
                "in_package": true,
                "mapping_code": "SPA-MASS20",
                "currency": "EUR"
            },
            {
                "id": 28,
                "title": "Reflexná masáž 60 min.",
                "line_price": 17,
                "source": "package",
                "in_package": true,
                "mapping_code": "SPA-REF60",
                "currency": "EUR"
            }
        ],
        "stay_price_services_persons": [
            {
                "reservation_person_id": 37180,
                "id_room": 35,
                "idp": 1,
                "services": [
                    {
                        "source": "package",
                        "service_id": 133,
                        "book_service_id": 252,
                        "title": "1 hodinový vstup",
                        "line_price": 10,
                        "mapping_code": "WELL-1H",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 120,
                        "book_service_id": 261,
                        "title": "Ajurvédska masáž 50 min.",
                        "line_price": 90,
                        "mapping_code": "SPA-AYUR50",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 146,
                        "book_service_id": 256,
                        "title": "Degustačná večera",
                        "line_price": 30,
                        "mapping_code": "GAST-DEG30",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 115,
                        "book_service_id": 260,
                        "title": "Fľaša vína",
                        "line_price": 9,
                        "mapping_code": "FB-WINE750",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 106,
                        "book_service_id": 254,
                        "title": "Masáž balíčková 20 Eur",
                        "line_price": 20,
                        "mapping_code": "SPA-MASS20",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 106,
                        "book_service_id": 258,
                        "title": "Masáž balíčková 20 Eur",
                        "line_price": 20,
                        "mapping_code": "SPA-MASS20",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 28,
                        "book_service_id": 270,
                        "title": "Reflexná masáž 60 min.",
                        "line_price": 17,
                        "mapping_code": "SPA-REF60",
                        "in_package": true,
                        "currency": "EUR"
                    }
                ]
            },
            {
                "reservation_person_id": 37181,
                "id_room": 35,
                "idp": 2,
                "services": [
                    {
                        "source": "package",
                        "service_id": 133,
                        "book_service_id": 253,
                        "title": "1 hodinový vstup",
                        "line_price": 10,
                        "mapping_code": "WELL-1H",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 120,
                        "book_service_id": 262,
                        "title": "Ajurvédska masáž 50 min.",
                        "line_price": 90,
                        "mapping_code": "SPA-AYUR50",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 146,
                        "book_service_id": 257,
                        "title": "Degustačná večera",
                        "line_price": 30,
                        "mapping_code": "GAST-DEG30",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 175,
                        "book_service_id": 269,
                        "title": "Konzum 50e 5%",
                        "line_price": 50,
                        "mapping_code": "FB-KONZ50",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 106,
                        "book_service_id": 255,
                        "title": "Masáž balíčková 20 Eur",
                        "line_price": 20,
                        "mapping_code": "SPA-MASS20",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 106,
                        "book_service_id": 259,
                        "title": "Masáž balíčková 20 Eur",
                        "line_price": 20,
                        "mapping_code": "SPA-MASS20",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 28,
                        "book_service_id": 271,
                        "title": "Reflexná masáž 60 min.",
                        "line_price": 17,
                        "mapping_code": "SPA-REF60",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "web_booking_person",
                        "service_id": null,
                        "book_service_id": null,
                        "title": "Parkovanie (WB doplnok na osobu)",
                        "line_price": null,
                        "mapping_code": "PARK-1",
                        "in_package": null,
                        "currency": "EUR",
                        "uid": "2008281-2-45-1"
                    }
                ]
            }
        ],
        "hotel_card_items": [
            {
                "id": 81445,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 84,
                "plu": "MASSAGE84",
                "title": "Masáže \/ Massage 84",
                "vat_rate_percent": 23,
                "price_unit_vat": 20,
                "lot": 2,
                "amount_vat": 40
            },
            {
                "id": 81446,
                "room_id": 35,
                "register_item_type": "cal",
                "register_item_id": 13,
                "plu": "MENU-DUCK",
                "title": "Kačacie stehno s červenou kapustou 320g",
                "vat_rate_percent": 5,
                "price_unit_vat": 20,
                "lot": 2,
                "amount_vat": 40
            },
            {
                "id": 81448,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 226,
                "plu": "FB-FM075",
                "title": "Frankovka modrá 0,75l",
                "vat_rate_percent": 23,
                "price_unit_vat": 9,
                "lot": 1,
                "amount_vat": 9
            },
            {
                "id": 81450,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 8,
                "plu": "TAX-LOCAL",
                "title": "Miestny poplatok \/ Local tax",
                "vat_rate_percent": 0,
                "price_unit_vat": 1.5,
                "lot": 2,
                "amount_vat": 3
            },
            {
                "id": 81453,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 3039,
                "plu": "CRED-STAY",
                "title": "Kredit konzumné k pobytu",
                "vat_rate_percent": 5,
                "price_unit_vat": 50,
                "lot": 1,
                "amount_vat": 50
            },
            {
                "id": 81457,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 7,
                "plu": "ROOM-ACC",
                "title": "Ubytovanie \/ Accommodation",
                "vat_rate_percent": 5,
                "price_unit_vat": 63.6,
                "lot": 1,
                "amount_vat": 63.6
            },
            {
                "id": 81456,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 50,
                "plu": "FB-BFAST",
                "title": "Raňajky dospelý \/ Breakfast adults",
                "vat_rate_percent": 5,
                "price_unit_vat": 14,
                "lot": 2,
                "amount_vat": 28
            }
        ]
    },
    "rooms": [
        {
            "idroom": "24339",
            "ext_stay_type_id": "DLX-BB-114",
            "roomname": "511",
            "uidroom": "35",
            "rateid": "114",
            "ratetype": "offer",
            "arrival": "2026-06-05",
            "departure": "2026-06-08",
            "checkin_time": "14:00",
            "checkout_time": "10:00",
            "roomstatus": "waiting",
            "clean": "false",
            "persons": [
                {
                    "id": "37180",
                    "name": "Peter",
                    "surname": "Sveter",
                    "services": [
                        {
                            "source": "package",
                            "service_id": 133,
                            "book_service_id": 252,
                            "title": "1 hodinový vstup",
                            "line_price": 10,
                            "mapping_code": "WELL-1H",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 120,
                            "book_service_id": 261,
                            "title": "Ajurvédska masáž 50 min.",
                            "line_price": 90,
                            "mapping_code": "SPA-AYUR50",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 146,
                            "book_service_id": 256,
                            "title": "Degustačná večera",
                            "line_price": 30,
                            "mapping_code": "GAST-DEG30",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 115,
                            "book_service_id": 260,
                            "title": "Fľaša vína",
                            "line_price": 9,
                            "mapping_code": "FB-WINE750",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 106,
                            "book_service_id": 254,
                            "title": "Masáž balíčková 20 Eur",
                            "line_price": 20,
                            "mapping_code": "SPA-MASS20",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 106,
                            "book_service_id": 258,
                            "title": "Masáž balíčková 20 Eur",
                            "line_price": 20,
                            "mapping_code": "SPA-MASS20",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 28,
                            "book_service_id": 270,
                            "title": "Reflexná masáž 60 min.",
                            "line_price": 17,
                            "mapping_code": "SPA-REF60",
                            "in_package": true,
                            "currency": "EUR"
                        }
                    ]
                },
                {
                    "id": "37181",
                    "name": "Druhá",
                    "surname": "Osoba",
                    "services": [
                        {
                            "source": "package",
                            "service_id": 133,
                            "book_service_id": 253,
                            "title": "1 hodinový vstup",
                            "line_price": 10,
                            "mapping_code": "WELL-1H",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 120,
                            "book_service_id": 262,
                            "title": "Ajurvédska masáž 50 min.",
                            "line_price": 90,
                            "mapping_code": "SPA-AYUR50",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 146,
                            "book_service_id": 257,
                            "title": "Degustačná večera",
                            "line_price": 30,
                            "mapping_code": "GAST-DEG30",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 175,
                            "book_service_id": 269,
                            "title": "Konzum 50e 5%",
                            "line_price": 50,
                            "mapping_code": "FB-KONZ50",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 106,
                            "book_service_id": 255,
                            "title": "Masáž balíčková 20 Eur",
                            "line_price": 20,
                            "mapping_code": "SPA-MASS20",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 106,
                            "book_service_id": 259,
                            "title": "Masáž balíčková 20 Eur",
                            "line_price": 20,
                            "mapping_code": "SPA-MASS20",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 28,
                            "book_service_id": 271,
                            "title": "Reflexná masáž 60 min.",
                            "line_price": 17,
                            "mapping_code": "SPA-REF60",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "web_booking_person",
                            "service_id": null,
                            "book_service_id": null,
                            "title": "Parkovanie (WB doplnok na osobu)",
                            "line_price": null,
                            "mapping_code": "PARK-1",
                            "in_package": null,
                            "currency": "EUR",
                            "uid": "2008281-2-45-1"
                        }
                    ]
                }
            ]
        }
    ]
}

Doklady a účtovníctvo (money)

Faktúry, bločky, pokladničné položky, partneri. Scope money:read / money:write.

21 operácií

GET /api/money/?type=vat money:read

Sadzby DPH

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=vat'

GET /api/money/?type=regitems money:read

Položky registra

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=regitems'

GET /api/money/?type=regsets money:read

Sety položiek

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=regsets'

GET /api/money/?type=registers money:read

Pokladne / registre

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=registers'

GET /api/money/?type=regcat money:read

Kategórie registra

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=regcat'

GET /api/money/?type=invcat money:read

Kategórie faktúr

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invcat'

GET /api/money/?type=invgroup money:read

Skupiny faktúr

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invgroup'

GET /api/money/?type=invlist money:read

Zoznam faktúr

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invlist'

GET /api/money/?type=billslist money:read

Zoznam bločkov

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=billslist'

GET /api/money/?type=exbillslist money:read

Externé bločky — zoznam

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=exbillslist'

GET /api/money/?type=exbill money:read

Externý bloček — detail

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=exbill'

GET /api/money/?type=bill money:read

Detail bločku

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=bill'

GET /api/money/?type=lastinvid money:read

Posledné ID faktúry

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=lastinvid'

GET /api/money/?type=lastbillid money:read

Posledné ID bločku

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=lastbillid'

GET /api/money/?type=invrange money:read

Rozsah faktúr

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invrange'

GET /api/money/?type=billrange money:read

Rozsah bločkov

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=billrange'

GET /api/money/?type=getpartner money:read

Detail partnera

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=getpartner'

POST /api/money/?type=invoice money:write

Vytvorenie faktúry

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invoice'

POST /api/money/?type=invpayment money:write

Platba faktúry

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invpayment'

POST /api/money/?type=billspayment money:write

Platba bločkov

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=billspayment'

POST /api/money/?type=addpartner money:write

Pridanie partnera

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=addpartner'

CRM

Správa CRM kontaktov, kredit, insight. Vyžaduje crm_api=1 na pripojení + príslušný sub-scope.

7 operácií

GET /api/crm/?type=users&limit=100&offset=0 crm:list

Zoznam CRM používateľov (limit/offset)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/crm/?type=users'

JSON príklady

Response 200

GET /api/crm/?type=profile&idcrm=42 crm:profile

Profil CRM kontaktu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/crm/?type=profile'

GET /api/crm/?type=insight&idcrm=42 crm:insight

CRM insight (kredit, obrat, VIP)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/crm/?type=insight'

JSON príklady

Response 200

POST /api/crm/?type=credit_add crm:credit_add

Pripísanie kreditu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -X POST -H 'Authorization: Bearer $TOKEN' -H 'Content-Type: application/json' 'https://{tenant}/api/crm/?type=credit_add' -d '{"idcrm":42,"amount":25.5}'

JSON príklady

Request

POST /api/crm/?type=credit_sub crm:credit_sub

Odpočítanie kreditu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

JSON príklady

Request

POST /api/crm/?type=user_add crm:user_add

Registrácia nového CRM kontaktu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

JSON príklady

Request

POST /api/crm/?type=user_remove crm:user_remove

Odstránenie CRM kontaktu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

JSON príklady

Request

Hotelový účet — zápis (bor / bor2)

Pripísanie položiek na izbu / hotelový účet hosta. bor scope bor:write, bor2 scope bor2:write.

5 operácií

GET /api/bor/?type=roompairs bor:write

Mapovanie izieb pre zápis

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/bor/?type=roompairs'

GET /api/bor/?type=checkroom bor:write

Overenie izby pred zápisom

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/bor/?type=checkroom'

POST /api/bor/?type=billtoroom bor:write

Zápis položky na hotelový účet izby

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/bor/?type=billtoroom'

JSON príklady

Request

Response 200

GET /api/bor2/?type=openbills bor2:write

Otvorené účty

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/bor2/?type=openbills'

POST /api/bor2/?type=billtoroom bor2:write

Zápis položky (bor2)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/bor2/?type=billtoroom'

Pokladne a zľavové kódy (register)

Správa zľavových QR kódov a pokladničných operácií. Scope register:read / register:write.

6 operácií

GET /api/register/?type=registerlist register:read

Zoznam pokladní

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=registerlist'

GET /api/register/?type=listsc register:read

Zoznam zľavových kódov

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=listsc'

GET /api/register/?type=used register:read

Použité kódy

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=used'

GET /api/register/?type=invoice_head register:read

Hlavička faktúry z pokladne

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=invoice_head'

POST /api/register/?type=setsc register:write

Vytvorenie / úprava zľavového kódu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=setsc'

POST /api/register/?type=deletesc register:write

Zmazanie zľavového kódu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=deletesc'

Služby (services)

Rezervácie služieb a oblastí (wellness, gastro). Scope services:read.

2 operácií

GET /api/services/?type=areas services:read

Oblasti / zóny služieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/services/?type=areas'

GET /api/services/?type=reservations services:read

Rezervácie služieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/services/?type=reservations'

Web booking & kanály

Endpointy pre booking engine a channel manager. Autentifikácia cez Bearer/Basic so scope wb:*. Pre analytiku vyhľadávaní (LYST / Looker) pozri modul Booking analytika.

6 operácií

GET /api/rooms/ wb:rooms

Zoznam izieb pre web booking

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/rooms/'

GET /api/offers/ wb:offers

Ponuky / balíky

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/offers/'

GET /api/checkroomsavailability/ wb:availability

Dostupnosť izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/checkroomsavailability/'

GET /api/checkpricescallendar/ wb:prices

Cenový kalendár

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/checkpricescallendar/'

GET /api/stayprices/ wb:stayprices

Ceny pobytov (WB)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stayprices/'

POST /api/multiellipsebookingdl/ wb:bookings

Multi-property booking download

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/multiellipsebookingdl/'

Booking analytika

Export vyhľadávaní a konverzií z web booking engine pre externé BI (Looker Studio, BigQuery). Scope analytics:booking — na API spojení zapnite Booking analytika API (analytics_api). Súvisí s reportom manager web/13 (YoY / LYST).

4 operácií

GET

/api/analytics/?type=booking_events&event_date_from=2026-06-01&event_date_to=2026-06-30&stay_date_from=2026-07-01&stay_date_to=2026-08-31&funnel_step=1&limit=1000&offset=0

analytics:booking

Event log vyhľadávaní — kedy (event_date) host hľadal ktorý termín (stay_date). Odporúčané pre LYST v Looker.

Poznámka: Query: event_date_from/to (deň udalosti), stay_date_from/to (termín pobytu), funnel_step 1–4, limit max 5000. Bez PII (bez session_id).

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/analytics/?type=booking_events&event_date_from=2026-06-01&event_date_to=2026-06-30&funnel_step=1'

JSON príklady

Response 200

GET /api/analytics/?type=booking_aggregates&stay_date_from=2026-07-01&stay_date_to=2026-08-31&limit=500 analytics:booking

Agregát podľa termínu príchodu (stay_date) — kumulatívny stav z reservations_stats.

Poznámka: Rovnaká logika ako report Web Booking /13. Nie je to historický snapshot — pre LYST použite booking_events alebo booking_snapshots.

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/analytics/?type=booking_aggregates&stay_date_from=2026-07-01&stay_date_to=2026-08-31'

JSON príklady

Response 200

GET /api/analytics/?type=booking_snapshots&snapshot_date=2026-06-08&stay_date_from=2026-07-01&stay_date_to=2026-08-31 analytics:booking

Denné snímky stavu vyhľadávaní (snapshot_date) — zdroj pre LYST v reporte aj v BI.

Poznámka: Snapshoty vznikajú denným cronom (tabuľka reservations_stats_snapshot, migrácia 1115). Query: snapshot_date alebo snapshot_date_from/to.

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/analytics/?type=booking_snapshots&snapshot_date=2026-06-08'

JSON príklady

Response 200

GET /api/analytics/?type=docs analytics:booking

Markdown dokumentácia modulu (Looker workflow, GDPR, príklady LYST)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/analytics/?type=docs'

RS Content API

Verejné read-only JSON API nad redakčným obsahom (články, izby, balíky, poukazy). OpenAPI: /api/rs/RS_CONTENT_API.yaml

17 operácií

GET /api/rs/?type=meta&lang=sk

RS obsah: meta

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=meta&lang=sk'

GET /api/rs/?type=articles&lang=sk

RS obsah: articles

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=articles&lang=sk'

GET /api/rs/?type=article&lang=sk

RS obsah: article

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=article&lang=sk'

GET /api/rs/?type=banners&lang=sk

RS obsah: banners

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=banners&lang=sk'

GET /api/rs/?type=text&lang=sk

RS obsah: text

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=text&lang=sk'

GET /api/rs/?type=categories&lang=sk

RS obsah: categories

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=categories&lang=sk'

GET /api/rs/?type=category_articles&lang=sk

RS obsah: category_articles

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=category_articles&lang=sk'

GET /api/rs/?type=articles_latest&lang=sk

RS obsah: articles_latest

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=articles_latest&lang=sk'

GET /api/rs/?type=galleries&lang=sk

RS obsah: galleries

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=galleries&lang=sk'

GET /api/rs/?type=gallery&lang=sk

RS obsah: gallery

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=gallery&lang=sk'

GET /api/rs/?type=rooms&lang=sk

RS obsah: rooms

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=rooms&lang=sk'

GET /api/rs/?type=room&lang=sk

RS obsah: room

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=room&lang=sk'

GET /api/rs/?type=room_filters_catalog&lang=sk

RS obsah: room_filters_catalog

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=room_filters_catalog&lang=sk'

GET /api/rs/?type=offers&lang=sk

RS obsah: offers

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=offers&lang=sk'

GET /api/rs/?type=offers_top&lang=sk

RS obsah: offers_top

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=offers_top&lang=sk'

GET /api/rs/?type=vouchers&lang=sk

RS obsah: vouchers

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=vouchers&lang=sk'

GET /api/rs/?type=events&lang=sk

RS obsah: events

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=events&lang=sk'

RMS — katalóg izieb

Verejný katalóg izieb pre RMS integrácie. rmsbookings vyžaduje autentifikáciu.

3 operácií

GET /api/rms/?type=langs

Podporované jazyky

Auth: verejné

cURL príklad

curl -sS 'https://{tenant}/api/rms/?type=langs'

GET /api/rms/?type=list

Katalóg izieb s fotkami a vybavením

Auth: verejné

cURL príklad

curl -sS 'https://{tenant}/api/rms/?type=list'

GET /api/rms/?type=rmsbookings&from=2026-01-01&to=2026-01-31 rms:read

Anonymizované rezervácie pre RMS

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $TOKEN' 'https://{tenant}/api/rms/?type=rmsbookings&from=2026-01-01&to=2026-01-31'

MCP Gateway (AI integrácie)

Endpointy pre AI asistentov (ChatGPT, Claude, Gemini). HMAC podpis okrem health/discovery. Kanonický gateway: mcp.ellipsecloud.com

12 operácií

GET /api/mcp/v1/health/ verejné

Health check

Auth: verejné

cURL príklad

curl -sS -X GET 'https://{tenant}/api/mcp/v1/health/'

GET /api/mcp/v1/discovery/ verejné

Discovery profil

Auth: verejné

cURL príklad

curl -sS -X GET 'https://{tenant}/api/mcp/v1/discovery/'

GET /api/mcp/v1/profile/ HMAC

Profil hotela

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X GET 'https://{tenant}/api/mcp/v1/profile/'

POST /api/mcp/v1/availability/ HMAC

Dostupnosť

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/availability/'

POST /api/mcp/v1/offers/ HMAC

Ponuky

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/offers/'

POST /api/mcp/v1/quote/ HMAC

Cenová ponuka

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/quote/'

POST /api/mcp/v1/best_price_periods/ HMAC

Najlepšie obdobia cien

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/best_price_periods/'

POST /api/mcp/v1/gift_vouchers/ HMAC

Darčekové poukazy

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/gift_vouchers/'

POST /api/mcp/v1/service_timeslots/ HMAC

Termíny služieb

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/service_timeslots/'

GET /api/mcp/v1/contract-party/ HMAC

Fakturačné údaje

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X GET 'https://{tenant}/api/mcp/v1/contract-party/'

POST /api/mcp/v1/area-booking-ingest/ HMAC

Import area booking

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/area-booking-ingest/'

POST /api/mcp/v1/area-booking-cancel/ HMAC

Zrušenie area booking

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/area-booking-cancel/'

Hardvérové integrácie

Assa Abloy, Salto, iCal export. Vyžadujú povolené API pripojenie alebo token v URL.

3 operácií

POST /api/assaabloy/ assaabloy:write

Assa Abloy Visionline — vydanie / prepísanie karty

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -X POST -H 'Authorization: Bearer $TOKEN' 'https://{tenant}/api/assaabloy/' -H 'Content-Type: application/json' -d '{"room":3,"resid":2004277,"start":"2026-08-15 12:00","end":"2026-08-20 12:00"}'

JSON príklady

Request

Response 200

POST /api/salto/ salto:write

Salto zámky — vydanie karty (rovnaká JSON štruktúra ako Assa Abloy)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -X POST -H 'Authorization: Bearer $TOKEN' 'https://{tenant}/api/salto/' -H 'Content-Type: application/json' -d '{…}'

JSON príklady

Request

GET /api/ical/{room|area}/{token}.ical.ics

iCal export (RFC 5545) pre OTA a kalendáre

Auth: token v URL

cURL príklad

curl -sS 'https://{tenant}/api/ical/room/TOKEN.ical.ics'

Gastro — vydané objednávky (regorders)

Polling vybavených objednávok z kuchyne pre bzučiaky a výdajné miesta. Odporúčame obmedziť prístup IP firewallom.

1 operácií

GET /api/regorders/?type=all register:read

Vybavené objednávky (dnes alebo od fromid)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $TOKEN' 'https://{tenant}/api/regorders/?type=all'

JSON príklady

Response 200

Periférie — čítačky a datastore

Integrácie s čítačkami dokladov a periférnymi zariadeniami. Hash reťazec a IP whitelist sa nastavujú individuálne v admine.

2 operácií

POST /api/datastore/?hash={service}-{device}-{encryptedId}

Zápis JSON dát z periférie (prepíše predchádzajúce dáta pre rovnaký hash)

Auth: hash v URL + IP whitelist

cURL príklad

curl -sS -X POST 'https://{tenant}/api/datastore/?hash=1-1-…' -H 'Content-Type: application/json' -d '{"data":{"temperature":4.2}}'

JSON príklady

Request

Response 200

POST /api/validate/?type=1&client={clientId}

Validácia QR dokladu (integrácia na mieru — kontaktujte support)

Auth: client ID + IP whitelist

JSON príklady

Request

Response 200