Wyjątki KSeF przy wysyłce faktury: 21405, 21180, 21184 i reszta

Jak je zobaczyć w Odoo

Gdy KSeF odrzuci zapytanie, l10n_pl_edi w Odoo 18, 19 i 20 pokazuje przy fakturze „Error when sending invoices to the KSeF”, a pod spodem „KSeF API Error: ” i treść odpowiedzi tak, jak przyszła, razem z exceptionCode. W 18 i 19 po polsku: „Podczas wysyłania faktur do KSeF wystąpił błąd” i „Błąd API KSeF: …”. Jeśli KSeF odmówi już przy otwieraniu sesji, komunikat zaczyna się od „Failed to open KSeF session: ” („Nie udało się otworzyć sesji KSeF: ”). Faktura nie dostaje stanu KSeF, więc po poprawce wyślesz ją tak samo jak wcześniej.

Kody, ich teksty i co zrobić

Sesja w Odoo

Odoo trzyma numer sesji interaktywnej w danych firmy. Przed wysyłką pyta KSeF o jej stan: jeśli to 100, czyli sesja otwarta, używa jej dalej, a w przeciwnym razie otwiera nową z formularzem FA (3) 1-0E. Kod 21180 zwykle więc mija przy kolejnej próbie. Z 21173 jest inaczej: przy następnej wysyłce Odoo pyta o stan tej samej sesji, dostaje ten sam błąd („Failed to check KSeF session: …”) i nowej sesji nie otwiera. Zapisaną sesję czyści dopiero usunięcie certyfikatu KSeF w ustawieniach i zapisanie, a potem ponowne dodanie certyfikatu. Tak wynika z kodu Odoo; nie sprawdzaliśmy tego na KSeF. Przy 21184 KSeF podpowiada nową sesję, ale Odoo otworzy ją dopiero wtedy, gdy zapisana nie będzie już miała statusu 100; jeśli błąd się powtarza, odczekaj, jak radzi komunikat.

Kody 21402 i 21403 dotyczą obliczeń, które robi sam program wysyłający: Odoo liczy skrót i rozmiar faktury przed i po zaszyfrowaniu. Przy standardowym Odoo nie wynikają z danych faktury. Korekty technicznej faktury offline Odoo nie wysyła, więc 21166 i 21167 pochodzą z innego programu.

Zanim zgłosisz problem

• Skopiuj pełny komunikat z Odoo, razem z JSON od „KSeF API Error:”.
• Zanotuj kod i treść details.
• Sprawdź, czy błąd dotyczy jednej faktury, czy wszystkich wysyłanych w tej chwili.
• Sprawdź, czy chodzi o środowisko produkcyjne, czy testowe.

Statusy samej sesji: 440 i 445

Sesja interaktywna też ma swój status. 440 „Sesja anulowana” z details „Nie przesłano faktur” znaczy, że w sesji nie wysłano żadnej faktury, a 445 „Błąd weryfikacji, brak poprawnych faktur”, że żadna faktura nie przeszła weryfikacji. Odoo sprawdza tylko, czy sesja ma status 100, więc tych statusów nie pokaże; przyczyny szukaj w statusach faktur, na przykład 450.

Nasz moduł, Poland KSeF 2.0 Validator, nie wysyła faktur i nie widzi tych kodów; z subskrypcją FlexigoTech Cloud, jeśli przed wysyłką klikniesz „Validate FA(3) (FlexigoTech Cloud)”, sprawdzi plik FA(3) ze schematem. Ten wynik nie blokuje wysyłki przez l10n_pl_edi: faktura „Not valid” wyjdzie, jeśli ją wyślesz.

Czytaj dalej