Demo na żywo

API zakwaterowania

API noclegów dla hoteli, apartamentów i domków wakacyjnych

API noclegów dostarcza do Twojego serwisu rezerwacyjnego każdy rodzaj zakwaterowania: pokoje hotelowe, apartamenty z obsługą, domki wakacyjne, hostele i pensjonaty. Ta strona wyjaśnia, jakie dane stoją za noclegiem, czym wynajem różni się od hotelu i jak PHPTRAVELS sprzedaje Twoje obiekty oraz zasoby dostawców w jednym wyszukiwaniu.

  • Obiekt, jednostka, taryfa, kalendarz
  • Minimalny pobyt i opłaty
  • Okna anulowania
  • Własna oferta i zasoby z API

Model danych

Cztery warstwy w każdym noclegu

Czy to hotel na 300 pokoi, czy pojedynczy domek nad morzem, API zakwaterowania opisuje go w tych samych czterech zagnieżdżonych warstwach. Każda odpowiada na inne pytanie, które gość zadaje przed rezerwacją.

01Obiekt

Samo miejsce: nazwa, typ, adres i położenie na mapie, zdjęcia, udogodnienia, kategoria gwiazdkowa lub ocena jakości, regulamin i godziny zameldowania.

property_id · type · address · geo · photos · amenities · check_in_from

02Pokój lub jednostka

To, co faktycznie się rezerwuje: typ pokoju, cały apartament lub łóżko w dormitorium, z metrażem, łóżkami i maksymalną liczbą osób.

unit_id · beds · size_m2 · max_adults · max_children

03Plan taryfowy

Sposób sprzedaży tej jednostki: wyżywienie, polityka anulowania, warunki płatności i to, kto może ją zarezerwować, np. wszyscy lub tylko agenci.

rate_plan_id · board · cancel_policy · payment · channel

04Dostępność

Jeden wiersz na noc: cena, pozostałe jednostki, minimalny pobyt oraz informacja, czy w danym dniu wolno przyjechać lub wyjechać.

date · price · units_left · min_stay · closed_to_arrival

Budynek, pokój, metka z ceną i kalendarz narysowane jako ułożone warstwy jednej oferty noclegowej

PHPTRAVELS nazywa swój moduł zakwaterowania Stays, bo ten sam model obejmuje znacznie więcej niż hotele. Obiekt zawiera jednostki, jednostka jest sprzedawana w jednym lub kilku planach taryfowych, a każdy plan ma kalendarz noc po nocy z ceną i dostępnością. Gdy te cztery warstwy są poprawne, miejsce w hostelu, apartament hotelowy i trzypokojowa willa mieszczą się w tym samym wyszukiwaniu i procesie płatności.

Dostawcy nazywają warstwy różnie, a niektórzy łączą dwie w jedną, ale struktura zawsze tam jest. Noclegi sprowadza do niej każde źródło, dzięki czemu gość widzi jedną spójną stronę.

Noc po nocy

To w kalendarzu dostępności wygrywa się lub przegrywa noclegi

Każde API noclegów kończy się kalendarzem. Wyszukiwarka zwraca obiekt tylko wtedy, gdy każda noc żądanego pobytu jest wolna, wyceniona i dozwolona przez zasady pobytu.

Apartament dwupokojowy · Taryfa standardowaListopad 2026 · Cena za noc
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Wolne, cena za noc
  • Już zarezerwowane
  • Zamknięte przez właściciela
  • Minimalny pobyt od tego przyjazdu
  • Przyjazd niemożliwy

Dane poglądowe, uproszczone

  • Ceny są za nocSuma pobytu to suma poszczególnych nocy, więc piątek i sobota w stawce weekendowej kosztują więcej niż dwa dni robocze. Ceny dzienne i sezonowe są w kalendarzu, nie w obiekcie.
  • Zasady minimalnego pobytuMinimum trzech nocy przy przyjeździe w piątek ukrywa jednostkę w wyszukiwaniu na dwie noce. Wynajem stosuje takie zasady znacznie częściej niż hotele, często ostrzejsze w weekendy i w wysokim sezonie.
  • Przyjazd lub wyjazd niemożliwyNoc może być dostępna w ramach dłuższego pobytu, ale nie jako pierwsza ani ostatnia. Tak działają dni zmiany gości w domkach wakacyjnych.
  • Zamknięte noce i stop-sellWłaściciele blokują terminy na własny użytek lub remont, a stop-sell natychmiast wyłącza jednostkę ze sprzedaży. Każda zamknięta noc w żądanych datach usuwa jednostkę z wyników.

Nie każdy nocleg to hotel

Hotele, apartamenty i domki wakacyjne

Model danych jest wspólny, ale każdy rodzaj noclegu wypełnia go inaczej. Oto różnice, które musi obsłużyć Twój proces rezerwacji, gdy sprzedajesz coś więcej niż pokoje hotelowe.

Hotele

W tym hostele i pensjonaty

Co się rezerwuje
Typ pokoju z wieloma identycznymi pokojami lub łóżko we wspólnym dormitorium.
Ceny
Stawka za noc za pokój i wyżywienie; dodatkowi dorośli lub dzieci mogą ją zmienić.
Zasady pobytu
Minimalny pobyt tylko w szczycie; większość nocy można rezerwować pojedynczo.
Opłaty i kaucje
Opłata miejscowa, czasem opłata resortowa płatna na miejscu.
Przyjazd
Recepcja czynna całą dobę lub z obsługą; wystarczą godziny zameldowania na voucherze.
Typowe źródło
Bedbanki i hurtownicy, umowy bezpośrednie, channel managery.

Apartamenty z obsługą

Aparthotele i apartamenty w mieście

Co się rezerwuje
Typ jednostki, często z kuchnią i osobnymi sypialniami.
Ceny
Stawka za noc za jednostkę, z cenami tygodniowymi lub miesięcznymi dla długich pobytów.
Zasady pobytu
Minimalne pobyty są częste, a długie pobyty stanowią dużą część popytu.
Opłaty i kaucje
Opłata za sprzątanie za pobyt i zwrotna kaucja są częste.
Przyjazd
Godziny recepcji bywają różne; późny przyjazd wymaga skrytki na klucze lub kodu.
Typowe źródło
Channel managery, umowy bezpośrednie i niektórzy hurtownicy.

Domki wakacyjne

Domy, wille i chaty

Co się rezerwuje
Konkretny dom. Zwykle istnieje tylko jeden.
Ceny
Stawka za noc za cały dom plus opłata za każdego dodatkowego gościa ponad liczbę bazową.
Zasady pobytu
Minimalny pobyt, stałe dni zmiany gości i daty bez przyjazdu to norma.
Opłaty i kaucje
Sprzątanie, zwrotna kaucja za szkody i podatki lokalne, każde pokazane przed płatnością.
Przyjazd
Instrukcja zameldowania, adres i kontakt są wysyłane przed przyjazdem, nigdy na stronie publicznej.
Typowe źródło
Właściciele i zarządcy nieruchomości, bezpośrednio lub przez channel manager.

Sprzedajesz domy od wielu gospodarzy zamiast własnych kontraktów? To marketplace, opisany na stronie Portal BnB.

Okna polityki anulowania

Jedna rezerwacja, trzy okna anulowania

Polityka anulowania to oś czasu liczona wstecz od daty przyjazdu. Każde okno określa, co gość odzyska, jeśli anuluje w jego trakcie.

RezerwacjaZameldowanie
  1. 01 · Do 14 dni przed przyjazdemBezpłatne anulowanieGość anuluje i dostaje pełny zwrot. To termin, którego podróżni szukają w pierwszej kolejności, więc pokaż go jako datę, a nie regułę.
  2. 02 · Od 14 do 3 dni przedCzęściowa karaObowiązuje kara, często pierwsza noc lub procent pobytu. Wynajem może w tym oknie zatrzymać kaucję.
  3. 03 · Ostatnie 3 dni i niestawienie sięBez zwrotuCała kwota zostaje zatrzymana. Taryfy sprzedawane jako bezzwrotne wchodzą w to okno od momentu rezerwacji.
Przykładowe okna; każdy plan taryfowy ma własne.
  • Dla planu taryfowego, nie dla obiektuTen sam apartament może mieć elastyczną taryfę i tańszą bezzwrotną, więc polityka należy do warstwy planu taryfowego.
  • Daty w strefie czasowej obiektu"14 dni przed" liczy się od daty przyjazdu w miejscu, w którym leży obiekt. Zamień to na wyraźną datę i godzinę na stronie i na voucherze.
  • Wygrywa polityka dostawcyPrzy zasobach z API nie możesz oferować łagodniejszych warunków niż dostawca. Przy własnych umowach okna ustalasz sam.

Własna oferta i zasoby z API

Twoje kontraktowane obiekty i API dostawców w jednym wyszukiwaniu

Większość sprzedawców noclegów robi jedno i drugie: wprowadza miejsca, które kontraktuje sama, i dodaje API dostawców na całą resztę. Podróżny nie powinien zauważyć, skąd pochodzi nocleg.

Twoje własne obiekty

  • Sam wprowadzasz obiekty, jednostki i plany taryfowe w panelu admina
  • Daj właścicielom i hotelom login do ekstranetu, by zarządzali kalendarzem
  • Ustawiaj ceny, minimalne pobyty, zamknięte daty i okna anulowania
  • Alotmenty z dniami zwolnienia i stop-sell
  • Albo odbieraj stawki i dostępność z channel managera

Zasoby dostawców z API

  • Duże katalogi w destynacjach, w których nigdy nie zawarłbyś umów
  • Ceny i dostępność na żywo w chwili wyszukiwania
  • Wyżywienie, polityki i opłaty dostawcy przy każdej stawce
  • Włączane z Twoją własną umową i danymi dostępowymi dostawcy
  • Rezerwacja i anulowanie trafiają prosto do dostawcy

Co dostaje gość

  • Jedna lista wyników z jedną stroną obiektu na miejsce
  • Ten sam pokój z kilku źródeł pokazany raz, w Twojej cenie
  • Twoje marże według dostawcy, destynacji lub kanału oraz stawki dla agentów B2B
  • Jeden format vouchera, niezależnie od źródła potwierdzenia

Podłączenie channel managera opisano na stronie Integracja z channel managerem. O pokojach, które masz na kontrakcie, przeczytasz w System zasobów rezerwacji.

Gotowe w PHPTRAVELS

Dostawcy noclegów już podłączeni

Ci dostawcy zakwaterowania są już podłączeni do modułu Stays. Podpisujesz umowę z dostawcą, wpisujesz własne dane dostępowe w panelu admina, testujesz w jego sandboxie i uruchamiasz sprzedaż. Lista pochodzi na żywo z naszego katalogu integracji.

Potrzebujesz dostawcy, którego nie ma na liście, np. regionalnej sieci wynajmu? Można dodać dowolne API zakwaterowania z dokumentacją, zobacz Integracja API na zamówienie. O typach dostawców hotelowych i mapowaniu treści przeczytasz na stronie API hoteli, a o dwóch największych bedbankach w przewodnikach: Integracja API RateHawk i Integracja API Hotelbeds.

Zarezerwuj nocleg tak, jak zrobią to Twoi goście

Szukaj, porównuj stawki i rezerwuj w demo na żywo, a potem powiedz nam, jakie obiekty i jakich dostawców planujesz sprzedawać.

Wypróbuj demoZapytaj o swoich dostawców

Budujesz własną aplikację lub feed dla partnerów? REST API PHPTRAVELS udostępnia wszystkie podłączone źródła noclegów w jednym formacie, z webhookami dla zdarzeń rezerwacji. Wchodzi w skład planu Enterprise, zobacz Cennik i dokumentację dla deweloperów. Szerszy obraz znajdziesz na stronie API turystyczne.

FAQ

API noclegów: pytania programistów i agencji

Kontakt ze sprzedażą

API noclegów to zestaw usług sieciowych, który pozwala serwisowi rezerwacyjnemu wyszukiwać zakwaterowanie, odczytywać ceny i dostępność dla podanych dat i gości oraz tworzyć, odczytywać i anulować rezerwacje. Obejmuje hotele i każdy inny rodzaj noclegu: apartamenty, domki wakacyjne, hostele i pensjonaty.

Podstawowe wywołania są te same. API noclegów musi jednak obsłużyć też to, czego wymagają noclegi pozahotelowe: rezerwacje całej jednostki, minimalne pobyty i dni zmiany gości, opłaty za dodatkowych gości, opłaty za sprzątanie, zwrotne kaucje i instrukcje zameldowania wysyłane przed przyjazdem.

Tak. W PHPTRAVELS moduł Stays używa jednego modelu obiektu, jednostki, planu taryfowego i dostępności dla każdego typu zakwaterowania, więc hotele, apartamenty i domki wakacyjne pojawiają się w tym samym wyszukiwaniu, każdy z własnymi zasadami.

Każda noc w kalendarzu może mieć minimalną długość pobytu, zwykle powiązaną z datą przyjazdu. Jeśli gość szuka mniejszej liczby nocy niż minimum, jednostka nie jest zwracana. Flagi braku przyjazdu i braku wyjazdu działają tak samo dla dni zmiany gości.

Tak. Możesz sam dodawać obiekty, jednostki, plany taryfowe i kalendarze, dać właścicielom login do ekstranetu lub odbierać stawki z channel managera i sprzedawać je obok zasobów dostawców w jednej liście wyników.

Z planu taryfowego. Zasoby dostawców niosą politykę dostawcy, a Twoje własne obiekty używają ustawionych przez Ciebie okien. Termin jest pokazywany gościowi przed płatnością i drukowany na voucherze.

Nie. Podpisujesz umowę z każdym dostawcą zakwaterowania i wpisujesz własne dane dostępowe w panelu admina. PHPTRAVELS zapewnia platformę rezerwacyjną, moduł Stays i gotowe konektory.

Tak. W planie Enterprise REST API PHPTRAVELS udostępnia wyszukiwanie i rezerwację we wszystkich podłączonych źródłach w jednym formacie, z webhookami dla zdarzeń rezerwacji i pełnym kodem źródłowym do rozbudowy.

Licencji PHPTRAVELS, własnej domeny i co najmniej jednego źródła zasobów: obiektów kontraktowanych przez siebie, channel managera albo umowy z hurtownikiem zakwaterowania. Demo na żywo najpierw pokazuje cały proces.

Odkryj więcej

Więcej o platformie