Integracja z e-Doręczeniami
Integracja z e-Doręczeniami pozwala pobierać pisma ze skrzynki e-Doręczeń bezpośrednio do Navigatora i wysyłać z niego pisma wychodzące, także w trybie hybrydowym, w którym operator drukuje pismo i doręcza je papierowo. Navigator pobiera też statusy wysyłki, dowody doręczenia w PDF i wyszukuje adresy do e-Doręczeń w Bazie Adresów Elektronicznych (BAE). Wszystko to robią akcje systemowe w krokach procedur obiegu (patrz Akcje systemowe).
Zanim zaczniesz¶
Navigator komunikuje się z e-Doręczeniami poprzez serwis pośredniczący dostarczany przez firmę Archman. Adres do e-Doręczeń, certyfikat, serwis i ustawienia Navigatora opisuje artykuł Przygotowanie systemu pod e-Doręczenia. Od tej konfiguracji zależy działanie akcji:
- Adres skrzynki firmy: akcje wybierają skrzynkę na podstawie pola Adres e-doręczeń kontrahenta przypisanego do firmy. Jeżeli pole jest puste, akcja kończy się błędem.
- Konfiguracja skrzynki w serwisie: serwis musi mieć konfigurację dla tego samego adresu skrzynki i zainstalowany certyfikat z kluczem prywatnym.
- Atrybuty na formularzach: pisma przychodzące i wychodzące potrzebują atrybutów na dane z e-Doręczeń, które akcje odczytują lub uzupełniają.
Przegląd akcji¶
| Akcja | Do czego służy |
|---|---|
| Pobierz wiadomości | Tworzy dokumenty z pism w skrzynce |
| Odczytaj wiadomość | Oznacza pismo jako odczytane i pobiera jego treść oraz załączniki |
| Wyślij wiadomość | Wysyła pismo na adres do e-Doręczeń odbiorcy |
| Wyślij wiadomość hybrydowo | Wysyła pismo do adresata bez skrzynki. Operator drukuje je i doręcza papierowo |
| Pobierz status | Zapisuje status wysłanego pisma |
| Pobierz potwierdzenie | Dołącza do dokumentu dowód wysłania lub odebrania w PDF |
| Szukaj adresu e-doręczeń | Wyszukuje w BAE adres firmy, urzędu lub organizacji |
| Szukaj adresu e-doręczeń osoby fizycznej | Wyszukuje w BAE adres osoby po numerze PESEL |
| Szukaj adresu e-doręczeń osoby fizycznej po adresie | Wyszukuje w BAE adres osoby po adresie zamieszkania |
Parametr Użytkownik występuje w każdej akcji. Wskazuje osobę, która zostanie zapisana jako autor zmian. Jeżeli parametr jest pusty, zmiany zostaną zapisane jako zmiany użytkownika o ID 1 (administratora systemu).
Akcje z sekcją Pola zapisują dane z e-Doręczeń w atrybutach formularza. W każdym wierszu wybierasz Pole e-doręczeń i Atrybut, do którego trafi jego wartość.
Pobierz wiadomości¶
Akcja pobiera pisma ze skrzynki firmy i dla każdego tworzy nowy dokument. Załączniki pisma trafiają do załączników dokumentu. Pisma, z których utworzono już dokument, są pomijane, dlatego akcję można bezpiecznie uruchamiać wielokrotnie. Zwykle ustawia się ją w procedurze uruchamianej według harmonogramu i w pozycji menu do ręcznego pobierania.
Pobieranie odbywa się w tle. Dla jednej skrzynki może trwać tylko jedno pobieranie naraz. Kolejne uruchomienie w tym czasie kończy się komunikatem „Pobieranie wiadomości z e-Doręczeń w trakcie.”
| Parametr | Opis |
|---|---|
| Firma | Firma, ze skrzynki której pobierasz pisma. Ta firma zostanie też przypisana do tworzonych dokumentów. |
| Typ | Typ tworzonych dokumentów. |
| Kategoria | Kategoria tworzonych dokumentów. |
| Użytkownik | Autor tworzonych dokumentów. |
| Odczytać wiadomość | Tak lub Nie. Pobranie z wartością Tak oznacza pismo w e-Doręczeniach jako odczytane, co ma skutek prawny doręczenia. Przy wartości Nie pismo pozostaje nieodczytane, a odczyt wykonuje później akcja Odczytaj wiadomość. Pusty parametr działa jak Tak. |
| Uzupełnij kontrahenta | Tak lub Nie. Przy wartości Tak akcja szuka kontrahenta po adresie do e-Doręczeń nadawcy, a jeżeli go nie znajdzie, po NIP-ie nadawcy odczytanym z BAE. Znaleziony kontrahent zostaje przypisany do dokumentu. |
| Tryb pobierania | Tryb przyrostowy pobiera tylko pisma, które wpłynęły od ostatniej synchronizacji. Tryb zakresu dat pobiera pisma z okresu podanego w parametrach Data od i Data do. |
| Data od, Data do | Zakres dat w trybie zakresu dat, w czasie UTC. W trybie przyrostowym Data od określa początek pobierania przy pierwszej synchronizacji. |
| Pola | Dane pisma zapisywane w atrybutach: Adres nadawcy, Nazwa nadawcy, Temat, Treść, ID wiadomości, Data nadania, Data doręczenia, ID wątku, Znak sprawy. ID wiadomości warto zapisywać zawsze, bo korzystają z niego akcje Odczytaj wiadomość i Pobierz potwierdzenie. |
Odczytaj wiadomość¶
Akcja oznacza pismo w e-Doręczeniach jako odczytane i uzupełnia dokument danymi pisma: treścią, załącznikami i atrybutami wskazanymi w sekcji Pola. Uruchamia się ją na dokumencie utworzonym akcją Pobierz wiadomości z parametrem Odczytać wiadomość ustawionym na Nie. Ponowne uruchomienie dla odczytanego już pisma nie zmienia dokumentu.
| Parametr | Opis |
|---|---|
| ID wiadomości | Identyfikator pisma w e-Doręczeniach, zapisany przy pobieraniu. |
| Dokument | Dokument do uzupełnienia, zwykle pole systemowe Id dokumentu. Skrzynka jest wybierana na podstawie firmy dokumentu. |
| Użytkownik | Autor zmian. |
| Uzupełnij kontrahenta | Działa jak w akcji Pobierz wiadomości, ale tylko wtedy, gdy dokument nie ma jeszcze przypisanego kontrahenta. |
| Pola | Jak w akcji Pobierz wiadomości. |
Wyślij wiadomość¶
Akcja wysyła pismo ze skrzynki firmy dokumentu na adresy do e-Doręczeń odbiorców. Zwraca identyfikator zadania wysłania, który zapisujesz na formularzu. Na jego podstawie akcja Pobierz status pobiera później status.
| Parametr | Opis |
|---|---|
| Dokument | Dokument pisma, zwykle pole systemowe Id dokumentu. |
| Do | Jeden lub więcej odbiorców. Możesz podać adres do e-Doręczeń albo kontrahenta. Wtedy akcja użyje adresu z jego pola Adres e-doręczeń. |
| Temat | Temat wiadomości. |
| Treść | Treść wiadomości. |
| Załączniki | Pliki do wysłania. Zwykle atrybut z załącznikami pisma. |
| Znak sprawy | Sygnatura sprawy, której dotyczy pismo. |
| Wątek | ID wątku, jeżeli pismo jest odpowiedzią w istniejącej korespondencji. |
| Użytkownik | Autor zmian. |
| Zapisz identyfikator zadania wysłania w | Atrybut, w którym zostanie zapisany identyfikator zwrócony przez e-Doręczenia. |
Wyślij wiadomość hybrydowo¶
Akcja wysyła pismo do adresata, który nie ma adresu do e-Doręczeń. Operator wyznaczony drukuje pismo i doręcza je w formie papierowej. Więcej o usłudze: Publiczna usługa hybrydowa w e-Doręczeniach.
Jako nadawca wskazywany jest kontrahent firmy dokumentu, dlatego musi mieć nazwę i domyślny adres z uzupełnionym krajem, ulicą, kodem pocztowym i miejscowością. Te same dane są wymagane w adresach odbiorców. Odbiorca musi mieć nazwę albo imię i nazwisko.
| Parametr | Opis |
|---|---|
| Dokument | ID dokumentu pisma. |
| Do | Adresy odbiorców, czyli adresy z formularza kontrahenta (nie adresy do e-Doręczeń). |
| Temat | Temat wiadomości. |
| Załączniki | Pliki do wysłania i wydrukowania. |
| Użytkownik | Autor zmian. |
| Znak sprawy | Sygnatura sprawy, której dotyczy pismo. |
| Informacja o treści przesyłki | Krótki opis zawartości przesyłki. |
| Zapisz identyfikator zadania wysłania w | Atrybut, w którym zostanie zapisany identyfikator zwrócony przez e-Doręczenia. |
Pozostałe parametry określają sposób wysyłki i wydruku. Każdy przyjmuje jedną z wartości podanych w tabeli:
| Parametr | Dopuszczalne wartości |
|---|---|
| Tryb przesyłki | Economic (ekonomiczna), Priority (priorytetowa) |
| Rodzaj pisma | General (pismo ogólne), Administrative (pismo w postępowaniu administracyjnym), Tax (korespondencja z urzędem skarbowym), Court_civil (pismo sądowe w postępowaniu cywilnym), Court_criminal (pismo sądowe w postępowaniu karnym) |
| Rodzaj przesyłki | Registered (rejestrowana), NotRegistered (nierejestrowana) |
| Obsługa zwrotu przesyłki | ReturnToSender (zwrot do nadawcy), Destroy (zniszczenie) |
| Kolor wydruku | Monochrome (czarno-biały), Color (kolorowy) |
| Typ zadruku | Simplex (jednostronny), Duplex (dwustronny) |
| Dodatkowy nadruk na kopercie w polu nadawcy | Dowolny tekst drukowany na kopercie |
Na formularzu najwygodniej przygotować te atrybuty jako listy rozwijane, których kluczem jest wartość z tabeli, a wyświetlaną nazwą jej polski opis. Przykładowe zapytanie SQL dla listy wartości:
SELECT 'Registered' AS ID, 'Rejestrowana' AS Value
UNION ALL
SELECT 'NotRegistered' AS ID, 'Nierejestrowana' AS Value
Pobierz status¶
Akcja pobiera status wysyłki na podstawie identyfikatora zadania zapisanego przez akcję Wyślij wiadomość lub Wyślij wiadomość hybrydowo. Pismo wysłane do kilku odbiorców ma osobny status dla każdego z nich, dlatego atrybuty w sekcji Pola muszą być kolumnami jednej tabeli. Każdy odbiorca to osobny wiersz, a przy kolejnym uruchomieniu akcja aktualizuje wiersz o tym samym ID wiadomości.
| Parametr | Opis |
|---|---|
| ID zadania | Identyfikator zadania wysłania wiadomości. |
| Dokument | ID dokumentu pisma. |
| Użytkownik | Autor zmian. |
| Pola | Kolumny tabeli: ID wiadomości, Temat, Adres odbiorcy, Status. |
Pobierz potwierdzenie¶
Akcja pobiera dowód wysłania lub odebrania pisma i dodaje go do załączników dokumentu jako plik PDF (Potwierdzenie_wysłania.pdf lub Potwierdzenie_odebrania.pdf).
Pobranie potwierdzenia dla pisma przychodzącego oznacza je w e-Doręczeniach jako odczytane, także jeśli nie uruchomiono wcześniej akcji Odczytaj wiadomość.
| Parametr | Opis |
|---|---|
| ID wiadomości | Identyfikator pisma w e-Doręczeniach. |
| Typ | Rodzaj potwierdzenia: wysłania (dla pism wychodzących) lub odebrania (dla pism przychodzących). |
| Dokument | Dokument, do którego akcja doda potwierdzenie. |
| Użytkownik | Autor zmian. |
Szukaj adresu e-doręczeń¶
Akcja wyszukuje w BAE adres do e-Doręczeń firmy, urzędu lub organizacji na podstawie NIP-u (lub numeru PESEL) zapisanego na formularzu kontrahenta. Zwykle uruchamia się ją z formularza kontrahenta i zapisuje wynik w polu Adres e-doręczeń.
| Parametr | Opis |
|---|---|
| Firma | Firma, której skrzynka wykonuje wyszukiwanie. |
| Kontrahent | ID kontrahenta. Na formularzu kontrahenta pole systemowe Id dokumentu, a na dokumencie kontrolka kontrahenta. |
| Użytkownik | Autor zmian. |
| Zapisz znaleziony adres w | Atrybut, w którym zostanie zapisany znaleziony adres. |
Szukaj adresu e-doręczeń osoby fizycznej¶
Akcja wyszukuje adres do e-Doręczeń osoby prywatnej po numerze PESEL.
| Parametr | Opis |
|---|---|
| Firma | Firma, której skrzynka wykonuje wyszukiwanie. |
| PESEL, Imię, Nazwisko | Dane szukanej osoby. |
| Użytkownik | Autor zmian. |
| Zapisz znaleziony adres w | Atrybut, w którym zostanie zapisany znaleziony adres. |
Szukaj adresu e-doręczeń osoby fizycznej po adresie¶
Akcja wyszukuje adres do e-Doręczeń osoby prywatnej, gdy nie znasz jej numeru PESEL. Najpierw szuka po imieniu, nazwisku, miejscowości i numerze budynku. Jeżeli wynik nie jest jednoznaczny, zawęża wyszukiwanie o numer lokalu, ulicę i kod pocztowy.
| Parametr | Opis |
|---|---|
| Firma | Firma, której skrzynka wykonuje wyszukiwanie. |
| Imię, Nazwisko | Dane szukanej osoby. |
| Adres | Adres zamieszkania z formularza kontrahenta. |
| Użytkownik | Autor zmian. |
| Zapisz znaleziony adres w | Atrybut, w którym zostanie zapisany znaleziony adres. |