KSeF błędy schemy FA(2) — troubleshooting 12 najczęściej spotykanych 2026

KSeF błędy schemy FA(2): jak diagnozować wysyłkę faktury w 2026 roku

W 2026 roku komunikat „błąd FA(2)” często oznacza skrót z logów ERP, choć KSeF pracuje już w modelu KSeF 2.0 i FA(3). Ministerstwo Finansów wskazuje, że od 1 lutego 2026 r. obowiązuje FA(3), także dla korekt do starszych faktur: oficjalna informacja KSeF. Troubleshooting obejmuje więc dane faktury i wersję XML.

Poniżej znajdziesz 12 błędów wysyłki z przyczyną i naprawą w ERP. Kody 100-600 traktuj jako typowe etykiety z integracji, nie jako jedyny urzędowy słownik. Przy wyborze systemu punktem startu powinien być Polski ERP z KSeF.

Szybka mapa błędów

12 najczęstszych błędów KSeF i naprawa w ERP

1. Kod 100: „Niepoprawny NIP nabywcy”

Znaczenie: KSeF albo walidator ERP nie może zaakceptować identyfikatora nabywcy. Przyczyną bywa literówka, spacja, przedrostek PL wpisany w niewłaściwym polu, zagraniczny kontrahent oznaczony jak polski podatnik albo niezgodność NIP z kartoteką.

1. W kartotece kontrahenta usuń spacje, myślniki i ręczne prefiksy, jeśli ERP ma osobne pole kraju.
2. Zweryfikuj NIP na białej liście i sprawdź, czy data weryfikacji odpowiada dacie transakcji.
3. W Insert nexo Pro lub Comarch ERP Optima popraw kartotekę, odśwież dane na fakturze i wygeneruj XML ponownie.

2. Kod 110: „Kontrahent nieaktywny VAT”

Znaczenie: faktura zawiera dane podmiotu, którego status VAT budzi zastrzeżenia. Nie zawsze oznacza to błąd faktury, ale w praktyce wymaga decyzji księgowej i udokumentowania weryfikacji.

1. Sprawdź status podatnika VAT na dzień wystawienia i dzień sprzedaży.
2. Jeżeli kontrahent jest zwolniony albo zagraniczny, popraw klasyfikację podatkową zamiast wymuszać status czynnego VAT.
3. Jeżeli błąd wynika z kartoteki, pobierz dane z rejestru ponownie i dopiero wtedy wyślij fakturę.

3. Kod 120: „Niepoprawny adres”

Znaczenie: adres nie przechodzi walidacji struktury lub reguł biznesowych. Najczęściej brakuje miasta, kodu pocztowego, numeru budynku albo w jednym polu wpisano cały adres.

1. Rozbij adres na pola: ulica, numer, kod pocztowy, miejscowość, kraj.
2. Nie wpisuj „brak”, „.” ani samego kodu pocztowego w polu ulicy.
3. Dla kontrahenta zagranicznego ustaw właściwy kraj i format identyfikatora, bo polski kod pocztowy nie jest wtedy wymagany w ten sam sposób.
4. Po poprawie kartoteki odśwież dane na fakturze.

4. Kod 130: „Kwota brutto nie zgadza się”

Znaczenie: suma pozycji, rabatów i podatku VAT nie zgadza się z wartością nagłówka faktury. To klasyczny błąd po ręcznej korekcie ceny, imporcie z e-commerce lub migracji z Excela.

1. Przelicz dokument w ERP i sprawdź, czy rabat jest naliczany od netto czy brutto.
2. Porównaj sumę netto, VAT i brutto w podziale na stawki VAT.
3. Usuń ręcznie wpisaną wartość końcową i wymuś jeden model zaokrągleń: na pozycji albo na dokumencie.

Przy imporcie z arkuszy ogranicz ryzyko błędnego formatowania liczb, porządkując stanowiska pracy, np. przez Office 2024 dla firm.

5. Kod 140: „Brak daty wystawienia”

Znaczenie: w XML brakuje wymaganej daty albo ma ona format niezgodny ze schemą. Typowy przykład to puste pole po imporcie dokumentu cyklicznego lub data zapisana jako tekst.

1. Uzupełnij datę wystawienia i datę sprzedaży w nagłówku faktury.
2. Sprawdź format daty: praktycznie powinien odpowiadać standardowi RRRR-MM-DD.
3. Jeżeli dokument powstał z szablonu, popraw szablon i wygeneruj XML ponownie.

6. Kod 200: „Status faktury”

Znaczenie: faktura mogła zostać wysłana wcześniej, oczekuje na przetworzenie albo ma już numer KSeF. Ponowna wysyłka bez sprawdzenia statusu może skończyć się duplikatem logicznym lub blokadą procesu.

1. Sprawdź, czy dokument ma numer KSeF, UPO albo identyfikator sesji.
2. Nie edytuj numeru faktury tylko po to, aby „przepchnąć” dokument.
3. Odśwież status wysyłki z poziomu modułu KSeF w ERP.
4. Jeżeli dokument został odrzucony, popraw przyczynę i ponów wysyłkę zgodnie z procedurą w programie.

7. Kod 210: „Korekta bez oryginału”

Znaczenie: korekta nie wskazuje faktury pierwotnej albo wskazuje ją w sposób, którego KSeF nie potrafi powiązać. Od 1 lutego 2026 r. także korekty do faktur z FA(2) powinny być wystawiane w FA(3).

1. Wystaw korektę z dokumentu źródłowego, a nie jako całkowicie nową fakturę.
2. Uzupełnij numer faktury pierwotnej, datę wystawienia oraz numer KSeF, jeżeli jest dostępny.
3. Przy fakturach sprzed obowiązku KSeF wprowadź dane oryginału ręcznie w polach referencyjnych korekty.
4. Sprawdź stawki VAT na korekcie, bo stare oznaczenia mogą wymagać mapowania.

8. Kod 300: „Token nieaktywny”

Znaczenie: program nie może uwierzytelnić sesji. Token mógł wygasnąć, zostać odwołany, dotyczyć innego NIP albo został wklejony do złego środowiska: testowego zamiast produkcyjnego.

1. Sprawdź, czy token dotyczy właściwego podatnika i środowiska KSeF.
2. Zweryfikuj uprawnienia osoby lub biura rachunkowego w Aplikacji Podatnika KSeF.
3. W Comarch ERP Optima sprawdź konfigurację KSeF; dokumentacja opisuje token, certyfikat i podpis kwalifikowany: pomoc Comarch ERP Optima.
4. W InsERT sprawdź usługę KSeF i Portfel InsERT/InsPunkty: KSeF w programach InsERT.

9. Kod 310: „Certyfikat niepoprawny”

Znaczenie: problem dotyczy certyfikatu KSeF, podpisu kwalifikowanego albo konfiguracji magazynu certyfikatów. W praktyce dotyka to firm, które przenoszą ERP na nowy komputer, serwer terminalowy albo środowisko zdalne.

1. Sprawdź ważność certyfikatu i zgodność danych podmiotu z NIP w ERP.
2. Upewnij się, że użytkownik systemu Windows ma dostęp do magazynu certyfikatów.
3. Na serwerach RDS przetestuj certyfikat na koncie operatora, nie tylko administratora.
4. Jeśli ERP działa centralnie, uporządkuj infrastrukturę, np. Windows Server 2025 i polityki dostępu.

10. Kod 400: „Liczba faktur w batchu przekroczona”

Znaczenie: paczka wsadowa jest zbyt duża dla limitów integracji. W wielu wdrożeniach przyjmuje się praktyczny limit 1000 faktur w batchu, a dodatkowo trzeba uwzględnić rozmiar XML i załączników, jeśli są obsługiwane.

1. Podziel wysyłkę na mniejsze paczki, np. po 250-500 dokumentów przy dużych fakturach.
2. Nie mieszaj faktur sprzedaży, korekt i dokumentów z błędami testowymi w jednej paczce.
3. Po wysyłce pobierz listę dokumentów odrzuconych; dla integracji własnych korzystaj z oficjalnych materiałów MF: CIRFMF/ksef-docs.

11. Kod 500: „Timeout systemu KSeF”

Znaczenie: połączenie z usługą KSeF nie zakończyło się w oczekiwanym czasie. To może być awaria po stronie infrastruktury, przeciążenie, problem sieci firmowej albo zbyt agresywne ponawianie żądań przez integrację.

1. Sprawdź status usługi i komunikaty techniczne KSeF.
2. Nie klikaj wysyłki wielokrotnie; najpierw odśwież status dokumentu.
3. Włącz kolejkę ponowień z odstępem czasowym, jeżeli ERP ją obsługuje.
4. Sprawdź sieć, DNS, proxy i antywirus dla firm, bo lokalna blokada potrafi wyglądać jak błąd KSeF.

12. Kod 600: „Schema FA(2) niezgodna”

Znaczenie: ERP, wtyczka lub integrator generuje XML w starej strukturze albo używa nieaktualnej przestrzeni nazw. To najważniejszy błąd migracyjny 2026 roku: użytkownik mówi „FA(2)”, ale KSeF wymaga FA(3).

1. Zaktualizuj ERP do wersji obsługującej KSeF 2.0 i FA(3).
2. Sprawdź, czy środowisko produkcyjne nie korzysta ze starej biblioteki integracyjnej.
3. Usuń stare szablony XML, jeżeli firma miała własny eksporter.
4. Wykonaj test na fakturze zwykłej, korekcie i kontrahencie zagranicznym.

Insert nexo Pro i Comarch ERP Optima: gdzie szukać ustawień

W InsERT nexo Pro sprawdzaj kartoteki, wersję programu, usługę KSeF oraz Portfel InsERT/InsPunkty. W Comarch ERP Optima kontroluj konfigurację firmy, operatorów, środowisko i metodę uwierzytelnienia. W 2026 InsERT komunikuje model InsPunktów, a Comarch publikuje pakiety KSeF od kilkunastu zł miesięcznie oraz OCR/KSeF od kilkuset zł netto. Gdy KSeF ma działać z pocztą, Teams i archiwum, zaplanuj Microsoft 365 + KSeF.

Procedura HowTo: co zrobić, gdy faktura nie przechodzi KSeF

1. Zapisz komunikat błędu, numer dokumentu, identyfikator sesji i czas wysyłki.
2. Sprawdź, czy dokument nie ma już numeru KSeF albo statusu „w przetwarzaniu”.
3. Popraw dane w źródle: kontrahenta, nagłówek, pozycje lub konfigurację podatkową.
4. Wygeneruj XML ponownie po poprawkach, a nie wysyłaj starego pliku z dysku.
5. Zweryfikuj wersję schemy: w 2026 podstawą jest FA(3).
6. Ponów wysyłkę pojedynczego dokumentu; batch uruchom dopiero po przejściu testu.
7. Po sukcesie zapisz numer KSeF i UPO w ERP oraz przekaż informację do księgowości.

Checklista

• Aktualizuj ERP przed masową wysyłką faktur.
• Ustal właściciela tokenów, certyfikatów i uprawnień.
• Kontroluj próbkę faktur: NIP, adres, VAT, kwoty, daty i status.