FAQ – Najczęściej zadawane pytania dotyczące KSeF

Pytanie : Dlaczego w wersji Comarch BPM 2025.2.3 podczas pobierania dokumentów z z KSeF poprzez punkt ACD Import dokumentów z KSeF pojawia się komunikat:

Wystąpił błąd: KSeF2 AuthorizationWithKsefTokenAsync – Authorization failed: KSeF error code: 21180 – Nieprawidłowe żądanie.

 

 

Odpowiedź: Opisany problem wynika z technicznej aktualizacji adresów środowisk KSeF przeprowadzonej przez Ministerstwo Finansów. Zgodnie z oficjalnym harmonogramem resortu, w celu wdrożenia docelowej infrastruktury KSeF 2.0, z dniem 17 stycznia 2026 r. dotychczasowe adresy usług zostały całkowicie wyłączone (wyłączono przekierowania ze starych adresów).

W związku z powyższym, wersja 2025.2.3 Comarch BPM przestała wspierać komunikację z serwerami KSeF. Aby przywrócić pełną funkcjonalność i zapewnić ciągłość pracy, należy zaktualizować aplikację do wersji 2026.0.0 Comarch BPM.

Nowa wersja wspiera ujednoliconą adresację dla wszystkich środowisk:

  • środowisko przedprodukcyjne (Demo) – działające na nowych adresach (api-demo.ksef.mf.gov.pl),
  • środowisko produkcyjne (API KSeF 2.0) – które od 1 lutego 2026 r. będzie dostępne wyłącznie z wykorzystaniem nowej adresacji (api.ksef.mf.gov.pl).

Ważne
Wersja 2026.0.0 jest obecnie jedynym wydaniem systemu Comarch BPM, które posiada zaktualizowane ścieżki dostępu do serwerów Ministerstwa Finansów i zapewnia poprawną obsługę środowiska produkcyjnego po zmianach wchodzących w życie z początkiem lutego.

 

Pytanie: Dlaczego nie zapisują się dane do integracji z KSeF przy ustawionym trybie współpracy Demo?
Po wprowadzeniu numeru NIP i tokenu i kliknięciu Zapisz dane znikają.

Odpowiedź: Wraz z przejściem Ministerstwa Finansów na API 2.0  dla KSeF  tryb Demo zmienił się format i długość tokenów autoryzacyjnych. Jeśli w systemie zapisany jest jeszcze stary (krótszy) token, baza danych Comarch BPM może blokować wpisanie nowego, dłuższego ciągu znaków, co powoduje błędy walidacji i uniemożliwia zapisanie zmian. Aby skutecznie wprowadzić nowy token, należy wykonać następujące kroki:

1. W tabeli do.DF_ConfCMDictionary, w polu CMD_KSeFToken należy wstawić wartość NULL

2. Uzupełnienie danych: Z poziomu Comarch BPM nalezy wejść w ustawienia integracji z KSeF.

3. Wstawić nowy token i zapisać wprowadzone zmiany.

 

Pytanie: Kiedy będzie możliwe skonfigurowanie BPM na odbiór faktur z wykorzystaniem certyfikatu, a nie tokenu?

Odpowiedź: Obsługa autoryzacji za pomocą certyfikatu została zaplanowana w wersji Comarch BPM 2026.0.1. Do tego czasu należy korzystać z tokenów generowanych w Aplikacji Podatnika KSeF.

 

Pytanie: Czy na dokumentach w Comarch ERP XL, które zostały wygenerowane przez Comarch BPM (po pobraniu z KSeF), parametr „Poza systemem” powinien być zaznaczony?

Odpowiedź: Tak. Jest to działanie prawidłowe. Zaznaczony checkbox „Poza systemem” jest informacją, że dany dokument nie został wystawiony bezpośrednio w ERP XL, lecz trafił do niego z zewnątrz (poprzez Comarch BPM).

 

Pytanie: Czy Comarch BPM w wersji 2026.0 obsługuje pieczęć elektroniczną do KseF?

Odpowiedź: Wsparcie dla wykorzystania kwalifikowanej pieczęci elektronicznej do uwierzytelniania w KSeF w wersji 2026.0 jest zapewnione. Generowanie tokenu KSeF odbywa się z poziomu aplikacji po uzupełnieniu NIP firmy oraz zainstalowaniu kwalifikowanej pieczęci elektronicznej. Tryb pracy KSeF (Demo/Production) konfigurowany jest w pliku Web.config za pomocą klucza KSeFWorkMode. Po wygenerowaniu token zostaje automatycznie zapisany w polu Token KSeF.

Link do dokumentacji: https://pomoc.comarch.pl/bpm/index.php/dokumentacja/konfiguracja-wspolpracy-comarch-bpm-z-ksef/

 

Pytanie: Czy można importować tylko wybrane faktury zakupu do Comarch BPM?

Odpowiedź: Możliwe jest dokonanie importu wg poniższych kryteriów:

  • Nowe – import dokonywany w tym trybie polega na pobraniu tych faktur, które zostały zarejestrowane od ostatniego importu tj. faktur z datą przyjęcia w KSeF równą i większą od daty dotąd pobranych faktur.
  • Za okres – importowane są faktury z datą przyjęcia w KSeF należącą do podanego przez Użytkownika okresu
  • Numer KSeF – importowana jest faktura o konkretnym, podanym przez Użytkownika numerze KSeF

 

Pytanie: Dlaczego podczas próby importu dokumentów z KSeF z poziomu Comarch BPM, którego folder z desktopem znajduje się w folderze z XL-em pojawia się komunikat o „Odmowie dostępu” do ścieżki …\DMS Desktop\Chrome\… lub nie można odnaleźć określonego pliku?

Przykład komunikatów:

Odmowa dostępu do ścieżki „C:\Program Files (x86)\Comarch ERP XL 2025.1\DMS Desktop\Chrome\Win64-124.0.6367.201\chrome-win64\D3DCompiler_47.dll”.

Odmowa dostępu do ścieżki „C:\Program Files (x86)\Comarch ERP XL 2025.1\DMS Desktop\ChromeHeadlessShell\Win64-124.0.6367.201\chrome-headless-shell-win64\chrome-headless-shell.exe”.

Lub

Nie można odnaleźć określonego pliku

Odpowiedź: Przy pierwszej próbie pobrania faktur, system próbuje pobrać i wypakować niezbędne biblioteki przeglądarki (Chromium) do wskazanego w komunikacie folderu. Folder Program Files jest domyślnie chroniony przez Windows. Zwykły użytkownik nie ma uprawnień do zapisu (tworzenia folderów i rozpakowywania plików .exe/.dll) w tej lokalizacji. Jednorazowe uruchomienie procesu (np. BPM.exe lub całego ERP XL) jako Administrator pozwala systemowi „doinstalować” brakujące komponenty do odpowiednich podfolderów. Gdy pliki już tam będą, zwykły użytkownik będzie mógł z nich korzystać (tylko do odczytu/uruchomienia), co rozwiąże problem.

 

Pytanie: Dlaczego podczas próby importu dokumentów z KSeF z poziomu Comarch BPM pojawia się komunikat:

KSeF2 GetInvoiceAsync – Error downloading invoice 6871728417-20260101-1100C0F60040-A5: GetInvoiceByKsefAsync failed: Too many requests. Please wait before sending more requests.

Odpowiedź: Komunikat ten pochodzi bezpośrednio z serwerów KSeF. Oznacza on, że w krótkim czasie wysłano zbyt dużą liczbę zapytań do bramki Ministerstwa Finansów. Należy odczekać od kilku do kilkunastu minut i spróbować ponownie. Problem ten często ustępuje samoistnie po ustaniu chwilowego przeciążenia serwerów rządowych.

 

Pytanie: Dlaczego nie zapisują się dane do integracji z KSeF ? Po wprowadzeniu numeru NIP i tokenu i kliknięciu Zapisz dane znikają.

Odpowiedź: Gdy Ministerstwo Finansów przeszło na API 2.0, zmienił się format i długość generowanych tokenów. Jeśli w bazie danych (tabela do.DF_ConfCMDictionary, pole CMD_KSeFToken) znajduje się stary token, system często „gubi się” podczas próby nadpisania go nowym, dłuższym ciągiem znaków lub występuje konflikt walidacji. Należy w polu CMD_KSeFToken wstawić wartość NULL, uzupełnić dane integracji z KSeF z poziomu Comarch BPM i zapisać wprowadzone zmiany.

 

Pytanie: Dlaczego podczas generowania dokumentu do Comarch ERPXL pojawia się komunikat:

„Błąd XL Api. W funkcji XLKSeFUstalStatusDokumentu wystąpił błąd nr -400:”

Odpowiedź: Użytkownik, który generuje dokument do XL-a musi mieć na swojej karcie operatora w XL-u na zakładce Ustawienia->Parametry zaznaczony parametr:

Edycja numeru KSeF na dok./Spinanie z KSeF na zatw. dok.

 

Pytanie: Czy w Comarch BPM jest możliwy do obsłużenia poniższy scenariusz:

  1. Wchodzę do XL/Optimy
  2. Pobieram dokumenty z KSEF
  3. Wchodzę do BPM – wybieram punkt ACD
  4. Pobieram dane z tabel KSEF XL/Optima
  5. Pobieram załącznik (wizualizację dokumentu KSeF)
  6. Generuję dokument w BPM
  7. Procesuję go – na odpowiednim etapie dodaję w ERP z informację o zatwierdzeniu dokumentu

Odpowiedź: Wszystkie punkty, oprócz punktu 5 są możliwe do obsłużenia w Comarch BPM. Na chwilę obecną nie jest możliwa wizualizacja dokumentów KSeF pobranych z ERP w punkcie ACD. Funkcjonalność jest zaplanowana do realizacji w kolejnych wersjach.

 

Pytanie: Czy dostępna jest dokumentacja pól KSeF z mapowaniem na BPM?

Odpowiedź: Schemat Mapowania Danych z Plików XML (struktura KSeF) do Konkretnych Tabel w Comarch BPM dostępna jest na stronach pomocowych pod linkiem:

https://pomoc.comarch.pl/bpm/index.php/dokumentacja/schemat-mapowania-danych-z-plikow-xml-struktura-ksef-do-konkretnych-tabel-w-comarch-bpm/

 

Pytanie: Dlaczego podczas importu dokumentów z KSeF (Tryb współpracy- Import dokumentów z KSeF) pojawia się komunikat:

Wystąpił błąd. Nieprawidłowa długość tablicy lub ciągu znaków Base-64.

Odpowiedź: Gdy Ministerstwo Finansów przeszło na API 2.0, zmienił się format i długość generowanych tokenów. Jeśli w bazie danych (tabela do.DF_ConfCMDictionary, pole CMD_KSeFToken) znajduje się stary token, system często „gubi się” podczas próby nadpisania go nowym, dłuższym ciągiem znaków lub występuje konflikt walidacji. Należy w polu CMD_KSeFToken wstawić wartość NULL, uzupełnić dane integracji z KSeF z poziomu Comarch BPM i zapisać wprowadzone zmiany.

 

Pytanie: W pliku Web.config aplikacji serwerowej mam ustawiony tryb KSeFWorkMode na „Demo”. W jaki sposób mogę wygenerować token do komunikacji z KSeF?

Odpowiedź: Aby wygenerować token autoryzacyjny dla trybu Demo, należy skorzystać z oficjalnego portalu serwisowego Ministerstwa Finansów przeznaczonego dla środowiska testowego. Należy postąpić zgodnie z poniższymi krokami:

1. Logowanie: Należy wejść na stronę  https://web2tr-ksef.mf.gov.pl/web/ i zalogować się do aplikacji (np. przez Profil Zaufany, podpis kwalifikowany lub pieczęć elektroniczną).

2. Sekcja Tokenów: Po zalogowaniu, z menu bocznego należy wybrać zakładkę „Tokeny” (dostępną w sekcji „Zarządzanie” lub „Uprawnienia”).

3. Generowanie: Po kliknięciu przycisku „Generuj token”, należy nadać mu nazwę własną oraz wybrać odpowiedni zakres uprawnień (np. wystawianie i przeglądanie faktur).

4. Zapisanie danych: Po zatwierdzeniu system wyświetli unikalny ciąg znaków (token).

Ważne

Token należy skopiować i zapisać w bezpiecznym miejscu natychmiast, ponieważ po zamknięciu okna nie będzie możliwości jego ponownego odczytania.

5. Konfiguracja w Comarch BPM:

Aby skonfigurować współpracę Comarch BPM z KSeF przy użyciu wygenerowanego tokenu, należy wprowadzić go w systemie w następujący sposób:

  • Dla trybu jednospółkowego: Na zakładce Ustawienia -> zakładka Integracje.
  • Dla trybu wielospółkowego: Na zakładce Ustawienia -> zakładka Połączenia z ERP -> ustawienia odpowiedniej spółki.

W ramach powyższych ustawień należy uzupełnić dane:

1. W polu „Nip firmy” należy wprowadzić NIP firmy, dla której ma odbywać się współpraca z KSeF.

2. W polu „Token KSeF” należy wprowadzić wygenerowany wcześniej token uwierzytelniający.

Uwaga
Token wygenerowany w środowisku Demo nie będzie działał po zmianie trybu pracy aplikacji na „Production”. Tryb produkcyjny wymaga wygenerowania osobnego tokenu na innym portalu Ministerstwa Finansów.

 

Pytanie: W dniu 17.01.2026 zostały wyłączone stare adresy środowisk KSeF. W związku z tym proszę o informację co należy zmienić w najnowszej wersji BPM 2026.0.0 by móc korzystać z KSeF ?

Odpowiedź: W wersji Comarch BPM 2026.0.0 nowe adresy są już obsłużone. Użytkownik nie musi wprowadzać żadnych zmian.

 

Pytanie: Gdzie z poziomu Comarch BPM konfiguruje się współpracę z KSeF?

Odpowiedź: Konfiguracja połączenia z Krajowym Systemem e-Faktur (KSeF) odbywa się w panelu konfiguracyjnym, a jej lokalizacja zależy od trybu pracy systemu (jednospółkowy lub wielospółkowy).

Lokalizacja ustawień:

Wymagane dane do uzupełnienia:

W obu przypadkach, aby poprawnie skonfigurować współpracę, należy wypełnić poniższe pola:

1. NIP firmy – numer identyfikacji podatkowej podmiotu, dla którego będą procesowane e-Faktury.

2.Token KSeF – unikalny ciąg znaków (token autoryzacyjny) wygenerowany wcześniej w systemie KSeF (np. poprzez Aplikację Podatnika KSeF), który umożliwia bezpieczną komunikację między Comarch BPM a bramką rządową.

 

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?

Sprawdź Szkolenia Comarch BPM!

 

Powrót do początku artykułu