Błąd JPK w Optima: „Brakuje nr KSeF lub kodu OFF lub BFK lub DI” – Jak łączyć nowe znaczniki?

Nie mogę wysłać deklaracji VAT-7

Od 1 lutego 2026 roku obowiązuje nowa struktura JPK_V7(3), która wprowadza rygorystyczne zasady raportowania faktur w kontekście Krajowego Systemu e-Faktur. Najczęstszym problemem w programie Comarch ERP Optima jest komunikat: „Sprawdzam poprawność struktury pliku JPK”, po którym pojawia się lista błędów walidacji XML.

Błąd JPK w Optima: „Brakuje nr KSeF lub kodu OFF lub BFK lub DI” – instrukcja łączenia nowych znaczników KSeF ze starymi kodami dokumentów w strukturze JPK_V7(3).

Dlaczego widzę błąd „TypDokumentu” lub „K_21/K_42”?

Błędy typu: „ma nieprawidłowy element podrzędny element 'TypDokumentu’” wynikają z faktu, że w nowym schemacie JPK dane o KSeF muszą pojawić się w pliku przed kodami dokumentów (takimi jak WEW, RO czy FP). Jeśli w Rejestrze VAT brakuje numeru KSeF lub odpowiedniego znacznika (OFF, BFK, DI), struktura pliku XML zostaje przerwana, co uniemożliwia jego wysyłkę.

Nowe znaczniki KSeF (od 02.2026)

W nowej rzeczywistości każdy dokument w ewidencji musi posiadać jeden z poniższych atrybutów:

  • NrKSeF: 32-znakowy identyfikator dla e-faktur ustrukturyzowanych.

  • OFF (offline): Dla faktur wystawionych podczas awarii lub braku dostępu do KSeF, które są przesyłane do systemu po ustaniu problemów.

  • BFK (Brak Faktury KSeF): Kluczowy znacznik dla faktur papierowych, zagranicznych oraz wystawianych poza systemem.

  • DI (Dokument Inny): Oznaczenie dla specyficznych transakcji, np. importu towarów (art. 33a) lub not księgowych.

Interakcje znaczników: BFK, DI oraz WEW

Największą nowością w JPK_V7(3) jest konieczność łączenia nowych znaczników KSeF z dotychczasowymi kodami typów dokumentów. Sam kod WEW lub FP to już za mało.

Oto najczęstsze poprawne kombinacje:

  • BFK + WEW: Obowiązkowe dla dokumentów wewnętrznych (np. korekta roczna, import usług, nieodpłatne przekazania), które z natury nie posiadają numeru KSeF.

  • DI + WEW: Stosowane przy dokumentach wewnętrznych służących do wykazania VAT należnego.

  • BFK + FP: Faktury do paragonów wystawione poza systemem KSeF (opcja dostępna do końca 2026 roku).

  • BFK + TP: Faktury od podmiotów powiązanych, jeśli zostały wystawione w formie papierowej lub elektronicznej poza KSeF.

Potrzebujesz aktualnej wersji COMARCH ERP OPTIMA, wpisz NIP/nazwę firmy i adres e-mail na który otrzymasz najnowszą wersję oprogramowania.



    Jak naprawić błędy w Comarch ERP Optima?

    1. Zweryfikuj listę błędów: Jeśli log wskazuje na brak kodu OFF/BFK/DI, przejdź do Rejestru VAT.
    2. Uzupełnij znaczniki: Na każdym dokumencie wykazanym w błędzie wejdź w zakładkę „KSeF/JPK”. (Tu opis jak to można zrobić dla wielu dokumentów: https://www.systemyit.pl/nowe-kody-w-jpk-od-1-lutego-off-bfk-di-jak-wprowadzic-w-optima/ )
    3. Zastosuj odpowiednią parę: Jeśli to dokument wewnętrzny, upewnij się, że obok pola „Typ dokumentu: WEW” zaznaczono również parametr „BFK” lub „DI”.
    4. Seryjna edycja: Aby zaoszczędzić czas, skorzystaj z Operacji Seryjnych w Rejestrze VAT, które pozwalają zbiorczo nadać znaczniki KSeF dla zaznaczonych faktur:

    Pamiętaj: Brak któregokolwiek z oznaczeń (NrKSeF/OFF/BFK/DI) jest obecnie traktowany jako błąd struktury, który uniemożliwia poprawne złożenie deklaracji i może skutkować wezwaniem do wyjaśnień z Urzędu Skarbowego.

    W artykule opisujemy jak wstawić seryjnie brakujące kody:

    Wprowadzanie nowych kodów JPK NRKSeF, OFF, BFK, DI w programie Comarch ERP Optima

    Aktualności OPTIMA:
    https://www.systemyit.pl/category/aktualnosci/comarch-erp-optima/

    Pobieranie aktualnej wersji COMARCH ERP OPTIMA
    https://www.systemyit.pl/category/comarch-optima/aktualna-wersja-optima/

    Brakuje Ci wsparcia do OPTIMA , uzyskaj je błyskawicznie bez zawierania umów:
     https://www.systemyit.pl/help-desk/

     

    FAQ – Najczęściej zadawane pytania dotyczące błędów KSeF w JPK

    1. Co oznacza błąd „Na dokumencie brakuje nr KSeF lub kodu OFF lub BFK lub DI”? Jest to informacja o braku obowiązkowych danych wymaganych w strukturze JPK_V7(3) obowiązującej od 1 lutego 2026 roku. Każda faktura w ewidencji musi posiadać albo 32-znakowy numer KSeF, albo oznaczenie przyczyny jego braku (BFK, OFF lub DI). Bez tych danych plik JPK jest uznawany za niekompletny.

    2. Dlaczego Optima zgłasza błąd struktury XML (np. element TypDokumentu lub K_21)? W nowej schemie JPK_V7 kody KSeF muszą znajdować się w pliku XML przed informacjami o dacie sprzedaży czy typie dokumentu. Jeśli nie uzupełnisz znacznika (np. BFK), program generuje błędną kolejność tagów. Rozwiązaniem nie jest zmiana ustawień programu, lecz uzupełnienie brakujących kodów KSeF w Rejestrze VAT.

    3. Kiedy należy stosować znacznik BFK (Brak Faktury w KSeF)? Znacznik BFK stosuje się dla wszystkich faktur, które zostały wystawione poza systemem KSeF. Dotyczy to w szczególności:

    • Faktur dla osób fizycznych (B2C).

    • Faktur zagranicznych (import usług, WNT).

    • Faktur wystawionych przez podatników zwolnionych z VAT.

    • Faktur papierowych lub elektronicznych wystawionych poza systemem w okresach przejściowych.

    4. Jak oznaczać faktury wewnętrzne (WEW) w nowym JPK? Samo oznaczenie WEW jest obecnie niewystarczające. Dokumenty wewnętrzne muszą posiadać dodatkowy znacznik KSeF. Najczęściej stosuje się kombinację BFK + WEW (dla transakcji, które nie są e-fakturami) lub DI + WEW (dla pozostałych operacji wewnętrznych, np. korekt rocznych).

    5. Co zrobić, gdy w logu pojawia się błąd „w polu NIP zapisano BRAK”? Należy wejść do dokumentu w Rejestrze VAT i usunąć słowo „BRAK” z pola NIP. Struktura JPK nie akceptuje tekstowych opisów w tym polu. Jeśli kontrahent nie posiada numeru NIP, pole musi pozostać puste.

    6. Czy znacznik OFF jest tym samym co BFK? Nie. OFF stosuje się wyłącznie dla faktur wystawionych w trybie awaryjnym lub offline, które docelowo mają trafić do KSeF i otrzymać swój numer. BFK jest oznaczeniem dla dokumentów, które do KSeF nie trafią nigdy.

    7. Jak najszybciej naprawić błędy w wielu dokumentach naraz? W programie Comarch ERP Optima najlepiej wykorzystać operacje seryjne w Rejestrze VAT. Po zaznaczeniu dokumentów generujących błędy, można zbiorczo przypisać im odpowiedni znacznik (np. BFK) oraz typ dokumentu, co wyeliminuje błędy struktury przy ponownym przeliczeniu JPK.