Zmiany w definicji punktu ACD typu „Import dokumentów ze skrzynki e-Doręczenia”
W wersji 2024.2.0 wprowadzono następujące zmiany w zakładce [Automatyczne generowanie dokumentów] w ramach trybu współpracy „Import dokumentów ze skrzynki e-Doręczenia”, na zakładce „Ogólne”:
- Usunięto pole „Adres skrzynki”
- Usunięto pole „Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenia”;
- Usunięto pole „Klucz prywatny”.
Powyższe pola zostały przeniesione:
- w przypadku trybu jednofirmowego – na zakładkę [Ustawienia] na zakładkę „Integracje” (zob. Zmiana nazwy zakładki „KSeF” na „Integracje” (tryb jednofirmowy));
- w przypadku trybu wielofirmowego – na zakładkę [Ustawienia] na zakładkę „Połączenia z ERP” (zob. Zmiany na zakładce „Połączenia z ERP” (tryb wielofirmowy)).
Zmiana nazwy zakładki „KSeF” na „Integracje” (tryb jednofirmowy)
W wersji 2024.2.0 w trybie jednospółkowym Comarch DMS zmieniono nazwę zakładki „KSeF”, dostępnej w ramach zakładki [Ustawienia], na „Integracje”.
Nastąpiły również następujące zmiany w zawartości zakładki:
- Wprowadzono podział zakładki na dwie sekcje:
- Integracja z usługą KSeF
- Integracja z usługą e-Doręczenia
- Pola „NIP firmy” i „Token KSeF”, znajdujące się dotychczas na zakładce „KSeF”, umieszczono w sekcji „Integracja z usługą KSeF”. Aby zapisać zmiany, należy kliknąć w znajdujący się obok przycisk „Zapisz”;
- Pola „Adres skrzynki”, „Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenia” i „Klucz prywatny”, znajdujące się dotychczas na zakładce „Ogólne” w oknie konfiguracji punktu ACD typu „Import dokumentów ze skrzynki e-Doręczenia”, przeniesiono do sekcji „Integracja z usługą e-Doręczenia”. Aby zapisać zmiany, należy kliknąć w znajdujący się obok przycisk „Zapisz”.
Zmiany na zakładce „Połączenia z ERP” (tryb wielofirmowy)
W wersji 2024.2.0 na zakładce [Ustawienia] na zakładce „Połączenia z ERP” w trybie wielofirmowym dodano pola dotyczące integracji z usuługę e-Doręczenia, znajdujące się wcześniej na zakładce „Ogólne” na definicji punktu ACD typu „Import dokumentów ze skrzynki e-Doręczenia”, a mianowicie:
- „Adres skrzynki”;
- „Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenia”;
- „Klucz prywatny”.
Wysyłanie wiadomości do usługi e-Doręczenia
W wersji 2024.2.0 umożliwiono wysyłanie wiadomości do usługi e-Doręczenia. Wysyłanie odbywa się za pomocą kontrolki typu Własna akcja z zastosowaniem kodu C#.
W tym celu dodano metodę EdorService.CreateClient(), która zwraca nowy obiekt klienta, używany do komunikacji z usługą e-Doręczenia.
Została również dodana metoda eDorClient.SendMessage(), przyjmująca 4 argumenty:
- Obowiązkowe:
- adres odbiorcy wiadomości;
- temat wiadomości;
- Opcjonalny:
- Załączniki
Załącznik musi spełniać poniższe warunki:
- wielkość wiadomości nie może przekraczać 15 MB;
- rozszerzenie załącznika należy do następującej listy:
- txt, rtf, pdf, xps, odt, ods, odp, doc, xls, ppt, docx, xlsx, pptx, csv – pliki tekstowe, tekstowo graficzne, multimedialne
- jpg, jpeg, tif, tiff, geotiff, png, svg – graficzne
- wav, mp3, avi, mpg, mpeg, mp4, m4a, mpeg4, ogg, ogv – audio
- zip, tar, gz, gzip, 7z – archiwa
- 5html, xhtml, css – strony internetowe
- xml, xsd, gml, rng – definicje informacji i powiązań między nimi
- xsl, xslt – przetwarzanie xml
- TSL, XMLsig, XAdES, PAdES, CAdES, XMLenc – podpisy elektroniczne, weryfikacja podpisów, szyfrowanie
Aby wysłać wiadomość do usługi e-Doręczenia, należy kolejno:
- W ramach wybranego typu obiegu dodać następujące kontrolki:
- Kontrolka „Do:” (identyfikator: Do) – kontrolka typu tekst; pole obowiązkowe – adres odbiorcy wiadomości
- Kontrolka „Temat:” (identyfikator: Temat) – kontrolka typu tekst; pole obowiązkowe – temat wysyłanej wiadomości
- Kontrolka „Treść:” (identyfikator: Tresc) – kontrolka typu tekst; pole obowiązkowe – treść wiadomości;
- Kontrolka „Załączniki” (identyfikator: Zalaczniki) – kontrolka typu Załącznik; pole opcjonalne – lista załączanych plików.
- W ramach tego samego typu obiegu dodać kontrolkę typu Własna akcja „Wyślij wiadomość do usługi e-Doręczenia” (identyfikator: Wyslij);
- Podczas konfiguracji kontrolki typu Własna akcja kliknąć w przycisk [Ustaw] w ramach pola „C# Script”;
- W oknie „Skrypt C#” wprowadzić następujący kod:
var eDorClient = EDorService.CreateClient(); string messageId=null; eDorClient.SendMessage(Globals.MainFrame.Do.Text,Globals.MainFrame.Temat.Text, Globals.MainFrame.Tresc.Text, Globals.MainFrame.Zalaczniki.Items, ref messageId); Globals.MainFrame.Wyslij_CSSCRIPT.Text=messageId;
- Jeśli w dolnej części okna wyświetli się napis „Kompilacja skryptu zakończyła się sukcesem”, zamknąć okno, klikając przycisk [Zamknij];
- Zapisać zmiany za pomocą przycisku [Zapisz];
- Dodać nowy dokument i zapisać go za pomocą przycisku [Zapisz];
- Uzupełnić pola: „Do:”, „Temat:”, „Treść:” i „Załączniki”
- Kliknąć kontrolkę typu Własna akcja (w tym przypadku „Wyślij wiadomość do usługi e-Doręczenia
- Jeśli konfiguracja przebiegła pomyślnie, użytkownik został zalogowany do usługi, a wiadomość została wysłana do odbiorcy.
Pobieranie dokumentów potwierdzających wysłanie wiadomości poprzez usługę e-Doręczeni
Integralnym elementem dokumentów wysyłanych poprzez usługę e-Doręczenia, są potwierdzenia świadczące o wykonaniu usługi wysyłki i dostarczenia przesyłki pod wskazany adres. Dokumenty te wystawiane są automatycznie w usłudze e-Doręczenia i są dołączane do wiadomości. Aktualnie w Comarch DMS nie ma możliwości pobrania tych dokumentów, zatem należy je pobrać samodzielnie wprost z usługi e-Doręczenia.
- Po zalogowaniu się na konto biznesowe w serwisie biznes.gov.pl należy przejść do usługi e-Doręczenia:
- Następnie na liście skrzynek należy wybrać tę, z której wysyłane były wiadomości dla których będą pobierane potwierdzenia:
- Po wejściu do skrzynki, należy wyświetlić listę wiadomości wysłanych:
- Potwierdzenia mogą być pobierane wyłącznie pojedynczo dla każdego dokumentu. W ramach dokumentu można pobrać osobno potwierdzenie wysłania i potwierdzenie odbioru w formatach pdf lub xml:
- Możliwe jest też pobranie wszystkich potwierdzeń na raz używając opcji Pobierz, dostępnej na dole wyświetlonej wiadomości lub w menu kontekstowym na liście wiadomości wysłanych:
W pobranej paczce *.zip znajdą się wszystkie elementy dotyczące danej wiadomości, tj:
- Potwierdzenie wysłania w formie pliku pdf
- Potwierdzenie otrzymania w formie pliku pdf
- Dowody techniczne w formie plików xml
- Utworzony wydruk wiadomości wraz z treścią i listą załączników, w formie pliku pdf
- Załączniki dołączone do wiadomości
- Oraz treść wiadomości w formie pliku txt
- Plik archiwum lub pliki pojedynczych potwierdzeń można dołączyć do kontrolki załącznik na dokumencie DMS, z którego dana wiadomość została wysłana.