Parametry linku do silnika rezerwacyjnego

Po co	Oszczędź gościowi kroki: link z newslettera, wpisu lub strony docelowej otwiera moduł od razu z datami, składem gości, właściwymi typami pokoi, kodem promocyjnym lub językiem.
Dla kogo	Dla tych, którzy prowadzą stronę i kampanie obiektu: newslettery, wpisy, ogłoszenia, strony docelowe. Programista nie jest potrzebny — parametry dopisuje się do adresu strony.
Co uzyskasz	Linki do silnika rezerwacyjnego (Booking Engine), które otwierają go z gotowymi datami, składem gości, typami pokoi, kodem promocyjnym i językiem.
Ograniczenia	W artykule — główne parametry i scenariusze; pełen wykaz — w dokumentacji „Parametry linku” w PMS. Wśród parametrów linku nie ma waluty: walutę wyświetlania gość wybiera sam.

Link do silnika rezerwacyjnego to adres strony, na której moduł jest osadzony, plus parametry: krótkie wskazówki o tym, co moduł powinien wiedzieć jeszcze przed pierwszym kontaktem gościa. Moduł otwiera się od razu w odpowiednim stanie: strona pojedynczego apartamentu — z tym apartamentem, newsletter z promocją — z datami i kodem promocyjnym, wiadomość po niemiecku — po niemiecku. Parametry łączą się: jeden link może nieść i daty, i kod promocyjny, i język.

Data przyjazdu

Najczęstszym parametrem są daty: checkIn — data przyjazdu, checkOut — data wyjazdu. Daty zapisuje się w formacie RRRR-MM-DD, na przykład 2026-12-11. Zamiast daty przyjazdu można przekazać słowo today albo tomorrow — moduł wstawi dzisiejszą lub jutrzejszą datę. Liczbę nocy określa parametr nights.

Daty w linku to sposób, by doprowadzić gościa do gotowego wyboru. Wpis o świątecznych pobytach, newsletter ze specjalną ofertą na weekend — w takich wiadomościach link z datami zwalnia gościa z pierwszego kroku: kalendarz otworzy się z już wstawionymi dniami.

Efekt: moduł otwiera się z wstawionymi datami przyjazdu i wyjazdu — gość od razu widzi, co dostępne na jego daty.

Skład gości

Ile osób pojedzie — to też część wyszukiwania: adults — dorośli, children — dzieci. Wiek dzieci można podać w formie listy oddzielonej przecinkami; liczbę pokoi w wyszukiwaniu określa parametr rooms.

Link „dla rodziny z dziećmi” otwiera moduł z już uzupełnioną grupą: gość nie musi ustawiać liczników — wyszukiwanie od razu obejmuje tylko pokoje, które zmieszczą jego grupę.

Widget ma własne wartości domyślne — pola „Dorośli domyślnie” i „Dzieci domyślnie” na stronie „Widget” w PMS; działają wtedy, gdy gość otwiera widget bez parametrów.

Efekt: link przywozi ze sobą skład gości — moduł otwiera się z uzupełnionymi dorosłymi, dziećmi i liczbą pokoi.

Typy pokoi

Parametr roomTypeIds wskazuje, które typy pokoi pokazywać: moduł otworzy się tylko z wybranymi typami, a pozostałe nie pojawią się w wyszukiwaniu. Parametr jest powtarzalny — dopisuje się go po jednym razie na każdy typ, więc można zebrać i jeden, i kilka.

Główny scenariusz to strona pojedynczego apartamentu. W aparthotelu każdy apartament jest osobnym typem pokoju; strona apartamentu na Twojej witrynie dostaje własny link, który otwiera moduł od razu na tym apartamencie. Tak samo zbiera się linki „tylko suite” na kampanię reklamową albo „pokoje dwuosobowe” na newsletter z okazji rocznicy.

O tym, jakie typy pokoi w ogóle są sprzedawane na stronie, decydujesz przez stawki; parametr zawęża wybór w ramach już dostępnych. Pełen wykaz parametrów — w dokumentacji „Parametry linku” w PMS.

Efekt: jeden link — jeden zestaw typów pokoi: od całego apartamentu na jego stronie po dobór pod konkretną kampanię.

Kod promocyjny

Parametr promoCode przynosi kod do modułu: gość otwiera link, a kod czeka już w polu „Kod promocyjny” w koszyku — jakby wpisał go sam. Dalej wszystko znajome: przycisk „Zastosuj”, odpowiedź pojawia się pod polem, bez przeładowania strony.

Pole „Kod promocyjny” jest w koszyku domyślnie; za jego wyświetlanie odpowiada przełącznik „Pokaż pole kodu promocyjnego” na stronie „Widget”. Jak zbudowane są zniżki, jak działa okres ważności kodu i co pokazuje statystyka użyć — w artykule o kodach promocyjnych.

W parze z datami parametr składa całą promocję: „daty przyjazdu plus kod” w jednej wiadomości — gość otwiera moduł z już gotowymi warunkami kampanii.

Efekt: kod z linku czeka już w polu „Kod promocyjny” — zostaje jedno kliknięcie, żeby go zastosować.

Język

Parametr lang określa język modułu dla tego linku: moduł otworzy się od razu w wybranym języku. Przydaje się tam, gdzie język jest znany z góry: newsletter po niemiecku, strona dla włoskich gości, wpis w zagranicznych mediach społecznościowych.

Zestaw języków modułu określasz Ty — osiem języków dla gości, można włączyć dowolne z nich; przełącznik języka w nagłówku modułu pozostaje do dyspozycji gościa. Waluty wśród parametrów linku nie ma: język można w linku przekazać, ale walutę gość zawsze wybiera sam.

Efekt: link otwiera moduł w języku odbiorców — bez zbędnego kroku „znajdź swój język”.

Przepisy na linki

Podstawą każdego linku jest adres strony, na której moduł jest osadzony. Dla widgetu strona ta jest ustalona w PMS: na stronie „Widget”, w bloku „Zachowanie”, znajduje się pole „URL strony rezerwacji” — strona, na której osadzony jest moduł; przycisk widgetu prowadzi właśnie do niej. Link z parametrami to ten sam adres plus dopisane parametry: pierwszy — po znaku „?”, kolejne — po &.

Kilka gotowych przepisów:

• Promocja w newsletterze — daty i kod promocyjny w jednej wiadomości:

  https://hotel.example/booking?checkIn=2026-12-11&checkOut=2026-12-14&promoCode=WELCOME_10

• Strona apartamentu — jeden typ pokoju; parametr dopisuje się po jednym razie na każdy typ:

  https://hotel.example/booking?roomTypeIds=IDENTYFIKATOR

• Newsletter w języku gościa — do dowolnego zestawu parametrów dochodzi lang: niemiecka wersja wiadomości prowadzi do linku z datami i językiem, włoska — ze swoim.

Sam kod osadzania pozostaje bez zmian: snippet z PMS podłącza moduł z serwerów HotelsCalendar, więc linki z parametrami żyją tylko tam, gdzie je rozdajesz — w wiadomościach, wpisach i na stronach docelowych. Nie trzeba nic zmieniać na stronie.

Efekt: bierzesz adres strony rezerwacji, dopisujesz parametry — i link do kampanii gotowy.

Zobacz też

• Kody promocyjne — utwórz kod, który link wstawi do koszyka: zniżki, okresy ważności, ograniczenia i statystyka.
• Języki i waluty modułu — wybierz zestaw języków modułu i zrozum, dlaczego wśród parametrów linku nie ma waluty.
• Widget wieloobiektowy — kilka obiektów w jednym widgecie: komu pasuje i jak włączyć wybór obiektu.