Wersja 2025.1.6 Comarch ERP XL doczekała się zestawu poprawek, które nie zostały zaszyte w standardowym instalatorze – trzeba je pobrać oddzielnie i wgrać w bazie. Najczęściej pojawia się to w kontekście błędu powiązania użytkownika SQL wykorzystywanego przez XL do wysyłki do KSeF, który na tej wersji potrafi zablokować otwarcie sesji lub wysyłkę zbiorczą faktur. Składają się na to skrypty SQL do puszczenia w bazie firmowej. Poniżej gdzie je znajdziesz i jak bezpiecznie zaaplikować.
Gdzie są poprawki do 2025.1.6
Comarch udostępnia hotfixy do wersji 2025.1.6 przez usługę iBard – jest to dedykowany link do folderu z pakietem plików (skrypty .SQL, ewentualne pliki .DLL do modułu KSeF i plik z instrukcją/ReadMe). Aktualny odnośnik do pobrania:
https://www.ibard.com/d/ff77223d5c3c7e15f43173e1195064bc749088c9#/folder.
Otwierasz link w przeglądarce, pobierasz cały folder na serwer, na którym stoi baza XL (albo na maszynę administratora z dostępem do SQL Server).
Co konkretnie naprawiają skrypty w 2025.1.6
Gros poprawek dotyczy modułu KSeF. W kilku scenariuszach instalator 2025.1.6 nie ustawia poprawnie powiązania użytkownika SQL wykorzystywanego przez XL do komunikacji z KSeF – efektem są:
– błędy 401/400 przy otwarciu sesji KSeF i przy wysyłce zbiorczej (SendBatch, OpenBatchSessionAsync),
– rozbieżności w tabeli cdn.KSeFTokeny – “martwe” wpisy, których XL nie potrafi odnowić,
– brak zapisu UPO albo status faktury utykający na “wysłana” bez potwierdzenia,
– błędne uprawnienia użytkownika technicznego SQL, który ma pisać do tabel KSeF.
Skrypty korygują uprawnienia, sprzątają nieprawidłowe wpisy i przywracają poprawne mapowanie użytkownika SQL – operatora KSeF.
Krok po kroku – jak bezpiecznie wgrać poprawki
Krok 1 – pobierz pakiet z iBard
Otwórz link do folderu na iBard i pobierz wszystkie pliki (nie pojedyncze). W folderze powinny być skrypty .SQL, ewentualnie plik ReadMe z opisem i kolejnością wykonania. Zapisz je w lokalizacji dostępnej z SQL Server Management Studio.
Krok 2 – zrób pełny backup bazy firmowej
Zanim czegokolwiek dotkniesz, wykonaj backup FULL bazy firmowej XL (SSMS → prawy klik na bazę → Tasks → Back Up…). Alternatywa dla środowisk zwirtualizowanych: snapshot maszyny SQL Server. Bez tego kroku nie zaczynaj – skrypty piszą do bazy i nie każdy z nich można cofnąć przez ROLLBACK po commicie.
Krok 3 – wyloguj użytkowników i wyłącz usługi Comarch
Wyślij informację do zespołu i wyloguj wszystkich operatorów z Comarch ERP XL. Na serwerze wyłącz usługi Comarch (m.in. Comarch ERP Serwis Operacji Automatycznych, Comarch ERP Automat Synchronizacji, usługi związane z KSeF). To pozwala uniknąć konfliktów blokowania tabel przy uruchamianiu skryptów.
Krok 4 – uruchom skrypty w kolejności z ReadMe
W SSMS otwórz nową sesję, przełącz kontekst na właściwą bazę firmową (nie master, nie tempdb, nie dbo domyślny) i uruchamiaj skrypty pojedynczo w kolejności wskazanej w ReadMe lub według numeracji w nazwach plików. Po każdym skrypcie zweryfikuj, że zakończył się bez błędów – nie uruchamiaj kolejnego, jeśli poprzedni rzucił wyjątkiem.
Krok 5 – uruchom usługi i zweryfikuj sesję KSeF
Włącz usługi Comarch z powrotem, uruchom Comarch ERP XL, zaloguj się na operatora używanego do KSeF.
W menu System → Sesja KSeF otwórz nową sesję i wykonaj test – pojedyncza wysyłka faktury i próba wysyłki zbiorczej (SendBatch). Jeśli poprzednio występowały błędy w cdn.KSeFTokeny lub OpenBatchSessionAsync unauthorized – po skryptach powinny zniknąć albo wymagać tylko ponownego uwierzytelnienia operatora (co odtworzy świeży wpis w tabeli KSeFTokeny).
Kilka zasad bezpieczeństwa przy takich hotfixach
Nie uruchamiaj skryptów “na produkcji z marszu”. Jeśli to możliwe, przetestuj je najpierw na kopii bazy – odtwórz kopię z ostatniego backupu na osobnej instancji SQL, puszczaj skrypty tam, sprawdź rezultat. Dopiero po pomyślnym teście replikujesz to na produkcji z nową kopią zapasową pod ręką.
Nie wgrywaj cudzych plików z iBard po linku, którego nie zna Twoja firma. Link z Comarch/forum społeczności jest legitymowany, ale przed uruchomieniem skryptu w bazie produkcyjnej zawsze przejrzyj jego treść – hotfix powinien mieć sensowny, opisowy komentarz na górze pliku i operować tylko na tabelach cdn.* związanych z problemem.
Dokumentuj wgranie poprawki. Zanotuj datę, które skrypty i w jakiej kolejności puściłeś, kto był operatorem SQL i jaki był stan przed/po (screen z błędem KSeF, screen z zakończoną wysyłką). To bezcenne przy audycie i przy następnej aktualizacji, kiedy trzeba będzie odtworzyć historię zmian.
Perspektywa ELTE-S
Hotfixy “po linku iBard” to normalna praktyka w świecie Comarch ERP XL – Comarch często tak dystrybuuje poprawki między oficjalnymi wersjami minor, bo szybciej jest udostępnić zestaw plików niż wypuścić pełną aktualizację. Nasza rada: potraktuj takie skrypty jako pełnoprawną zmianę w produkcji – z backupem, oknem serwisowym i checklistem. W obszarze KSeF w wersji 2025.1.6 widać wyraźnie, że Comarch dopiero stabilizuje mapowanie użytkownika SQL na operatora KSeF, więc warto mieć swój sprawdzony scenariusz na wypadek podobnych problemów przy kolejnych wersjach. Jeśli integracja z KSeF przechodzi Ci przez kilkadziesiąt baz klienckich – dobrze mieć to zautomatyzowane w formie własnego skryptu instalującego hotfix na wszystkie bazy jednym przebiegiem, zamiast klikania po kolei w SSMS.
Porozmawiajmy o uporządkowaniu procesu aktualizacji Comarch ERP XL i integracji KSeF u Twoich klientów.