Wysyłanie wiadomości do usługi e-Doręczenia

image_pdfimage_print
Uwaga

W przypadku korzystania ze środowiska testowego dla usługi e-Doręczenia w pliku web.config w folderze z aplikacją serwerową należy zmodyfikować wartości kluczy, które dotyczą e-Doręczeń, jak na poniższej ilustracji:

 

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

 

Uwaga

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”;

 

Wybór opcji „Ustaw” w ramach pola „C# Script” na definicji kontrolki typu Własna akcja

 

  • 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;

 

  • Nacisnąć przycisk [Kompiluj i zapisz]

 

Uwaga
Należy pamiętać o tym, aby przed kompilacją skryptów C# na komputerze z IIS nadać użytkownikowi IIS_IUSRS prawo zapisu do katalogu .scriptcs_cache (lokalizacja: C:\inetpub\wwwroot\folder_aplikacji_serwerowej\bin)

 

  • Jeśli w dolnej części okna wyświetli się napis „Kompilacja skryptu zakończyła się sukcesem”, zamknąć okno, klikając przycisk [Zamknij];

 

Okno „Skrypt C#” po skompilowaniu kodu C#

 

  • 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.

 

Wskazówka

Warto dodać również kontrolkę typu Komunikat, która będzie obserwować kontrolkę „Do:” i wyświetli ostrzeżenie, jeśli operator omyłkowo wprowadzi spację przed albo po adresie, na który chce wysłać wiadomość – pozwoli to uniknąć problemu z poprawną wysylką wiadomości.

Aby dodać taką kontrolkę, należy kolejno:

  • dodać kontrolkę typu Komunikat
  • wprowadzić tekst w polu tytuł, np. Uwaga!
  • w ramach pola „Kontrolki powiązane” dodać kontrolkę „Do: (Do)”
  • w ramach pola „Wzór na wartość” wybrać opcję „C# Script” i wprowadzić następujący kod:
 if (Globals.MainFrame.Do.Text.StartsWith(" ")) 

{ 
Globals.MainFrame.Message1.Title = "Uwaga";
Globals.MainFrame.Message1.Message = "Przed adresem wysyłki wprowadzonym w kontrolce 'Do:' znajduje się spacja. Usuń ją, aby poprawnie przesłać wiadomość.";
} 

if (Globals.MainFrame.Do.Text.EndsWith(" ")) 

{ 
Globals.MainFrame.Message1.Title = "Uwaga";
Globals.MainFrame.Message1.Message = "Po adresie wysyłki wprowadzonym w kontrolce 'Do:' znajduje się spacja. Usuń ją, aby poprawnie przesłać wiadomość.";
}
  • Nacisnąć przycisk [Kompiluj i zapisz]
  • 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 w definicji obiegu za pomocą ikony zapisz32  [Zapisz]

 

Wówczas:

  • Jeśli na dokumencie w ramach typu obiegu służącego do wysyłki wiadomości do E-Doręczeń w kontrolce „Do: ” zostanie wprowadzony adres poprzedzony spacją, zostanie wyświetlony komunikat: „Przed adresem wysyłki wprowadzonym w kontrolce 'Do:’ znajduje się spacja. Usuń ją, aby poprawnie przesłać wiadomość.”
Film
Wyświetlanie komunikatu o spacji przed  adresem wprowadzonym w polu „Do:”

  • Jeśli na dokumencie w ramach typu obiegu służącego do wysyłki wiadomości do E-Doręczeń w kontrolce „Do: ” zostanie wprowadzony adres, po którym występuje spacja, zostanie wyświetlony komunikat: „Po adresie wysyłki wprowadzonym w kontrolce 'Do:’ znajduje się spacja. Usuń ją, aby poprawnie przesłać wiadomość.”
Film
Wyświetlanie komunikatu o spacji po adresie wprowadzonym w polu „Do:”

 

 

Pobieranie dokumentów potwierdzających wysłanie wiadomości poprzez usługę e-Doręczenia

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:

 

Konto przedsiębiorcy w serwisie biznes.gov.pl
  • 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:
Lista skrzynek przedsiębiorcy w serwisie biznes.gov.pl
  • Po wejściu do skrzynki, należy wyświetlić listę wiadomości wysłanych:
Lista wiadomości wysłanych w skrzynce przedsiębiorcy w serwisie biznes.gov.pl

 

  •  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:
Podgląd wiadomości w skrzynce przedsiębiorcy w serwisie biznes.gov.pl – dowody wysłanej wiadomości – pobieranie pojedynczo
  • 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:
Podgląd wiadomości w skrzynce przedsiębiorcy w serwisie biznes.gov.pl – pobieranie paczki plików dotyczących wiadomości

 

Opcja pobierania paczki plików dla wysłanej wiadomości

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.

Czy ten artykuł był pomocny?

Wyślij opnie