• Docs
• Nastavenia
• Pripojenia
• Pripojenia - API pripojenia

Pripojenia - API pripojenia

Pripojenia

V tejto sekcii spravuješ API pripojenia pre externé systémy a partnerov, ktorí sa napájajú na tvoj Ellipse Cloud. Sem prídeš, keď potrebuješ vytvoriť nové API pripojenie pre booking engine, channel manager, PMS integráciu alebo iného partnera, ktorý potrebuje prístup k tvojim dátam o rezerváciách, cenách a dostupnosti.

Kde to nájdeš

Otvor ľavé menu a klikni na Nastavenia → Pripojenia. Adresa v prehliadači bude /manager/settings/connections/. Ak si superadmin (admin_id = 1), na vrchu stránky uvidíš modrý panel s odkazom na API tokeny — tam spravuješ modernú Bearer autentifikáciu. Bežní manažéri tento panel nevidia a pracujú len s tabuľkou pripojení.

Čo tu môžeš robiť

• Zapnúť alebo vypnúť pripojenie — zaškrtni alebo odškrtni checkbox v stĺpci Status a ulož zmeny. Vypnuté pripojenie sa prestane autentifikovať.
• Skopírovať Hash — v stĺpci Hash nájdeš šifrovaný reťazec, ktorý pošleš partnerovi ako autentifikačný token.
• Upraviť oprávnenia API — klikni na ikonu ceruzky v stĺpci Oprávnenia API, otvorí sa modálne okno s prepínačmi pre jednotlivé funkcie (voľná cena, WB ceny, limit predaja, Money API, GDPR, RMS API, CRM API).
• Nastaviť cenový koeficient a distribútora — v modálnom okne oprávnení zadaj koeficient (0,50 – 1,80) a vyber distribútora zo zoznamu.
• Odstrániť pripojenie (len superadmin) — klikni na ikonu koša v stĺpci Odstrániť, potvrdíš dialóg a záznam sa označí ako zmazaný.
• Upraviť meno, heslo a IP (len superadmin) — priamo v tabuľke zmeň hodnoty v stĺpcoch Meno spojenia, Heslo a IP, potom ulož.
• Uložiť všetky zmeny — po úpravách klikni na tlačidlo Uložiť v spodnej časti formulára.

Postup krok za krokom

1. Otvor záložku Nastavenia → Pripojenia v ľavom menu.
2. Nájdi riadok s pripojením, ktoré chceš upraviť (napr. „Booking Engine Partner").
3. Klikni na ikonu ceruzky v stĺpci Oprávnenia API — otvorí sa modálne okno s názvom „Oprávnenia API pripojenia".
4. Zapni prepínač Voľná cena, ak chceš partnerovi povoliť posielať vlastné ceny (nie len štandardné cenníkové).
5. Nastav Cenový koeficient na hodnotu medzi 0,50 a 1,80 (napr. 1,15 znamená +15 % k základnej cene).
6. Vyber Distribútor zo zoznamu, ak chceš rezervácie z tohto API pripojenia automaticky priradiť konkrétnemu distribútorovi.
7. Zapni ďalšie oprávnenia podľa potreby (Limit predaja, Money API, GDPR, RMS API, CRM API a jeho pod-oprávnenia).
8. Klikni Uložiť v modálnom okne — zmeny sa uložia do skrytých polí formulára.
9. Skontroluj checkbox Status v tabuľke — ak je zaškrtnutý, pripojenie je aktívne.
10. Klikni Uložiť v spodnej časti stránky — všetky zmeny (status, oprávnenia, koeficient, distribútor) sa zapíšu do databázy.
11. Skopíruj Hash z príslušného stĺpca a pošli ho partnerovi — tento reťazec použije na autentifikáciu API volaní.

Polia, stĺpce a nastavenia

• Status — checkbox, ktorý zapína alebo vypína pripojenie. Ak je vypnutý, API volania s týmto Hash sa odmietnu. Zapni ho len pre aktívnych partnerov.
• Názov — interný popis pripojenia (napr. „Booking.com Channel Manager", „Vlastná mobilná appka"). Superadmin môže meniť priamo v tabuľke, bežný manažér vidí len text.
• Hash — šifrovaný reťazec v tvare id|heslo, ktorý slúži ako API token. Skopíruj ho a pošli partnerovi — on ho použije v hlavičke Authorization: Basic ... alebo v URL parametri.
• Meno spojenia (len superadmin) — username pre Basic Auth. Partner ho použije spolu s heslom pri autentifikácii API volaní.
• Heslo (len superadmin) — heslo pre Basic Auth. Zmeň ho, ak podozrievaš kompromitáciu prístupu.
• IP (len superadmin) — voliteľné obmedzenie IP adresy, z ktorej môže partner volať API. Ak je prázdne, volania sú povolené z akejkoľvek IP.
• Odstrániť (len superadmin) — ikona koša. Kliknutím nastavíš deleted = 1 a pripojenie zmizne zo zoznamu (nie je fyzicky vymazané z databázy).
• Oprávnenia API — ikona ceruzky. Kliknutím otvoríš modálne okno s prepínačmi a poľami pre detailné nastavenie oprávnení (Voľná cena, WB ceny, Limit predaja, Cenový koeficient, Distribútor, Money API, GDPR, RMS API, CRM API).
• Voľná cena (v modálnom okne) — ak je zapnutá, partner môže posielať vlastné ceny, ktoré prepíšu štandardný cenník. Používaj opatrne — môže to narušiť tvoju cenovú stratégiu.
• WB ceny (v modálnom okne, len superadmin) — povoľuje partnerovi prístup k walk-in / bar cenám (ceny pre hostí bez rezervácie). Štandardne vypnuté.
• Limit predaja (v modálnom okne) — ak je zapnutý, partner vidí len dostupnosť do limitu predaja (nie celkovú kapacitu). Používaj pre OTA, aby si kontroloval, koľko izieb im sprístupníš.
• Cenový koeficient (v modálnom okne) — číslo medzi 0,50 a 1,80. Všetky ceny pre toto pripojenie sa vynásobia týmto koeficientom (napr. 1,10 = +10 %, 0,90 = -10 %). Validácia zabráni extrémnym hodnotám.
• Distribútor (v modálnom okne) — vyber distribútora zo zoznamu. Rezervácie vytvorené cez toto API pripojenie sa automaticky priradia vybranému distribútorovi (napr. „Booking.com", „Vlastný web").
• Money API (v modálnom okne, len superadmin) — povoľuje partnerovi prístup k finančným dátam (platby, faktúry, zostatky). Zapni len pre dôveryhodné systémy.
• GDPR (v modálnom okne, len superadmin) — povoľuje partnerovi prístup k GDPR endpointom (export, anonymizácia, výmaz osobných údajov). Používaj len pre compliance nástroje.
• RMS API (v modálnom okne, len superadmin) — povoľuje prístup k Revenue Management System API (dynamické ceny, predpovede, optimalizácia). Zapni pre RMS nástroje ako IDeaS, Duetto a pod.
• Povoliť CRM API (v modálnom okne, len superadmin) — hlavný prepínač pre CRM API. Ak je vypnutý, všetky pod-oprávnenia (Zoznam používateľov, Detail profilu atď.) sú neaktívne.
• Zoznam používateľov (v modálnom okne, len superadmin) — povoľuje volanie ?pa=api&pb=crm&type=users — partner dostane zoznam kontaktov z CRM.
• Detail profilu (v modálnom okne, len superadmin) — povoľuje volanie ?pa=api&pb=crm&type=profile — partner dostane detailné údaje o konkrétnom kontakte (meno, email, telefón, adresa).
• Kredit, tagy, úroveň, obraty (v modálnom okne, len superadmin) — povoľuje volanie ?pa=api&pb=crm&type=insight — partner dostane finančné a marketingové metriky kontaktu (kredit, vernostná úroveň, celkový obrat, tagy).
• Pripísanie kreditu (v modálnom okne, len superadmin) — povoľuje volanie ?pa=api&pb=crm&type=credit_add — partner môže pripísať kredit na účet kontaktu (napr. vernostný bonus).
• Odpočet kreditu (v modálnom okne, len superadmin) — povoľuje volanie ?pa=api&pb=crm&type=credit_sub — partner môže odpočítať kredit z účtu kontaktu (napr. pri uplatnení zľavy).
• Pridať kontakt do CRM (v modálnom okne, len superadmin) — povoľuje volanie ?pa=api&pb=crm&type=user_add — partner môže vytvoriť nový kontakt v CRM (napr. import z externého systému).
• Odobrať kontakt z CRM (v modálnom okne, len superadmin) — povoľuje volanie ?pa=api&pb=crm&type=user_remove — partner môže odstrániť kontakt z CRM (soft delete, nie fyzický výmaz).

Tipy a časté chyby

• Zabudneš uložiť po úprave oprávnení — modálne okno sa zatvorí, ale zmeny sa zapíšu len do skrytých polí formulára. Musíš ešte kliknúť na Uložiť v spodnej časti stránky, inak sa nič neuloží do databázy.
• Partner hlási chybu autentifikácie — skontroluj, či má pripojenie zaškrtnutý Status. Ak je vypnutý, API volania sa odmietnu. Skontroluj tiež, či partner používa správny Hash (skopíruj ho znova zo stĺpca Hash).
• Cenový koeficient nefunguje — validácia obmedzuje rozsah na 0,50 – 1,80. Ak zadáš napr. 2,50, systém ho automaticky zníži na 1,80. Ak chceš väčšiu zľavu alebo prirážku, použi inú metódu (napr. špeciálny cenník).
• Rezervácie sa nepriraďujú k distribútorovi — skontroluj, či si v modálnom okne oprávnení vybral distribútora zo zoznamu. Ak je nastavené „-- Nevybraté --", rezervácie sa nepriradia automaticky.
• Superadmin vidí iné polia ako bežný manažér — superadmin (admin_id = 1) vidí stĺpce Meno spojenia, Heslo, IP, Odstrániť a všetky pokročilé oprávnenia (WB ceny, Money API, GDPR, RMS API, CRM API). Bežný manažér vidí len Status, Názov, Hash a základné oprávnenia (Voľná cena, Limit predaja, Cenový koeficient, Distribútor, RMS API).
• Hash sa zmenil po úprave hesla — Hash je šifrovaný reťazec id|heslo. Ak superadmin zmení heslo v stĺpci Heslo, Hash sa automaticky prepočíta. Musíš poslať partnerovi nový Hash.
• CRM API nefunguje napriek zapnutým pod-oprávneniam — skontroluj, či je zapnutý hlavný prepínač Povoliť CRM API. Ak je vypnutý, všetky pod-oprávnenia (Zoznam používateľov, Detail profilu atď.) sú neaktívne, aj keď sú zaškrtnuté.
• Partner vidí všetky izby napriek Limit predaja — prepínač Limit predaja ovplyvňuje len dostupnosť (koľko izieb partner vidí ako voľné), nie celkovú kapacitu. Ak chceš obmedziť, ktoré typy izieb partner vidí, nastav to v channel manageri alebo booking engine, nie tu.
• Nevidíš tlačidlo Odstrániť — toto tlačidlo je dostupné len pre superadmina. Bežný manažér môže len vypnúť pripojenie (odškrtnúť Status), nie ho zmazať.
• Modálne okno oprávnení sa neotvorí — skontroluj, či máš povolený JavaScript v prehliadači. Ak problém pretrváva, vymaž cache prehliadača (Ctrl+Shift+Del) a obnov stránku (F5).