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.
