Ostatnia aktualizacja: 2026-11-16
- Na liście muszą znaleźć się co najmniej dwa numery KSeF faktur.
- Faktury muszą mieć tego samego sprzedawcę.
- Trzeba mieć właściwe uprawnienie i działać w odpowiednim kontekście.
- Limit zależy od kanału, w którym wykonywana jest operacja.
Co najczęściej blokuje wygenerowanie identyfikatora zbiorczego
Brak identyfikatora zwykle oznacza, że nie został spełniony co najmniej jeden warunek dotyczący faktur, uprawnień, limitu albo dostępności funkcji. KSeF generuje identyfikator na podstawie przekazanej listy numerów KSeF, dlatego znaczenie mają zarówno dane wejściowe, jak i możliwość wykonania operacji przez dany podmiot.[1]
Najpierw należy ustalić, czy na liście są co najmniej dwie faktury z przydzielonymi numerami KSeF i czy mają one tego samego sprzedawcę. Jeśli te warunki są spełnione, kolejnymi obszarami kontroli są uprawnienia, kontekst podmiotu, limit właściwy dla używanego kanału oraz ewentualna niedostępność funkcji.
Komunikat wyświetlany przez program księgowy może odnosić się do konfiguracji integracji, a nie bezpośrednio do reguł KSeF. Samo ponawianie tej samej operacji bez sprawdzenia jej danych nie pozwala rozróżnić tych sytuacji.
Najpierw sprawdź faktury i sprzedawcę
Do wygenerowania identyfikatora zbiorczego potrzebne są co najmniej dwa numery KSeF faktur. Wszystkie faktury objęte jednym identyfikatorem muszą mieć tego samego sprzedawcę wskazanego w polu Podmiot1. Nabywcy mogą być różni.[2]
- Potwierdź, że lista zawiera co najmniej dwie faktury.
- Zweryfikuj, czy każdej fakturze został przydzielony numer KSeF.
- Porównaj sprzedawcę wskazanego w polu Podmiot1 na wszystkich fakturach.
- Rozdziel faktury od różnych sprzedawców na osobne listy.
- Sprawdź listę przed wysłaniem, ponieważ utworzonego identyfikatora nie można edytować ani usunąć.[4]
Numer KSeF to nie numer własny faktury
Do żądania trzeba przekazać numer nadany fakturze przez KSeF, a nie jej numer własny nadany przez sprzedawcę. Nowego identyfikatora nie można też utworzyć z wcześniej wygenerowanych identyfikatorów zbiorczych — podstawą pozostają numery KSeF poszczególnych faktur.
Niepoprawny numer, numer pochodzący z innego środowiska albo brak dostępu do faktury może spowodować niepowodzenie operacji. Jest to jednak diagnoza warunkowa: dostępne materiały nie zawierają kompletnej listy kodów błędów przypisanych do każdego z tych przypadków.[6]
Dlaczego różny nabywca nie musi być problemem
Warunek wspólności dotyczy sprzedawcy w polu Podmiot1, nie nabywcy. Faktury wystawione przez jednego sprzedawcę dla różnych nabywców mogą więc zostać objęte jednym identyfikatorem, o ile pozostałe wymagania są spełnione. Faktury od różnych sprzedawców trzeba natomiast rozdzielić.
Uprawnienia, kontekst i błąd po stronie integracji
Poprawna lista faktur nie wystarczy, jeśli użytkownik albo integracja nie ma właściwego uprawnienia lub wykonuje operację w niewłaściwym kontekście. W przypadku API trzeba dodatkowo zweryfikować format żądania, liczbę elementów, numery KSeF, autoryzację i kontekst NIP.[3]
Dokumentacja API wymienia uprawnienia InvoiceRead, InvoiceWrite lub CollectiveIdentifierManage. Dokładny wymagany zestaw zależy jednak od używanego kanału i aktualnej wersji KSeF API, dlatego samo zalogowanie do systemu nie przesądza o możliwości wykonania tej operacji.
Co oznacza właściwy kontekst
Kontekst wskazuje firmę lub inny podmiot, w imieniu którego wykonywana jest operacja. Uwierzytelnienie może być poprawne, ale nie zapewniać dostępu do faktur w wybranym kontekście. Przy diagnozie trzeba też upewnić się, że numery faktur i dane uwierzytelniające odnoszą się do właściwego środowiska. Jest to element diagnostyczny, a nie uniwersalne wyjaśnienie każdego błędu.
Dane przydatne przy zgłoszeniu do dostawcy programu
Zgłoszenie powinno zawierać pełny komunikat błędu, używany kanał, NIP kontekstu i listę zweryfikowanych numerów KSeF. Przy opisie konfiguracji dobrze oddzielić problem z identyfikatorem od innych obszarów systemu finansowego, takich jak znaczniki kont JPK_KR_PD, aby zgłoszenie dotyczyło właściwego modułu.
Limit faktur zależy od kanału
Przekroczenie limitu właściwego dla używanego kanału może zatrzymać generowanie identyfikatora. Oficjalna strona MF wskazuje 50 faktur dla Aplikacji Podatnika KSeF, natomiast dokumentacja API podaje domyślny limit 500 faktur.[1][3]
| Kanał | Limit wskazany w źródle | Co zweryfikować przed wysłaniem |
|---|---|---|
| Aplikacja Podatnika KSeF | 50 faktur | Liczbę faktur na przygotowanej liście |
| API KSeF | Domyślnie 500 faktur | Limit integracji oraz strukturę żądania |
Liczby dotyczą różnych kanałów i nie należy stosować ich zamiennie. Limity mogą się zmienić albo zostać indywidualnie zwiększone, dlatego przed wysłaniem dużej listy trzeba potwierdzić aktualne wymagania dla konkretnego kanału. Starsze materiały mogą zawierać inne wartości.
Co zrobić przed ponowną próbą
Przed powtórzeniem operacji należy zweryfikować dane wejściowe, sprzedawcę, uprawnienia, kontekst i limit. Dopiero po wykluczeniu tych przyczyn można oceniać, czy problem wynika z chwilowej niedostępności KSeF albo z działania konkretnej integracji.
- Potwierdź, że przekazujesz co najmniej dwa numery KSeF, a nie numery własne faktur.
- Sprawdź, czy wszystkie faktury mają tego samego sprzedawcę w polu Podmiot1.
- Zweryfikuj uprawnienie użytkownika lub integracji oraz kontekst NIP.
- Ustal, czy operacja odbywa się w Aplikacji Podatnika, przez API czy w programie księgowym.
- Porównaj liczbę faktur z aktualnym limitem właściwym dla tego kanału.
- Zapisz pełną treść komunikatu błędu przed kolejną próbą.
- Jeśli dane są poprawne, zweryfikuj bieżącą dostępność funkcji KSeF.
Gdy problem dotyczy chwilowej niedostępności KSeF
Jeżeli funkcja generowania jest niedostępna po stronie KSeF, identyfikator można utworzyć po jej przywróceniu. W kontekście płatności należy stosować aktualne zasady dotyczące podawania numerów KSeF.[5] To rozwiązanie zastępcze nie naprawia jednak błędu API ani nie rozwiązuje problemu konfiguracji programu księgowego.
Bez komunikatu systemowego lub innych oznak niedostępności nie należy automatycznie uznawać każdej odmowy za awarię KSeF. Po przejściu checklisty pełny komunikat, kanał operacji, kontekst NIP i zweryfikowane numery KSeF tworzą zestaw danych potrzebny do dalszej diagnozy technicznej.
Źródła
- Numer KSeF i zbiorczy identyfikator, Ministerstwo Finansów / KSeF.
- Podręcznik KSeF 2.0 cz. III dodatkowe funkcjonalności KSeF 06112026, Ministerstwo Finansów / KSeF.
- KSeF API (PR) – dokumentacja, Ministerstwo Finansów / KSeF API.
- Pytania i odpowiedzi KSeF 2.0, Ministerstwo Finansów / KSeF.
- Pytania i odpowiedzi KSeF 2.0 – token i płatności, Ministerstwo Finansów / KSeF.
- Jak wygenerować identyfikator zbiorczy KSeF – instrukcja, Pewny JPK.
+Artykuł Sponsorowany+
