Integracja AMODIT z ePUAP i Profilem Zaufanym

1. Czym jest ePUAP?

ePUAP (Elektroniczna Platforma Usług Administracji Publicznej) to państwowy system, który umożliwia bezpłatną, elektroniczną wymianę pism pomiędzy instytucjami publicznymi a obywatelami, firmami i NGO. Działa w modelu „skrzynka nadawczo‑odbiorcza” – każda jednostka posiada własny adres skrytki, a dokumenty są podpisywane kwalifikowanym podpisem lub Profilem Zaufanym (PZ).

2. Dlaczego warto zintegrować ePUAP z AMODIT?

Wyzwanie (bez integracji)	Korzyść z modułu ePUAP w AMODIT
Ręczne logowanie się do portalu ePUAP, pobieranie PDF i przepisywanie danych	W pełni automatyczny obieg – wysyłka, odbiór i archiwizacja dokumentów w AMODIT.
Ryzyko pominięcia nowych pism i przekroczenia terminów	Harmonogram pobierający wiadomości 24/7 i tworzący sprawy z alertami SLA.
Brak centralnej historii korespondencji	Wszystkie pisma ePUAP w jednym procesie, z linkiem do oryginału i podglądem XML.
Kłopotliwe podpisywanie Profilem Zaufanym (kilka systemów)	Klik w AMODIT ➜ przekierowanie do PZ ➜ podpis ➜ dokument wraca do sprawy.

3. Kluczowe korzyści biznesowe

• Pełna obsługa korespondencji urzędowej w jednym miejscu – użytkownicy nie opuszczają AMODIT.
• Zgodność z prawem – podpis kwalifikowany / Profil Zaufany i oficjalne wzory dokumentów.
• Automatyzacja procesów – reguły wysyłki (Nadaj), doręczeń (Doręcz) i odbioru skrzynki.
• Bezpieczeństwo – certyfikaty X.509 autoryzują komunikację; dostęp tylko dla uprawnionych ról.
• Skalowalność – obsługa wielu skrytek i setek dokumentów dziennie bez ręcznej pracy.

4. Co dokładnie umożliwia moduł ePUAP w AMODIT

Stan na 2023 rok

Funkcja	Co daje w praktyce?
ePUAP_SendStandardMessage	Wysyłka pisma w trybie Nadaj – idealne dla obywatela.
ePUAP_SendMessageInDeliveryMode	Wysyłka w trybie Doręcz (UPD/fikcja doręczenia) – obowiązkowe dla urzędów.
ePUAP_ReceiveMessages	Automatyczne (lub ręczne) pobieranie nowych pism z kolejki skrytki.
ProfilZaufany_SendToSign	Wysyłka dokumentu do podpisu PZ i automatyczny zwrot podpisanej wersji.
Podgląd XML	Dokumenty ePUAP prezentowane czytelnie w AMODIT (XSLT).
Raporty skrzynkowe	Widok Odebrane / Wysłane / Robocze jak w portalu ePUAP.

5. Wymagania wdrożeniowe

• Status instytucji publicznej – moduł przeznaczony wyłącznie dla podmiotów z nadaną decyzją ministerstwa.
• Certyfikaty X.509 – jeden na każdą skrytkę, zabezpieczone wspólnym hasłem.
• Licencja AMODIT – moduł ePUAP (aktywacja w ustawieniach systemowych).
• Wersja AMODIT ≥ 230930.

6. Kroki wdrożenia (high‑level)

1. Zakup/aktywacja licencji ePUAP w AMODIT.
2. Wgranie wtyczki AMODITePUAPConnector.dll do katalogu bin oraz usługi asynchronicznej.
3. Dodanie certyfikatów w procesie Companies (pola ePUAP_userName, ePUAP_userCertificate).
4. Ustawienie parametrów (adresy web‑service, hasło do certyfikatów).
5. Modyfikacja web.config – dodanie endpointu callback dla PZ.
6. Zdefiniowanie procesów: – Wysłane dokumenty (generowanie, podpis, wysyłka) – Odebrane dokumenty (odbiór, routing, odpowiedzi).
7. Testy na środowisku INT ePUAP/PZ – gotowe konta demo dostępne od AMODIT.

7. Typowe scenariusze

• Urzędowe pisma ogólne wysyłane do obywateli (tryb Doręcz + UPD).
• Odbiór wniosków od firm – dokument trafia do procesu AMODIT, pola mapują się z XML.
• Automatyczna odpowiedź – AMODIT generuje szablon, podkłada dane, podpis PZ i wysyła.
• Akceptacja UPP/UPD – dokument zwrotny przypina się do sprawy, a status aktualizuje się sam.

8. FAQ

Pytanie	Odpowiedź
Czy mogę używać integracji, jeśli nie jestem urzędem?	Nie, moduł dostępny tylko dla podmiotów ze statusem instytucji publicznej.
Jak długo trwa pobranie nowych pism?	Reguła może działać co parę minut; pojedyncza wiadomość to <1 s.
Czy podpis kwalifikowany też jest obsługiwany?	Tak, moduł nie ogranicza rodzaju podpisu – PZ to opcja dodatkowa.
Co z plikami >3,5 MB?	W roadmapzie 2025 – „obsługa dużych plików”.
Jak monitorować błędy?	Włączyć logowanie poziom 3 dla modułu AMODITePUAPConnector.

9. Roadmapa rozwoju

• Walidacja szablonów przed wysyłką
• Weryfikacja podpisu PZ w AMODIT
• Obsługa dużych załączników (>3,5 MB)
• Grupowe wysyłanie do PZ (wiele dokumentów, jedno logowanie)

---

Podsumowanie: Moduł ePUAP w AMODIT pozwala instytucjom publicznym przenieść pełną obsługę korespondencji urzędowej do jednego, zautomatyzowanego obiegu. Wysyłka, odbiór, podpis PZ i raporty dzieją się w tle – urzędnik widzi klarowne sprawy, a obywatele otrzymują pisma bez opóźnień.