Podatki - moduł e-Doręczenia

Podatki wersja >= 2025.0.0.210.216

Skrzynkę e-Doręczeń można obsługiwać nie tylko za pomocą interfejsu webowego, ale również za pomocą systemów zewnętrznych, takich jak np. Podatki. Aby udzielić dostępu do skrzynki dla systemu zewnętrznego, konieczne jest wygenerowanie pliku CSR (Certificate Signing Request), który zostanie wykorzystany w procesie rejestracji. Po zweryfikowaniu pliku CSR, system e-Doręczeń wygeneruje certyfikat X.509, który należy pobrać i zapisać wraz z kluczem prywatnym i publicznym.

Generowanie kluczy

Do wygenerowania kluczy najlepiej użyć narzędzia OpenSSL. Link do pobrania: https://slproweb.com/products/Win32OpenSSL.html

Generowanie klucza prywatnego

Aby utworzyć klucz prywatny, który będzie używany z certyfikatem, przy wykorzystaniu pakietu openSSL, należy wpisać poniższe polecenie w oknie terminala:

openssl genrsa -out D:\klucze\infosys_edor.key 2048

Uwaga! Wygenerowany klucz prywatny należy zachować w bezpiecznym miejscu i uniemożliwić dostęp do niego osobom trzecim. Należy również wykonać kopię bezpieczeństwa tego pliku, jest on niezbędny do późniejszego używania certyfikatu. Powtórne wygenerowanie identycznego klucza prywatnego nie jest możliwe, zatem jego utrata automatycznie uniemożliwia korzystanie z certyfikatu.

Generowanie pliku żądania podpisania certyfikatu

Aby utworzyć plik żądania podpisania certyfikatu (CSR) na podstawie wcześniej wygenerowanego klucza prywatnego, należy użyć polecenia:

openssl req -new -key D:\klucze\infosys_edor.key -out D:\klucze\infosys_edor.csr

W trakcie tworzenia pliku CSR, należy podać następujące informacje:

• Country Name (C) ‒ należy podać dwuliterowy kod kraju [PL].
• State or Province Name (ST) ‒ należy podać nazwę województwa, w którym mieści się siedziba firmy [Wojewodztwo].
• Locality Name (L) ‒ należy podać nazwę miejscowości, w której mieści się siedziba firmy [Miejscowosc].
• Organization Name (O) ‒ należy podać pełną i dokładną nazwę firmy, musi się ona zgadzać z nazwą przedstawioną w dokumentach rejestrowych, czyli w rejestrze CEIDG lub KRS [Nazwa Firmy].
• Organizational Unit Name (OU) ‒ pole nieobowiązkowe, opcjonalnie można podać nazwę działu firmy odpowiedzialnego za wdrożenie certyfikatu [Nazwa Dzialu IT].
• Common Name (CN) ‒ należy wpisać nazwę domeny, dla której ma być wystawiony certyfikat np. [ezd.domena.pl]. Dla certyfikatów typu Wildcard podajemy nazwę domeny w postaci [*.domena.pl].
• Email Address [E] ‒ pole nieobowiązkowe.
• Po przejściu przez tę procedurę pojawią się jeszcze dwa dodatkowe pytania (extra attributes). Pola te należy pozostawić puste i zatwierdzić klawiszem Enter:
  • A challenge password ‒ należy pominąć i zatwierdzić klawiszem Enter.
  • An optional company name ‒ należy pominąć i zatwierdzić klawiszem Enter.

Uwaga! Podczas udzielania odpowiedzi na pytania NIE NALEŻY używać polskich znaków.

Poprawność pliku CSR zostanie sprawdzona podczas rejestracji integrowanego systemu.

Dodawanie integrowanego systemu do skrzynki e-Doręczeń

Rejestrację integrowanego systemu rozpocznij od zalogowania się do systemu e-Doręczeń w roli w właściciela skrzynki. Przejdź do strony z widokiem zakładki Systemy znajdującej się w sekcji Uprawnienia.

Następnie naciśnij przycisk Dodaj system w prawym górnym rogu ekranu. Przejedziesz do strony Dodaj system.

Dodawanie systemu

Uwaga! Przeprowadzanie procesu rejestracji systemu zewnętrznego może dokonać tylko użytkownik pełniący role właściciela skrzynki.

Dodawanie systemu

Wprowadź wymagane informacje:

• Nazwę systemu, która umożliwi łatwe zidentyfikowanie go na liście - unikaj spacji;
• Wgraj żądanie certyfikatu (CSR), jako środek uwierzytelniający;
• Dodatkowo w polu Opis systemu możesz wprowadzić krótki opis systemu, maksymalnie 256 znaków.

Zapisz wprowadzone informacje klikając na przycisk Zapisz.

Plik CSR jest weryfikowany – dostaniesz informację o tym, czy proces weryfikacji przebiegł prawidłowo. Jeśli tak, system tworzy certyfikat X.509. Kliknij Pobierz certyfikat, aby go pobrać.

Konfiguracja

Uwaga! Instalacja bibliotek!

Przed rozpoczęciem konfiguracji niezbędne jest doinstalowanie bibliotek umożliwiających uruchamianie w systemie Windows aplikacji stworzonych przy pomocy narzędzi programistycznych firmy Microsoft:

• .NET Framework w wersji 4.8 lub wyższej,
• Microsoft Visual C++ 2015-2022 Redistributable (wersja x86).
• Microsoft Visual C++ 2015-2022 Redistributable (wersja x64).

Brak w/w bibliotek uniemożliwi zapisane parametrów modułu e-Doręczenia.

Parametry modułu e-Doręczenia

Menu: Konfiguracja -> Ustawienia -> Parametry modułu e-Doręczenia

Środowisko produkcyjne

Parametry środowiska produkcyjnego usługi e-Doręczenia

Przygotowane w poprzednich krokach dane należy wprowadzić w zakładce Środowisko produkcyjne.

1. Przycisk Podaj domyślne uzupełni pola:
   • Adres usług e-Doręczeń,
   • Adres usług BAE,
   • Adres serwera uwierzytelniającego,
2. Adres elektroniczny skrzynki - podajemy adres skrzynki e-Doręczeń,
3. Nazwa systemu - podajemy nazwę systemu ustawioną podczas dodawania systemu zewnętrznego do e-Doręczeń,
4. Klucz uwierzytelniający - wklejamy zawartość pliku z wygenerowanym wcześniej kluczem prywatnym .KEY (otwieramy notatnikiem).

Po uzupełnieniu danych zaznaczamy parametr Używaj środowiska produkcyjnego i zapisujemy wprowadzone parametry klikając na przycisk Zapisz'.

Dane nadawcy i potwierdzenia odbioru

Parametry: dane nadawcy oraz typy zdarzeń uznawane za potwierdzenie odbioru

Właściwości programu > Decyzje

Menu: Konfiguracja > Ustawienia > Właściwości programu

W zakładce Decyzje dostępny jest przycisk e-Doręczenia - parametry wiadomości.

e-Doręczenia - parametry wiadomości

Okno pozwala na ustawienie tytułu oraz treść wiadomości, które będą wykorzystywane przy wysyłce typu PUH i PURDE.

Decyzcja podatkowa na rok @ROK

Dzień dobry.
W załączniku przesyłamy decyzję podatkową na @ROK. 
Urząd Miasta Testowice

e-Doręczenia w aplikacji Podatki

Wymiar podatków -> Drukowanie decyzji

Drukowanie decyzji - e-Doręczenia

Edycja jednostek opodatkowania

robocze

• Po prawej stronie okna w kolumnie są ikony, ostatnia to e-Doręczenia gdzie zobaczymy decyzje wysłane przez e-Doręczenia i ich szczegóły.
• Z kolei w górnej części okna jest zielona ikonka ‘Rejestrowanie potwierdzeń odbioru’. W tym oknie jest przycisk ‘Status e-Doręczeń”.
• W górnym wierszu przycisk e-Doręczenia pozwalający na wysyłkę dowolnej wiadomości na skrzynkę e-Doręczeń.

Linki

Jak skutecznie wdrożyć e-Doręczenia? Przewodnik dla podmiotów publicznych

E-Doręczenia - informacje ogólne