Masz wykupiony i aktywny pakiet KSeF, Optima poprawnie rozlicza go przy pobieraniu faktur zakupu, ale gdy próbujesz pobrać faktury przez BPM, proces pokazuje liczbę dokumentów do pobrania i natychmiast się przerywa z komunikatem “Wystąpiły błędy w zapisie”. To jeden z tych błędów, który wygląda na problem z KSeF, a w rzeczywistości jest problemem konfiguracji serwera BPM – dokładnie tam, gdzie BPM szuka informacji o Twoim kluczu licencyjnym.
Dlaczego BPM nie widzi Twojego pakietu KSeF, mimo że Optima go widzi
Comarch ERP BPM i Comarch ERP Optima to dwa różne procesy, które mogą korzystać z różnych kluczy wirtualnych. Jeli pakiet KSeF został aktywowany na osobnym kluczu wirtualnym niż ten, z którego standardowo korzysta moduł DMS w BPM, to serwer aplikacyjny BPM (IIS) nie ma skąd wiedzieć, że ma po ten klucz sięgnąć – i próba zapisu dokumentów pobranych z KSeF kończy się błędem. Kluczowy jest tu plik Web.config w katalogu BPMBPMSRVAPP na serwerze, w którym znajdują się dwa wpisy: LicenceKeyServerDMS (klucz standardowo używany przez moduł DMS) i opcjonalny LicenceKeyServerKSeF (dedykowany klucz używany wyłącznie przez integrację KSeF – jeśli zdefiniowany, BPM użyje go zamiast LicenceKeyServerDMS).
Krok po kroku – jak naprawić konfigurację
Krok 1 – sprawdź, czy pakiet KSeF jest na innym kluczu wirtualnym niż BPM/DMS
W Menadżerze Kluczy sprawdź, na którym kluczu wirtualnym siedzi Twoja licencja BPM/DMS, a na którym pakiet KSeF. Jeli to dwa różne numery klucza – to jest źródło problemu i musisz wykonać kroki poniżej. Jeli to ten sam klucz, problem leży gdzie indziej (uprawnienia użytkownika w BPM, wersja BPM – patrz Krok 4).
<screen>
Krok 2 – otwórz Web.config w katalogu BPMBPMSRVAPP na serwerze
Na serwerze aplikacyjnym BPM przejdź do katalogu instalacyjnego BPM, podkatalog BPMSRVAPP, i otwórz plik Web.config w edytorze tekstu (np. Notepad++, z uprawnieniami administratora). Znajdź sekcję z wpisami LicenceKeyServerDMS i LicenceKeyServerKSeF.
<screen>
Krok 3 – wpisz numer klucza KSeF w polu LicenceKeyServerKSeF
W wartości wpisu LicenceKeyServerKSeF wpisz sam numer klucza, na którym masz aktywowany pakiet KSeF – nie format “serwer::numer_klucza” (mimo że komentarz w pliku to sugeruje, w praktyce ten format często nie działa). Zapisz plik, zrestartuj usługę IIS/BPM na serwerze, żeby zmiana została wczytana, i spróbuj ponownie pobrać faktury z KSeF przez BPM.
<screen>
Krok 4 – sprawdź wersję BPM i zaktualizuj, jeli trzeba
Integracja KSeF w BPM jest wspierana od wersji 2026.1.1 wzwyż. Jeli masz starszą wersję (np. 2026.0.0), w Web.config może nawet nie być wpisu LicenceKeyServerKSeF – w takim przypadku najpierw zaktualizuj BPM do wersji wspieranej i dołącz najnowszy dostępny QuickFix, a następnie wróć do Kroku 2 i 3.
<screen>
Krok 5 – zweryfikuj uprawnienia użytkownika do zapisu dokumentów w Optimie
Jeli po poprawieniu klucza błąd nadal się powtarza, sprawdź, czy użytkownik, na którym działa proces BPM, ma odpowiednie uprawnienia do dodawania dokumentów w Optimie (moduy Handel/Księgowość, w zależności gdzie trafiają faktury z KSeF). Warto też porównać konfigurację KSeF/firmy i ścieżek w BPM z inną bazą/firmą, gdzie proces działa poprawnie, oraz przetestować na jednym, prostym szablonie procesu.
<screen>
Krok 6 – włącz logowanie w BPM/DMS, jeli błąd nadal się powtarza
Sam komunikat “Wystąpiły błędy w zapisie” jest zbyt ogólny, aby jednoznacznie zdiagnozować przyczynę, jeli powyższe kroki nie pomogą. Włącz szczegółowe logowanie w BPM/DMS, sprawdź, który krok procesu faktycznie zwraca błąd, i przekaż logi partnerowi do analizy.
<screen>
Perspektywa ELTE-S
Ten błąd jest dobrym przykładem tego, dlaczego przy wdrożeniach z wieloma modułami (BPM + KSeF + DMS) warto od razu na etapie aktywacji pakietu KSeF zweryfikować, na którym kluczu wirtualnym siedzi każdy moduł. Zaoszczędzi to godzin diagnostyki po fakcie, kiedy pakiet jest już opłacony, a integracja nie działa. Rekomendujemy też, aby przy każdej aktualizacji BPM sprawdzać zawartość Web.config po update – niektóre instalatory nadpisują ten plik i mogą zresetować ręcznie wprowadzone wpisy takie jak LicenceKeyServerKSeF.
Porozmawiajmy o poprawnej konfiguracji integracji BPM i KSeF w Twojej firmie.