Chcesz przegadać swój projekt?
Odpowiadam osobiście w ciągu 24h w dni robocze — bez handlowca po drodze.
Status 415 przy fakturze w KSeF to brak zgody na faktury z załącznikiem. Czym jest załącznik w FA(3), jak uzyskać zgodę, jaka sesja i jakie limity rozmiaru.
Faktura wychodzi z programu bez problemu, a KSeF zwraca status 415 i opis „brak możliwości wysyłania faktury z załącznikiem”. Kod jest jednoznaczny: dokument zawiera sekcję załącznika, a firma nie ma w KSeF zgody na wystawianie takich faktur. To nie usterka programu ani awaria, tylko brakujący krok formalny albo niepotrzebny węzeł w pliku XML.
To najczęstsze nieporozumienie. Do faktury w KSeF nie dołączysz skanu umowy, zdjęcia ani PDF-u z cennikiem. Załącznik jest częścią samej struktury FA(3): dodatkowym blokiem danych w pliku XML, przewidzianym dla faktur ze złożonymi danymi o jednostkach miary, ilościach albo cenach jednostkowych netto. Przykładem jest rozliczenie mediów z wieloma odczytami albo dostawy z setkami pozycji pomiarowych. Treści handlowe i marketingowe do załącznika nie należą.
Ten sam numer ma w KSeF dwa znaczenia. Przy statusie faktury 415 dotyczy załącznika. Przy uwierzytelnieniu 415 oznacza brak przypisanych uprawnień, co opisałem w tekście o błędzie uwierzytelnienia. Jeśli program pokazuje tylko numer, sprawdź, które wywołanie go zwróciło. Pełną mapę kodów masz w przeglądzie błędów KSeF.
Zgłoszenie w e-Urzędzie Skarbowym
Składa je podatnik do Szefa KAS, wyłącznie przez konto w e-Urzędzie Skarbowym.
Akceptacja zgłoszenia
Zgoda jest przypisana do konkretnego NIP-u. Do tego czasu KSeF odrzuca faktury z załącznikiem.
Sprawdzenie w API
Integracja może odpytać KSeF o status zgody dla bieżącego kontekstu, zanim wyśle pierwszą taką fakturę.
Druga pułapka to rodzaj sesji. Według dokumentacji weryfikacji faktur faktury z załącznikami można wysyłać tylko w sesji wsadowej. Jedynym wyjątkiem jest korekta techniczna faktury offline, którą wysyła się w sesji interaktywnej. Program, który ma zgodę, ale wysyła takie faktury pojedynczo w sesji interaktywnej, i tak ich nie przepchnie.
Na środowisku testowym KSeF zgodę można włączyć i wyłączyć osobnymi endpointami danych testowych. Dzięki temu da się przetestować oba scenariusze, zanim zgłoszenie zostanie złożone naprawdę. O różnicach między środowiskami piszę w tekście o środowisku testowym KSeF.
Dokumentacja KSeF podaje domyślne limity dla kontekstu: faktura bez załącznika może mieć do 1 MB, faktura z załącznikiem do 3 MB. Większe pliki zostaną odrzucone niezależnie od zgody. Jeśli Twoje faktury z natury przekraczają te progi, limit można podnieść tylko na uzasadniony wniosek przez formularz kontaktowy KSeF.
Zdarza się w systemach, które generują XML z jednego szablonu: blok załącznika trafia do każdej faktury, często pusty. Wtedy rozwiązaniem nie jest zgłoszenie, tylko poprawka generatora. Faktura bez zbędnej sekcji przejdzie od razu, a odrzucone dokumenty wysyłasz ponownie, bo nie dostały numeru KSeF.
W praktyce faktury z załącznikiem dotyczą głównie branż rozliczających dużo danych pomiarowych: energii, mediów, telekomunikacji, usług z rozliczeniem godzinowym na wielu pozycjach. Sklep internetowy, hurtownia z typowym asortymentem czy firma usługowa zwykle nie ma powodu, żeby z nich korzystać.
Źródła: weryfikacja faktury i ograniczenia dotyczące załączników oraz limity KSeF.
Nie. KSeF przyjmuje tylko plik XML w strukturze FA(3). Umowę czy specyfikację przekazujesz kontrahentowi osobno, np. mailem.
Ministerstwo Finansów zapowiadało realizację zgłoszeń w ciągu kilku dni roboczych. Do czasu akceptacji faktury z załącznikiem będą odrzucane ze statusem 415.
Zwykle nie. Typowa faktura ze sklepu mieści się w standardowej strukturze. Jeśli sklep dostaje 415, najpewniej generator dodaje zbędną sekcję. Przy WooCommerce poprawiam to w ramach integracji KSeF z WooCommerce.
Chcesz przegadać swój projekt?
Odpowiadam osobiście w ciągu 24h w dni robocze — bez handlowca po drodze.