Metodologia
Niniejsza strona opisuje, w jaki sposób NFZ Terminy pobiera, przetwarza i prezentuje dane o czasach oczekiwania na świadczenia w ramach Narodowego Funduszu Zdrowia. Celem jest pełna transparentność: aby pacjent, dziennikarz lub badacz mógł zweryfikować, skąd biorą się liczby na tej stronie.
Skąd pochodzą dane
Wszystkie dane o kolejkach pobieramy z publicznego API NFZ (api.nfz.gov.pl, app-itl-api v1.3) — z endpointu informacji o terminach leczenia (queues). Jest to ten sam zbiór, który zasila oficjalny portal terminyleczenia.nfz.gov.pl. Nie korzystamy z prywatnych źródeł, nie kupujemy danych i nie pobieramy informacji bezpośrednio od placówek.
Mapowanie specjalizacji
API NFZ udostępnia dane w postaci tzw. „typów świadczeń” — jest ich ponad 340. Aby pokazać użytkownikowi czytelne kategorie (np. „Kardiolog”, „Stomatolog dziecięcy”), grupujemy te typy w 234 zmapowane specjalizacje. Mapowania prowadzone są ręcznie i widoczne w panelu administracyjnym serwisu. Dla 27 najczęściej wyszukiwanych specjalizacji utrzymujemy też aliasy językowe (np. „okulista” jako synonim „okulistyki”).
Jakie czasy oczekiwania pokazujemy
Dla każdej kolejki NFZ raportuje dwa rodzaje czasów: dla przypadków stabilnych (planowych) oraz dla przypadków pilnych. NFZ Terminy domyślnie wyświetla czas oczekiwania dla przypadków stabilnych, ponieważ to one są najczęstsze i porównywalne między placówkami. Czas wyrażony jest w dniach i pochodzi bezpośrednio z odpowiedzi API — nie wykonujemy dodatkowych korekt ani uśredniania w skali czasu. „Najkrótszy termin” na liście wyników to po prostu najmniejsza wartość zwrócona przez API w danej grupie placówek.
Częstotliwość aktualizacji
Synchronizacja z API NFZ uruchamiana jest raz na dobę i zasila lokalną bazę danych serwisu. Strony użytkownika są jednak serwowane z pamięci podręcznej Incremental Static Regeneration odświeżanej raz na 7 dni — taki kompromis pozwala utrzymać niski koszt hostingu przy 144 000+ stron. Data faktycznie widoczna na stronie odpowiada ostatniej regeneracji danej strony i jest pokazana w stopce w postaci „Źródło danych: api.nfz.gov.pl (synchronizacja DD MM RRRR)”. Realna różnica względem API NFZ może wynosić do 7 dni.
Deduplikacja placówek
Placówki NFZ raportują się przez wiele rejestrów, dlatego ten sam podmiot może występować w API pod różnymi identyfikatorami. Ujednolicamy je po nazwie, adresie i współrzędnych geograficznych, aby na liście miejskiej nie pojawiała się ta sama klinika dwa razy. Każdej placówce przydzielamy stabilny slug URL (np. „rusmed-11035”), który jest jej kanonicznym adresem w serwisie.
Wersje językowe
Serwis dostępny jest w trzech wersjach językowych: polskiej (domyślna, bez prefiksu), rosyjskiej (/ru) i angielskiej (/en). Zawartość danych jest identyczna we wszystkich wersjach — różnią się jedynie etykiety interfejsu i opisy specjalizacji. Tagowanie hreflang i kanoniczne URL-e są ustawione zgodnie z zaleceniami Google dla witryn wielojęzycznych.
Ograniczenia danych
NFZ Terminy nie weryfikuje danych raportowanych przez placówki — pokazujemy je w postaci pochodzącej z NFZ. Czas oczekiwania może odbiegać od rzeczywistego, jeśli placówka spóźnia się z aktualizacją kolejki, jeśli zmieniła się obsada lekarzy lub jeśli pacjent kwalifikuje się do procedury pilnej. Nie pokazujemy danych o kolejkach prywatnych ani komercyjnych — tylko świadczenia finansowane przez NFZ. Zawsze zalecamy telefoniczne potwierdzenie terminu w wybranej placówce.
Zmiany w metodologii
Każda istotna zmiana w sposobie zbierania lub przetwarzania danych zostanie udokumentowana na tej stronie wraz z datą wdrożenia. W razie pytań dotyczących konkretnych liczb lub źródła konkretnego rekordu prosimy o kontakt: contact@nfzterminy.pl.