Czy można generować dokument do Comarch ERP Optima w Chmurze za pomocą kodu C#?
W Comarch BPM współpracującym z Comarch ERP Optima w modelu usługowym nie ma możliwości generowania dokumentów do Comarch ERP Optima za pomocą kodu C#.
Zamiast tego proces ten jest realizowany za pomocą gotowych plików wykonywalnych i konfiguracyjnych.
Rozwiązanie to działa wyłącznie w wersji Desktop aplikacji, a korzystanie z niego wymaga wgrania odpowiednich plików .config oraz definicji obiegu do folderu ComarchDMS.
Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?
Aplikacje Comarch BPM w wersji 2026.0.0 współpracują z następującymi Systemami Comarch ERP:
Comarch ERP XL – wersje systemu: 2025.0.3, 2025.1, 2025.1.1
Comarch ERP Optima – wersje systemu: 2025.5.1, 2026.0.1, 2026.1.1
Comarch ERP Altum – wersje systemu: 2024.5, 2025.0, 2026.0
Comarch ERP Enterprise 6.4 – DMS Integration APP wersja 45.2
Uwaga
Od wersji 2025.1.0 wsparcie dla starej wersji aplikacji web zostało zakończone.
Uwaga
Obsługa logów z generatora została oprogramowana w Comarch BPM dla następujących wersji Comarch ERP Optima: 2024.3.1, 2024.5.1, 2024.6.1, 2025.0.1, 2025.1.1, 2025.2.1 i późniejszych. Ze stron walidowanych należy pobrać zaktualizowany generator Comarch ERP Optima adekwatny do wersji Comarch ERP Optima.
Uwaga
Wymagane oprogramowanie serwera IIS:
System operacyjny (jedna z poniższych możliwości):
Windows Server 2016
Windows Server 2019
Windows Server 2022
Windows Serwer 2025
Zmiany w instalatorze
Zmiany funkcjonalne w wersji 2026.0.0
Zmiana komunikatu dotyczącego wymaganego systemu operacyjnego
W wersji 2026.0.0 zmieniono komunikat wyświetlany podczas próby instalacji Comarch BPM w wersji Windows Server, która nie jest wspierana – komunikat informuje, że „Comarch BPM nie może być zainstalowany w systemie wcześniejszym niż Windows 8 x64, Windows 8 x86, Windows Server 2016 x64.”
Komunikat wyświetlany przy próbie zainstalowania Comarch BPM w systemie, który nie jest wspierany
Zmiany dotyczące instalacji Comarch sPrint
Od wersji 2026.0.0 podczas instalacji Comarch BPM za pomocą instalatora zostaje zainstalowany Comarch sPrint.
W przypadku instalacji ręcznej instalacja Comarch sPrint ma miejsce w ramach programowania klucza HASP za pomocą instalatora (por. poniżej Zmiana opisów i komunikatów dotyczących CDNHASPDMS).
Zmiana opisów i komunikatów dotyczących CDNHASPDMS
W wersji 2026.0.0 w instalatorze Comarch BPM informacje o tworzeniu użytkownika CDNHASPDMS zastąpiono informacjami o programowaniu klucza HASP – zmianie uległy następujące okna:
Wybór aplikacji – zmieniono opcję „Utwórz użytkownika CDNHASPDMS. Tworzenie użytkownika CDNHASPDMS na serwerze Menadżera Kluczy” na „Zaprogramuj klucz HASP.Programowanie klucza HASP na serwerze Menadżera Kluczy” , zmodyfikowano też odpowiednio informację na bocznym panelu
Okno „Wybór aplikacji“ ze zmienioną nazwą opcji programowania klucza HASP
Wybór aplikacji serwerowej – w ramach tego okna zmieniono informację z panelu bocznego z „Wybierz witrynę, na której znajduje się aplikacja oraz aplikację serwerową na której ma zostać zainstalowany użytkownik CDNHASPDMS“ na „Wybierz witrynę, na której znajduje się aplikacja, oraz aplikację serwerową, dla której ma zostać zaprogramowany klucz HASP“
Okno „Wybór aplikacji serwerowej“ ze zmienionym opisem w panelu bocznym
Użytkownik CDNHASPDMS – nazwę okna zmieniono na „Klucz HASP“, przycisk „Utwórz“ na „Wykonaj“, a w panelu bocznym zmodyfikowano informacje:
„Dane uwierzytelniające operatora są niezbędne do przeprowadzenia procesu tworzenia użytkownika CDNHASPDMS i są wykorzystywane wyłącznie podczas pracy instalatora“ na „Dane uwierzytelniające operatora są niezbędne do przeprowadzenia procesu programowania klucza HASP i są wykorzystywane wyłącznie podczas pracy instalatora.“
„Po pomyślnym połączeniu z serwerem, kliknij przycisk „Utwórz”, aby utworzyć użytkownika CDNHASPDMS na wskazanym serwerze.“ na „Po pomyślnym połączeniu z serwerem, kliknij przycisk „Wykonaj”, aby zaprogramować klucz HASP na wskazanym serwerze.“
Zmieniono również treść komunikatów:
„Nie udało się utworzyć użytkownika CDNHASPDMS.“ na „Nie udało się zaprogramowac klucza HASP“.
„Użytkownik CDNHASPDMS został utworzony“ na . „Klucz HASP został zaprogramowany.“
Okno „Klucz HASP“
Usunięcie opcji instalacji „Comarch BPM Lite”
W 2026.0.0 usunięto z instalatora z okna „Tryb pracy” opcję instalacji „Comarch BPM Lite” – licencja Lite nie jest już dostępna.
Okno „Tryb pracy”
Zmiany dotyczące korzystania z ChatERP
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 wprowadzono następujące zmiany związane z korzystaniem z ChatERP:
Zmiana ikony „ChatERP”
W wersji 2026.0.0 uległa zmianie ikona ChatERP na następującą:
W aplikacji desktop:
W aplikacji web:
Dodanie ustawienia „ChatERP” na zakładce „Struktura organizacyjna”
W wersji 2026.0.0 na zakładce [Struktura organizacyjna], na karcie pracownika, na zakładce „Uprawnienia”, w sekcji „Funkcjonalności” wprowadzono pole „ChatERP”, w ramach którego można zadecydować o dostępności ChatERP dla danego pracownika. Administrator może wybrać w ramach pola jedna z dwóch wartości:
Tak – wówczas dany operator będzie mógł korzystać z ChatERP, a ikona [ChatERP] (w aplikacji desktop) oraz [ChatERP] (w aplikacji web) w górnej części okna aplikacji Comarch BPM będzie dla niego widoczna
Nie – w takim przypadku dany operator nie będzie mógł korzystać z ChatERP, a ikona [ChatERP] (w aplikacji desktop) oraz [ChatERP] (w aplikacji web) w górnej części okna aplikacji Comarch BPM nie będzie dla niego widoczna
Uwaga
Jeżeli dla danego operatora na karcie pracownika, na zakładce „Uprawnienia”, w sekcji „Funkcjonalności” w polu „Administrator“ wybrano opcję „Tak“, wówczas automatycznie zostaje mu nadane uprawnienie do korzystania z ChatERP (w polu „ChatERP“ wybrana jest opcja „Tak“). Uprawnienie administratora do korzystania z ChatERP może zostać wyłączone, analogicznie jak dla każdego operatora.
Widok nowego pola „ChatERP“ na karcie pracownika, na zakładce „Uprawnienia“, w sekcji „Funkcjonalności“
Zmiany w oknie ChatERP w aplikacji desktop
Od wersji 2026.0.0 ikona [ChatERP] w aplikacji desktop widoczna jest jedynie dla operatorów, którym przyznano uprawnienie do korzystania z ChatERP (zob. powyżej Dodanie ustawienia „ChatERP” na zakładce „Struktura organizacyjna”).
Po pierwszym uruchomieniu ChatERP dla spółki o danym numerze NIP – czyli po kliknięciu w przycisk [ChatERP] – zostanie wyświetlone okno komunikatu informujące o konieczności wypełnienia formularza i ponownego uruchomienia okna ChataERP. W ramach tego okna należy kliknąć w przycisk [Zaakceptuj regulamin]. Wówczas zostanie otwarta strona formularza, który należy wypełnić, należy również zaakceptować regulamin.
Uwaga
Aby korzystać z Chat ERP, należy również uzupełnić NIP w polu „NIP firmy”, które znajduje się na zakładce „Integracje” w sekcji „Integracja z usługa KSeF” (dla trybu jednospółkowego) lub na zakładce „Połączenia z ERP” w konfiguracji danej spółki (dla trybu wielospółkowego).
Uwaga
Operator może wypełnić formularz i zaakceptować regulamin na dowolnej platformie – za pośrednictwem aplikacji desktop lub aplikacji web.
Uwaga
Zalecamy, aby pierwszego uruchomienia ChataERP dokonał operator z uprawnieniami administratora, ponieważ do korzystania z ChatERP niezbędne jest wypełnienie formularza.
Jeśli operator poprawnie uzupełnił formularz i zaakceptował regulamin, wówczas po ponownym uruchomieniu ChataERP zostanie wyświetlone okno umożliwiające rozpoczęcie rozmowy – w tym celu należy kliknąć w pole [Rozpocznij rozmowę]. Wówczas zostanie otwarte okno aktywnej konwersacji, w którym można prowadzić rozmowę z ChatERP. W dolnej części okna dodano komunikat: „ Comarch ChatERP może popełniać błędy, dlatego należy weryfikować jego odpowiedzi”. Takie okno będzie od tej pory wyświetlane wszystkim uprawnionym operatorom z danej spółki (o danym numerze NIP).
W przypadku, jeśli operator zamknie okno z przyciskiem [Rozpocznij rozmowę] za pomocą znaku X i nie naciśnie przycisku, wówczas po kolejnym uruchomieniu ChatERP nadal widoczne będzie okno z tym przyciskiem.
Uwaga
Jeśli formularz został niepoprawnie uzupełniony, wówczas po ponownym uruchomieniu ChatERP ponownie zostanie wyświetlone okno z przyciskiem „Zaakceptuj regulamin“.
Podobnie, okno z przyciskiem „Zaakceptuj regulamin“ zostanie również wyświetlone, jeżeli ChatERP zostanie uruchomiony w innej spółce o innym numerze NIP.
Okno ChatERP wyświetlane w aplikacji desktop po pierwszym uruchomieniu ChatERP dla danego numeru NIP
Okno ChatERP wyświetlane w aplikacji desktop po poprawnym uzupełnieniu formularza
Okno aktywnej konwersacji ChatERP w aplikacji desktop
Zmiany w oknie ChatERP w aplikacji web
Od wersji 2026.0.0 ikona [ChatERP] w aplikacji web widoczna jest jedynie dla operatorów, którym przyznano uprawnienie do korzystania z ChatERP (zob. powyżej Dodanie ustawienia „ChatERP” na zakładce „Struktura organizacyjna”).
Po pierwszym uruchomieniu ChatERP dla spółki o danym numerze NIP – czyli po kliknięciu w przycisk [ChatERP] – zostanie wyświetlone okno komunikatu „Aktywacja usługi”, informujące o konieczności wypełnienia formularza i ponownego uruchomienia okna ChataERP – w przypadku, jeśli wcześniej nie uzupełniono formularza. W ramach tego okna należy kliknąć w przycisk [Przejdź do formularza]. Wówczas okno komunikatu zostanie zamknięte i nastąpi przejście do strony formularza, który należy wypełnić, należy również zaakceptować regulamin.
Uwaga
Operator może wypełnić formularz i zaakceptować regulamin za pośrednictwem aplikacji desktop lub aplikacji web.
Uwaga
Zalecamy, aby pierwszego uruchomienia ChataERP dokonał operator z uprawnieniami administratora, ponieważ do korzystania z ChatERP niezbędne jest wypełnienie formularza.
Uwaga
Jeśli formularz został niepoprawnie uzupełniony lub jeżeli operator zamknie okno „Aktywacja usługi“ za pomocą znaku X lub przyciskiem [Anuluj], wówczas po ponownym uruchomieniu ChatERP ponownie zostanie wyświetlone okno „Aktywacja usługi“ z przyciskiem „Zaakceptuj regulamin“.
Podobnie, okno „Aktywacja usługi“ zostanie również wyświetlone, jeżeli ChatERP zostanie uruchomiony w innej spółce o innym numerze NIP.
Jeśli operator poprawnie uzupełnił formularz i zaakceptował regulamin, wówczas po powrocie na stronę aplikacji web Comarch BPM i po ponownym uruchomieniu ChatERP zostanie wyświetlone okno „Poznaj ChatERP!”, w którym operator może rozpocząć rozmowę z ChatERP – w tym celu należy kliknąć w przycisk [Rozpocznij rozmowę]. Wówczas zostanie otwarte okno aktywnej konwersacji, w którym można prowadzić konwersację z ChatERP. W górnej części okna dodano komunikat: „Comarch ChatERP może popełniać błędy, dlatego należy weryfikować jego odpowiedzi”. Takie okno będzie od tej pory wyświetlane dla wszystkich uprawnionych operatorów z danej spółki (o danym numerze NIP).
W przypadku, jeśli operator zamknie okno „Poznaj ChatERP!” za pomocą znaku X lub przyciskiem [Anuluj] i nie naciśnie przycisku, wówczas po kolejnym uruchomieniu ChatERP nadal widoczne będzie to okno.
Okno ChatERP wyświetlane w aplikacji web po pierwszym uruchomieniu ChatERP dla danego numeru NIP
Okno ChatERP w aplikacji web wyświetlane po poprawnym uzupełnieniu formularza
Okno aktywnej konwersacji ChatERP w aplikacji web
Zmiany w oknie „Pozostałe filtry”
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 wprowadzono następujące zmiany w oknie „Pozostałe filtry”, dostępnym w module Repozytorium w aplikacji web oraz podczas dodawania załącznika z Repozytorium w aplikacji desktop:
Dodano ekspandery dla pól „Powód unieważnienia” i „Kryterium okresu przechowywania” – domyślnie lista powodów unieważnienia i pola, w których wprowadza się daty dla kryterium okresu przechowywania, zostają ukryte. Obok pól dodano ikonę strzałki w dół – aby rozwinąć daną sekcję należy kliknąć w tę ikonę lub w nazwę danej sekcji – wówczas ikona zmienia się na strzałkę w górę , a lista powodów unieważnienia/ pola do wprowadzenia kryterium stają się widoczne.
Widok zwiniętych sekcji „Powód unieważnienia“ i „Kryterium okresu przechowywania“ w oknie ‚Pozostałe filtry“
Widok rozwiniętych sekcji „Powód unieważnienia“ i „Kryterium okresu przechowywania“ w oknie ‚Pozostałe filtry“
Dla atrybutu typu liczba dodano pole typu liczba „Do“, które umożliwia wprowadzenie wartości maksymalnej w ramach filtra. Filtrowanie odbywa się zgodnie z zakresem określonym dla atrybutu typu liczba, ale nie jest konieczne wypełnienie obydwóch pól: „Od“ i „Do“. Jeżeli operator:
Wprowadzi tylko wartość w polu „Od“ – nastąpi filtrowanie zgodnie z zakresem od podanej wartości do wartości maksymalnej
Wprowadzi tylko wartość w polu „Do“ – nastąpi filtrowanie zgodnie z zakresem od wartości minimalnej do podanej wartości
Wprowadzi wartości w obydwóch polach: „Od“ i „Do“ – nastąpi filtrowanie według wybranego zakresu
Od wersji 2026.0.0 etykiety pól dla atrybutów typu liczba rozpoczynają się zawsze wielką literą.
Widok atrybutu typu Liczba –„Wartość“ – z polem „Do“ w ramach okna „Pozostałe filtry“ w koszu w module Repozytorium
Wprowadzenie możliwości dodania jednego punktu ACD połączonego z wieloma obiegami
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 umożliwiono dodanie jednego punktu ACD dla wielu różnych obiegów dla punktów konfiguracyjnych ACD typu:
Import dokumentów zakupu z KSeF
Współpraca z dowolnym programem OCR
Współpraca z Comarch OCR
Zmiana ta ma na celu uproszczenie i uelastycznienie konfiguracji punktów ACD w Comarch BPM, a także optymalizację obsługi dokumentów.
W tym celu dla wymienionych powyżej typów punktów ACD wprowadzono następujące zmiany:
Podczas konfiguracji punktu ACD na zakładce „Ogólne” w ramach pola „Typ obiegu” umożliwiono wybór wielu typów obiegów – po kliknięciu w pole rozwijana jest lista wszystkich typów obiegów dostępnych w systemie, a administrator powinien zaznaczyć checkbox obok jednego lub więcej typu obiegu – liczba zaznaczonych typów obiegów może być dowolna. Jeśli lista jest długa, po prawej stronie dostępny jest suwak.
Uwaga
Aby możliwy był zapis punktu konfiguracyjnego ACD, konieczne jest wybranie co najmniej jednego typu obiegu w polu „Typ obiegu”.
Gdy operator zaznaczy typy obiegów i kliknie obok listy, wówczas zostanie ona zamknięta, a w polu „Typ obiegu“ będzie widoczny napis „Wybrano: [liczba wybranych typów obiegów]“.
Widok zakładki „Ogólne” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF”, gdy w polu „Typ obiegu“ jest wybieranych wiele typów obiegów
Widok zakładki „Ogólne” w ramach konfiguracji punktu ACD typu „Współpraca z dowolnym programem OCR”, gdy w polu „Typ obiegu“ jest wybieranych wiele typów obiegów
Widok zakładki „Ogólne” w ramach konfiguracji punktu ACD typu „Współpraca z Comarch OCR”, gdy w polu „Typ obiegu“ jest wybieranych wiele typów obiegów
Widok zakładki „Ogólne” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” po wyborze w polu „Typ obiegu“ 3 typów obiegów
Zmodyfikowano zakładkę „Kontrolki” dostępną podczas konfiguracji punktu ACD w taki sposób, aby możliwe było odrębne definiowanie mapowania kontrolek dla każdego typu obiegu wybranego na zakładce „Ogólne”.
W tym celu w górnej części zakładki dodano pole, po kliknięciu w które rozwijana jest lista typów obiegów przypisanych do danego punktu ACD na zakładce „Ogólne“. Gdy zostanie wybrany typ obiegu, wówczas poniżej dostępny będzie obszar, w ramach którego można zdefiniować kontrolki dla danego typu obiegu. Pozostałe ustawienia dotyczące zakładki „Kontrolki“ nie ulegają zmianie – aby dodać kontrolkę do mapowania, należy kliknąć w przycisk [Dodaj], a następnie wprowadzić odpowiednie zapytanie SQL w polu znajdującym się po prawej stronie okna. Mapowanie danej kontrolki można usunąć, klikając w ikonę kosza na prawo od nazwy kontrolki
Uwaga
Jeśli dany typ obiegu zostanie odznaczony w polu „Typ obiegu” na zakładce „Ogólne” podczas konfiguracji punktu ACD, wówczas nie będzie również dostępny do wyboru na zakładce „Kontrolki”.
Widok zakładki „Kontrolki” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” przed wyborem typu obiegu
Widok zakładki „Kontrolki” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” z listą typów obiegów przypisanych do danego punktu ACD do wyboru
Widok zakładki „Kontrolki” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” po wyborze typu obiegu wraz ze zdefiniowanym mapowaniem kontrolek
W ramach okna pracującego punktu ACD w ramach podglądu dokumentu umożliwiono wybór typu obiegu, dla którego ma zostać wyświetlony podgląd mapowania kontrolek.
W tym celu pod polem „Punkt konfiguracyjny” dodano pole „Typ obiegu”, w ramach którego z rozwijanej listy można wybrać nazwę typu obiegu przypisanego do danego punktu ACD – musi to być również typ obiegu, do którego operator ma przyznane uprawnienia do inicjowania. Domyślnie wyświetlany jest pierwszy typ obiegu na liście. Po wyborze typu obiegu zostaną dla niego wyświetlone mapowania kontrolek, zgodnie z zakładką „Kontrolki”.
Jeśli dany operator nie ma uprawnień do inicjowania dokumentów w żadnym z typów obiegów przypisanych do danego punktu ACD, wówczas zamiast pola „Typ obiegu” wyświetlany jest napis: „Brak uprawnienia do inicjowania dokumentów dla typu obiegu na wybranym punkcie.”.
W przypadku, jeśli na którymś z typów obiegów wartość/wartości nie zostały zmapowane, wówczas będą widoczne następujące oznaczenia:
Obok danego dokumentu na liście wyświetlona zostanie czerwona ikona wykrzyknika
Obok nazwy danego typu obiegu, w którym brakuje danego mapowania, w polu „Typ obiegu” zostanie wyświetlona czerwona ikona wykrzyknika
Pole, w którym brakuje mapowania, zostanie zaznaczone na czerwono
Gdy wartość/wartości zostaną uzupełnione, wówczas powyższe oznaczenia znikną.
Widok punktu ACD typu „Import dokumentów zakupu z KSeF” podczas dokonywania wyboru typu obiegu w polu „Typ obiegu“
Widok punktu ACD typu „Import dokumentów zakupu z KSeF” po wyborze typu obiegu w polu „Typ obiegu“
Widok punktu ACD typu „Współpraca z Comarch OCR” po wyborze w polu „Typ obiegu“ typu obiegu
Zmodyfikowano proces generowania dokumentu do obiegu – jeśli operator ma uprawnienia co najmniej do jednego z typów obiegów przypisanych do danego punktu ACD, wtedy po wyborze wartości w polu „Dokumenty” i po kliknięciu w przycisk [Generuj] wyświetlone zostanie okno, w ramach którego należy wybrać z listy typ obiegu, do którego ma zostać wygenerowany dany dokument/dokumenty. Lista składa się z typów obiegów, do których dany operator ma uprawnienie do inicjowania dokumentów; jeżeli lista jest długa, obok dostępny jest suwak. W ramach okna dostępne są następujące przyciski:
[OK] – kliknięcie w ten przycisk potwierdza wybór typu obiegu z listy – jeśli przedtem wybrano obieg, wówczas okno zostanie zamknięte, a dokument (dokumenty) zostanie wygenerowany do wybranego typu obiegu; jeśli operator kliknie w przycisk, a nie wybrał przedtem typu obiegu, wówczas ono nie zostanie zamknięte, a dokument(dokumenty) nie jest generowany ;
[Anuluj] – naciśnięcie tego przycisku powoduje zamknięcie okna, anuluje wybór typu obiegu i zatrzymuje generowanie dokumentów
X – kliknięcie w ten przycisk powoduje zamknięcie okna, anuluje wybór typu obiegu oraz zatrzymuje generowanie dokumentów
Okno wyświetlone po kliknięciu w przycisk „Generuj” – w tym oknie należy wybrać typ obiegu, do którego mają zostać wygenerowane dane dokumenty
Okno wyświetlone po kliknięciu w przycisk „Generuj” z przykładową listą typów obiegów
Jeżeli operator nie ma uprawnień do inicjowania w żadnym z typów obiegów przypisanych do danego punktu ACD, wówczas przycisk [Generuj] pozostanie wyszarzony.
Okno punktu ACD, gdy dany operator nie ma uprawnień do inicjowania dokumentów w żadnym typie obiegu spośród przypisanych do danego punktu ACD
W obiekcie Globals w klasie ACD dodano metodę SetDocumentFlow(string) – metoda ustawia jeden wybrany obieg, co umożliwia uruchomienie automatyzacji procesu wskazywania typu obiegu dokumentów, którym ma posługiwać się program procesu.
Metoda Globals.ACD.SetDocumentFlow(string):
Ma parametr wejściowy: nazwę typu obiegu – jest to parametr obowiązkowy
Zwraca wyniki:
0 – operacja wykonała się poprawnie
-1 – wystąpił błąd
-2 – podany obieg dokumentów nie istnieje
Wprowadzanie kodu na zakładce „Edytor skryptów” na zakładce „Konfiguracja automatycznego trybu pracy” – widoczna jest metoda Globals.ACD.SetDocumentFlow(string)
Udostępnianie dokumentów w Repozytorium przez linki wewnętrzne
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 w ramach menu kontekstowego dokumentu w module Repozytorium udostępniono dwie opcje:
Kopiuj link – analogiczna do dotychczas występującej opcji „Kopiuj link“; wybór tej opcji pozwala na skopiowanie pełnego linku do danego dokumentu, który można wkleić w wyszukiwarce danej przeglądarki (link rozpoczyna się od http)
Kopiuj link wewnętrzny – wybór tej opcji umożliwia skopiowanie identyfikatora dokumentu, który można wkleić w wyszukiwarce Repozytorium (identyfikator składa się z ciągu liter i liczb, jest zgodny z UUID danego dokumentu w bazie danych)
Obydwie opcje kopiowania linków są dostępne dla wszystkich dokumentów (aktywnych, zarchiwizowanych, unieważnionych).
Widok menu kontekstowego przykładowego dokumentu (w tym przypadku aktywnego) z opcjami „Kopiuj link“ i „Kopiuj link wewnętrzny“
Po kliknięciu w przycisk „Kopiuj link“ lub „Kopiuj link wewnętrzny“ link zostanie skopiowany i wyświetli się informujący o tym komunikat.
Komunikat „Link został skopiowany“
Link skopiowany za pomocą opcji „Kopiuj link wewnętrzny“ należy wkleić w ramach pola wyszukiwarki [Wyszukaj w Repozytorium] i kliknąć w ikonę lupy. Jeśli dokument z wprowadzonym UUID znajduje się w module Repozytorium, a dany zalogowany operator ma do niego uprawnienia, wówczas zostanie otwarty dokument.
Wyszukiwanie dokumentu po UUID skopiowanym za pomocą opcji „ Kopiuj link wewnętrzny“
Dokument wyświetlony, gdy wyszukiwanie po UUID zakończyło się powodzeniem – przykład
Jeżeli dokument o danym numerze UUID nie zostanie znaleziony, wówczas wyświetli się informacja „Brak wyników“.
Informacja „Brak wyników“, gdy wyszukiwanie po UUID zakończyło się niepowodzeniem
W przypadku, jeśli w module Repozytorium znajduje się dokument, który ma taką samą nazwę, jak inny dokument ma identyfikator (link wewnętrzny), wówczas po wyszukiwaniu danego identyfikatora w Repozytorium na liście wyników zostaną wyświetlone obydwie pozycje.
Wyniki wyszukiwania, gdy wyszukiwana wartość jest jednocześnie identyfikatorem jednego dokumentu i nazwą innego dokumentu
Zmiany w integracji z Comarch ERP Enterprise
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 w kwestiach związanych z integracją z Comarch ERP Enterprise w pliku DMS.Ext.CEE.dll, znajdującym się w folderze z plikami aplikacji desktop Comarch BPM, wprowadzono następujące zmiany:
Wprowadzono rozszerzenie Optional Dimensions w serwisie DocumentCreateService:
Dodano dwie metody w klasie CEEFinancials:
public List<CEEDimensionType> GetDimensionTypes()
public List<CEEOptionalDimension> GetOptionalDimensions(string dimensionType);
Rozszerzono klasę InvoiceCostingData, dodając pole InvoiceOptionalDimension[] optionalDimensions;
Dodano klasę InvoiceOptionalDimension dla serwisu com.sem.ext.app.dms.rest.DocumentCreateService/createSupplierInvoice;
Przypisano konto z CEE do BPM – w tym celu dodano pole accountOriginType w ramach klasy Details dla serwisu com.sem.ext.app.dms.rest.DocumentCreateService/createSupplierInvoice;
Dodano parametry NKUP percentage, NKUP durability, NKUP account podczas tworzenia faktury zakupu – w tym celu dodano pola nkupAccount, nkupDurability i nkupPercentage w ramach klasy Details dla serwisu com.sem.ext.app.dms.rest.DocumentCreateService/createSupplierInvoice;
Dodano rozszerzenie BPM w serwisie web oraz w BPM App, aby umożliwić przekazywanie faktur zakupowych z BPM do CEE – w tym celu dodano pole ksefDocumentNumber w ramach klasy SupplierInvoiceData w serwisie com.sem.ext.app.dms.rest.DocumentCreateService/createSupplierInvoice.
Dostosowanie Comarch BPM do wersji 3 UA API usługi e-Doręczenia
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 zaktualizowano mechanizm komunikacji z usługą e-Doręczenia do UA API w wersji 3 (3.0.8) – dzięki temu zapewniona zostaje nieprzerwana współpraca z Comarch BPM.
Zmieniono także wartość klucza „EDorUserAgentApiUrl”, który znajduje się w pliku Web.config.
Nowa wartość klucza to:<add key=”EDorUserAgentApiUrl” value=” https://uaapi-ow.poczta-polska.pl/api/v3″ />.
Klucze dotyczące usługi e-Doręczenia po wprowadzeniu zmiany
Umożliwienie generowania dokumentów typu (S)FZ (spinacz nagłówkowy faktury zakupu) do Comarch ERP XL
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 wprowadzono możliwość generowania dokumentów typu (S)FZ (spinacz nagłówkowy zakupu) z poziomu Comarch BPM do Comarch ERP XL Operator może utworzyć dokument spinacza nagłówkowego, do którego można dodać jako pozycje dokumentu dokumenty PZ z Comarch ERP XL. Na formatce Dokument ERP XL widoczne są numery dokumentów oraz pozycje dokumentów, które dodano do spinacza.
Spinacz nagłówkowy faktury zakupu w aplikacji desktop Comarch BPM
Formatka spinacza nagłówkowego faktury zakupu w aplikacji desktop
Od wersji 2026.0.0 formatka spinacza nagłówkowego faktury zakupu składa się z następujących 3 zakładek:
Spinacz faktury
Spięte dokumenty
Opis analityczny
Widok formatki spinacza nagłówkowego faktury zakupu
Zakładka „Spinacz faktury”
Zakładka, na której znajdują się:
Dane nagłówkowe dokumentu – pola, których obsługa odbywa się tak samo, jak w przypadku innych typów dokumentów:
Kontrahent
Seria dokumentu
Rodzaj zakupu
Płatnik
Rejestr VAT
Numer KSeF
Data przyjęcia KSeF
Lista elementów – lista dokumentów PZ spiętych do spinacza nagłówkowego, dodanych z Comarch ERP XL po kliknięciu w przycisk + (zob. poniżej Generowanie dokumentu (S)FZ do Comarch ERP XL z poziomu aplikacji desktop).
Dopóki dokument (S)FZ nie został wygenerowany, poszczególne pozycje można usunąć, klikając w ikonę kosza, znajdującą się po prawej stronie danej pozycji; do tego momentu można również dodać pozycję spinacza, naciskając w ikonę plusa pod listą elementów. Spinane dokumenty mogą być wystawione na różnych kontrahentów,
Jeżeli dla danego dokumentu PZ, który użytkownik próbuje dodać do listy, nie ustalono wartości dostawy (TrN_KosztUstalono=0 w tabeli cdn.TraNag w bazie Comarch ERP XL), wówczas przy próbie dodania takiego dokumentu zostanie wyświetlony komunikat „Nie wszystkie wskazane dokumenty zostały dodane do spinacza nagłówkowego faktury zakupu”. -Dokumenty bez ustalonego kosztu dostawy: [numery dokumentów]”. Okno komunikatu należy zamknąć, klikając w przycisk [Zamknij] lub X – dokument nie zostanie dodany do listy elementów w formatce.
Komunikat wyświetlony w przypadku, gdy dla danego dokumentu PZ, który operator próbuje dodać do listy elementów na formatce Dokument ERP XL, nie ustalono wartości dostawy
Zakładka „Spięte dokumenty”
Zakładka, na której może zostać wyświetlony dokument PZ.
Aby wybrać dany dokument PZ spośród dokumentów dodanych na zakładce „Spinacz faktury”, należy w ramach pola „Wyświetl dokument” wybrać daną pozycję – wówczas poniżej zostanie wyświetlona zawartość tego dokumentu.
Uwaga
Zmiana wartości w polach na dokumentach w zakładce „Spięte dokumenty” nie jest możliwa.
Widok zakładki „Spięte dokumenty” na formatce spinacza nagłówkowego faktury zakupu – przed wyborem dokumentu
Widok zakładki „Spięte dokumenty” na formatce spinacza nagłówkowego faktury zakupu – po wyborze dokumentu
Zakładka „Opis analityczny”
Zakładka działa analogicznie jak dotychczas na dokumencie spinacza faktury. W ramach tej zakładki operator może utworzyć i dodać opis analityczny do tworzonego dokumentu (S)FZ. Opis analityczny może być aktualizowany oraz uzupełniany również po wygenerowaniu dokumentu (S)FZ do Comarch ERP XL. W ramach opisu analitycznego uwzględnione są pozycje wszystkich dokumentów PZ, które dodano do spinacza faktury.
Widok zakładki „Opis analityczny” na formatce spinacza nagłówkowego faktury zakupu – uwzględnione są wszystkie spięte dokumenty PZ
Generowanie dokumentu (S)FZ do Comarch ERP XL z poziomu aplikacji desktop
Od wersji 2026.0.0 proces generowania dokumentu (S)FZ do Comarch ERP XL w aplikacji desktop Comarch BPM ma następujący przebieg:
Na dokumencie Comarch BPM w ramach kontrolki typu Dokument ERP XL, dla której w ustawieniach wybrano spinacz nagłówkowy faktury zakupu, operator klika w przycisk [Dodaj];
Po prawej stronie okna zostaje otwarta formatka „Dokument ERP XL”; w ramach zakładki „Spinacz faktury” operator klika w przycisk [Dodaj];
W otwartym wówczas oknie z listą dokumentów zakupowych z Comarch ERP XL operator wybiera dokumenty do spięcia do (S)FZ i zatwierdza wybór, klikając znak potwierdzenia . Lista dokumentów zakupowych zostaje zamknięta. Istnieje możliwość dodania kolejnych pozycji na liście elementów za pomocą przycisku [Dodaj] lub usunięcia za pomocą ikony kosza obok danej pozycji (zob. Zakładka „Spinacz faktury”).
Uwaga
W odróżnieniu od pracy z dokumentem (S)FZ w wersjach wcześniejszych niż 2026.0.0 operator:
Musi wybrać takie dokumenty PZ, które jeszcze nie są spięte do żadnego spinacza
Ma możliwość wyboru więcej niż jednego dokumentu.
W przypadku, jeżeli:
operator zaznaczył dokumenty, które są już spięte z innym spinaczem, wówczas te dokumenty wyświetlane są na czerwono w Comarch ERP XL– są pomijane przy dodawaniu dokumentów do spinacza nagłówkowego, a po zamknięciu listy PZ wyświetlony zostaje komunikat: „Nie wszystkie wskazane dokumenty zostały dodane do spinacza nagłówkowego faktury zakupu. Dokumenty związane z innym spinaczem: [numer pominiętego dokumentu].”.
Operator zaznaczył dokument PZ, który jest w buforze, wówczas ten dokument zostanie pominięty przy dodawaniu dokumentów do spinacza nagłówkowego, a po zamknięciu okna z Comarch ERP XL z listą PZ wyświetlany jest komunikat: „Nie wszystkie wskazane dokumenty zostały dodane do spinacza nagłówkowego faktury zakupu. Dokumenty w buforze: [numer pominiętego dokumentu].”
Komunikat wyświetlany, gdy próbowano dodać dokument, który dodano już do innego spinacza nagłówkowego
Komunikat wyświetlany, gdy próbowano dodać dokument z bufora do spinacza nagłówkowego
Operator zaznaczył dokument, który nie jest dokumentem PZ, wówczas ten dokument zostanie pominięty przy dodawaniu dokumentów do spinacza nagłówkowego, a po zamknięciu okna z Comarch ERP XL z listą PZ wyświetlany jest komunikat: „Nie wszystkie wskazane dokumenty zostały dodane do spinacza nagłówkowego faktury zakupu. Dokumenty, o typie innym niż PZ: [numer pominiętego dokumentu].”
Komunikat wyświetlany, gdy próbowano dodać dokument inny niż PZ do spinacza nagłówkowego
Operator zaznaczył dokumenty PZ, które są już spięte z innym spinaczem oraz te, które są w buforze, wówczas te dokumenty zostają pominięte przy dodawaniu dokumentów do spinacza nagłówkowego, a po zamknięciu listy PZ wyświetlany jest komunikat informujący o braku możliwości dodania takich dokumentów.
Operator musi uzupełnić dane na zakładce „Opis analityczny“ (zob. Zakładka „Opis analityczny” )
Zostaje aktywowana ikona [Generuj dokument] – operator musi kliknąć w tę ikonę, aby wygenerować dokument (S)FZ do Comarch ERP XL
Dokument (S)FZ został wygenerowany – wówczas:
w ramach kontrolki typu Dokument ERP XL widoczny jest numer wygenerowanego dokumentu jako link. Jeśli operator w niego kliknie, wówczas wyświetlany jest podgląd dokumentu w Comarch ERP XL
jeśli operator kliknie w ikonę lupy obok numeru dokumentu, wtedy po prawej stronie okna zostanie otwarta formatka Dokument ERP XL na zakładce „Spinacz faktury“ – formatka jest dostępna tylko do odczytu – nie ma możliwości edycji danych, można jedynie uzupełnić opis analityczny i zaktualizować go na danym dokumencie w Comarch ERP XL
Dołączanie dokumentu (S)FZ z Comarch ERP XL do kontrolki typu Dokument ERP XL w aplikacji desktop Comarch BPM
Dołączanie dokumentu spinacza nagłówkowego faktury zakupu (wiązanie dokumentów) jest analogiczne jak w przypadku innych typów dokumentów, a mianowicie:
Dane z dokumentu ERP XL zawsze zostaną nadpisane na dokument w Comarch BPM;
Operator nie może edytować dokumentu dowiązanego z ERP XL z poziomu powiązanego dokumentu w Comarch BPM
Na dokumencie dowiązanym z ERP XL można aktualizować jedynie opis analityczny
Widok komunikatu pokazującego różnice pomiędzy dokumentem w Comarch BPM i w Comarch ERP XL
W ramach komunikatu, który porównuje wartości na danym dokumencie w Comarch ERP XL i Comarch BPM, sprawdzane są następujące wartości:
Na zakładce „Spinacz faktury”
Kontrahent
Płatnik
Seria dokumentu
Rodzaj zakupu
Rejestr VAT
Numer KSeF
Data przyjęcia KSeF
Razem netto
Razem brutto
Lista spiętych dokumentów
Na zakładce „Opis analityczny”:
Nazwa
Data analityczna
Kategoria finansowa
Wartości z tabelki: Pozycja, Procent, Wartość i pozostałe wynikające z konfiguracji OA w Comarch ERP XL dla danego typu dokumentu
Spinacz nagłówkowy faktury zakupu w aplikacji web
W wersji 2026.0.0 umożliwiono generowanie dokumentów typu (S)FZ (spinacz nagłówkowy zakupu) z poziomu aplikacji web Comarch BPM do Comarch ERP XL.
Formatka spinacza nagłówkowego faktury zakupu w aplikacji web
Od wersji 2026.0.0 formatka spinacza nagłówkowego faktury zakupu składa się z następujących 3 zakładek:
Spinacz faktury
Spięte dokumenty
Opis analityczny
Widok formatki spinacza nagłówkowego faktury zakupu w aplikacji web
Zakładka „Spinacz faktury”
Zakładka, na której znajdują się:
Dane nagłówkowe dokumentu – pola, których obsługa odbywa się tak samo, jak w przypadku innych typów dokumentów:
Kontrahent
Seria dokumentu
Rodzaj zakupu
Płatnik
Rejestr VAT
Numer KSeF
Data przyjęcia KSeF
Tabela „Elementy” – tabela z listą dokumentów PZ, które mają zostać spięte do spinacza nagłówkowego, dodanych z Comarch ERP XL po kliknięciu w przycisk [+Dodaj dokument] – zostaje wówczas otwarte okno „Wybierz dokumenty, które chcesz dodać do spinacza nagłówkowego”, w którym należy dokonać wyboru dokumentów PZ (zob. Generowanie dokumentu (S)FZ do Comarch ERP XL z poziomu aplikacji web).
Lista dokumentów dostępna w oknie „Wybierz dokumenty, które chcesz dodać do spinacza nagłówkowego” może być filtrowana według miesiąca i roku – aby został uaktywniony filtr wyboru miesiąca, należy najpierw wybrać rok. Możliwe jest również filtrowanie listy według kontrahenta.
Okno „Wybierz dokumenty, które chcesz dodać do spinacza nagłówkowego” – wybór filtra miesiąca
Tabela „Dokumenty” składa się z następujących kolumn:
Numer dokumentu
Kontrahent
Wartość netto
Wartość VAT
Wartość brutto
Dopóki dokument (S)FZ nie został wygenerowany, poszczególne pozycje z tabeli „Dokumenty” można usunąć, klikając w ikonę kosza, znajdującą się po prawej stronie danej pozycji; do tego momentu można również dodać pozycję spinacza, naciskając w przycisk [+Dodaj dokument] pod tabelą. Spinane dokumenty mogą być wystawione na różnych kontrahentów
Widok listy dokumentów w tabeli „Dokumenty” na zakładce „Spinacz faktury” na formatce spinacza nagłówkowego faktury zakupu
Zakładka „Spięte dokumenty”
Zakładka, na której może zostać wyświetlony podgląd dokumentów PZ, które mają zostać dodane do spinacza nagłówkowego faktury zakupu.
Uwaga
Zmiana wartości w polach na dokumentach w zakładce „Spięte dokumenty” nie jest możliwa.
Aby wybrać dany dokument PZ spośród dokumentów dodanych na zakładce „Spinacz faktury”, należy w ramach pola „Wybierz spięty dokument” wybrać daną pozycję – wówczas poniżej zostanie wyświetlona zawartość tego dokumentu.
Widok zakładki „Spięte dokumenty” na formatce spinacza nagłówkowego faktury zakupu w aplikacji web – przed wyborem dokumentu
Widok zakładki „Spięte dokumenty” na formatce spinacza nagłówkowego faktury zakupu w aplikacji web – po wyborze dokumentu
Zakładka „Opis analityczny”
Zakładka działa analogicznie jak dotychczas na dokumencie spinacza faktury. W ramach tej zakładki operator może utworzyć i dodać opis analityczny do tworzonego dokumentu (S)FZ. Opis analityczny może być aktualizowany oraz uzupełniany również po wygenerowaniu dokumentu (S)FZ do Comarch ERP XL. W ramach opisu analitycznego uwzględnione są pozycje wszystkich dokumentów PZ, które dodano do spinacza faktury.
Widok zakładki „Opis analityczny” na formatce spinacza nagłówkowego faktury zakupu
Generowanie dokumentu (S)FZ do Comarch ERP XL z poziomu aplikacji web
Od wersji 2026.0.0 proces generowania dokumentu (S)FZ do Comarch ERP XL w aplikacji desktop Comarch BPM ma następujący przebieg:
W ramach kontrolki typu Dokument ERP XL, dla której ustawiono typu dokumentu „Spinacz nagłówkowy faktury zakupu”, operator klika w przycisk [Dodaj];
Po prawej stronie okna zostaje otwarta formatka „Dokument ERP XL”; w ramach zakładki „Spinacz faktury” operator klika w przycisk [Dodaj dokument];
W otwartym wówczas oknie „Wybierz dokumenty, które chcesz dodać do spinacza nagłówkowego” z listy dokumentów zakupowych z Comarch ERP XL operator wybiera dokumenty do spięcia do (S)FZ , zaznaczając checkboxy obok danych pozycji, a następnie zatwierdza wybór, klikając w przycisk [Dodaj]. Lista dokumentów zakupowych zostaje zamknięta. Istnieje możliwość dodania kolejnych pozycji na liście elementów za pomocą przycisku „+ Dodaj dokument” lub usunięcia za pomocą ikony kosza obok danej pozycji (zob. Zakładka „Spinacz faktury”).
Uwaga
Od wersji 2026.0.0 operator:
Musi wybrać takie dokumenty PZ, które jeszcze nie są spięte do żadnego spinacza
Ma możliwość wyboru więcej niż jednego dokumentu.
Operator musi uzupełnić dane na zakładce „Opis analityczny“ (zob. Zakładka „Opis analityczny”)
Następnie, gdy ustalono wartość dostawy dla wszystkich spiętych dokumentów PZ, zostaje aktywowana ikona [Generuj] do ERP] – operator musi kliknąć w tę ikonę, aby wygenerować dokument (S)FZ do Comarch ERP XL
Dokument (S)FZ został wygenerowany – wówczas w ramach kontrolki typu Dokument ERP XL widoczny jest numer wygenerowanego dokumentu. Jeśli operator kliknie w znajdujca się obok ikonę z lupą , wtedy po prawej stronie okna zostanie otwarta formatka Dokument ERP XL na zakładce „Spinacz faktury“ – formatka jest dostępna tylko do odczytu – nie ma możliwości edycji danych, można jedynie uzupełnić opis analityczny i zaktualizować go na danym dokumencie w Comarch ERP XL
Dołączanie dokumentu (S)FZ z Comarch ERP XL do kontrolki typu Dokument ERP XL w aplikacji web w Comarch BPM
Dołączanie dokumentu spinacza nagłówkowego faktury zakupu (wiązanie dokumentów) jest analogiczne jak w przypadku innych typów dokumentów, a mianowicie:
Dane z dokumentu ERP XL zawsze zostaną nadpisane na dokument w Comarch BPM;
Operator nie może edytować dokumentu dowiązanego z ERP XL z poziomu powiązanego dokumentu w Comarch BPM
Na dokumencie dowiązanym z ERP XL można aktualizować jedynie opis analityczny