Oferta od wykonawcy wygląda porządnie. Jedna strona, punkt czwarty: „Integracja z platformą P1 oraz systemem HIS szpitala zgodnie ze standardem HL7 FHIR, 6 tygodni, cena ryczałtowa”. Zarząd przychodni sieciowej podpisuje, bo słowo „standard” brzmi jak gwarancja, że nic nie trzeba wymyślać od zera. W trzecim tygodniu okazuje się, że wymiana elektronicznej dokumentacji medycznej z P1 nie odbywa się przez FHIR, tylko przez dokumenty HL7 CDA i usługi SOAP. W piątym, że system szpitalny wysyła wyniki laboratoryjne komunikatami HL7 v2, a kody badań są lokalne i nikt nie ma do nich słownika. W ósmym tygodniu wykonawca przysyła pierwsze zlecenie zmiany.

Nikt tu nie kłamał. „Zgodność z FHIR” była w ofercie prawdą i jednocześnie nie mówiła nic o tym, co trzeba było zbudować. To najczęstszy wzorzec, jaki widzimy w rozmowach o integracjach medycznych: standard pojawia się w zakresie zamiast zakresu.

Ten artykuł jest dla CTO i kierowników IT w podmiotach leczniczych oraz firmach health-tech, którzy zamawiają albo wyceniają integrację z systemami EDM i EHR. Teza jest konkretna i część dostawców się z nią nie zgodzi: integrację medyczną należy wyceniać i odbierać przepływ po przepływie, z jawnie wskazanym profilem, wersją i słownikami, a nie „według standardu”. FHIR jest umową o składni i sposobie wymiany. Większość kosztu leży gdzie indziej: w mapowaniu znaczenia, terminologii, tożsamości pacjenta, obsłudze błędów i testach zgodności. Oferta, która tego nie rozpisuje, nie jest tańsza, tylko odkłada rachunek na później.

Dlaczego „mamy API FHIR” nie odpowiada na pytanie o koszt integracji?

HL7 FHIR (Fast Healthcare Interoperability Resources) definiuje zasoby, takie jak Patient, Encounter, Observation czy DocumentReference, oraz sposób ich wymiany przez REST. Wersja R4 z 2019 roku jest tą, którą wdrożyła większość rynku, w tym amerykańskie wymagania certyfikacyjne. Wersja R5 ukazała się w 2023 roku, ale w produkcyjnych integracjach wciąż dominuje R4. Już tu pojawia się pierwsza decyzja, której „zgodność z FHIR” nie rozstrzyga: z którą wersją pracujemy i co zrobimy, gdy druga strona przejdzie na inną.

Zasób bazowy FHIR jest celowo luźny. Pacjent może mieć zero lub wiele identyfikatorów, obserwacja może być zakodowana w dowolnym systemie kodów, a większość pól jest opcjonalna. Dlatego każde wdrożenie nakłada na zasoby profile: reguły, które mówią, które pola są wymagane, jakich słowników używać i jakie rozszerzenia są dopuszczalne. W Stanach Zjednoczonych tym zestawem reguł jest US Core, w Polsce mamy profile Centrum e-Zdrowia dla wybranych usług i rozwijany przez HL7 Polska przewodnik bazowy. Dwa systemy „zgodne z FHIR R4” mogą nie wymienić ze sobą ani jednego poprawnego zasobu, jeśli implementują różne profile.

Druga warstwa to znaczenie. FHIR mówi, jak zapisać obserwację, ale nie mówi, czy „HGB” w laboratorium A to ta sama wartość co „Hemoglobina” w systemie B, w tej samej jednostce i z tą samą metodą. To jest problem interoperacyjności semantycznej i nie rozwiązuje go żaden standard transportu. Rozwiązuje go mapa kodów, którą ktoś musi zbudować, przejrzeć z personelem medycznym i utrzymywać.

Trzecia warstwa to proces. Integracja nie przenosi danych w próżni. Przenosi je w ramach konkretnego zdarzenia: przyjęcia pacjenta, zlecenia badania, wypisu, wystawienia skierowania. Każde z nich ma swoją kolejność, swoje wyjątki (korekta, anulowanie, zmiana lekarza) i swoje wymagania prawne. To właśnie liczba i złożoność tych procesów wyznacza koszt, a nie liczba zasobów FHIR, które trzeba obsłużyć.

Wniosek dla zamawiającego jest prosty: pytanie „czy macie API FHIR” jest pytaniem o warunek konieczny, a nie o zakres. Zakres to lista przepływów.

Co właściwie integrujesz w polskim systemie ochrony zdrowia?

Polska ma jedną cechę, która odróżnia ją od większości rynków opisywanych w anglojęzycznych poradnikach: centralną platformę P1, utrzymywaną przez Centrum e-Zdrowia (CeZ, dawniej CSIOZ). Każdy podmiot wykonujący działalność leczniczą, z umową z NFZ czy bez niej, ma od 1 lipca 2021 roku obowiązek zapewnienia wymiany elektronicznej dokumentacji medycznej przez System Informacji Medycznej, wynikający z art. 56 ust. 4 ustawy o systemie informacji w ochronie zdrowia.

Architektura tej wymiany jest rozproszona. Jak wyjaśnia baza wiedzy e-Zdrowie serwisu mp.pl, do P1 trafiają komunikaty o zdarzeniach medycznych i indeksy dokumentów EDM, a same dokumenty leżą w repozytoriach poszczególnych placówek. Dane o zdarzeniu medycznym trzeba przekazać do P1 w ciągu dwóch dni od jego zakończenia (na przykład wizyty ambulatoryjnej) albo rozpoczęcia (na przykład pobytu w szpitalu). Gdy inny lekarz chce zobaczyć dokument, P1 wskazuje, gdzie on jest, a dokument pobiera się z repozytorium placówki, która go wytworzyła.

Same dokumenty EDM mają postać plików XML zgodnych z Polską Implementacją Krajową HL7 CDA (PIK HL7 CDA), czyli zestawem reguł doprecyzowujących międzynarodowy standard CDA. Usługi sieciowe P1 są zabezpieczone WS-Security, a dokumentacja integracyjna obejmuje definicje usług WSDL, schematy XSD i przykładowe dokumenty, co opisuje dokument CeZ „Minimalne wymagania techniczne i funkcjonalne dla Systemów Usługodawców”. Do testów CeZ udostępnia środowisko integracyjne P1, do którego dostęp daje zestaw testowych certyfikatów wydawanych przez Centrum Certyfikacji P1.

Gdzie w tym obrazie jest FHIR? W kilku miejscach, ale nie w rdzeniu wymiany EDM. Centrum e-Zdrowia publikuje dokumentację integracyjną w formie przewodników FHIR dla części nowszych usług. Przykładem jest dokumentacja SMPL na portalu isus.ezdrowie.gov.pl, z profilami w przestrzeni nazw ezdrowie.gov.pl/fhir i zasobami opisującymi rejestry programów lekowych. Równolegle HL7 Polska rozwija bazowy przewodnik FHIR dla Polski (pl-fhir-base) oraz robocze specyfikacje dla diagnostyki laboratoryjnej i obrazowej, ale w momencie pisania tego tekstu są to wersje robocze, bez statusu oficjalnej publikacji.

Dla projektu oznacza to coś, czego oferty często nie mówią wprost: typowa integracja w Polsce obsługuje co najmniej dwa standardy. CDA i SOAP dla P1, FHIR tam, gdzie wymaga go konkretna usługa CeZ albo partner, i bardzo często HL7 v2 albo własne API po stronie systemu szpitalnego. Jeśli więcej o tym, jak zmieniała się cyfryzacja polskiej ochrony zdrowia i gdzie są dziś główne obowiązki, pisaliśmy w tekście o transformacji cyfrowej ochrony zdrowia w Polsce.

Jakie standardy spotkasz po drugiej stronie i co z tego wynika?

Lista standardów w projekcie wynika z tego, z kim się łączysz, a nie z tego, co jest nowoczesne. W polskim projekcie spotkasz zwykle cztery rodziny.

HL7 v2. Najstarszy i wciąż bardzo rozpowszechniony w szpitalach format komunikatów: przyjęcia i wypisy (ADT), zlecenia (ORM/OML), wyniki (ORU). Działa na zasadzie strumienia komunikatów, często przez MLLP po TCP. Jego słabość to elastyczność: każdy dostawca systemu szpitalnego interpretuje pola po swojemu, a pola niestandardowe (segmenty Z) są normą. Integracja z HL7 v2 wymaga specyfikacji interfejsu od konkretnego dostawcy, nie od standardu.

HL7 CDA. Dokument kliniczny z nagłówkiem i treścią, podpisywany i archiwizowany. W Polsce to podstawa EDM. Trudność polega na poprawnym wygenerowaniu dokumentu zgodnego z PIK, podpisaniu go i obsłudze cyklu życia: korekty, anulowania, nowej wersji dokumentu.

HL7 FHIR. REST, JSON lub XML, zasoby i profile. Najwygodniejszy dla programistów i najlepiej wspierany przez narzędzia, ale tylko wtedy, gdy druga strona faktycznie go wystawia i opisuje swój profil.

DICOM. Obrazy medyczne i ich metadane. Integracja z PACS to osobny świat: wolumen danych, protokoły DICOMweb, przeglądarki obrazów. Jeśli Twój zakres obejmuje obrazy, policz go osobno.

Co z tego wynika dla architektury? Że warstwa integracyjna musi być tłumaczem, a nie rurą. Komunikat ADT z HL7 v2 trzeba przetłumaczyć na model domenowy, z niego wygenerować dokument CDA dla P1 i zasób FHIR dla aplikacji partnera. Każda z tych transformacji ma własne reguły, testy i błędy. Wzorce, które pomagają taką warstwę zorganizować (pośrednik, kolejki, silnik integracyjny, architektura zdarzeniowa), opisaliśmy w przeglądzie wzorców integracji oprogramowania.

Jak opisać zakres integracji, żeby dało się go wycenić?

Jednostką zakresu jest przepływ: jedno zdarzenie biznesowe, które przenosi określone dane z systemu A do systemu B, w określonym standardzie, z określoną obsługą wyjątków. Przykłady: „wynik badania laboratoryjnego z LIS trafia do karty pacjenta w aplikacji i jako dokument EDM do repozytorium z indeksem w P1” albo „przyjęcie pacjenta w HIS tworzy pacjenta i wizytę w systemie do teleporad”.

Dla każdego przepływu opisz osiem rzeczy:

  1. Wyzwalacz. Jakie zdarzenie uruchamia wymianę i w którym systemie.
  2. Kierunek i tryb. Odczyt czy zapis, synchronicznie czy przez kolejkę, w czasie rzeczywistym czy wsadowo.
  3. Standard i profil po obu stronach. Na przykład HL7 v2.5 ORU według specyfikacji dostawcy LIS po jednej stronie, PIK HL7 CDA w konkretnej wersji po drugiej.
  4. Zestaw danych. Lista pól wymaganych i opcjonalnych, z pochodzeniem każdego z nich.
  5. Słowniki. Jakie systemy kodów są po każdej stronie (ICD-10, ICD-9 PL, LOINC, kody lokalne) i kto dostarcza mapę.
  6. Tożsamość. Jak rozpoznajemy pacjenta i personel po obu stronach.
  7. Wyjątki. Korekty, anulowania, duplikaty, niedostępność drugiej strony, odrzucenie przez walidator.
  8. Kryteria odbioru. Jakie przypadki testowe muszą przejść i na jakim środowisku.

Taki opis zajmuje jedną do dwóch stron na przepływ. Jego przygotowanie to zwykle praca na kilka dni z udziałem analityka, architekta i osoby z placówki, która zna proces kliniczny. Bez niego wycena jest zgadywaniem, a każde „przecież to oczywiste” zamienia się w zlecenie zmiany.

Ta jednostka ma jeszcze jedną zaletę: pozwala decydować etapami. Zamiast zamawiać „integrację z P1 i HIS”, zamawiasz pierwszy przepływ, mierzysz rzeczywisty koszt i dopiero wtedy wyceniasz kolejne. Drugi przepływ tego samego typu kosztuje zwykle wyraźnie mniej niż pierwszy, bo warstwa wspólna (certyfikaty, podpis, kolejki, monitoring) już istnieje. Jeśli te rozmowy prowadzisz po raz pierwszy, warto zacząć od krótkiej fazy discovery. W ARDURA trwa ona 1–2 tygodnie i kończy się zakresem oraz architekturą, które można wycenić.

Dlaczego profil i wersja są ważniejsze niż sam standard?

Bo to profil, a nie standard, decyduje, czy Twój zasób zostanie przyjęty. Zasób Patient, który jest poprawny według bazowego FHIR R4, zostanie odrzucony przez serwer wymagający profilu, w którym identyfikator PESEL jest obowiązkowy i ma określony system. Dokument CDA, który jest poprawnym CDA, zostanie odrzucony przez walidator, jeśli nie spełnia reguł PIK w wersji obowiązującej w danym momencie.

W praktyce oznacza to trzy wymagania wobec wykonawcy i wobec siebie.

Lista profili i wersji w zakresie. Dla każdego przepływu wpisz nazwę profilu, adres kanoniczny i wersję. Jeśli druga strona nie publikuje profilu, wpisz specyfikację interfejsu dostawcy z numerem wersji dokumentu. „HL7 FHIR” bez tych danych nie jest specyfikacją.

Walidacja automatyczna. Każdy wysyłany zasób i dokument powinien przechodzić walidację przed wysłaniem, w pipeline CI i na produkcji. Dla FHIR jest to oficjalny walidator HL7 uruchamiany z pakietem profili, dla CDA reguły schematów i Schematron, jeśli są dostępne. Walidacja na produkcji wydaje się kosztowna, ale tańsza jest niż szukanie, dlaczego część dokumentów od tygodnia nie trafia do repozytorium.

Plan zmian wersji. Profile się zmieniają. CeZ aktualizuje dokumentację integracyjną P1, dostawcy systemów szpitalnych wydają nowe wersje interfejsów, a w USA kolejne wersje US Core przesuwają wymagany zestaw danych. Integracja bez planu aktualizacji jest projektem, który kończy się w dniu odbioru i psuje kilka miesięcy później. W umowie warto zapisać, kto monitoruje zmiany specyfikacji, w jakim czasie wykonawca dostosowuje integrację i według jakiej stawki.

Kto pracował z wersjonowaniem API, rozpozna tu znany problem: zmiana kontraktu po jednej stronie psuje stronę drugą, często bez żadnego błędu kompilacji. Technika, która pozwala wykryć takie zmiany wcześnie, to testy kontraktowe; ich zastosowanie opisaliśmy w tekście o testach kontraktowych i kompatybilności API.

Gdzie leżą pułapki, których oferta zwykle nie wycenia?

Z naszego punktu widzenia pięć obszarów odpowiada za większość niespodzianek w integracjach medycznych. Żaden z nich nie jest egzotyczny, ale każdy łatwo pominąć, gdy zakres opisuje się standardem.

Tożsamość pacjenta. W Polsce PESEL ułatwia sprawę, ale nie rozwiązuje jej w całości. Są pacjenci bez numeru PESEL (cudzoziemcy, noworodki przed nadaniem numeru, pacjenci w stanie nieprzytomności przyjmowani jako NN), są błędy wprowadzania i są systemy, które przechowują własne identyfikatory. Integracja potrzebuje reguł dopasowania, obsługi scalania kartotek i procedury, co zrobić, gdy dopasowanie jest niepewne. W USA problem jest większy, bo nie ma krajowego identyfikatora pacjenta, a dopasowanie opiera się na danych demograficznych.

Terminologie i mapowanie kodów. Słowniki laboratoryjne bywają lokalne, rozpoznania zakodowane w ICD-10 w wersji polskiej, procedury w ICD-9 PL, a partner zagraniczny oczekuje LOINC lub SNOMED CT. Mapa kodów musi powstać, musi ją zatwierdzić osoba z wiedzą kliniczną i musi być utrzymywana. To praca analityczna, której nie przyspieszy żaden framework, i jedna z najczęściej niedoszacowanych pozycji. Warto też sprawdzić warunki licencyjne terminologii, z których chcesz korzystać, zanim wpiszesz je do zakresu.

Kolejność i idempotencja. Komunikaty przychodzą w złej kolejności, powtarzają się po restarcie kolejki, korekta dociera przed oryginałem. Integracja musi być odporna na każdy z tych przypadków, a to oznacza identyfikatory komunikatów, deduplikację, możliwość ponownego przetworzenia i jasne reguły rozstrzygania konfliktów.

Cykl życia dokumentu. W EDM dokument nie jest „wysyłany i zapomniany”. Ma wersje, może zostać anulowany, wymaga podpisu, a jego indeks w P1 musi odpowiadać stanowi w repozytorium. Każda z tych operacji to osobna ścieżka do zaprojektowania i przetestowania.

Dane historyczne. Czy integracja dotyczy tylko nowych zdarzeń, czy także migracji danych sprzed uruchomienia? Migracja historii to często osobny projekt, z własną analizą jakości danych, i nie powinna wchodzić do zakresu przez domniemanie.

Każdą z tych pułapek da się wycenić, jeśli zostanie nazwana przed podpisaniem umowy. Problem polega na tym, że oferta mówiąca o „zgodności ze standardem” nie ma miejsca, w którym mogłyby się pojawić.

Czy FHIR powinien być wewnętrznym modelem danych Twojego systemu?

To pytanie dzieli architektów i warto mieć na nie własną odpowiedź przed rozmową z wykonawcą. Część zespołów buduje aplikację medyczną bezpośrednio na serwerze FHIR: zasoby FHIR są modelem danych, a API FHIR jest jednocześnie API aplikacji. Argument jest kuszący: jeden model, zero tłumaczenia, gotowe narzędzia.

Naszym zdaniem w większości projektów to błąd, z trzech powodów. Po pierwsze, wiąże model domenowy z wersją standardu i profilami, które kontrolują inni. Zmiana profilu CeZ albo przejście partnera na nowszą wersję FHIR staje się wtedy zmianą w sercu aplikacji, a nie w warstwie integracyjnej. Po drugie, zasoby FHIR są zaprojektowane do wymiany, nie do logiki biznesowej. Reguły typu „wizyta może zostać zamknięta dopiero po podpisaniu dokumentacji” trzeba i tak zapisać poza modelem, tyle że w mniej naturalny sposób. Po trzecie, w Polsce i tak musisz generować CDA dla P1, więc „zero tłumaczenia” jest złudzeniem: tłumaczenie istnieje, tylko leży w mniej oczywistym miejscu.

Bezpieczniejszy wzorzec to własny model domenowy plus warstwa antykorupcyjna: komponent, który tłumaczy model wewnętrzny na FHIR, CDA czy HL7 v2 i z powrotem. Zmiany zewnętrznych specyfikacji zamykają się w tej warstwie, a jej testy można prowadzić niezależnie od reszty aplikacji.

Są wyjątki. Jeśli budujesz repozytorium danych klinicznych, którego głównym zadaniem jest gromadzenie i udostępnianie danych innym systemom, model FHIR może być rozsądnym wyborem. Podobnie w aplikacji, która jest tylko przeglądarką danych z jednego EHR. Ale dla systemu z własną logiką procesu, na przykład platformy telemedycznej, systemu zleceń czy aplikacji dla programów lekowych, FHIR powinien być granicą, a nie fundamentem.

Jeśli integrujesz się z systemem, który już istnieje i którego nie da się wymienić od razu, ta sama warstwa tłumacząca pozwala stopniowo przenosić funkcje do nowego rozwiązania. Ten sposób działania opisuje wzorzec Strangler Fig.

Jak zabezpieczyć integrację z danymi medycznymi?

Dane o zdrowiu to szczególna kategoria danych osobowych w rozumieniu art. 9 RODO, więc integracja musi spełniać wymagania wyższe niż zwykłe API biznesowe. Część z nich narzuca platforma, część musisz zaprojektować sam.

Uwierzytelnianie i autoryzacja. Usługi P1 wymagają certyfikatów wydawanych przez CeZ i podpisywania komunikatów zgodnie z WS-Security. Po stronie FHIR standardem rynkowym jest SMART App Launch, czyli profil OAuth 2.0 i OpenID Connect dla aplikacji medycznych, z zakresami uprawnień określającymi, do jakich zasobów aplikacja ma dostęp. Jeśli integrujesz się z systemem EHR dostawcy zagranicznego, prawie na pewno będzie to SMART.

Zarządzanie kluczami i certyfikatami. Certyfikaty wygasają. Integracja, która przestaje działać, bo nikt nie odnowił certyfikatu, jest klasyczną awarią, którą łatwo przewidzieć i rzadko się przewiduje. Wpisz do zakresu monitoring ważności certyfikatów i procedurę ich odnowienia.

Ślad audytowy. Kto, kiedy i w jakim celu odczytał dane pacjenta? Integracja powinna logować każdy dostęp w sposób, który pozwala odpowiedzieć na to pytanie, bez zapisywania samych danych medycznych w logach aplikacyjnych. To ostatnie jest częstym błędem: logi z pełną treścią komunikatów HL7 lądują w systemie, do którego dostęp ma pół działu IT.

Minimalizacja danych. Przepływ powinien przenosić tylko te dane, które są potrzebne odbiorcy. Specyfikacja przepływu z ośmioma punktami z poprzedniej sekcji jest dobrym miejscem, żeby to udokumentować.

Bezpieczeństwo samego API. Typowe podatności API, takie jak brak kontroli dostępu na poziomie obiektu czy nadmierna ekspozycja danych, w kontekście medycznym mają poważniejsze skutki niż gdzie indziej. Przegląd najczęstszych ataków na interfejsy i sposobów obrony zebraliśmy w tekście o bezpieczeństwie API.

Część organizacji ochrony zdrowia podlega też przepisom o krajowym systemie cyberbezpieczeństwa. To, czy i w jakim zakresie dotyczy to Twojej placówki, warto ustalić z działem prawnym przed zaprojektowaniem integracji, bo wpływa na wymagania wobec monitoringu i zgłaszania incydentów.

Jak testować integrację medyczną, zanim dotknie danych pacjentów?

Testowanie integracji medycznej ma jedno ograniczenie, którego nie ma w większości projektów: nie możesz swobodnie używać danych produkcyjnych. Potrzebujesz więc danych syntetycznych, które są wystarczająco realistyczne, żeby wyłapać problemy z mapowaniem, i wystarczająco sztuczne, żeby nie stanowić danych osobowych.

Sensowny plan testów ma cztery poziomy.

Walidacja struktury. Każdy wygenerowany zasób FHIR przechodzi przez walidator HL7 z pakietem profili docelowych, każdy dokument CDA przez schematy i reguły PIK. To najtańszy poziom i powinien działać automatycznie przy każdej zmianie kodu.

Testy kontraktowe. Dla każdego przepływu zestaw przykładowych komunikatów wejściowych i oczekiwanych wyjść, obejmujący przypadki brzegowe: korektę, anulowanie, brak pola opcjonalnego, nieznany kod. Przy integracjach z dostawcami, którzy często zmieniają interfejs, to one jako pierwsze pokażą, że coś się zmieniło.

Testy na środowisku integracyjnym. Dla P1 jest to środowisko integracyjne CeZ z testowymi certyfikatami. Dla zagranicznych EHR zwykle sandbox dostawcy. W USA dostępne jest też narzędzie Inferno, za pomocą którego ASTP/ONC testuje zgodność z kryterium certyfikacyjnym dotyczącym standardowego API FHIR.

Testy akceptacyjne z udziałem personelu. Ktoś, kto zna proces kliniczny, musi sprawdzić, czy dane po drugiej stronie znaczą to samo. Wynik badania z poprawną wartością, ale w złej jednostce, przejdzie wszystkie testy automatyczne i nie przejdzie oka lekarza.

Pułapką jest zostawienie testów na koniec. Środowiska integracyjne platform publicznych i dostawców mają własne harmonogramy, okna serwisowe i kolejki zgłoszeń. Jeśli pierwszy kontakt z sandboxem następuje w ostatnim tygodniu projektu, termin odbioru jest fikcją.

Co EHDS i regulacje unijne zmienią w integracjach do 2031 roku?

Rozporządzenie (UE) 2025/327 w sprawie europejskiej przestrzeni danych dotyczących zdrowia (EHDS) zostało opublikowane 5 marca 2025 roku i weszło w życie 26 marca 2025 roku. Ogólnie stosuje się je od 26 marca 2027 roku, ale najważniejsze dla integracji obowiązki mają późniejsze terminy, zapisane w art. 105.

Od 26 marca 2029 roku dotyczą one pierwszej grupy priorytetowych kategorii danych: podsumowań pacjenta, e-recept i e-wydań. Producenci mogą od tej daty wprowadzać do obrotu tylko takie systemy EHR przetwarzające te kategorie, które spełniają wspólne specyfikacje zharmonizowanych komponentów, w tym możliwość wymiany danych w europejskim formacie wymiany elektronicznej dokumentacji zdrowotnej (EEHRxF). Od 26 marca 2031 roku to samo dotyczy obrazów medycznych i ich opisów, wyników badań oraz wypisów szpitalnych, a rozdział III rozporządzenia obejmuje wtedy również systemy EHR budowane przez placówki na własne potrzeby albo oferowane jako usługa.

Co to oznacza dla integracji zamawianej dziś? Po pierwsze, jeśli budujesz system, który będzie można uznać za system EHR w rozumieniu EHDS, architektura powinna od początku przewidywać eksport i import w formacie europejskim. Szczegóły techniczne formatu określą akty wykonawcze, więc nie warto implementować go na zapas, ale warstwa tłumacząca z sekcji o modelu danych jest dokładnie tym miejscem, w którym pojawi się kolejny format. Po drugie, termin 2031 dla systemów budowanych na własne potrzeby oznacza, że „to tylko nasz wewnętrzny system” przestaje być zwolnieniem z wymagań. Po trzecie, państwa członkowskie mogą wprowadzić część wymagań wcześniej, więc warto śledzić krajowe przepisy wykonawcze.

Jeśli Twój produkt może zostać zakwalifikowany jako wyrób medyczny, dochodzą wymagania MDR i normy IEC 62304. To osobny obszar, który zmienia proces wytwarzania w całym projekcie, a nie tylko w integracji, i powinien zostać rozstrzygnięty przed wyceną.

Ile kosztuje projekt integracji EHR/EDM i z czego wynika ta kwota?

Publicznie dostępne rzetelne dane o kosztach integracji medycznych w Polsce praktycznie nie istnieją, a liczby z amerykańskich poradników dotyczą innego rynku pracy i innej architektury. Poniższe przedziały są więc naszym szacunkiem, opisanym jako szacunek, z czynnikami, które go przesuwają. Traktuj je jako punkt wyjścia do rozmowy, nie jako cennik.

Element zakresuSzacowany nakład (osobodni)Co przesuwa w góręCo przesuwa w dół
Specyfikacja przepływów (discovery)5–15wiele systemów źródłowych, brak dokumentacji po drugiej stroniejeden partner z opublikowanym profilem
Warstwa wspólna: kolejki, monitoring, audyt, certyfikaty, obsługa błędów30–60wysoka dostępność, wiele środowisk, wymóg pracy 24/7istniejący silnik integracyjny w organizacji
Przepływ odczytu z gotowego API FHIR15–30 na przepływprofil niestandardowy, duże wolumeny, synchronizacja historiidobrze opisany profil i sandbox dostawcy
Przepływ zapisu dokumentu EDM do repozytorium z indeksem w P140–80 dla pierwszego, mniej dla kolejnychkorekty i anulowania, wiele typów dokumentów, podpis wielu osóbjeden typ dokumentu, gotowy komponent podpisu
Przepływ dwukierunkowy z HIS przez HL7 v2 lub API dostawcy40–100 na przepływsegmenty niestandardowe, kody lokalne bez słownika, brak środowiska testowegoaktualna specyfikacja interfejsu i testowa instancja HIS
Mapowanie terminologii10–40 na słownikkody lokalne, brak osoby klinicznej do weryfikacjistandardowe słowniki po obu stronach
Testy akceptacyjne i uruchomienie produkcyjne15–30wiele placówek, okna serwisowe partnerówjedna placówka, pilotaż

Jak z tego zrobić budżet? Przykład: platforma przychodni sieciowej integrująca się z jednym systemem laboratoryjnym przez HL7 v2, wysyłająca dwa typy dokumentów EDM do P1 i odczytująca dane pacjenta z systemu partnera przez FHIR. Discovery, warstwa wspólna, trzy przepływy, dwa słowniki i testy dają w sumie od około 150 do około 280 osobodni. Przy stawkach seniorów 180–260 zł/h, czyli 1440–2080 zł za dzień, to rząd od około 215 tysięcy do ponad 580 tysięcy złotych. Rozpiętość jest duża, bo na tym etapie taka powinna być: zawęża ją dopiero specyfikacja przepływów.

Do tego trzeba doliczyć koszty po własnej stronie: czas personelu medycznego przy mapowaniu i testach akceptacyjnych, opłaty dostawców systemów szpitalnych za udostępnienie interfejsu lub środowiska testowego (często pomijane, a bywają istotne), licencje silnika integracyjnego, jeśli go kupujesz, oraz utrzymanie. Utrzymanie integracji, czyli monitoring, obsługa incydentów i dostosowanie do zmian specyfikacji, szacujemy w praktyce na kilkanaście do dwudziestu kilku procent kosztu budowy rocznie, w zależności od tego, jak często zmieniają się interfejsy partnerów.

Dwie obserwacje na koniec tej sekcji. Oferta znacznie poniżej dolnej granicy takiego przedziału prawie zawsze pomija któryś z elementów tabeli, najczęściej obsługę wyjątków albo mapowanie terminologii. A oferta „za całość” bez rozbicia na przepływy uniemożliwia porównanie z inną ofertą, bo nie wiadomo, co każdy z wykonawców przyjął.

Jak zapisać umowę z wykonawcą integracji?

Umowa na integrację medyczną różni się od zwykłej umowy na oprogramowanie tym, że część zakresu zależy od stron trzecich: CeZ, dostawcy systemu szpitalnego, laboratorium. Dobra umowa nazywa te zależności i przypisuje do nich ryzyko.

Zakres jako lista przepływów. Każdy przepływ z opisem ośmiu elementów, profilem i wersją. Zmiana profilu albo wersji po stronie partnera to zmiana zakresu z określoną procedurą wyceny, a nie spór o to, czy „zgodność z FHIR” ją obejmowała.

Zależności od stron trzecich. Kto zapewnia dostęp do środowiska testowego HIS, kto zamawia certyfikaty P1, kto dostarcza specyfikację interfejsu laboratorium i w jakim terminie. Jeśli zależność nie zostanie spełniona, harmonogram się przesuwa, a umowa powinna mówić, co dzieje się z kosztem.

Kryteria odbioru per przepływ. Lista przypadków testowych, walidacja na środowisku integracyjnym, określony okres stabilnej pracy na produkcji. Odbiór całości „po uruchomieniu” bez kryteriów per przepływ kończy się sporem o to, czy błąd w rzadkim przypadku korekty jest wadą, czy nową funkcją.

Model rozliczenia. Stała cena działa dla przepływów dobrze opisanych, z dostępną specyfikacją po drugiej stronie. Dla przepływów z dużą niepewnością, na przykład integracji z systemem bez dokumentacji, rozsądniejszy jest czas i materiały z limitem albo osobny etap rozpoznania z własną wyceną. Mieszanie obu modeli w jednym projekcie jest w porządku, jeśli granica jest zapisana.

Utrzymanie i zmiany wersji. Kto monitoruje komunikaty CeZ i dostawców o zmianach specyfikacji, w jakim czasie wykonawca dostosowuje integrację, według jakich stawek i jak długo trwa zobowiązanie. Integracja bez umowy utrzymaniowej jest integracją, która za rok przestanie działać.

Wiedza i dokumentacja. Mapy kodów, specyfikacje przepływów i konfiguracja silnika integracyjnego powinny należeć do Ciebie i być przekazywane na bieżąco, a nie na koniec projektu. Inaczej zmiana wykonawcy oznacza odtwarzanie wiedzy od zera.

Osobną decyzją jest skład zespołu. Integracja medyczna potrzebuje kilku ról, które rzadko występują razem w jednej osobie: analityka znającego procesy kliniczne, programisty z doświadczeniem w HL7 i FHIR, architekta odpowiedzialnego za warstwę wspólną i testera umiejącego budować dane syntetyczne. O tym, jak dobrać taki zespół i rozłożyć role na fazy projektu, pisaliśmy w tekście o zespole IT do projektu e-zdrowia.

Jakie są kluczowe wnioski przed zamówieniem integracji?

Integracja z systemami EDM i EHR nie jest droga dlatego, że standardy są trudne. Jest droga wtedy, gdy zakres opisuje się standardem, a nie przepływami, bo wtedy koszt mapowania, terminologii, tożsamości pacjenta i wyjątków pojawia się dopiero w trakcie projektu, w formie zleceń zmian.

Zapamiętaj sześć rzeczy. Po pierwsze, w Polsce wymiana EDM z P1 opiera się na HL7 CDA i usługach SOAP, a FHIR pojawia się w części usług CeZ i u partnerów, więc projekt zwykle obsługuje kilka standardów. Po drugie, opisz zakres jako listę przepływów, każdy z ośmioma elementami, profilem i wersją. Po trzecie, wymagaj automatycznej walidacji wobec konkretnych profili, nie deklaracji zgodności. Po czwarte, nie buduj logiki aplikacji na zasobach FHIR, tylko na własnym modelu z warstwą tłumaczącą. Po piąte, uwzględnij w budżecie mapowanie terminologii, koszty po stronie partnerów i utrzymanie. Po szóste, zaplanuj architekturę z myślą o EHDS i terminach 2029 i 2031, nie implementując jeszcze formatu europejskiego na zapas.

Jeśli przygotowujesz integrację z P1, systemem szpitalnym albo zagranicznym EHR i potrzebujesz zamienić ogólny zakres na listę przepływów, którą da się wycenić, zobacz, jak pracujemy w tworzeniu oprogramowania na zamówienie. Możesz też uzupełnić własny zespół o specjalistów IT dla ochrony zdrowia albo porozmawiać z nami o zakresie pierwszego przepływu.