Przejdź do głównej treści
KSeF 2.0 · status faktury

Kody 410 i 415 w KSeF: uprawnienia sprzedawcy i załączniki

Oba kody przychodzą jako status faktury po wysyłce i oba dotyczą tego, czy wolno Ci wysłać tę fakturę w tym kontekście. Testy biblioteki Ministerstwa Finansów pokazują trzy konkretne przyczyny: inny NIP sprzedawcy niż NIP sesji, brak zgody na załączniki i załącznik w sesji interaktywnej.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 5 listopada 2026

Najważniejsze

Moduł
KSeF 2.0
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym modułu, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
2 min

Co mówi KSeF i co sprawdza MF

KodTekst KSeFPrzypadek z testów MF
410„Nieprawidłowy zakres uprawnień”Faktura z NIP sprzedawcy innym niż NIP, którym uwierzytelniono sesję.
410„Nieprawidłowy zakres uprawnień”Sprzedawca bez zgody na załączniki; w details: „Sprzedawca {nip} nie posiada zgody do wysyłania faktur z załącznikami”.
415„Brak możliwości wysyłania faktury z załącznikiem”Faktura z załącznikiem wysłana w sesji interaktywnej.

Dokumentacja KSeF dodaje dwie zasady. Wysłanie faktury wymaga uprawnień do jej wystawienia w kontekście danego podmiotu. Faktury z załącznikami wolno wysyłać tylko w trybie wsadowym (wyjątek: korekta techniczna faktury offline) i dopiero po zgłoszeniu tej opcji w e-Urzędzie Skarbowym.

Karta kodów 410 i 415 KSeF
Kod 410 z opisem z API, a obok 415 dla faktury z załącznikiem.

Jak to wygląda w Odoo 18, 19 i 20

l10n_pl_edi loguje się do KSeF certyfikatem KSeF z ustawień, z NIP firmy jako kontekstem, i ten sam NIP wpisuje do Podmiot1. Wymaga przy tym, żeby numer VAT firmy zaczynał się od PL („A polish VAT number must be set on your company.”, w 18 i 19 „W danych firmy należy podać polski numer NIP.”). Po kodzie 410 ustawia stan Rejected i pisze „Status KSeF: Odrzucono (Kod:410). Nieprawidłowy zakres uprawnień.” (w 20 po angielsku: „KSeF Status: Rejected (Code: 410). Incorrect scope of permissions.”).

Kod 410 przychodzi jako status faktury, tak jak 450, więc Odoo pokazuje go w historii po sprawdzeniu statusu: zaraz po wysyłce albo później, przyciskiem „Sprawdź wysyłkę”. Uprawnienia nadaje się i sprawdza w samym KSeF, nie w Odoo: Odoo zna tylko certyfikat i NIP firmy.

Szablon FA(3) z Odoo nie ma elementu Zalacznik, a Odoo wysyła w sesji interaktywnej. Kod 415 i 410 z powodu załączników nie powinny więc pochodzić z faktury wygenerowanej przez Odoo; jeśli je widzisz, plik przyszedł z innego programu.

Co sprawdzić przy 410

  • NIP firmy w Odoo to dokładnie ten NIP, na który ma uprawnienia właściciel certyfikatu.
  • Właściciel certyfikatu ma w KSeF uprawnienie do wystawiania faktur dla tego NIP; nadaje je właściciel firmy. Bez żadnych uprawnień KSeF nie przepuści już logowania (status 415 przy uwierzytelnianiu: „Brak przypisanych uprawnień”).
  • Jeśli zmieniłeś NIP firmy w Odoo, zapisz certyfikat w ustawieniach jeszcze raz. Odoo pisze w Podmiot1 aktualny NIP firmy, a do najbliższego automatycznego odnowienia ma dostęp z logowania na poprzedni, czyli dokładnie przypadek z testu MF.
  • W bazie z kilkoma firmami każda ma własny certyfikat; faktura idzie z kontekstem firmy, której jest.
Schemat: co zwraca KSeF przy kodach 410 i 415 i co pokazuje Odoo 20
Schemat na podstawie kodu l10n_pl_edi z Odoo 20 i specyfikacji API KSeF 2.9.0; skreślone jest to, czego Odoo nie zapisuje albo nie robi.

Ponowna wysyłka

Po poprawce przywróć fakturę do wersji roboczej (przy odrzuconej Odoo czyści stan i numer KSeF), zatwierdź ją i wyślij jeszcze raz. Nasz moduł, Poland KSeF 2.0 Validator, przejmie od l10n_pl_edi stan Rejected, a potem Accepted, ale sam niczego nie wysyła i nie zmienia uprawnień w KSeF.

Czytaj dalej

Statusy uwierzytelniania KSeF: 415, 425, 450, 470 i 480Statusy logowania do KSeF 2.0 poza certyfikatem: brak uprawnień, unieważnienie, zły token, blokada. Kody 21301 i 21304 i jak to wygląda w Odoo 18-20.Logowanie certyfikatem do KSeF: kod 460 i błędy podpisu XAdESKod 460 KSeF i wyjątki 9101-9105, 21111, 21115, 21117, 21217, 21401 i 21406 przy logowaniu certyfikatem. Czego Odoo 18, 19 i 20 nie pokazuje i co sprawdzić.Kod 440 w KSeF: „Duplikat faktury”Kod 440 KSeF: faktura z tym samym NIP sprzedawcy, rodzajem i numerem już jest w systemie. Jak KSeF to liczy, co pokazuje Odoo 18, 19 i 20 i jak to rozwiązać.
Sprawdzone w kodzie źródłowym modułu (wersja 20.0) i w podlinkowanych źródłach

Źródła