Rozwiązywanie problemów z błędami synchronizacji
Ostatnia aktualizacja: 12.03.2025 13:55
Dotyczy rozwiązania: Synchronizacja z OTA
Kliknij tutaj, aby zgłosić sugestie lub uwagi do tego artykułu
Instrukcja video: BRAK

W związku z rosnącymi wymaganiami naszych partnerów dotyczących monitorowania błędów w procesach synchronizacji, postanowiliśmy stworzyć szczegółowy artykuł, który pomoże Ci w diagnozowaniu i rozwiązywaniu problemów związanych z integracją KWHotel z systemami OTA i Channel Managerami.
W najnowszej wersji produkcyjnej KWHotel dodaliśmy nowe zabezpieczenie. Po przekroczeniu określonego limitu błędów synchronizacji w danym dniu – obecnie wynoszącego 10 – wtyczka synchronizacyjna danego partnera zostanie automatycznie wyłączona w programie KWHotel.
W artykule poniżej znajdziesz konkretne instrukcje oraz kroki, które pomogą w rozwiązaniu typowych problemów synchronizacyjnych w:
Booking.com
Błąd „Access Denied” / “You do not have the access to this specific HotelID”
Błąd ten występuje, gdy w zakładce „Dostawca usług connectivity” na Twoim koncie Booking.com nie jest wybrany KWHotel jako dostawca usług. W takim przypadku:
- Zaloguj się na swoje konto Booking.com.
- Przejdź do zakładki „Dostawca usług connectivity”.
- Wybierz KWHotel jako dostawcę usług.
- Skontaktuj się z nami pod adresem bok@kwhotel.pl, aby poprosić o aktywację połączenia.
Po akceptacji połączenia wtyczka zostanie ponownie włączona.
Błąd związany z mapowaniem pokoi (“room code not found”)
Jeśli problem dotyczy mapowania pokoi, musisz:
- Wejść w ustawienia wtyczki.
- Kliknąć „Połączenia” i przejść do grup pokoi.
- Otworzyć sekcję „Synchronizacja grup pokoi” i zweryfikować mapowanie.
- Sprawdzić, czy wszystkie pokoje są poprawnie przypisane i że nie ma nieistniejących pokoi. Aby wprowadzić zmianę, należy skopiować ID pokoju z dolnej tabeli (lista pokoi po stronie portalu), wkleić numer przy odpowiednim pokoju w górnej tabeli (pokoje po stronie KWHotel) i zaznaczyć połączenie jako Aktywne.
- Zapisz zmiany.
Jeśli po przetestowaniu połączenia problem zostanie rozwiązany, możesz ponownie aktywować połączenie. W przypadku problemów, skontaktuj się z nami.
Błędy związane z planami cenowymi
Jednym z najczęstszych błędów jest komunikat „Room is not active for the rate plan”. Oznacza to, że pokój nie jest aktywny w danym planie cenowym. Aby rozwiązać ten problem:
- Zaloguj się na swoje konto Booking.com.
- Przejdź do zakładki „Plany cenowe” i sprawdź, czy pokój jest przypisany do odpowiedniego planu cenowego.
- Jeśli pokój nie jest przypisany, dodaj go do planu cenowego.
- Alternatywnie, w KWHotel ustaw, aby pokój nie synchronizował się z tym planem cenowym. Można to ustawić bezpośrednio w cenach w planie cenowym zaznaczając checkbox “Nie synchronizuj tej grupy” w danym okresie w danej grupie pokoi.
- Warto także zweryfikować, czy we wszystkich pokojach na każdą datę jest ustawiona konkretna kwota – nie może być ona równa 0.
Jeśli po tych zmianach błąd nie zostanie rozwiązany, skontaktuj się z nami.
Expedia
Błąd związany z wyborem dostawcy
W Expedia musisz wybrać KWHotel jako dostawcę usług w odpowiedniej zakładce. Aby to zrobić:
- Zaloguj się do swojego konta Expedia.
2. Przejdź do zakładki „Ceny i dostępność” → „Ustawienia połączenia”.

Błąd mapowania pokoi
Podobnie jak w przypadku Booking.com, w Expedia także należy zweryfikować mapowanie pokoi. Musisz:
- Przejść do ustawień wtyczki.
- Sprawdzić, czy wszystkie pokoje zostały poprawnie przypisane do odpowiednich grup pokoi.
Błędy związane z planami cenowymi
W Expedia ceny mogą być przesyłane z KWHotel, ale nie mogą wynosić zero. Jeśli wystąpi błąd związany z ceną, musisz:
- Sprawdzić, czy ceny w KWHotel nie są ustawione na zero.
Zmień cenę na wartość większą niż zero, aby synchronizacja przebiegła poprawnie.
Noclegi.pl
Wybór dostawcy
W Noclegi.pl musisz wybrać KWHotel jako dostawcę w zakładce „Ceny i dostępność” → „Channel Manager”. Aby to zrobić:
- Zaloguj się do swojego konta Noclegi.pl.
- Przejdź do zakładki „Ceny i dostępność” → „Channel Manager”.

Błędy związane z liczbą osób
W Noclegi.pl ważne jest, aby liczba osób w planie cenowym zgadzała się z wymaganiami platformy. Jeśli system nie znajdzie zgodności, pojawi się błąd. Musisz:
- Sprawdzić, czy liczba osób w planie cenowym jest zgodna z wymaganiami Noclegi.pl (np. 3-4 osoby). Wartość musi znajdować się w okresie 1-31.
- Wprowadź zmiany, jeśli liczba osób jest niewłaściwa.
Hotres i Hotelsystems
Obie platformy posiadają bardziej otwarte API, dlatego nie generują typowych błędów synchronizacji. W przypadku tych systemów, jeśli dane są poprawnie wprowadzone we wtyczce, nie powinno być problemów.
Należy pamiętać, że Hotelsystems obsługuje jedynie dostępność, a nie ceny.
YieldPlanet
Błędy związane z ceną
W YieldPlanet najczęstszym problemem jest wysyłanie ceny zero. YieldPlanet nie akceptuje ceny zero, dlatego musisz:
- Upewnić się, że żadna cena w systemie KWHotel nie wynosi zero.
- Jeśli nie ma ceny w danym okresie, zaznacz opcję „nie synchronizuj” dla tego okresu.
- Jeżeli zarządzasz cenami po stronie YieldPlanet, nie musisz uzupełniać tych wartości. Upewnij się jedynie, że opcja przesyłania cen jest odznaczona w danym planie cenowym w KWHotel po jego otwarciu i zakładce Synchronizuj ustawienia.
Profitroom
W przypadku Profitroom nie występują typowe błędy synchronizacji. Problemy mogą się pojawić w kontekście API v1, ale wersja API v2 jest już dostępna. Jeśli korzystasz z API v2, nie powinno być większych trudności, a synchronizacja przebiega bez problemów.
Podsumowanie
Rozwiązywanie problemów z błędami synchronizacji w systemie KWHotel wymaga dokładnego przestrzegania instrukcji oraz sprawdzenia poprawności konfiguracji po stronie platform.
Powyższe kroki powinny pomóc Ci w rozwiązaniu najczęstszych błędów. Jeśli problemu nie uda się rozwiązać samodzielnie, skontaktuj się z zespołem wsparcia pod adresem bok@kwhotel.pl.
🔴 WAŻNE
– Zgłoszenie problemu wiąże się z koniecznością aktywacji połączenia w systemie, co może wiązać się z opłatą za pomoc techniczną, jeśli problem wynika z nieprawidłowej konfiguracji z Twojej strony.
– Usługa byłaby odpłatna także w przypadku, jeśli zgłosisz potrzebę szkolenia lub wspólnej konfiguracji z technikiem. Niemniej jednak zawsze służymy radą, więc jeśli będziesz potrzebować sugestii, zawsze możesz nas zapytać mailowo o dalsze kroki.
– Ważne jest, aby na bieżąco monitorować błędy synchronizacji, aby uniknąć automatycznego wyłączenia wtyczki.