Przejdź do treści

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.