Połączenia z ERP

Po włączeniu wielofirmowego trybu pracy w Comarch BPM (dawniej 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ą)

[przed wersją 2026.0.0 ] [ChatERP] – przycisk dodany w wersji 2024.3.0; otwiera okno ChatERP ; od wersji 2026.0.0 widoczny w przypadku, jeśli operator ma uprawnienia do pracy z ChatERP (zob. Integracja z Chat ERP).

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

Operator dodaje nową spółkę, klikając ikonę . Prawy panel pokazuje listę pól, które należy wypełnić danymi nowej spółki.

[System ERP]  – wskazanie typu spółki, która ma zostać dodana, oprócz Standalone możliwe jest stworzenie spółek Comarch ERP Altum, Comarch ERP XL, Comarch ERP Optima i Comarch ERP Enterprise.

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

  [Nazwa spółki (baza)] – w polu należy wprowadzić pełną nazwę dodawanej spółki zgodnie z jej nazwą w bazie.

[Nazwa wyświetlana]  – pole dodane w wersji 2023.0.0, dostępne tylko w przypadku, jeśli w polu „System ERP” wybrano opcję „Optima”. Pole pozwala na ukrycie nazwy spółek Comarch DMS Optima w oknie logowania do Comarch DMS. Jeśli:

Jeśli pole „Nazwa wyświetlana” zostało uzupełnione, wówczas wprowadzona nazwa jest wyświetlana na liście spółek dostępnych w oknie logowania Comarch DMS, ta nazwa jest także wyszukiwana w trybie wyszukiwania nazw spółek w oknie logowania.

Jeśli pole „Nazwa wyświetlana” nie zostało uzupełnione, wówczas na liście spółek widoczna jest nazwa, którą wpisano w polu „Nazwa spółki (baza)”, według niej także odbywa się wyszukiwanie w trybie wyszukiwania nazw spółek w oknie logowania.

[Spółka (skrót)] – skrót nazwy spółki (maksymalnie 5 znaków)

[Baza firmowa]  – definicja połączenia do firmowej bazy Comarch ERP Optima. Połączenie jest automatycznie konfigurowane po wskazaniu nazwy spółki.

[Klucz licencyjny]   – nazwa serwera klucza licencji, od wersji 2026.0.1 pole zostało usunięte i nie jest wykorzystywane

[Domyślny login operatora ERP] – login operatora Comarch ERP Optima wykorzystywany przez operatorów natywnych Comarch DMS do wykonywania operacji typu: podniesienie formatek listy dokumentów, listy kontrahentów oraz towarów.

[Hasło operatora ERP] – hasło operatora Comarch ERP Optima

[Używaj domeny] – po zaznaczeniu tego checkboxa możliwe jest logowanie operatora  przez domenę (zob. Domena)

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

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

[NIP firmy] – 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; od wersji 2026.0.0 uzupełnienie pola jest konieczne do współpracy z ChatERP (zob. Integracja z Chat ERP)

[Token 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”.

W wersji 2026.0.1 zachowano możliwość ustawienia tokenu KSeF – zarówno poprzez wklejenie tokenu, jaki przez jego generowanie – analogicznie jak w dotychczasowych wersjach.

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:

Od wersji 2026.0.1 w ramach Comarch BPM umożliwiono uwierzytelnianie za pomocą certyfikatu KSeF otrzymanego poprzez MCU – z tego powodu wprowadzono następujące nowe pola:

[Klucz prywatny certyfikatu KSeF] – w ramach tego pola po kliknięciu w przycisk [Dodaj] można dodać z dysku plik o rozszerzeniu .key – klucz, który uzyskano podczas wnioskowania o certyfikat KSeF. Dodany plik zostanie wyświetlony zgodnie ze swoją nazwą. Operator może go zapisać na dysku, klikając w ikonę [Zapisz] lub usunąć z aplikacji Comarch BPM, klikając w przycisk kosza [Usuń]. Dane klucza prywatnego są zaszyfrowane i przechowywane w bazie danych Comarch BPM;

[Odcisk certyfikatu KSeF] – w tym polu operator może wybrać certyfikat KSeF, z którym jest powiązany klucz prywatny, który wybrano w polu „Klucz prywatny certyfikatu KSeF“. W tym celu nalezy kliknąc w link [Wybierz certyfikat], a następnie w ramach okna Eksploratora plików wybrać odpowiedni plik i nacisnąć przycisk „Otwórz“. Dodawany plik powinien być certyfikatem z rozszerzeniem .crt, który uzyskano poprzez wnioskowanie o certyfikat KSeF Jeżeli operator wybrał pllik w poprawnym formacie, wówczas pole „Odcisk certyfikatu KSeF“ zostanie automatycznie wypełnione danymi odcisku palca tego certyfikatu, a obok pola zamiast linku [Wybierz certyfikat] zostanie wyświetlony link [Usuń certyfikat]. Dodany certyfikat jest przechowywany w formie zaszyfrowanej w bazie danych Comarch BPM. Ręczna edycja pola „Odcisk certyfikatu KSeF“ nie jest możliwa.

Jeśli operator kliknie w link [Usuń certyfikat], wówczas dane certyfikatu (odcisk odciska palca certyfikatu i certyfikat) zostaną usunięte zarówno z bazy Comarch BPM, jak i z pola „Odcisk certyfikatu KSeF“. Gdy certyfikat zostanie usunięty, link [Usuń certyfikat] zmieni się ponownie w link [Wybierz certyfikat] i bdzie możliwe ponowne wybranie certyfikatu.

Uwaga

Aplikacja Comarch BPM nie weryfikuje zgodności dodanego certyfikatu z dodanym kluczem prywatnym. Jeśli operator wybrał certyfikat, z którym nie jest powiązany klucz prywatny wybrany w polu „Klucz prywatny certyfikatu KSeF“, wówczas przy próbie pobrania faktur z KSeF w puncie ACd zostaje wyświetlony komunikat: „Wystąpił błąd: KSeF2 AuthorizationWithKsefCertAsync – Authorization failed: Invalid operation 'Authentication’: Failed to decrypt private key: Nieprawidłowe hasło do klucza prywatnego“.

[Hasło certyfikatu KSeF] – pole, w ramach którego należy wprowadzić hasło, które wprowadzono podczas wnioskowania o certyfikat KSeF. Wprowadzone hasło jest przechowywane w formie zaszyfrowanej w bazie danych Comarch BPM.

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

[Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenia]  – 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”.

[od wersji 2026.0.1: Klucz prywatny skrzynki e-Doręczenia] – 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 .

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