Integracja EZD RP z systemami IT i e-Doręczeniami

Integracja systemu EZD RP z istniejącą infrastrukturą informatyczną jednostki samorządu terytorialnego oraz obligatoryjnym systemem e-Doręczeń to kluczowy element pełnej cyfryzacji administracji publicznej. W 2025 roku wymogi prawne oraz techniczne osiągnęły poziom dojrzałości wymagający od JST kompleksowej strategii integracyjnej.

1. Przegląd wymogów integracji z e-Doręczeniami

System e-Doręczeń, funkcjonujący od 2022 roku, od stycznia 2025 stał się obligatoryjnym kanałem komunikacji elektronicznej między podmiotami publicznymi a obywatelami. Każda jednostka administracji publicznej zobowiązana jest do posiadania Adresu Publicznej Usługi Hybrydowej (APUH) oraz do przyjmowania i wysyłania korespondencji wyłącznie w tej formie. EZD RP został wyposażony w natywne mechanizmy integracyjne z Krajowym Systemem Doręczeń Elektronicznych (KSDE), co umożliwia:

• Automatyczne odbieranie przesyłek elektronicznych bezpośrednio do systemu obiegu dokumentów
• Wysyłanie dokumentów wychodzących z automatycznym poświadczeniem odbioru (EPO)
• Synchronizację statusów doręczeń w czasie rzeczywistym
• Archiwizację kompletnej korespondencji z zachowaniem wartości dowodowej

2. Wymogi regulacyjne i zgodność prawna 2025

Ustawa z dnia 18 listopada 2020 r. o doręczeniach elektronicznych oraz szereg rozporządzeń wykonawczych nakładają na JST rygorystyczne obowiązki. Od 1 stycznia 2025 roku każda jednostka musi:

• Zapewnić pełną dostępność APUH oraz jego widoczność w centralnym rejestrze
• Obsługiwać kwalifikowane podpisy elektroniczne oraz pieczęcie elektroniczne zgodnie z eIDAS
• Gwarantować nieprzerwany odbiór korespondencji 24/7/365
• Przestrzegać maksymalnych terminów procesowania przesyłek (3 dni robocze)
• Prowadzić szczegółowy audyt wszystkich operacji doręczeniowych

Niezastosowanie się do przepisów wiąże się z sankcjami administracyjnymi oraz utratą możliwości skutecznego doręczania pism urzędowych, co paraliżuje działalność administracyjną.

3. Architektura techniczna i modele integracji

Integracja EZD RP z e-Doręczeniami opiera się na architekturze SOA (Service-Oriented Architecture) z wykorzystaniem protokołów SOAP i REST API. System KSDE udostępnia zestaw usług sieciowych (web services), które EZD RP wywołuje w celu realizacji operacji doręczeniowych. Podstawowy model integracji obejmuje:

• Moduł konektora e-Doręczeń: Komponent EZD RP odpowiedzialny za nawiązywanie bezpiecznego połączenia z KSDE poprzez wzajemne uwierzytelnianie certyfikatami TLS 1.3
• Warstwa synchronizacji: Automatyczny polling lub mechanizm push notifications informujący o nowych przesyłkach w skrzynce APUH
• Parser metadanych: Ekstrakcja strukturalnych danych z nagłówków przesyłek i automatyczne mapowanie na pola formularza wpływu korespondencji w EZD RP
• Moduł podpisywania: Integracja z HSM (Hardware Security Module) lub zaufanym dostawcą usług certyfikacyjnych w celu składania pieczęci na dokumentach wychodzących

Zalecany jest model hybrydowy: połączenie synchronicznej komunikacji dla operacji krytycznych (wysyłka pism) z asynchronicznym odbieraniem przesyłek w tle (scheduled jobs co 15 minut).

4. Integracja z istniejącymi systemami IT (HR, Finanse, Zarządzanie Dokumentami)

Nowoczesna jednostka samorządowa dysponuje zazwyczaj kilkoma wyspecjalizowanymi systemami dziedzinowymi: systemem kadrowo-płacowym (HR), systemem finansowo-księgowym (np. budżet JST), systemem zarządzania nieruchomościami czy ewidencją ludności. EZD RP jako centralne repozytorium dokumentacji musi zapewnić dwukierunkową wymianę informacji z tymi platformami:

• System HR: Automatyczny import struktury organizacyjnej, stanowisk i pracowników w celu bieżącej aktualizacji katalogu użytkowników EZD RP. Eksport dokumentacji kadrowej (np. umów o pracę, aneksów) do systemu płacowego.
• System Finansowo-Księgowy: Przekazywanie faktur zakupionych, umów cywilnoprawnych oraz decyzji administracyjnych z wpływem budżetowym bezpośrednio do modułu księgowości. Weryfikacja dostępności środków przed akceptacją zobowiązań.
• System Zarządzania Nieruchomościami/GIS: Linkowanie spraw urbanistycznych, decyzji o warunkach zabudowy czy pozwoleń na budowę z mapami GIS oraz ewidencją geodezyjną.

Integracja realizowana jest najczęściej poprzez uniwersalne złącza REST API lub klasyczne mechanizmy wymiany plików CSV/XML w folderach sieciowych z harmonogramami cyklicznymi (cron jobs).

5. Specyfikacja API i endpointy integracyjne

EZD RP udostępnia REST API zgodne ze standardem OpenAPI 3.0. Kluczowe endpointy wykorzystywane w integracjach to:

• POST /api/v1/documents/incoming – Rejestracja nowego dokumentu wpływającego (wywołanie z systemu e-Doręczeń po odebraniu przesyłki)
• GET /api/v1/documents/{id}/metadata – Pobranie pełnych metadanych sprawy (wywoływane przez systemy zewnętrzne)
• PUT /api/v1/documents/{id}/assign – Dekretacja sprawy do konkretnego pracownika (integracja z systemem workflow)
• POST /api/v1/documents/outgoing – Wysłanie dokumentu wychodzącego z automatyczną konwersją do formatu e-Doręczeń
• GET /api/v1/users/sync – Synchronizacja użytkowników z Active Directory lub LDAP

Każde żądanie API wymaga autoryzacji poprzez token Bearer JWT z odpowiednimi zakresami uprawnień (scopes). Dokumentacja API dostępna jest w portalu programistycznym NASK pod adresem developer.ezd.gov.pl.

6. Bezpieczeństwo i protokoły uwierzytelniania

Integrations between EZD RP and external systems must comply with stringent security standards:

• Transport Layer Security: Wyłącznie połączenia TLS 1.3 z wzajemnym uwierzytelnianiem certyfikatami (mutual TLS)
• OAuth 2.0 + OpenID Connect: Federacyjne zarządzanie tożsamościami umożliwiające Single Sign-On (SSO) dla użytkowników łączących się z wielu systemów
• IP Whitelisting: Rejestracja adresów IP systemów uprawnionych do komunikacji z EZD RP w celu blokowania nieautoryzowanych żądań
• Rate Limiting: Ograniczenia liczby wywołań API (np. 1000 requestów/godzinę) zapobiegające atakom DDoS
• Szyfrowanie danych: Wrażliwe payload'y szyfrowane algorytmem AES-256 przed transmisją

7. Mapowanie i transformacja danych

Różnice w modelach danych między systemami źródłowymi a EZD RP wymagają precyzyjnie zdefiniowanych reguł transformacji. Przykładowa mapa konwersji dla importu użytkowników z Active Directory:

• AD: sAMAccountName → EZD RP: username
• AD: displayName → EZD RP: full_name
• AD: mail → EZD RP: email
• AD: department → EZD RP: organizational_unit_id (wymagane dodatkowe mapowanie słownikowe)

Transformacje wykonywane są przez dedykowany moduł ETL (Extract, Transform, Load), który dodatkowo waliduje poprawność danych przed zasileniem docelowego systemu.

8. Procedury testowania i walidacji

Przed uruchomieniem integracji produkcyjnie konieczne jest przeprowadzenie kompleksowych testów funkcjonalnych i obciążeniowych:

• Testy jednostkowe: Weryfikacja poprawności każdego endpointu API w izolacji (Postman, Newman)
• Testy integracyjne: Sprawdzenie scenariuszy end-to-end, np. pełny cykl wysyłki dokumentu z EZD RP przez e-Doręczenia do adresata
• Testy obciążeniowe: Symulacja dużego wolumenu transakcji (JMeter, Gatling) w celu weryfikacji wydajności i stabilności
• Testy bezpieczeństwa: Audyty penetracyjne (penetration testing) wykonywane przez zewnętrzne firmy specjalizujące się w cybersecurity
• User Acceptance Testing (UAT): Testy akceptacyjne z udziałem rzeczywistych użytkowników końcowych

9. Monitorowanie i utrzymanie integracji

Po wdrożeniu produkcyjnym niezbędne jest wdrożenie systemu monitoringu ciągłego (continuous monitoring):

• Dashboard operacyjny wyświetlający w czasie rzeczywistym liczbę przetworzonych dokumentów, statusy synchronizacji oraz alerty błędów
• Automatyczne powiadomienia (email, SMS) w przypadku awarii krytycznych komponentów integracyjnych
• Logi transakcyjne przechowywane minimum 5 lat zgodnie z wymogami archiwalnymi
• Regularne przeglądy wydajności (performance reviews) i optymalizacja zapytań SQL oraz wywołań API
• Harmonogram aktualizacji (patch management) zapewniający zgodność z nowymi wersjami API systemów zewnętrznych

10. Wsparcie techniczne i procedury eskalacji

W przypadku problemów z integracjami JST powinny mieć wdrożone jasne procedury eskalacji:

• Poziom 1 (L1 Support): Helpdesk wewnętrzny jednostki – rozwiązywanie podstawowych problemów (np. błędne logowanie, brak uprawnień)
• Poziom 2 (L2 Support): Administratorzy systemów IT – diagnostyka problemów konfiguracyjnych i sieciowych
• Poziom 3 (L3 Support): Zespół deweloperski lub partner integracyjny – naprawa defektów w kodzie, modyfikacja mapowań
• Poziom 4 (Vendor Support): NASK oraz dostawcy systemów zewnętrznych – wsparcie w przypadku błędów na poziomie platformy

Umowa SLA powinna definiować maksymalne czasy reakcji na zgłoszenia w zależności od ich krytyczności (np. Critical: 1h, High: 4h, Medium: 24h, Low: 72h).

Podsumowanie: Skuteczna integracja EZD RP z systemami IT oraz e-Doręczeniami wymaga starannego planowania, zgodności z aktualnymi przepisami oraz rygorystycznych procedur testowania i monitorowania. JST inwestujące w profesjonalne podejście do integracji zyskują pełną automatyzację obiegu dokumentów, eliminację błędów ludzkich oraz zgodność z najwyższymi standardami bezpieczeństwa danych. W 2025 roku brak takiej integracji oznacza nie tylko nieefektywność operacyjną, ale także naruszenie wymogów prawnych regulujących cyfrową administrację publiczną.