Integracja z P1 (e-Recepta, e-Skierowanie): czego nauczyło nas wdrożenie

Integracja z P1 to połączenie systemu placówki z Platformą P1 Centrum e-Zdrowia, żeby wystawiać i pobierać e-Recepty oraz e-Skierowania. Brzmi jak jedno zadanie. W praktyce to autoryzowany dostęp do SOAP-API, certyfikaty, podpis elektroniczny dokumentów i osobne moduły do wysyłania oraz odpytywania ich statusu. Ten artykuł pokazuje, co naprawdę kryje się za zdaniem „integrujemy z P1" — na podstawie realnego wdrożenia.

„Jedna integracja z P1" prawie nigdy nie oznacza jednej integracji.

Czy ten artykuł jest dla Ciebie?

Będzie pomocny, jeśli:

• planujesz dedykowany system lub portal pacjenta z e-Receptą,
• jesteś dyrektorem IT / decydentem i wybierasz wykonawcę,
• oceniasz, czy P1 zrobić samodzielnie, czy zlecić,
• chcesz wiedzieć, co realnie wpływa na czas i koszt takiej integracji.

Jeśli szukasz gotowej instrukcji krok-po-kroku do samodzielnego wdrożenia — pełna dokumentacja jest u Centrum e-Zdrowia. Tu pokazujemy obraz z lotu ptaka i pułapki, których w dokumentacji nie widać.

Co to jest P1 i integracja z P1

P1 to Elektroniczna Platforma Gromadzenia, Analizy i Udostępnienia Zasobów Cyfrowych o Zdarzeniach Medycznych, prowadzona przez Centrum e-Zdrowia. To przez nią przechodzą m.in. e-Recepta i e-Skierowanie. Integracja z P1 oznacza, że Twój system potrafi rozmawiać z tą platformą: wystawić dokument, wysłać go, pobrać status i identyfikator.

Od strony technicznej to autoryzowany SOAP-API. Twój backend musi się uwierzytelnić certyfikatem, zbudować poprawny dokument, podpisać go i wysłać — a potem obsłużyć odpowiedź i błędy. To nie jest „wywołanie jednego REST-a".

Czego nauczyło nas wdrożenie

Przy budowie portalu systemu dla sieci placówek medycznych — projekcie rzędu 450 zadań i ~1,5 roku, dla środowiska ~150 placówek i 40 lekarzy — integracja z P1 była jednym z filarów. Oto co z niej wynieśliśmy:

Założenie: „integracja z P1 to jeden moduł do podłączenia".

Rzeczywistość: P1 okazał się autoryzowanym SOAP-API, które trzeba obudować kilkoma osobnymi funkcjami — wystawianie recepty, wystawianie skierowania, odpytywanie statusu. Sam dokument e-Recepty budowaliśmy od podstaw w XML, z walidacją i obsługą wariantów (recepta zwykła, RP, PRW, recepturowa), pobieraniem produktów farmaceutycznych i automatycznym uzupełnianiem danych pacjenta. Do tego doszedł podpis elektroniczny dokumentów, obsługa błędów i statusów oraz praca na środowisku testowym przed produkcją. A obok P1 stanęły dwa kolejne, niezależne światy: ZUS e-ZLA (osobny SOAP, własna walidacja XSD, podpis) i NIL — weryfikacja numeru PWZ lekarza.

Wniosek: „integracja z P1" to nie checkbox w ofercie, tylko podprojekt z własną architekturą, testami i odbiorami. Kto wycenia ją jako „jedną integrację", prawdopodobnie nie robił jej wcześniej.

Co naprawdę obejmuje integracja z P1

Poniżej lista etapów, które w ofercie łatwo skryć pod jednym słowem „P1":

• Dostęp i certyfikaty — uzyskanie uprawnień, certyfikatów i dostępu do środowiska integracyjnego (formalności + czas).
• Autoryzacja do usług P1 na backendzie.
• Moduły dokumentów — wystawianie e-Recepty i e-Skierowania, odpytywanie statusu, anulowanie.
• Budowa i walidacja XML — dla e-Recepty w kilku wariantach (zwykła, RP, PRW, recepturowa) oraz dla e-Skierowania (builder z walidacją P1, wyszukiwarki ICD-9/ICD-10 i jednostek NFZ, wszystkie typy skierowań, historia i anulowanie).
• Dane leków — pobieranie produktów farmaceutycznych (np. z bazy typu Pharmindex) i kontrola dawkowania.
• Podpis dokumentów — WS-Security, certyfikat per lekarz, konwersja p12 → pem i bezpieczne przechowywanie klucza.
• Obsługa błędów i statusów — realne odpowiedzi P1 bywają asynchroniczne; trzeba je logować i obsłużyć.
• Testy i odbiory — najpierw środowisko testowe, potem produkcja.

Od strony technicznej oznacza to własnego klienta SOAP dla P1, generatory i walidatory dokumentów, warstwę podpisu oraz obsługę cyklu życia dokumentu (wystawienie → status → ewentualne anulowanie).

Najczęstsze pułapki przy integracji z P1

• Traktowanie P1 jako „jednej integracji" — a obok stoją e-ZLA (ZUS) i weryfikacja PWZ (NIL), każde z własnym API i certyfikatami.
• Niedoszacowanie budowy XML — warianty recept i walidacja to realna praca, nie „mapowanie pól".
• Formalności certyfikatów i dostępu — potrafią wydłużyć start bardziej niż sam kod.
• Bezpieczeństwo kluczy — certyfikat .p12 to dane wrażliwe; wymaga szyfrowanego składowania.
• Obsługa statusów i błędów — pominięta na początku, wraca jako największy dług techniczny.
• Aktualizacje dokumentacji P1 — integracja to nie „zrób i zapomnij", tylko utrzymanie w czasie.

W systemie medycznym najwięcej ryzyka nie leży w napisaniu kodu, lecz w certyfikatach, walidacji dokumentów i obsłudze tego, co pójdzie nie tak.

Red flags: kiedy uciekać od wykonawcy

• mówi, że „P1 to szybka integracja",
• nie wspomina o certyfikatach i środowisku testowym,
• nie ma doświadczenia z e-Receptą, e-ZLA ani weryfikacją PWZ,
• nie planuje obsługi błędów i statusów dokumentów,
• nie potrafi pokazać, jak działa u niego podpis i bezpieczne przechowywanie klucza.

Robić samemu czy zlecić i ile to kosztuje

Jeśli kupujesz gotowy system, integracja z P1 jest zwykle wbudowana — nie budujesz jej sam. Własną integrację ma sens robić, gdy tworzysz dedykowany system lub portal pacjenta i potrzebujesz pełnej kontroli nad procesem oraz danymi. Wtedy jednak traktuj ją jak osobny podprojekt z własnym budżetem i harmonogramem.

Ile to kosztuje w kontekście całego systemu i jak liczyć TCO — rozkładamy w osobnym artykule: ile kosztuje oprogramowanie dla przychodni.

FAQ

Co to jest integracja z P1?

Połączenie systemu placówki z Platformą P1, umożliwiające wystawianie i pobieranie e-Recept oraz e-Skierowań — przez autoryzowany SOAP-API, z certyfikatami i podpisem elektronicznym.

Ile trwa integracja z P1?

To podprojekt, nie jeden endpoint: certyfikaty, środowisko testowe, budowa i walidacja XML, podpis, obsługa statusów, testy. Realnie liczony w tygodniach — więcej, jeśli dochodzą e-ZLA i weryfikacja PWZ.

Czy do e-Recepty potrzebne są certyfikaty?

Tak. Dostęp do P1 jest autoryzowany, a dokumenty podpisywane elektronicznie (np. PKCS#12). To osobny etap do zaplanowania przed implementacją.

Czy P1 to to samo co e-ZLA w ZUS?

Nie. P1 (e-Recepta, e-Skierowanie) i e-ZLA (ZUS) to dwie odrębne integracje, a weryfikacja PWZ (NIL) to trzeci system. Inne API, inne certyfikaty, inna dokumentacja.

Czy można wystawiać e-Recepty bez własnej integracji z P1?

Tak — gotowe systemy mają to wbudowane. Własną integrację buduje się przy systemie dedykowanym lub portalu pacjenta.

Co dalej

Nie każdy projekt wymaga własnej integracji z P1 — czasem gotowy system w zupełności wystarczy, i powiemy Ci to wprost. Jeśli jednak budujesz coś dedykowanego:

Warto też przeczytać:

• Ile kosztuje oprogramowanie dla przychodni — modele, TCO i koszty ukryte
• Jak wybrać system dla przychodni lub kliniki
• AI i systemy dla ochrony zdrowia — przegląd rozwiązań dla placówek

Dowody i doświadczenia

Co zmieniło się w 2026?