Po włączeniu wielofirmowego trybu pracy w Comarch DMS poprzez zmianę wartości klucza „MultiCompany=true” w pliku konfiguracyjnym Web.config, zakładka „Autoryzacja API” zostaje zastąpiona zakładką „Połączenia z ERP”, na której definiowane są spółki.

W ramach zakładki dostępne są następujące przyciski:

[Dodaj] – opcja dodania nowej spółki

[Zapisz] – opcja zapisu danych

[Usuń] – opcja umożliwiająca usunięcie zdefiniowanej spółki (po uprzednim kliknięciu na nią)

[ChatERP] – przycisk dodany w wersji 2024.3.0; otwiera okno ChatERP (zob. Korzystanie z ChatERP w aplikacji desktop Comarch DMS).

Widoczna jest również lista dodanych spółek. Po kliknięciu na nazwę danej spółki na liście informacje o tej spółce są pokazywane na prawym panelu.

Definiowanie nowej spółki

Nową spółkę operator dodaje po przyciśnięciu ikony. Na prawym panelu pojawia się lista pól do wypełnienia danymi nowej spółki.

– wybór trybu pracy spółki (Comarch ERP XL, Optima, Altum, Enterprise, Standalone)

– definicja nazwy spółki

– skrót nazwy spółki (max 5 znaków)

– definicja połączenia do bazy systemu Comarch ERP XL. Po przyciśnięciu linku „zmień” pojawia się formatka połączenia.

– pole, w którym operator wprowadza nazwę klucza licencyjnego

– nazwa zmapowanej bazy Comarch ERP XL (nazwa firmy)

– lista wyboru domyślnego centrum ze struktury podległościowej z systemu Comarch ERP XL. Lista jest automatycznie inicjowana po zdefiniowaniu poprawnego połączenia z bazą w polu „Połączenie”.

– login operatora Comarch ERP XL wykorzystywany przez operatorów natywnych Comarch DMS do wykonywania operacji typu: podniesienie formatek listy dokumentów, listy kontrahentów, generowanie dokumentu z kontrolki Dokument ERP XL.

– hasło operatora Comarch ERP XL

– po zaznaczeniu tego checkboxa możliwe jest logowanie operatora  przez domenę (zob. Domena)

– w tym polu możliwy jest wybór właściwej domeny z listy po zaznaczeniu parametru „Używaj domeny”

– w ramach tego pola możliwy jest wybór z listy określonej grupy z danej domeny

– pole dodane w wersji 2024.0.0; w ramach tego pola należy wprowadzić NIP firmy, dla której ma odbywać się współpraca z KSeF;

– pole dodane w wersji 2024.0.0; w ramach tego pola należy wprowadzić token uwierzytelniający w KSeF

Istnieje możliwość wygenerowania tokenu KSeF z poziomu Comarch DMS. W tym celu należy kliknąć w link [Wygeneruj token] znajdujący się obok pola „Token KSeF”, a następnie w oknie „Wybierz certyfikat” wybrać odpowiedni certyfikat uwierzytelniający. Po wyborze certyfikatu zostanie wygenerowany token KSeF, który zostanie automatycznie wprowadzony w ramach pola „Token KSeF”.

Aby wygenerować token uwierzytelniający, należy najpierw uzupełnić pole „NIP Firmy”. Jeżeli użytkownik nie uzupełni pola „NIP Firmy” i naciśnie link [Wygeneruj token], wówczas zostanie wyświetlony następujący komunikat:

 – pole przeniesione do zakładki w wersji 2024.2.0; adres skrzynki e-Doręczeń, pochodzący bezpośrednio ze skrzynki;

– pole przeniesione do zakładki w wersji 2024.2.0; nazwa systemu Comarch DMS integrowanego z usługa e-Doręczenia, którą dodano podczas konfiguracji skrzynki e-Doręczenia w ramach pola „Systemy”.

– pole (przeniesione do zakładki w wersji 2024.2.0), w którym należy dodać klucz prywatny, który jest pozyskiwany w procesie generowania certyfikatu – dostarczony razem z certyfikatem. Aby dodać klucz prywatny, należy kliknąć w przycisk , dostępny w ramach pola, a następnie w ramach otwartego okna systemowego wybrać odpowiedni klucz PEM i kliknąć w przycisk [Otwórz]. Klucz prywatny, który dodano do definicji punktu ACD, może zostać usunięty z punktu za pomocą ikony lub zapisany na dysku za pomocą ikony .

W dolnej części ekranu w osobnej sekcji definiowane są ustawienia konfiguracyjne wspólne dla wszystkich spółek. Oznacza to, że wszystkie bazy systemu Comarch ERP XL powinny pracować na tej samej wersji API.

Ustawienie wartości „Tak” dla właściwości „Generowanie dokumentów z opisem analitycznym” umożliwia pracę z kontrolką typu Dokument ERP XL w każdej ze spółek.

– lista wyboru wersji API (aktualnie w wersji Comarch DMS 2024.2.1 można wybrać jedną z następujących wersji API: 20232, 20240, 20241)

– lista, w której określany jest tryb pracy aplikacji w zakresie kontrolki typu Dokument ERP XL

Wprowadzone dane należy zapisać, używając przycisku dyskietki [Zapisz].

W wersji 2024.0.0 dodano zakładkę „KSeF”. W wersji 2024.2.0 nazwa zakładki została zmieniona na „Integracje”.

Zakładka „Integracje” jest dostępna jedynie w trybie jednospółkowym i służy do wprowadzenia danych potrzebnych do uwierzytelnienia w KSeF oraz (od wersji 2024.2.0) danych wymaganych do pobierania i wysyłania wiadomości w ramach integracji z usługą e-Doręczenia.

Od wersji 2024.2.0 zakładka dzieli się na dwie sekcje:

Integracja z usługą KSeF

W ramach zakładki dostępne są dwa pola:

Istnieje możliwość wygenerowania tokenu KSeF z poziomu Comarch DMS. W tym celu należy kliknąć w link [Wygeneruj token] znajdujący się obok pola „Token KSeF”, a następnie w oknie „Wybierz certyfikat” wybrać odpowiedni certyfikat uwierzytelniający.

Po wyborze certyfikatu zostanie wygenerowany token KSeF, który zostanie automatycznie wprowadzony w ramach pola „Token KSeF”.

Wprowadzone zmiany należy zapisać za pomocą przycisku  [Zapisz], dostępnego w ramach sekcji.

Aby wygenerować token uwierzytelniający, należy najpierw uzupełnić pole „NIP Firmy”.

Jeżeli użytkownik nie uzupełni pola „NIP Firmy” i naciśnie link [Wygeneruj token], wówczas zostanie wyświetlony następujący komunikat.

Integracja z usługą e-Doręczenia

W ramach zakładki dostępne są trzy pola:

• Adres skrzynki – adres skrzynki e-Doręczeń, pochodzący bezpośrednio ze skrzynki;

 

 

• Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenia – nazwa systemu Comarch DMS integrowanego z usługa e-Doręczenia, którą dodano podczas konfiguracji skrzynki e-Doręczenia w ramach pola „Systemy”.

 

Wskazówka

Instrukcja dodania zewnętrznego systemu w usłudze e-Doręczenia jest dostępna pod adresem:

https://www.gov.pl/attachment/07a8c8c5-b329-44cf-9e08-ed7c497f6d1c

 

 

• Klucz prywatny – pole, w którym należy dodać klucz prywatny, który jest pozyskiwany w procesie generowania certyfikatu – dostarczony razem z certyfikatem. Aby dodać klucz prywatny, należy kliknąć w przycisk , dostępny w ramach pola, a następnie w ramach otwartego okna systemowego wybrać odpowiedni klucz PEM i kliknąć w przycisk [Otwórz]. Klucz prywatny, który dodano do definicji punktu ACD, może zostać usunięty z punktu za pomocą ikony lub zapisany na dysku za pomocą ikony .

Wprowadzone zmiany należy zapisać za pomocą przycisku  [Zapisz], dostępnego w ramach sekcji.

W wersji 2024.1.0 wprowadzono integrację Comarch DMS z usługą e-Doręczenia.

W pierwszym etapie integracji Comarch DMS z systemem e-Doręczenia został zrealizowany mechanizm autoryzacji oraz pobierania wiadomości z systemu e-Doręczenia za pomocą dedykowanego punktu ACD

W wersji 2024.1.0 w ramach zakładki [Automatyczne generowanie dokumentów] dodano nowy typ punktu ACD „Import dokumentów ze skrzynki e-Doręczenia”, który ma na celu umożliwienie pobierania wiadomości z usługi e-Doręczenia.

Zakładka „Tryb współpracy”

Aby utworzyć punkt konfiguracyjny typu „Import dokumentów ze skrzynki e-Doręczenia” należy w oknie „Automatyczne generowanie dokumentów” dodać nowy punkt konfiguracyjny za pomocą ikony , a następnie na liście trybów pracy punktu wybrać opcję „Import dokumentów ze skrzynki e-Doręczenia” .

Zakładka „Ogólne”

W ramach zakładki „Ogólne” znajdują się następujące pola:

Zakładka Kontrolki

Na zakładce „Kontrolki” za pomocą zapytań SQL należy wskazać wartości, które będą wyświetlane w poszczególnych kontrolkach danego typu obiegu po przeprocesowaniu dokumentu.

Załączniki przesłane w wiadomości zostaną dodane do wskazanej kontrolki typu Załącznik.

Zakładka Uprawnienia

Na zakładce definiowane są uprawnienia do pracy z punktem konfiguracyjnym. Uprawnienia mogą być dodawane poprzez wskazanie pracowników, nie ma możliwości dodania uprawnień dla pracowników wskazanego działu czy pracowników zajmujących określone stanowisko.

Na każdej zakładce znajduje się ikona [Eksport], która umożliwia eksportowanie danego punktu ACD do zapisu na dysk.

Aby rozpocząć pracę z punktem ACD typu „Import dokumentów ze skrzynki e-Doręczenia”, należy kliknąć w ikonę [Pobierz wiadomości]. Zostanie wówczas otwarte okno „Import wiadomości z usługi e-Doręczenia”, w którym należy nacisnąć przycisk [Importuj].

Na liście wiadomości w ramach okna Import wiadomości z usługi e-Doręczenia dostępne są następujące kolumny:

W górnej części okna znajduje się parametr [Pokaż wiadomości zapisane w DMS] – jeśli ten parametr jest zaznaczony, wówczas wyświetlane są również wiadomości, które zostały już zarejestrowane w Comarch DMS – takie dokumenty są wyszarzone na liście wiadomości widocznej w oknie.

Po załadowaniu się listy wiadomości należy zaznaczyć wybrane pozycje i kliknąć przycisk [Zapisz], aby okno Import wiadomości z usługi e-Doręczenia zostało zamknięte, a lista wiadomości została wyświetlona w Comarch DMS.

Jeżeli użytkownik wybierze przycisk [Anuluj], wówczas okno Import wiadomości z usługi e-Doręczenia zostanie zamknięte, a wiadomości nie zostaną zarejestrowane w Comarch DMS.

Uwaga

Jeśli użytkownik kliknie w przycisk [Importuj] i pobierze dokumenty z usługi e-Doręczenia do okna „Import wiadomości z usługi e-Doręczenia”, a następnie naciśnie przycisk [Anuluj], wówczas dokumenty nie zostaną wyświetlone w pracującym punkcie ACD, jednak usługa e-Doręczenia wygeneruje potwierdzenia doręczenia wiadomości do adresata.

Po kliknięciu w przycisk [Zapisz] w prawej części okna punktu ACD zostaje wyświetlona lista wiadomości, które zostały pobrane ze skrzynki e-Doręczenia. Lista składa się z trzech kolumn:

Obok wiadomości z załącznikami widoczna jest ikona .

Po kliknięciu prawym przyciskiem myszki na daną wiadomość zostaje wyświetlone menu kontekstowe z następującymi opcjami:

• Usuń z listy – po wyborze tej opcji wiadomość zostaje usunięta z listy wiadomości

Uwaga

Jeśli użytkownik usunie wiadomość z listy za pomocą opcji „Usuń z listy”, wówczas dokument nie będzie już wyświetlany w pracującym punkcie ACD, jednak wiadomość zostaje oznaczona jako zapisana w DMS i nie można jej pobrać ponownie.

• Pobierz dowody techniczne – jeśli operator wybierze tę opcję, wówczas zostanie otwarte okno systemowe, w ramach którego należy wybrać lokalizację, w której zostaną zapisane dowody techniczne w formacie pliku zip

 

 

 

 

• Zapisz załączniki jako – jeśli operator wybierze tę opcję, wówczas zostanie otwarte okno systemowe, w ramach którego należy wybrać lokalizację, w której zostaną zapisane załączniki dołączone do danej wiadomości
  

Wiadomości, które zostały pobrane w punkcie ACD, są oznaczone identyfikatorem punktu ACD i identyfikatorem użytkownika. Domyślnie wyświetlana lista wiadomości w ramach punktu to wszystkie wiadomości, które zostały pobrane z e-doręczeń przez zalogowanego użytkownika i z których nie wygenerował dokumentów do obiegu Comarch DMS.

Nad listą wiadomości znajduje się informacja „Liczba wiadomości”, obok której widoczna jest liczba wiadomości wyświetlanych na liście dla danego operatora.

Poniżej dostępny jest filtr [Pokaż wiadomości doręczone w ostatnich X dniach] – w ramach tego filtra można zawęzić listę wiadomości do takich wiadomości, których data doręczenia jest w wybranym zakresie dat.

Pod filtrem [Pokaż wiadomości doręczone w ostatnich X dniach] znajduje się parametr [Pokaż wszystkie wiadomości pobrane w punkcie], którego zaznaczenie umożliwia wyświetlenie wszystkich wiadomości, które pobrali w danym punkcie ACD wszyscy uprawnieni użytkownicy. Domyślnie parametr jest odznaczony – w takim przypadku dla zalogowanego operatora na liście wyświetlane są jedynie takie wiadomości, które ten operator pobrał z usługi e-doręczeń.

Poniżej dostępny jest filtr [Zaznacz wszystko] – jeżeli operator zaznaczy ten parametr, wówczas wszystkie wiadomości na liście zostaną zaznaczone.

Po zaznaczeniu wiadomości z listy w lewej części punktu ACD wyświetlane są dane dotyczące tej wiadomości. W górnej części okna widoczny jest podgląd załącznika graficznego – pierwszego z listy załączników, która jest wyświetlana obok podglądu.

W dolnej części okna znajdują się kontrolki, które wybrano w ramach zakładki „Kontrolki” podczas konfiguracji punktu ACD wraz z wartościami, które zostały określone za pomocą zapytań SQL.

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:

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;

 

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

 

 

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

 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ść.";
}

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:

 

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