Integracja IQ Dental z kalendarzem: co ustalić, zanim połączysz systemy
Integracja kalendarza zaczyna się od ustalenia, który system rozstrzyga o wolnym terminie, jak mapują się typy wizyt i co robić po błędzie.
Połączenie dwóch kalendarzy nie polega na skopiowaniu godzin z jednego widoku do drugiego. Trzeba ustalić, który system może przyjąć rezerwację, jak gabinet rozpoznaje rodzaj wizyty i co zobaczy recepcja, gdy systemy nie odpowiedzą w tym samym czasie.
Publiczna dokumentacja IQ Dental opisuje API w standardzie OpenAPI 3.0.4. Wskazuje między innymi pobieranie dostępnych terminów oraz zapisy wizyt. Endpoint z terminami wymaga tokenu Bearer, identyfikatora placówki i rodzaju wizyty. Zakres zapytania może obejmować maksymalnie 31 dni, a przekazanie parametru duration może zmienić domyślny czas przypisany do typu wizyty. To opis interfejsu IQ Dental, nie potwierdzenie gotowej integracji z Bookito. Dokumentacja API IQ Dental
Najpierw ustal źródło prawdy
Zapisz jedno zdanie, które odpowie na pytanie: gdzie pracownik sprawdza, czy termin jest naprawdę wolny? Jeśli gabinet przyjmuje rezerwacje równolegle przez telefon, stronę i system kliniczny, odpowiedź musi wskazać system, który ostatecznie zatwierdza slot.
Na spotkaniu wdrożeniowym wypełnij krótką kartę:
| Decyzja | Ustalenie gabinetu |
|---|---|
| Kalendarz rozstrzygający o wolnym terminie | [nazwa systemu i osoba odpowiedzialna] |
| Kanały przyjmowania rezerwacji | [telefon, formularz, recepcja, inne] |
| Kto może zmienić wizytę | [role lub stanowiska] |
| Jak sprawdzamy zapis po błędzie | [widok, raport lub kontakt do wsparcia] |
Jeśli nie potraficie wskazać właściciela kalendarza, integracja może powielać niepewność zamiast ją usuwać. Najpierw ustalcie, kto i w którym miejscu poprawia termin, gdy pojawi się konflikt.
Zmapuj nazwy, nie tylko identyfikatory
W gabinecie recepcja może mówić „konsultacja”, system używać nazwy „pierwsza wizyta”, a rezerwator prezentować „poznaj lekarza”. Taka zgodność językowa nie powstaje automatycznie. Przygotuj tabelę mapowania z nazwą widoczną dla pacjenta, typem wizyty w IQ Dental, usługą rezerwacji, wymaganym czasem i osobą lub zasobem, który ją obsługuje.
Nie zgaduj czasu na podstawie nazwy. Użyj wartości zatwierdzonej przez gabinet i zapisz, kto ją potwierdził. API IQ Dental pozwala odczytać terminy dla typu wizyty i opcjonalnego pracownika; może też przyjąć własną długość wizyty. Przed wdrożeniem trzeba więc sprawdzić, czy oba systemy stosują tę samą regułę czasu i przerw. Specyfikacja IQ Dental
Przygotuj osobne wiersze dla typów wizyt, które mają różne zasady organizacyjne: na przykład nowego pacjenta, kontroli, wizyty konkretnego specjalisty i terminu wymagającego dłuższego bloku. To są przykłady do potwierdzenia w gabinecie, nie sugestie kliniczne.
Zdecyduj, jak rozpoznawać pacjenta
Właściciel gabinetu powinien uzgodnić, które dane są potrzebne do rezerwacji i jak recepcja znajdzie później właściwy wpis. Ustalcie dopuszczalne pola, format numeru telefonu, obsługę literówek oraz przypadek, gdy dwie osoby mają podobne dane. Nie przekazuj integracji dodatkowych informacji „na zapas”.
Najlepszy test nie polega na tym, że rekord pojawił się w tabeli. Sprawdź, czy pracownik potrafi odnaleźć rezerwację w swoim codziennym widoku i rozpoznać ją bez domysłów.
Przejdź cztery scenariusze przed startem
- Wolny termin: wybierz typ wizyty, sprawdź wynik w obu systemach i wykonaj próbny zapis.
- Termin zajęty w trakcie rozmowy: spróbuj zapisać slot, który recepcja właśnie zarezerwowała. System powinien odmówić albo jasno wskazać konflikt.
- Brak odpowiedzi: przerwij połączenie w chwili zapisu. Sprawdź, czy wiadomo, czy wizyta powstała, i jak uniknąć drugiego wpisu.
- Zmiana lub anulowanie: wykonaj zmianę tam, gdzie gabinet uzgodnił źródło prawdy. Następnie sprawdź drugi widok i historię operacji.
Przy każdym scenariuszu zapisz: godzinę, typ wizyty, oczekiwany rezultat, faktyczny rezultat i osobę, która potwierdziła zapis. Do próby użyj danych testowych, jeśli dostawca udostępni środowisko. Nie zakładaj, że istnieje sandbox ani że dostęp do niego jest bezpłatny. Warunki tokenu, środowiska testowego i kosztów trzeba potwierdzić z IQ Dental.
Co ustalić z dostawcami
Poproś o odpowiedzi na piśmie: jaki zakres tokenu jest potrzebny, jak go odnawiać, czy API ma środowisko testowe, jak długo ważne są dane o terminach i jak obsługiwane są konflikty. Zapytaj też, kto diagnozuje błąd po stronie integracji. W specyfikacji IQ Dental widać wymagane uwierzytelnianie i endpointy, ale sama specyfikacja nie rozstrzyga warunków handlowych ani dostępności konkretnego konta gabinetu.
Integracja Bookito z IQ Dental jest przygotowywana. Do czasu jej odbioru traktuj mapowanie, próby i dostęp jako elementy do uzgodnienia, a nie działające już funkcje.
Źródła
Jeśli chcesz omówić potrzeby swojego gabinetu, napisz do Bookito.