410

    Błąd KSeF 410: nieprawidłowy zakres uprawnień

    Kod 410 przy wysyłce znaczy, że NIP sprzedawcy na fakturze jest inny niż NIP firmy, w której kontekście jesteś zalogowany, a ta firma nie ma prawa wystawiać faktur w imieniu sprzedawcy. Najczęściej to pomyłka w NIP-ie albo logowanie w niewłaściwej firmie.

    Aktualizacja: 11 października 2026 · Opisy z dokumentacji API KSeF 2.0 (MF) · Przykłady sprawdzone na środowisku testowym KSeF

    Gdzie pojawia się kod 410 — brzmienie z dokumentacji MF

    • Status faktury w sesji

      „Nieprawidłowy zakres uprawnień”

      Kontekst 9138880104 nie jest uprawniony do wystawienia faktury w imieniu sprzedawcy (NIP: 9231147966)

    • Status operacji na uprawnieniach

      „Podane identyfikatory są niezgodne lub pozostają w niewłaściwej relacji”

    Odpowiedź KSeF: faktura z NIP-em innej firmy jako sprzedawcyGET /sessions/{sesja}/invoices/{faktura} → status 410
    {
  "status": {
    "code": 410,
    "description": "Nieprawidłowy zakres uprawnień",
    "details": ["Kontekst 9138880104 nie jest uprawniony do wystawienia faktury w imieniu sprzedawcy (NIP: 9231147966)"]
  }
}

    Środowisko testowe MF, 11.10.2026. Numery referencyjne skróciliśmy, reszta bez zmian. Zalogowaliśmy się jako firma 9138880104 i wysłaliśmy fakturę, na której sprzedawcą była firma 9231147966.

    Jak czytać ten komunikat

    Kontekst to firma (NIP), w której imieniu jesteś zalogowany do KSeF — tak samo jak „wybór firmy” w Aplikacji Podatnika. Sprzedawca to NIP z pola Podmiot1 na fakturze. KSeF przyjmie fakturę tylko wtedy, gdy te NIP-y są takie same albo gdy sprzedawca nadał kontekstowi odpowiednie uprawnienie (np. do samofakturowania).

    Najczęstsze przyczyny

    • Literówka w NIP-ie sprzedawcy w ustawieniach programu albo na fakturze.
    • Biuro rachunkowe zalogowane w złej firmie — token lub kontekst jednego klienta, faktura drugiego.
    • Faktura wystawiana w cudzym imieniu (samofakturowanie, przedstawiciel) bez nadanego uprawnienia w KSeF.
    • Zamienieni sprzedawca i nabywca — np. faktura zakupowa wysłana tak, jakby była sprzedażą.

    Jak naprawić

    1. Porównaj dwa NIP-y z komunikatu: ten po słowie „Kontekst” i ten w nawiasie.
    2. Jeśli faktura jest Twoja — popraw NIP sprzedawcy w programie i wyślij ponownie.
    3. Jeśli wysyłasz za klienta — zaloguj się tokenem tego klienta (token KSeF zawsze należy do jednego NIP-u).
    4. Jeśli wystawiasz faktury w czyimś imieniu — sprzedawca musi nadać Twojej firmie uprawnienie w Aplikacji Podatnika.

    W operacjach na uprawnieniach kod 410 oznacza: „Podane identyfikatory są niezgodne lub pozostają w niewłaściwej relacji”.

    Pytania o błąd 410

    Czy biuro rachunkowe może wysyłać faktury klientów?

    Tak, jeśli klient nada biuru uprawnienie do wystawiania faktur, a biuro wyśle je w kontekście klienta. Najprościej: token wygenerowany w firmie klienta.

    Czym 410 różni się od 403?

    403 pojawia się od razu, gdy token nie ma uprawnienia do wysyłki w ogóle. 410 dotyczy konkretnej faktury: uprawnienie do wysyłki jest, ale nie w imieniu sprzedawcy, który jest na fakturze.