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.

 

Widok klucza “KSeFProdVersion“