Integracja AI: Portal Świadczeniodawcy / Portal SZOI
Podłączamy asystenta do Portalu Świadczeniodawcy i SZOI przez interfejs WSBroker lub import plików XML. Zespół dostaje natychmiastowy podgląd błędów w sprawozdaniach, stanu rachunków i wykonania limitów umowy, bez ręcznego przeglądania komunikatów.
Jak się łączymy: Łączymy się z Portalem Świadczeniodawcy przez interfejs usługowy WSBroker (WSDL i XSD NFZ), który od 16 marca 2026 jest podstawowym kanałem wymiany komunikatów XML. Asystent pobiera komunikaty zwrotne, statusy rachunków i dane planu rzeczowo-finansowego bez logowania do portalu www.
Czego potrzebujemy: Konto techniczne z dostępem do WSBroker NFZ lub możliwość eksportu plików XML z Portalu Świadczeniodawcy i przekazania ich do folderu roboczego na serwerze placówki.
Czego asystent nie robi: Asystent nie wysyła komunikatów XML do NFZ ani nie składa rachunków i wniosków: każde przesłanie zatwierdza i wykonuje uprawniony pracownik w portalu lub przez WSBroker.
Co podłączamy
Sprawozdania SWIAD
Czytamyprzesłane pliki XML ze świadczeniami i komunikaty weryfikacji zwrócone przez NFZ
Asystentwskazuje odrzucone pozycje, grupuje błędy według kodu i przygotowuje projekt opisu korekty dla pracownika sprawozdawczości
Rachunki
Czytamyzłożone rachunki i ich statusy w Portalu Świadczeniodawcy
Asystentinformuje, które rachunki NFZ przyjął, które czekają na akceptację i które wróciły z uwagami wymagającymi poprawki
Plan rzeczowo-finansowy
Czytamylimity umowy według zakresów i rodzajów świadczeń
Asystentzestawia wykonanie z limitem na bieżący okres, sygnalizuje zagrożenie przekroczenia lub niedowykonania w poszczególnych zakresach
Deklaracje POZ (ZBPOZ)
Czytamyaktywne deklaracje i odpowiedzi NFZ do komunikatów ZBPOZ
Asystentsprawdza stan przesłanych deklaracji i zgłasza niezgodności między listą w programie a odpowiedzią Funduszu
Komunikaty zwrotne XML
Czytamypliki odpowiedzi NFZ pobrane z portalu lub przez WSBroker
Asystentstreszcza treść komunikatu, wyciąga pozycje z błędem i podaje termin obowiązkowej korekty
Wnioski i harmonogramy dostępności
Czytamyzłożone wnioski i harmonogramy w Portalu Świadczeniodawcy
Asystentinformuje o statusie wniosków i przypomina o zbliżających się terminach złożenia harmonogramów wynikających z umowy
O co pyta personel w praktyce
- Które świadczenia z ostatniego sprawozdania SWIAD wróciły z błędem i co konkretnie trzeba poprawić?
- Ile wykonaliśmy z planu umowy na ten kwartał i które zakresy są zagrożone niedowykonaniem?
- Czy NFZ przyjął już rachunek za październik, czy wróciło z uwagami?
- Jakie błędy w deklaracjach POZ wróciły w ostatnim komunikacie ZBPOZ?
- Kiedy mija termin złożenia korekty do sprawozdania z września?
- Które zakresy świadczeń mamy już wykonane powyżej limitu umowy na ten rok?
Co się zmienia
Pracownik sprawozdawczości przestaje ręcznie przeglądać każdy komunikat XML w poszukiwaniu błędów. Asystent wyciąga odrzucone pozycje, grupuje je według kodu błędu i podaje termin korekty. Kierownik rozliczeń widzi w jednym miejscu, jak wykonanie idzie względem planu umowy, zanim kończy się miesiąc. Rachunki nie leżą bez reakcji: asystent sygnalizuje każdy zmieniony status od razu po pobraniu komunikatu zwrotnego z portalu.
O programie
Portal Świadczeniodawcy i jego poprzednik SZOI to aplikacje webowe Narodowego Funduszu Zdrowia przeznaczone dla wszystkich świadczeniodawców posiadających umowę z NFZ. Służą do elektronicznej wymiany danych z Funduszem: przesyłania i odbioru komunikatów XML według obowiązujących schematów XSD (m.in. SWIAD, DEKL, ZBPOZ), składania wniosków, zarządzania harmonogramami dostępności i obsługi weryfikacji uprawnień przez eWUŚ.
W portalu obsługuje się rachunki, plany rzeczowo-finansowe i deklaracje POZ. Od 16 marca 2026 podstawowym kanałem wymiany jest interfejs usługowy WSBroker, a portal www pełni rolę kanału awaryjnego. Każdy świadczeniodawca rozliczający się z NFZ korzysta z tych narzędzi co miesiąc lub co kwartał, a błędy w komunikatach trzeba poprawić w ściśle określonych terminach.
Gdzie to działa najlepiej
Na koniec miesiąca pracownik sprawozdawczości przesyła deklaracje ZBPOZ i odbiera komunikat zwrotny NFZ z kilkudziesięcioma pozycjami do poprawienia. Każdą trzeba ręcznie otworzyć, zidentyfikować błąd i przypisać do właściwego pacjenta.
Asystent czyta komunikat ZBPOZ, wyciąga listę niezgodności z opisem błędu przy każdej pozycji i wskazuje, które deklaracje wymagają ponownego przesłania przed terminem.
W połowie kwartału kierownik chce wiedzieć, jak idzie wykonanie planu rzeczowo-finansowego w podziale na oddziały i zakresy, żeby zdążyć z korektą zanim upłynie limit.
Asystent zestawia wykonanie z limitem według zakresów z aktualnego planu umowy i wskazuje zakresy z najniższym pozostałym wolumenem.
Rachunek za poprzedni miesiąc wrócił z portalu z uwagami NFZ, ale pracownik nie zauważył komunikatu przez kilka dni, bo sprawdzał portal raz w tygodniu, a termin korekty minął.
Asystent po pobraniu komunikatu zwrotnego od razu sygnalizuje, że rachunek wymaga poprawki, i podaje termin ponownego złożenia, zanim ktoś go przegapi.
Jak się łączymy
Łączymy się z Portalem Świadczeniodawcy przez interfejs usługowy WSBroker (WSDL i XSD NFZ), który od 16 marca 2026 jest podstawowym kanałem wymiany komunikatów XML. Asystent pobiera komunikaty zwrotne, statusy rachunków i dane planu rzeczowo-finansowego bez logowania do portalu www. Połączenie wymaga aktywnego konta technicznego z dostępem do WSBroker po stronie Waszego świadczeniodawcy.
Gdy WSBroker nie jest jeszcze skonfigurowany, pracujemy na plikach XML pobieranych ręcznie z portalu i przekazywanych do folderu roboczego na serwerze placówki. Asystent analizuje plik na miejscu i odpowiada na pytania bez dodatkowego połączenia z NFZ. Oba tryby można łączyć: automatyczny odczyt przez WSBroker i doraźny import pliku przez pracownika.
Portal z plikami, bazami i historią rozmów stoi na serwerze placówki. Do modelu AI trafia polecenie i fragmenty potrzebne do odpowiedzi, bez trenowania cudzych modeli na danych pacjentów.
Czego potrzebujemy od Was
- Konto techniczne z dostępem do WSBroker NFZ lub możliwość eksportu plików XML z Portalu Świadczeniodawcy i przekazania ich do folderu roboczego na serwerze placówki.
- Numer identyfikatora świadczeniodawcy (kod NFZ lub REGON) i numery umów do zawężenia pobieranych danych.
- Dostęp odczytu do folderu roboczego, w którym lądują pobrane komunikaty XML ze sprawozdań i rachunków.
- Zgoda administratora IT na konfigurację połączenia WSBroker lub wskazanie folderu z plikami XML.
- Dokumentacja przetwarzania danych osobowych uzupełniona o nowego procesora, jeśli w komunikatach XML pojawiają się dane identyfikujące pacjentów.
Czego asystent nie robi
- Asystent nie wysyła komunikatów XML do NFZ ani nie składa rachunków i wniosków: każde przesłanie zatwierdza i wykonuje uprawniony pracownik w portalu lub przez WSBroker.
- Nie interpretuje przepisów dotyczących kwalifikacji świadczeń ani zasad rozliczania w miejsce personelu merytorycznego lub radcy prawnego.
- Nie ma wglądu w dane NFZ w czasie rzeczywistym bez skonfigurowanego połączenia WSBroker lub dostarczonych plików XML z portalu.
- Nie podejmuje decyzji klinicznych ani administracyjnych i nie podpisuje żadnej dokumentacji.
Pytania o integrację z tym systemem
Czy dane pacjentów z komunikatów XML trafiają do zewnętrznych systemów?
Portal asystenta stoi na serwerze Waszej placówki. Do modelu AI trafia polecenie i fragmenty danych potrzebne do odpowiedzi, np. treść komunikatu XML ze sprawozdania. Dane pacjentów to dane szczególnej kategorii (RODO art. 9) objęte tajemnicą lekarską. Przed uruchomieniem integracji z danymi, które identyfikują pacjentów, przygotowujemy razem z placówką analizę ryzyka i dokumentację przetwarzania.
Czy potrzebujemy zgody NFZ albo producenta portalu na podłączenie asystenta AI?
Portal Świadczeniodawcy i WSBroker to systemy NFZ udostępniane Wam na podstawie Waszej umowy z Funduszem. Nie potrzebujecie zgody NFZ na asystenta AI działającego po stronie placówki. Konfigurację konta technicznego do WSBroker i certyfikatów przeprowadzacie sami lub z pomocą działu IT, według dokumentacji technicznej NFZ. Asystent nie modyfikuje oprogramowania portalu.
Co zrobić, gdy nasza placówka nie korzysta jeszcze z WSBroker?
Możemy zacząć od pracy na plikach XML pobieranych ręcznie z Portalu Świadczeniodawcy. Pracownik pobiera plik z portalu, zapisuje go w wyznaczonym folderze na serwerze, a asystent go analizuje. To wymaga minimalnej konfiguracji i daje pełne możliwości analizy błędów i statusów. Przejście na WSBroker można zaplanować osobno, gdy dział IT będzie gotowy.
Jakie błędy w sprawozdaniach asystent potrafi wykryć?
Asystent odczytuje kody błędów i opisy zwrócone przez NFZ w komunikatach weryfikacji, m.in. do typów SWIAD i ZBPOZ. Grupuje odrzucone pozycje, wskazuje najczęstsze kody błędów i przygotowuje projekt listy do korekty. Nie kwalifikuje świadczeń ani nie decyduje, jak je poprawić: ostateczną korektę i ponowne przesłanie wykonuje pracownik sprawozdawczości.
Czy asystent może pilnować terminów składania sprawozdań i rachunków?
Tak. Asystent może sprawdzać, które rachunki lub korekty czekają na złożenie, i informować o zbliżających się terminach wynikających z harmonogramu sprawozdawczości NFZ. Terminy ustawowe są znane z góry, a asystent może je zestawić z aktualnym statusem przesłanych dokumentów i przypomnieć, co jeszcze nie zostało złożone.
Więcej w artykule: Jak AI może pilnować limitów umowy NFZ i komunikatów zwrotnych przez SZOI i Portal Świadczeniodawcy? →
Inne integracje: nfz i rozliczenia
Sprawdźmy to na Waszej placówce
Na bezpłatnym audycie pokażemy, jakie dane da się wyciągnąć z Waszego systemu i od którego procesu zacząć, żeby zespół szybko poczuł różnicę.
Umówcie bezpłatny audyt →