Błąd walidacji KSeF w Optimie: „Nieprawidłowy format wartości” – jak wysłać zablokowaną korektę?

Znasz tę sytuację? Wgrywasz najnowszą aktualizację systemu (np. 2026.5.1), chcesz wysłać fakturę do KSeF, a na ekranie pojawia się ściana tekstu o błędach walidacji i niespełnieniu wymaganego wzorca.

O ile przy nowej fakturze możesz ją po prostu wycofać do bufora, wyczyścić kontrahenta i załadować jego dane od nowa, o tyle przy fakturze korygującej trafiasz na ścianę. Dane nabywcy są tam całkowicie zablokowane. System nie pozwala poprawić błędnego wpisu na samym dokumencie, a platforma ministerstwa twardo odrzuca plik XML. Co dokładnie blokuje wysyłkę i jak z tego wybrnąć?

Zły format, czyli dlaczego KSeF odrzuca dokument?

Komunikat o błędzie: „Wartość ‘7340009446’ nie spełnia wymaganego wzorca” jest wbrew pozorom bardzo nietypowy. Zazwyczaj Comarch precyzyjnie informuje w logach walidacji, z jakim dokładnie polem jest problem (np. pojawia się informacja, że minimalna liczba znaków to 2, albo że występuje błędna struktura ID-wew). W tym przypadku komunikat jest jednak niepokojąco ogólny – sam producent raczej nie przewidział takiego scenariusza.

Prawdziwą przyczyną blokady jest to, że NIP trafił w zupełnie nieodpowiednie pole. Może to być efekt “namieszania” z oddziałami lub łączeniem kart. Jednak bardzo prawdopodobnym scenariuszem jest to, że dokument został dodany poprzez zewnętrzną aplikację. Wtedy pole, w którym błędnie zapisano NIP, może być w ogóle niewidoczne z poziomu interfejsu Optimy. Błąd da się zlokalizować dopiero po zejściu “pod bazę” (czyli analizując strukturę bezpośrednio na poziomie bazy danych).

Jak odblokować wysyłkę faktury korygującej?

Wiele osób myśli, że wystarczy poprawić kartę kontrahenta i po prostu wysłać dokument jeszcze raz. Niestety to tak nie działa. Kiedy Optima pobierze już błędne dane na dokument, sama poprawa w kartotece głównej nic nie da, bo dokument “pamięta” stary, zły wpis.

Aby naprawić ten błąd i odblokować wysyłkę, wykonaj następujące kroki:

1. Przejdź do głównej bazy (Ogólne -> Kontrahenci).

2. Znajdź kartotekę problematycznego kontrahenta, sprawdź pola i popraw błędnie przypisane wartości (np. wyczyść numery NIP z niewłaściwych rubryk). Zapisz zmiany.

3. Wróć do zablokowanej faktury korygującej.

4. Zaktualizuj dane na samym dokumencie. Użyj prawego przycisku myszy na fakturze i wybierz opcję aktualizacji danych kontrahenta (funkcja ta jest dostępna, o ile Twój operator ma do niej nadane uprawnienia).

5. Dopiero po zaktualizowaniu danych bezpośrednio na dokumencie ponów próbę wysyłki do KSeF.

Dzięki ręcznemu wymuszeniu aktualizacji na poziomie samego dokumentu, Optima nadpisze “zepsute” dane tymi świeżo poprawionymi w kartotece. Wtedy walidacja powinna przejść bez problemu.

Perspektywa ELTE-S: Higiena bazy to klucz do sukcesu z KSeF

Problemy z walidacją formatów to doskonały dowód na to, jak rygorystyczny i bezlitosny pod kątem ustandaryzowanych danych jest KSeF. Jeśli w bazie kontrahentów panuje bałagan (błędne i podwójne kody krajów, numery NIP z myślnikami, powciskane w złe pola prefiksy), błędy podczas wysyłki będą pojawiać się przy co drugiej operacji.

Brak systematycznego audytu i weryfikacji bazy danych przed pełnym wejściem e-Faktur w życie po prostu zemści się podwójnie w postaci zablokowanych dokumentów i nieotrzymanych płatności.

Jeśli wciąż masz problemy z masową walidacją bazy danych lub optymalizacją procesu KSeF w swojej Optimie, chętnie pomożemy.

Przebudowa drzewa grup towarowych w Comarch ERP Optima pod e-Sklep i B2B – jak to zrobić bezpiecznie?

Uruchamiasz nowy kanał sprzedaży (np. platformę B2B) obok istniejącego już Comarch e-Sklep i nagle okazuje się, że Twoje obecne drzewo grup towarowych w Optimie nie pasuje do nowej rzeczywistości.

Znasz tę sytuację?

Zamiast jednej głównej gałęzi, potrzebujesz poziomu pośredniego, żeby sprawnie rozdzielić asortyment. Wielu przedsiębiorców obawia się takiej przebudowy, bojąc się zepsucia obecnej synchronizacji ze sklepem. Jak więc bezpiecznie przenieść i zreorganizować setki lub tysiące produktów?

Zmiana struktury to zadanie dla Optimy, nie e-Sklepu

Wiele osób szuka rozwiązania po stronie panelu samego sklepu internetowego. Tymczasem cała reorganizacja musi odbyć się w Twoim systemie Comarch ERP Optima. E-Sklep jedynie “odczytuje” to, co mu wyślesz.

Dlatego zadanie polega na zbudowaniu całkowicie nowego drzewka towarowego obok starego w Optimie. Dopiero na samym końcu, po zbudowaniu nowej struktury i przypisaniu produktów, w konfiguracji e-Sklepu zmieniasz ustawienia i wskazujesz nowy “korzeń” (główny węzeł dla danego sklepu).

Jak sprawnie przepiąć produkty do nowych grup?

Samo stworzenie folderów to najprostszy etap. Prawdziwe wyzwanie to poprawne umieszczenie w nich towarów. Masz do wyboru dwie ścieżki:

Opcja A: Ręczne operacje seryjne (dla małych baz)

Jeśli masz stosunkowo mało produktów i grup, możesz stworzyć nową strukturę ręcznie, a następnie wykorzystać wbudowane w Optimę operacje seryjne. Pozwalają one na zbiorcze przepięcie zaznaczonych towarów do nowych węzłów. Wymaga to jednak sporo klikania i bardzo ostrożnego zaznaczania rekordów.

Opcja B: Automatyzacja z pliku Excel (dla dużych baz)

Gdy mówimy o tysiącach produktów i skomplikowanym wielopoziomowym drzewie, ręczne przepinanie to murowane błędy i godziny zablokowanej pracy. Najlepszą praktyką jest przygotowanie np. arkusza Excel, w którym zestawiasz kod towaru z kodem nowej grupy (lub z całą nową ścieżką drzewa grupy).

Mając taki plik, proces zamyka się w kilku chwilach. Za pomocą dedykowanej funkcji dodatkowej system automatycznie wczytuje arkusz, samodzielnie zakłada brakujące grupy (węzły) i precyzyjnie przypina do nich produkty na podstawie kodów.

Perspektywa ELTE-S: Zautomatyzuj to i uniknij chaosu

Praca na “żywym organizmie”, jakim jest zsynchronizowany sklep internetowy, nie wybacza błędów. Ręczne odtwarzanie drzewa i pojedyncze przenoszenie towarów w Optimie często kończy się tym, że produkty znikają ze strony lub lądują w złych kategoriach.

W ELTE-S podchodzimy do takich zadań systemowo. Posiadamy gotowe narzędzia, które potrafią na podstawie przygotowanego Excela w mgnieniu oka zaktualizować nawet najbardziej rozbudowane drzewa grup towarowych, dbając o pełną spójność danych.

Błąd „BinarySecurityToken” przy eksporcie przelewów do Alior Banku w Optimie – jak to naprawić?

Automatyczna wymiana danych z bankiem (WebService) to ogromna wygoda. Niestety, proces autoryzacji komunikacji z bankiem opiera się na certyfikatach i ścisłej weryfikacji uprawnień. Czasem drobny brak w konfiguracji potrafi zablokować wypuszczenie paczki przelewów.

Częstym problemem, z którym spotykają się użytkownicy integrujący Optimę z Alior Bankiem, jest komunikat pojawiający się zaraz po podpisaniu przelewów certyfikatem:

„Nie znaleziono elementu BinarySecurityToken w nagłówku przychodzącej wiadomości.”

Zastanawiające jest to, że nierzadko na tym samym serwerze w innej bazie (dla innej spółki) dokładnie taki sam mechanizm działa bez zarzutu. Gdzie zatem szukać przyczyny?

Sprawdź uprawnienia bankowe i Identyfikator kontekstu

Komunikat o braku tokena bezpieczeństwa zazwyczaj wskazuje na to, że system bankowy nie jest w stanie poprawnie zidentyfikować lub zautoryzować żądania płynącego z Twojego systemu ERP.

W takiej sytuacji weryfikację zawsze zaczynamy od dwóch kroków:

Uprawnienia po stronie banku

Nawet jeśli masz wygenerowany poprawny certyfikat, upewnij się, że ten konkretny podmiot (firma, z której próbujesz wyeksportować przelewy) ma fizycznie aktywowane i przypisane uprawnienia do obsługi kanału WebService w systemie Alior Banku. Bez tego bank odrzuci połączenie.

Identyfikator kontekstu w Optimie

Drugim, najczęściej pomijanym elementem jest brak uzupełnionego “Identyfikatora kontekstu” w konfiguracji samego rejestru bankowego w systemie Comarch ERP Optima. Jest to unikalny numer przypisywany przez bank, który system musi dołączać do nagłówka wiadomości przy komunikacji.

Aby to sprawdzić:

Przejdź do formularza rejestru bankowego w Optimie (Kasa/Bank -> Rejestry kasowe/bankowe), wybierz odpowiedni rejestr i sprawdź, czy pole Identyfikator kontekstu zostało prawidłowo uzupełnione.

Certyfikaty i bankowość potrafią płatać figle

Jeżeli uprawnienia są aktywne, identyfikator poprawnie wprowadzony, a certyfikat z pewnością przypisany do właściwej bazy, problem może leżeć w samej konfiguracji sterowników lub lokalnych blokadach na stacji roboczej.

Gdy pojawiają się problemy z komunikacją bankową, na które standardowe kroki nie pomagają, zachęcamy do kontaktu. W ELTE-S chętnie przyjrzymy się tej sprawie i pomożemy przywrócić poprawną wymianę danych.

Seryjny zapis wizualizacji faktur zakupowych z KSeF w Optimie – czy to możliwe?

Pobierasz faktury zakupu z Krajowego Systemu e-Faktur i chcesz zarchiwizować je na dysku w formie czytelnych dokumentów PDF. Wchodzisz na listę, podglądasz pojedynczą fakturę i bez problemu zapisujesz jej wizualizację.

Znasz tę sytuację?

Problem pojawia się, gdy na koniec miesiąca musisz pobrać nie jedną, a na przykład sto takich faktur dla biura rachunkowego, zarządu lub po prostu do własnego archiwum. Naturalnym odruchem jest zaznaczenie wszystkich dokumentów na liście i szukanie opcji “zapisz seryjnie do PDF”. Niestety, przycisk nie istnieje lub nie działa tak, jakbyś tego oczekiwał.

Dlaczego nie mogę wyeksportować wielu faktur naraz?

Wielu użytkowników spędza godziny na przeszukiwaniu forów i instrukcji, myśląc, że to kwestia ukrytego parametru lub braku uprawnień. Prawda jest jednak znacznie prostsza i dotyczy samej wersji oprogramowania.

W systemie Comarch ERP Optima w wersji do 2026.4 mechanizm seryjnego eksportu wizualizacji faktur zakupowych pobranych z KSeF do plików PDF nie jest w pełni wspierany. Obecnie oprogramowanie pozwala jedynie na generowanie i zapisywanie wizualizacji pojedynczo – dokument po dokumencie.

Dla księgowości obsługującej duże wolumeny dokumentów jest to proces niezwykle żmudny i nieefektywny.

Kiedy możemy spodziewać się zmiany?

Rozwój narzędzi związanych z KSeF to obecnie jeden z priorytetów producenta. Środowisko księgowe mocno naciska na automatyzację tego obszaru, a funkcja seryjnego zapisu wizualizacji jest jedną z najczęściej zgłaszanych sugestii.

Z naszych analiz i doświadczenia wynika, że braki tego typu są bardzo szybko łatane. Istnieje ogromne prawdopodobieństwo, że opcja seryjnego pobierania paczki PDF-ów zostanie udostępniona w dużej aktualizacji systemu – najpewniej w wersji 2026.5 lub kolejnych poprawkach.

Perspektywa ELTE-S: Bądź na bieżąco z aktualizacjami

Czekanie na oficjalną aktualizację producenta wymaga cierpliwości. W ELTE-S zawsze doradzamy, aby w przypadku takich braków upewnić się, czy dana funkcja nie pojawiła się w najnowszym wydaniu programu. Regularne aktualizowanie Optimy to gwarancja dostępu do najświeższych rozwiązań, zwłaszcza w tak dynamicznym obszarze jak KSeF.

Jeżeli brak seryjnego pobierania wizualizacji całkowicie paraliżuje Twoją pracę i nie możesz czekać na nową wersję, zapraszamy do rozmowy. Często jesteśmy w stanie wygenerować dedykowane skrypty eksportujące lub zaproponować rozwiązania poboczne dla masowego przetwarzania dokumentów.

Potrzebujesz pomocy z aktualizacją systemu lub optymalizacją pracy z KSeF?

Comarch OCR a KSeF po 31 lipca 2026 r. – czy musisz kupować dwa pakiety w Optimie?

Wielkimi krokami zbliża się koniec darmowego okresu dostępowego do wymiany dokumentów z Krajowym Systemem e-Faktur (KSeF) w systemach Comarch. Dla wielu użytkowników data 31 lipca 2026 roku rodzi sporo pytań o koszty i konieczność wykupywania dodatkowych licencji czy pakietów.

Szczególne wątpliwości mają firmy, które od dawna korzystają już z usługi Comarch OCR (służącej do automatycznego sczytywania danych z faktur kosztowych). Czy mając aktywny pakiet OCR, musisz dodatkowo kupować osobny pakiet Comarch KSeF, aby pobierać e-faktury z ministerstwa?

Masz Comarch OCR? Nie musisz kupować Comarch KSeF

Dobra informacja jest taka: nie musisz zamawiać osobnego pakietu Comarch KSeF.

Jeżeli w Twojej firmie działa już Comarch OCR (w usłudze Comarch OCR&KSeF), będziesz miał nieprzerwany dostęp do KSeF również po 31 lipca 2026 r. Jedyne, o czym bezwzględnie musisz pamiętać, to aktualizacja programu – do poprawnego działania wymagana jest Optima w wersji co najmniej 2026.4.1.

Po zakończeniu darmowego okresu promocyjnego, system zacznie po prostu automatycznie pobierać opłaty (strony/dokumenty) z Twojej bieżącej puli pakietu OCR.

Brzmi wygodnie, prawda?

Zanim jednak uznasz temat za zamknięty, warto przyjrzeć się kosztom.

Wygoda vs ekonomia: dlaczego warto jednak dokupić pakiet KSeF?

Brak przymusu zakupu nowego pakietu to jedno, ale opłacalność tego rozwiązania to zupełnie inna sprawa.

W praktyce rozliczanie pobranych z KSeF dokumentów z puli pakietu OCR jest najzwyczajniej w świecie bardzo drogie. Koszty przetwarzania dokumentów w usłudze OCR są nieporównywalnie wyższe niż w dedykowanej, tańszej usłudze Comarch KSeF. Jeśli pobierasz z urzędu dziesiątki lub setki faktur w miesiącu i system zacznie “zjadać” na to Twój drogi pakiet OCR, błyskawicznie przepalisz limit, za który słono zapłaciłeś.

Dlatego z czysto biznesowego punktu widzenia, najbardziej opłaca się dokupić dedykowany (tańszy) pakiet Comarch KSeF.

Co się stanie, gdy będę miał dwa pakiety naraz?

Comarch przewidział taką sytuację i rozwiązał to bardzo przyjaźnie dla portfela użytkowników. Możesz bez obaw posiadać jednocześnie usługi Comarch OCR&KSeF oraz Comarch KSeF.

Jeśli masz aktywne oba pakiety, system wbudowany w Optimę działa inteligentnie: w pierwszej kolejności zawsze zużywa pulę z tańszego rozwiązania, czyli Comarch KSeF. Twój droższy pakiet OCR pozostaje nienaruszony i jest wykorzystywany wyłącznie do tego, do czego został stworzony – czyli do skanowania tradycyjnych papierowych faktur i PDF-ów.

Jeśli masz wątpliwości, jak zoptymalizować koszty usług chmurowych i pakietów w swojej Optimie – jesteśmy do dyspozycji.