Integracja z Medicover Sport: Kompletny przewodnik

Aktualizowano: 10 czerwca, 2026

Integracja z systemem Medicover Sport pozwala na pełną automatyzację obsługi klientów korzystających z pakietów zewnętrznych. Dzięki niej klubowicze mogą samodzielnie rejestrować się i wchodzić do obiektu, co znacząco odciąża pracowników recepcji.

1. Wymagania wstępne i techniczne

Zanim rozpoczniesz proces integracji, upewnij się, że Twoja infrastruktura spełnia poniższe standardy.

Aplikacja: Klub musi korzystać z naszej aplikacji (eFitness) lub aplikacji w wersji White Label.
Aktualizacja SupremaService oraz ACS: Niezbędne jest posiadanie najnowszych wersji oprogramowania do kontroli dostępu. Starsze wersje mogą błędnie interpretować kody QR, co uniemożliwi wejście.

Nie wiesz, czy posiadasz aktualne wersje? Jeśli nie masz pewności co do wersji oprogramowania, wyślij zgłoszenie na Support. Przejmiemy temat i skierujemy go do naszego działu IT z prośbą o weryfikację Twojej infrastruktury.

2. Niezbędne dane do aktywacji

Do uruchomienia integracji będziesz potrzebować danych, które otrzymasz bezpośrednio od Medicover Sport:

Oficjalna zgoda na integrację.
X-AUTH-TOKEN (tzw. facility token).
Merchant ID.

Co zrobić po ich uzyskaniu? Gdy otrzymasz komplet danych od partnera, prześlij je do nas poprzez system zgłoszeniowy z prośbą o przeprowadzenie integracji. Poprawność tych danych leży po stronie Medicover, my wykorzystamy je do sparowania systemów.

3. Konfiguracja systemu eFitness i karnetu

Proces różni się w zależności od tego, czy konfigurujesz pierwszą lokalizację, czy dodajesz kolejny klub do istniejącej sieci.

A. Pierwsza instancja (nowy klub)

Konfiguracja karnetu: W pierwszej kolejności utwórz w systemie dedykowany karnet dla użytkowników Medicover.
Zgłoszenie do Supportu: W wysyłanym zgłoszeniu (wspomnianym w pkt 2) poproś o aktywację systemu zewnętrznego o typie Medicover.
- Ważne: W treści zgłoszenia koniecznie podaj dokładną nazwę utworzonego karnetu, który ma zostać zintegrowany. Jest to niezbędne dla działu Support do poprawnej konfiguracji.
Szablon rejestracji: Konfiguracja pól odbywa się w zakładce Dane do aplikacji mobilnej. Należy tam utworzyć szablon wybierając wymagane dane jakie chcemy zbierać od Klubowiczów i dodać do niego karnet Medicover.

B. Dodanie nowego klubu do sieci

Jeśli w Twojej sieci funkcjonuje już karnet Medicover (sieciowy), proces jest uproszczony:

Wystarczy dodać istniejący karnet do sprzedaży na danej instancji.
Nie ma potrzeby ponownej aktywacji systemu zewnętrznego.

4. Kluczowe ustawienia pól rejestracji

Aby integracja działała poprawnie, musisz odpowiednio skonfigurować pola w szablonie rejestracji w zakładce Dane do aplikacji mobilnej. Krytyczne znaczenie ma pole Telefon komórkowy.

Instrukcja konfiguracji:

Wejdź w edycję szablonu rejestracji dla karnetu Medicover.
Znajdź pole „Telefon komórkowy”.
Zaznacz dla niego obie opcje: Dostępne oraz Wymagane.

Numer telefonu jest unikalnym identyfikatorem w systemie Medicover. Tylko jego poprawne podanie pozwoli zweryfikować uprawnienia klienta i automatycznie wpuścić go do klubu.

5. Obsługa ruchu i rozwiązywanie problemów

Automatyzacja przepływu osób w klubie opiera się na skanowaniu kodów QR z aplikacji mobilnej Medicover Sport.

Proces wejścia i wyjścia

Wejście: Klient skanuje kod QR (ze swojej aplikacji). Bramka otworzy się wyłącznie wtedy, gdy system eFitness oraz Medicover potwierdzą uprawnienia.
Wyjście: Klient skanuje kod i jest wypuszczany natychmiastowo. Weryfikacja wizyty w systemie partnera odbywa się w tle.
Anulowanie wizyty: Jeśli klient wyjdzie z klubu w ciągu 15 minut (np. wróci się po coś do szatni lub samochodu), jego wizyta zostanie automatycznie anulowana. Dzięki temu Medicover Sport pozwoli mu na ponowne wejście tego samego dnia bez utraty limitu wejść.

Co zrobić w przypadku problemów z wejściem?

Jeśli klubowicz zgłasza problem z wejściem (bramka nie otwiera się mimo aktywnego pakietu), wyślij zgłoszenie do Supportu zawierające: