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
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.
Wprowadzenie automatycznego odświeżania karty obiegu po wykonaniu własnej akcji
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 umożliwiono automatyczne odświeżanie karty obiegu po wykonaniu akcji określonej w kontrolce typu Własna akcja. W tym celu w aplikacji desktop w ramach ustawień kontrolki typu Własna akcja dodano checkbox „Odśwież po wykonaniu”.
Jeśli checkbox „Odśwież po wykonaniu” jest zaznaczony, wówczas po wykonaniu akcji określonej w danej kontrolce karta obiegu zostanie przeładowana bez zapisywania obiegu.
Uwaga
Jeśli operator zaznaczył parametr „Odśwież po wykonaniu”, a nie zaznaczył parametru „Zapisz przed uruchomieniem”, wówczas zmiany, które wprowadzono w innych kontrolkach, nie zostaną zapisane, zaś uruchomienie własnej akcji spowoduje utratę niezapisanych zmian. Okno z pytaniem o zapis zmian nie jest wyświetlane.
Za pomocą funkcjonalności „Odśwież po wykonaniu” można np. zaktualizować wartości kontrolek, które zostały zainicjowane uruchomieniem własnej akcji.
Widok ustawień przykładowej kontrolki typu Własna akcja w aplikacji desktop Comarch BPM z zaznaczonym parametrem „Odśwież po wykonaniu”
Funkcjonalność odświeżania karty obiegu, jeśli w aplikacji desktop zaznaczono parametr „Odśwież po wykonaniu”, dotyczy wszystkich platform Comarch BPM (aplikacji desktop, web i mobilnych).
Zmiany i poprawki dotyczące interfejsu aplikacji web
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 w aplikacji web Comarch BPM wprowadzono następujące zmiany dotyczące interfejsu:
Nowy komunikat wyświetlany przy próbie przekazania z listy, gdy warunki przekazania nie zostały spełnione
W przypadku, gdy zostały spełnione obydwa poniższe kryteria:
Dla danego typu obiegu zdefiniowano warunki, których spełnienie jest konieczne do przekazania dokumentu do danego etapu
Dla danego typu obiegu dla danego etapu zaznaczono możliwość przekazania dokumentu z poziomu listy
wówczas jeśli określone warunki przekazania nie zostały spełnione, a w aplikacji web operator podejmuje próbę przekazania dokumentu z listy, wyświetlony zostaje następujący komunikat: Nie przekazano dokumentu.Nie można przekazać dokumentu do następnego etapu, ponieważ nie zostały spełnione warunki przekazania. Wprowadź zmiany i spróbuj ponownie.
Nowy komunikat wyświetlany przy próbie przekazania dokumentu z listy, gdy nie spełniono warunków przekazania do kolejnego etapu
Rozszerzenie pola „Komentarz”
Zarówno w aplikacji web, jak i w Repozytorium zwiększono liczbę znaków, które można wprowadzić w ramach pola „Komentarz”, znajdującego się w panelu szczegółów przekazania – z 255 znaków do 900 znaków. Tak jak dotychczas operator może rozciągnąć pole komentarza, chwytając w prawym dolnym rogu i rozciągając je. Jeżeli ilość znaków przekracza dostępne miejsce w polu komentarza, wówczas zostanie wyświetlony suwak.
Pole komentarza, w którym wprowadzono 900 znaków (aplikacja web)
Wprowadzenie separacji tysięcy w kontrolkach i kolumnach liczbowych
Wartość w kontrolkach i kolumnach liczbowych (typu Liczba całkowita, Liczba stałoprzecinkowa i Liczba rzeczywista) jest prezentowana w formacie, który umożliwia oddzielenie części tysięcy za pomocą spacji, np. 999 939.
Widok przykładowych wartości w kolumnach liczbowych w kontrolce typu Dane tabelaryczne
Zmiany dotyczące wyboru daty w kontrolce typu Data i godzina
W ramach kontrolki typu Data i godzina umożliwiono ręczne wprowadzanie daty, bez konieczności otwierania kalendarza, aby wybrać datę. Datę można wprowadzić zgodnie z formatem dd.mm.rrrr, wprowadzona data musi też odpowiadać rzeczywistości (nie można wprowadzić takiej daty jak np. 33.77.2012).
Data wprowadzona ręcznie w kontrolce typu Data i godzina
Ręczne wprowadzenie daty jest równoznaczne z zaznaczeniem jej w kalendarzu – jeśli operator otworzy kalendarz, np. klikając w przycisk „Enter” w ramach danej kontrolki typu Data, wówczas poprawnie wprowadzona data jest oznaczona na niebiesko w kalendarzu.
Umożliwiono obsługę klawiatury dla kontrolki typu Data i godzina – wobec tego:
Wybór daty można zatwierdzić za pomocą przycisku „Enter”, zaś po kliknięciu w przycisk „Tab” nastąpi przejście do kolejnego elementu;
Operator może przejść do poprzedniego elementu, wybierając kombinację przycisków „Shift” + „Tab”
Jeśli focus jest ustawiony na danym elemencie, wówczas za pomocą przycisku „Enter” operator może wywołać akcję – przykładowo kliknięcie w strzałkę w lewo zmieni miesiąc na poprzedni, a w strzałkę w prawo – na następny;
Operator może poruszać się w obrębie danego miesiąca w kalendarzu za pomocą strzałek w lewo/w prawo – jedynie w obrębie jednego miesiąca, z wyjątkiem pierwszego i ostatniego tygodnia miesiąca. Klikanie w strzałki góra/dół pozwala na zmianę miesiąca na poprzedni/następny;
Jeśli dla kontrolki wybrano opcję „Tak” dla parametru „Czas”, wówczas operator może zmienić godziny i minuty za pomocą strzałek góra/dół
Współpraca z Comarch sPrint – poprawa wydajności oraz umożliwienie pracy w aplikacji web
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 wprowadzono następujące zmiany dotyczące współpracy Comarch BPM z Comarch sPrint:
Modyfikacja trybu uruchamiania Comarch sPrint
Wprowadzono modyfikację trybu uruchamiania Comarch sPrint, aby poprawić wydajność – po pierwszym wywołaniu wydruku sPrint albo konfiguratora wydruków sPrint uruchomiona aplikacja Comarch sPrint jest przechowywana w tle aż do czasu zakończenia sesji danego operatora w Comarch BPM.
Aplikacja Comarch sPrint nie jest uruchamiana wraz z uruchomieniem Comarch BPM – operator może podczas danej sesji nie korzystać z wydruków/konfiguratora Comarch sPrint.
Umożliwienie pracy z wydrukami sPrint w aplikacji web
Od wersji 2026.0.0 w przypadku, jeśli w aplikacji desktop Comarch BPM w ramach zakładki [Kreator raportów i dashboardów] w zakładce „Uprawnienia” nadano danemu operatorowi prawo do pracy z danymi wydrukami sPrint, wówczas te wydruki sPrint są dostępne w aplikacji web Comarch BPM w zakładce [Raporty].
Wydruki sPrint w aplikacji web są oznaczone napisem [sPrint] przed nazwą wydruku. Sortowanie alfabetyczne wszystkich raportów i dashboardów odbywa się według nazwy, bez informacji o aplikacji, z której pochodzi wydruk. Wywoływane raporty otwierają się w nowym oknie.
Widok przykładowej listy raportów i dashboardów na zakładce „Raporty” w aplikacji web – widoczny jest predefiniowany wydruk sPrint
Jeżeli danemu operatorowi w aplikacji desktop przyznano uprawnienia do danych wydruków sPrint, a także wybrano miejsca wywoływania danego wydruku – z listy dokumentów, ze szczegółów dokumentu albo zarówno z listy dokumentów, jak i ze szczegółów dokumentu – wówczas w aplikacji web Comarch BPM dany operator ma dostęp do wybranego wydruku sPrint zgodnie z tymi ustawieniami:
W przypadku dostępu z poziomu listy dokumentów – wydruk sPrint znajduje się na liście widocznej po kliknięciu w przycisk [Więcej akcji], a następnie [Wygeneruj raport];
Widok przykładowej listy dokumentów w aplikacji web – na liście dostępnej po kliknięciu w opcję „Wygeneruj raport” widoczny jest wydruk sPrint
W przypadku dostępu z poziomu szczegółów dokumentu – wydruk sPrint znajduje się na liście widocznej po kliknięciu w przycisk [Więcej akcji], a następnie [Wygeneruj raport];
Widok przykładowych szczegółów dokumentu w aplikacji web – na liście dostępnej po kliknięciu w opcję „Wygeneruj raport” widoczny jest wydruk sPrint
W obydwóch przypadkach na liście dostępnej po kliknięciu w „wygeneruj raport” wydruki sPrint są poprzedzone napisem (sPrint).
Jeżeli dany wydruk sPrint wymaga podania parametrów do wywołania wydruku, wówczas po kliknięciu w nazwę wydruku w aplikacji web na zakładce [Raporty] albo z poziomu listy dokumentów zostanie wyświetlone okno, w którym operator może wprowadzić parametry. W przypadku konieczności podania jako parametru numeru dokumentu, gdy wydruk sPrint jest wywoływany z poziomu szczegółów dokumentu, parametr jest automatycznie uzupełniany, a okno do wprowadzania parametrów nie zostaje wywołane. W ramach okna do wprowadzania parametrów dostępne są następujące przyciski:
X – przycisk, za pomocą którego można zamknąć okno – wówczas wydruk sPrint nie zostanie utworzony;
[Anuluj] – po kliknięciu w ten przycisk wprowadzone zmiany zostaną anulowane, okno do wprowadzania parametrów zamknie się, a wydruk sPrint nie zostanie utworzony
[Zapisz] – jeśli operator kliknie w ten przycisk, wówczas dane, które wprowadził, zostaną zapisane i zostanie utworzony wydruk sPrint
Widok przykładowego okna „Wprowadź parametry” dla parametrów „Data od“ i „Data do“ w aplikacji web Comarch BPM
Aktualizacja bibliotek komponentu KSeFConnector
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 zaktualizowano biblioteki KSeFConnector.dll oraz KSeFConnector2.dll do najnowszych wersji, w związku ze zmianami adresacji, które zostały ogłoszone przez Ministerstwo Finansów.
Wprowadzenie możliwości pobierania potwierdzeń dostarczenia dla wysyłki do usługi e-Doręczenia
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 umożliwiono pobieranie potwierdzeń dostarczenia wysyłki do usługi e-Doręczenia. W tym celu:
utworzono skrypt C#, umożliwiający pobranie potwierdzenia otrzymania wiadomości z usługi e-Doręczenia oraz zapisanie potwierdzenia.
przygotowano przykładowy typ obiegu i rozszerzono opis pobierania potwierdzeń dostarczenia oraz zapisywania ich w kontrolce typu Załącznik na tym typie obiegu: oprócz kontrolek „Do:”, „Temat:”, „Treść:”, „Załączniki”, „Wyślij wiadomość” i kontrolki typu Komunikat, skonfigurowanych zgodnie z opisem dostępnym na stronie https://pomoc.comarch.pl/bpm/index.php/dokumentacja/wysylanie-wiadomosci-do-uslugi-e-doreczenia/, dodano następujące kontrolki:
Pobierz potwierdzenie dostarczenia (identyfikator: Pobierz_potwierdzenie) – to kontrolka typu Własna akcja, po kliknięciu w którą nastąpi pobranie potwierdzenia dostarczenia; należy na niej zaznaczyć opcję „Odśwież po wykonaniu“, która pozwala na przeładowanie dokumentu (zob. Wprowadzenie automatycznego odświeżania karty obiegu po wykonaniu własnej akcji), a następnie zapisanie pliku z bazy w kontrolce typu Załącznik; w ramach kontrolki należy wprowadzić następujący skrypt:
var eDorClient = EDorService.CreateClient();
string messageId = Globals.MainFrame.messageId.Text;
int documentId = Globals.Common.DocumentId ?? 0;
// nazwa (identyfikator) kontrolki załącznik, która ma przechowywać zapisane potwierdzenie
string attachmentControlName = "Potwierdzenie_dostarczenia";
try
{
eDorClient.FetchReceiptEvidence(messageId, documentId, attachmentControlName);
//Globals.MainFrame.Pobierz_potwierdzenie_CSSCRIPT.Text = messageId;
}
catch (Exception ex)
{
throw ex;
}
Powyższy kod C#Script umożliwia pobranie potwierdzenia dostarczenia oraz zapisanie go w kontrolce typu Załącznik „Potwierdzenie dostarczenia“ (identyfikator: Potwierdzenie_dostarczenia);
Potwierdzenie dostarczenia (identyfikator: Potwierdzenie_dostarczenia) – to kontrolka typu Załącznik;w kontrolce zostaje dodany dokument PDF potwierdzenia dostarczenia po tym, jak pomyślnie wykonano akcję po kliknięciu w kontrolkę „ Pobierz potwierdzenie dostarczenia“;
Potwierdzenie dostarczenia (identyfikator: Czy_Potwierdzono) – kontrolka typu Tekst, obserwująca kontrolkę „Pobierz potwierdzenie dostarczenia (identyfikator: Pobierz_potwierdzenie) i samą siebie (jest dodana w polu „Kontrolki powiązane“); dla kontrolki należy wprowadzić następujące zapytania:
W polu „Inicjowanie“ po wyborze „SQL OD“:
select 'Nie dokonano sprawdzenia dostarczenia wiadomości.'
W polu „Wzór na wartość“ po wyborze „SQL OD“:
SELECT
CASE
WHEN EXISTS (
SELECT 1
FROM do.DF_WorkCF wcf
JOIN do.DF_ConfCFCardDokFlow dko ON wcf.DWC_DKOId = dko.DKO_ID
JOIN do.DF_WorkCFBin bin ON wcf.DWC_ID = bin.DWB_DWCID
WHERE wcf.DWC_DWDId = @^DocumentId@
-- nazwa (identyfikator) kontrolki załącznik przechowującej potwierdzenie
AND dko.DKO_Name = 'Potwierdzenie_dostarczenia'
AND bin.DWB_Archival = 0
) THEN 'Potwierdzenie jest dostępne do pobrania.'
ELSE 'Dostarczenie nie zostało jeszcze potwierdzone.'
END
W ramach kontrolki wyświetlana jest informacja dotycząca pobierania potwierdzenia dostarczenia:
Jeśli nie wykonano jeszcze własnej akcji z kontrolki „Pobierz potwierdzenie dostarczenia” – wyświetlana jest informacja: „Nie dokonano sprawdzenia dostarczenia wiadomości.”
Jeśli wykonano własną akcję z kontrolki „Pobierz potwierdzenie dostarczenia” i potwierdzenie zostało poprawnie zapisane w bazie – widoczna jest informacja: „Potwierdzenie jest dostępne do pobrania”
Jeśli wykonano własną akcję z kontrolki „Pobierz potwierdzenie dostarczenia”, ale potwierdzenie jeszcze nie istnieje w bazie – widoczna jest informacja: „Dostarczenie nie zostało jeszcze potwierdzone.“
Wprowadzenie weryfikacji istnienia dokumentu KSeF w Comarch ERP XL w kontrolce typu Dokument ERP XL
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 wprowadzono weryfikację istnienia dokumentu KSeF w Comarch ERP XL w przypadku, kiedy na zakładce „Dokument” znajdującej się na formatce „Dokument ERP XL” w kontrolce typu Dokument ERP XL w ramach kontrolki „Numer KSeF” wprowadzono numer faktury KSeF, a następnie operator kliknął w przycisk [Generuj dokument] (desktop)/ [Generuj dokument] (web)/ [Generuj dokument] (Android)/ [Generuj dokument] (iOS)
Jeśli dokument o podanym numerze KSeF istnieje w Comarch ERP XL, wówczas próba wygenerowania dokumentu zakończy się niepowodzeniem i zostanie wyświetlony komunikat: „Dokument o podanym numerze KSeF już istnieje w systemie ERP”.
Komunikat informujący o tym, że dokument o podanym numerze KSeF znajduje się już w Comarch ERP XL – aplikacja desktop
Komunikat informujący o tym, że dokument o podanym numerze KSeF znajduje się już w Comarch ERP XL – aplikacja na Android
Komunikat informujący o tym, że dokument o podanym numerze KSeF znajduje się już w Comarch ERP XL – aplikacja iOS
Zmiany w aplikacjach mobilnych Comarch BPM
Zmiany funkcjonalne w wersji 2026.0.0
W wersji 2026.0.0 w aplikacjach mobilnych wprowadzono następujące poprawki i zmiany ergonomiczne:
Umożliwienie uruchomienia zdefiniowanych wydruków (raportów) z poziomu karty obiegu
W wersji 2026.0.0 w aplikacjach mobilnych Comarch BPM na systemy: Android i iOS umożliwiono uruchomienie zdefiniowanych wydruków (raportów) z poziomu karty obiegu. Z tego powodu wprowadzono następujące zmiany:
W ramach karty obiegu usunięto ikonę kosza i wprowadzono zamiast niej menu kontekstowe ( dla aplikacji na Android, dla aplikacji na iOS), w którym dostępne są dwie opcje:
Generuj wydruk – opcja dostępna, jeśli w aplikacji desktop na zakładce [Struktura organizacyjna] na karcie pracownika, na zakładce „Uprawnienia”, w ramach sekcji „Praca z dokumentem” zaznaczono „Tak” w polu „Wydruk standardowy”; po wyborze tej opcji otwierane jest okno wydruku
Usuń dokument – opcja dostępna, jeśli w aplikacji desktop na zakładce [Struktura organizacyjna] na karcie pracownika, na zakładce „Uprawnienia”, w ramach sekcji „Praca z dokumentem” zaznaczono „Tak” w polu „Usuwanie dokumentów”; po kliknięciu w tę opcję dany dokument zostanie usunięty
Nowe menu rozwijane na karcie obiegu (Android)
Nowe menu rozwijane na karcie obiegu (iOS)
Okno wydruku (Android)
Okno wydruku (iOS)
W aplikacji na system Android na zakładce „Konto” dodano nową sekcję „Wydruk dokumentów”, w ramach której operator może zaznaczyć opcję „Ukryj przebieg etapów” – wówczas na wydruku nie będzie widoczny przebieg etapów dla danego dokumentu. Analogiczne ustawienie dotyczące ukrywania etapów zostało dodane bezpośrednio na zakładce „Konto” w aplikacji iOS.
Zakładka „Konto“ z nową sekcją „Wydruk dokumentów (Android)
Sekcja „Wydruk dokumentów“ (Android)
Ogólne zmiany w aplikacji na Android
W ramach aplikacji mobilnej na Android wprowadzono dodatkowo następujące zmiany:
Opcja czyszczenia wszystkich filtrów (także typu lub/oraz rodzaju) dla dokumentów za pomocą jednego przycisku – „Usuń filtry“, tak, aby przywrócone zostały początkowe ustawienia listy dokumentów („U mnie”, „Wszystkie typy”, „Filtry”);
Widok przycisku „Usuń filtry“ w aplikacji na Android
Skalowanie załączników – kiedy operator otworzy podgląd załącznika tak, że można go przybliżać, wówczas obszar przybliżenia jest zmaksymalizowany na cały widok (podgląd ma być widoczny w całości, można przybliżyć załącznik na całym obszarze widoku).
Ogólne zmiany w aplikacji na iOS
W ramach aplikacji mobilnej na iOS wprowadzono dodatkowo następujące zmiany:
Ukrywanie klawiatury tak, aby nie zasłaniała wartości na liście i zatwierdzanie tekstu w aktywnym polu – do klawiatury dodano przycisk systemowy „Gotowe“ („Done“), w który można kliknąć, aby zamknąć klawiaturę;
Widok przycisku „Done“ („Gotowe“) w aplikacji na iOS
Uzupełnianie pól tekstowych rozpoczyna się automatycznie wielką literą;
Rozwiązanie problemu ergonomicznego dotyczącego zapisu kontrolki typu Dokumenty w obiegu – zlikwidowanie automatycznego focusa, gdy wybrano przycisk „Dodaj“, tak, aby jako pierwszy wyświetlał się pełny komunikat z opcją tworzenia nowego dokumentu w ramach obiegu, nieprzysłonięty klawiaturą.
Wprowadzenie klucza “KSeFProdVersion“ do przełączania wersji produkcyjnej KSeF
Zmiany funkcjonalne w wersji 2026.0.0
Uwaga
W wersji 2026.0.0 wprowadzono nowy klucz “KSeFProdVersion“, który ma umożliwić zmianę wersji KSeF dla pracy w trybie produkcyjnym. Klucz może przyjmować jedną z następujących wartości:
1 – wartość domyślna w wersji 2026.0.0; możliwa jest praca w trybie produkcyjnym KSeF 1.0
2 – możliwa jest praca w trybie produkcyjnym KSeF 2.0
Praca w trybie produkcyjnym KSeF 2.0 będzie możliwa jedynie wtedy, gdy <add key=”KSeFWorkMode” value=”Production” /> oraz <add key=”KSeFProdVersion” value=”2″ /> – ten tryb pracy będzie aktywny dopiero po uruchomieniu przez Ministerstwo Finansów środowiska produkcyjnego KSeF 2.0, tj. po 01.02.2026.
Klucz “KSeFProdVersion“ nie wpływa na pracę w trybie „Test“ oraz „Demo“.
Ustawiono także wartość „Production“ jako wartość domyślną dla klucza KSeFWorkMode.