• Docs
• Booking
• API mix
• API mix - obmedzenia distribučných kanálov cez API predaj

API mix - obmedzenia distribučných kanálov cez API predaj

API mix

V tejto záložke nastavuješ, koľko izieb môže každý distribučný kanál (Booking.com, Expedia a podobne) predať v konkrétne dni. Vidíš tu obsadenosť, počet voľných izieb a pre každý kanál osobitne nastavíš maximálny počet predaja (Max sale) a StopSale. Prídeš sem, keď chceš obmedziť predaj cez konkrétny kanál, napríklad pred sviatkami alebo pri nízkej obsadenosti.

Kde to nájdeš

V ľavom menu klikni na Booking → API mix. Adresa v prehliadači bude /manager/prices/apimix/. Na obrazovke uvidíš filter s výberom termínu, tlačidlo Hromadné úpravy a tabuľku s distribučnými kanálmi. Ak nemáš nastavené žiadne API prepojenie s limitom predaja, zobrazí sa ti informačná hláška a odkaz na Nastavenia API pripojení.

Čo tu môžeš robiť

• Vybrať termín: Zadáš dátum od-do a stlačíš Zobraziť — tabuľka sa prefiltruje na zvolené dni.
• Nastaviť Max sale: Pre každý kanál a deň zadáš číslo do poľa Max sale — určíš maximálny počet izieb, ktoré môže kanál predať v daný deň.
• Zapnúť StopSale: Zaškrtneš políčko StopSale pri konkrétnom kanáli a dni — kanál nebude môcť v tento deň predávať žiadne izby.
• Uložiť nastavenia: Po vyplnení polí klikneš na Uložiť nastavenia — zmeny sa uložia a zobrazí sa hláška „Nastavenia boli uložené."
• Hromadná úprava: Klikneš na Hromadné úpravy — otvorí sa modálne okno, kde nastavíš Max sale a StopSale pre viacero kanálov a dní naraz.
• Vybrať dni v týždni: V hromadnej úprave použiješ tlačidlá Označiť víkend, Označiť týždeň, Vybrať všetko alebo Odobrať všetko — rýchlo označíš dni, na ktoré chceš aplikovať zmenu.
• Aplikovať hromadnú zmenu: Po výbere kanálov a dní klikneš na Aplikovať hromadnú zmenu — systém uloží nastavenia pre všetky vybrané kombinácie a zobrazí počet aktualizovaných záznamov.

Postup krok za krokom

1. Vyber termín: Do poľa Od zadaj dátum začiatku (napr. 01.06.2025) a do poľa Do dátum konca (napr. 30.06.2025). Klikni na Zobraziť.
2. Skontroluj obsadenosť: V hornej časti tabuľky uvidíš riadok Obsadenosť s percentami a riadok K dispozícii s počtom voľných izieb pre každý deň.
3. Nájdi distribučný kanál: Prejdi tabuľkou nadol — každý kanál má vlastný blok s názvom (napr. „Booking.com") a pod ním riadok Predané, Max sale a StopSale.
4. Nastav Max sale: Do poľa Max sale pri konkrétnom kanáli a dni zadaj číslo (napr. 5). Ak chceš zakázať predaj úplne, zadaj 0 alebo zaškrtni StopSale.
5. Ulož zmeny: Skroluj na koniec tabuľky a klikni na Uložiť nastavenia. Zobrazí sa zelená hláška „Nastavenia boli uložené."
6. Použij hromadnú úpravu (voliteľné): Ak chceš nastaviť rovnaké hodnoty pre viacero dní, klikni na Hromadné úpravy, vyber kanály, označ dni (napr. Označiť víkend), zadaj Max sale a StopSale a klikni na Aplikovať hromadnú zmenu.

Polia, stĺpce a nastavenia

• Od / Do: Polia pre výber dátumového rozsahu. Zadávaš dátum v tvare dd.mm.rrrr (napr. 15.05.2025). Po kliknutí na pole sa otvorí kalendár. Použiješ ich, keď chceš zobraziť konkrétne obdobie — napríklad len júl alebo len víkendy v júni.
• Zobraziť: Tlačidlo, ktoré prefiltruje tabuľku na zvolený termín. Klikneš naň po vyplnení polí Od a Do. Tabuľka sa znovu načíta a zobrazí len dni v zadanom rozsahu.
• Hromadné úpravy: Tlačidlo, ktoré otvorí modálne okno pre nastavenie Max sale a StopSale pre viacero kanálov a dní naraz. Použiješ ho, keď chceš napríklad obmedziť predaj cez všetky kanály počas víkendov alebo pred sviatkami.
• Obsadenosť: Riadok v tabuľke, ktorý zobrazuje percento obsadených izieb pre každý deň. Počíta sa z celkového počtu dostupných izieb (bez draft rezervácií) a rezervovaných izieb. Hodnota 100 % znamená, že sú všetky izby obsadené. Tento riadok je globálny — platí pre všetky kanály dohromady.
• K dispozícii: Riadok v tabuľke, ktorý zobrazuje počet voľných izieb pre každý deň. Počíta sa ako celkový počet izieb mínus draft rezervácie mínus rezervované izby. Ak je hodnota 0, nemáš žiadne voľné izby a predaj by mal byť zastavený.
• Distribučný kanál: Názov API prepojenia (napr. „Booking.com", „Expedia"). Pod názvom vidíš v zátvorke názov distribútora, ak je priradený. Každý kanál má vlastný blok v tabuľke s riadkami Predané, Max sale a StopSale.
• Predané: Riadok v bloku každého kanála, ktorý zobrazuje počet izbonoci predaných cez tento konkrétny distribučný kanál v daný deň. Počíta sa len z rezervácií, ktoré majú priradenú distribútora tohto kanála a nie sú draft ani zrušené.
• Max sale: Vstupné pole (číslo) pre každý kanál a deň. Zadávaš tu maximálny počet izieb, ktoré môže kanál predať v daný deň. Ak zadáš 0, kanál nebude môcť predať žiadnu izbu (rovnaký efekt ako StopSale). Ak pole necháš prázdne, systém ho uloží ako 0. Použiješ ho, keď chceš obmedziť predaj cez konkrétny kanál — napríklad Booking.com môže predať max 3 izby, Expedia max 2.
• StopSale: Zaškrtávacie políčko pre každý kanál a deň. Ak ho zaškrtneš, kanál nebude môcť v tento deň predávať žiadne izby. Použiješ ho, keď chceš úplne zastaviť predaj cez konkrétny kanál — napríklad počas údržby alebo ak máš plno a nechceš riskovať prepredanie.
• Uložiť nastavenia: Tlačidlo na konci tabuľky. Klikneš naň po vyplnení polí Max sale a StopSale. Systém uloží všetky zmeny do databázy a zobrazí zelenú hlášku „Nastavenia boli uložené." Ak nezmeníš žiadne pole a klikneš na toto tlačidlo, zmeny sa aj tak uložia (prázdne polia sa uložia ako 0).
• Distribučné kanály (v hromadnej úprave): Zoznam zaškrtávacích políčok s názvami API prepojení. Označíš kanály, pre ktoré chceš aplikovať hromadnú zmenu. Ak neoznačíš žiadny kanál, systém zobrazí chybu „Pre hromadnú aktualizáciu musíte vyplniť všetky polia a vybrať aspoň jeden kanál a deň."
• Dni v týždni (v hromadnej úprave): Zoznam zaškrtávacích políčok pre Pondelok, Utorok, Streda, Štvrtok, Piatok, Sobota, Nedeľa. Označíš dni, na ktoré chceš aplikovať hromadnú zmenu. Systém aplikuje zmenu len na tie dni v zobrazenom termíne, ktoré zodpovedajú označeným dňom v týždni.
• Vybrať všetko: Tlačidlo v hromadnej úprave, ktoré označí všetky dni v týždni (Pondelok až Nedeľa). Použiješ ho, keď chceš aplikovať zmenu na celý týždeň.
• Odobrať všetko: Tlačidlo v hromadnej úprave, ktoré odznačí všetky dni v týždni. Použiješ ho, keď chceš začať výber odznova.
• Označiť víkend: Tlačidlo v hromadnej úprave, ktoré označí Sobotu a Nedeľu. Použiješ ho, keď chceš aplikovať zmenu len na víkendy — napríklad obmedziť predaj cez Booking.com len na víkendové dni.
• Označiť týždeň: Tlačidlo v hromadnej úprave, ktoré označí Pondelok až Piatok. Použiješ ho, keď chceš aplikovať zmenu len na pracovné dni.
• Aplikovať hromadnú zmenu: Tlačidlo v hromadnej úprave. Klikneš naň po vyplnení Max sale, StopSale a výbere kanálov a dní. Systém uloží nastavenia pre všetky kombinácie a zobrazí hlášku „Hromadná aktualizácia bola úspešne uložená. Aktualizovaných: X" (X = počet záznamov).
• Zrušiť: Tlačidlo v hromadnej úprave, ktoré zatvorí modálne okno bez uloženia zmien. Použiješ ho, keď si to rozmyslíš alebo chceš začať odznova.

Tipy a časté chyby

• Nevidíš žiadne kanály v tabuľke: Systém zobrazí hlášku „Žiadne API prepojenia" a odkaz na nastavenia. Znamená to, že nemáš nastavené žiadne API prepojenie s aktivovaným limitom predaja. Choď do Nastavenia → API pripojenia, vyber kanál (napr. Booking.com), zaškrtni možnosť „Limit predaja" (limitsales) a priradí distribútora. Potom sa kanál zobrazí v API mix.
• Max sale sa neuloží: Ak zadáš Max sale, klikneš na Uložiť nastavenia, ale po obnovení stránky je pole prázdne, skontroluj, či si naozaj klikol na tlačidlo Uložiť nastavenia (nie len na Enter). Systém ukladá len po kliknutí na toto tlačidlo. Ak problém pretrváva, skontroluj, či máš nastavený distribútor pre daný kanál v API pripojeniach.
• Hromadná úprava nefunguje: Ak klikneš na Aplikovať hromadnú zmenu a zobrazí sa chyba „Pre hromadnú aktualizáciu musíte vyplniť všetky polia a vybrať aspoň jeden kanál a deň", znamená to, že si nezadal Max sale alebo StopSale, alebo si neoznačil žiadny kanál alebo deň. Vyplň obe polia (aj keď chceš nastaviť len jedno, druhé zadaj ako 0), označ aspoň jeden kanál a aspoň jeden deň v týždni.
• Obsadenosť je 100 %, ale máš voľné izby: Obsadenosť sa počíta z dostupných izieb mínus draft rezervácie. Ak máš veľa draft rezervácií (mimoprevádzkové izby), obsadenosť môže byť vysoká, aj keď máš fyzicky voľné izby. Skontroluj draft rezervácie v kalendári a zruš tie, ktoré už nie sú potrebné.
• Predané izby sa nezobrazujú správne: Riadok Predané zobrazuje len rezervácie, ktoré majú priradenú distribútora daného kanála. Ak si vytvoril rezerváciu ručne cez Ellipse a nepriradil si distribútora, nezobrazí sa tu. Choď do rezervácie, otvor detail a vyber distribútora v poli „Distribútor".
• Chceš obmedziť predaj len na víkendy: Klikni na Hromadné úpravy, vyber kanály, klikni na Označiť víkend, zadaj Max sale (napr. 2) a StopSale (0 alebo 1), klikni na Aplikovať hromadnú zmenu. Systém nastaví limit len pre soboty a nedele v zobrazenom termíne.
• Chceš úplne zastaviť predaj cez konkrétny kanál: Nájdi kanál v tabuľke, zaškrtni StopSale pre všetky dni (alebo použi hromadnú úpravu s Vybrať všetko a StopSale = 1) a klikni na Uložiť nastavenia. Kanál nebude môcť predávať žiadne izby v zvolenom termíne.
• Tabuľka je príliš široká: Ak zobrazuješ veľa dní (napr. 60), tabuľka sa môže rozšíriť mimo obrazovku. Zmenš termín v filtri (napr. zobraz len 14 dní) alebo použi horizontálny scroll. Systém zobrazuje max 60 dní naraz.
• Chceš nastaviť rôzne limity pre rôzne kanály: Nemôžeš použiť hromadnú úpravu, pretože tá nastaví rovnaké hodnoty pre všetky vybrané kanály. Musíš nastaviť Max sale manuálne pre každý kanál v tabuľke. Vyplň polia Max sale pre každý kanál osobitne a klikni na Uložiť nastavenia.
• Chceš skopírovať nastavenia z minulého mesiaca: Systém momentálne nepodporuje kopírovanie nastavení medzi termínmi. Musíš použiť hromadnú úpravu alebo vyplniť polia manuálne. Ak potrebuješ skopírovať nastavenia často, použi hromadnú úpravu s Vybrať všetko a aplikuj rovnaké hodnoty na nový termín.