Strona główna › Identyfikator zbiorczy KSeF › Instrukcja
Pomoc · darmowe narzędzie

Jak wygenerować identyfikator zbiorczy KSeF: instrukcja narzędzia

Zespół PewnyJPK.pl·Ostatnia aktualizacja: 23 października 2026
Dłoń kładzie plik faktur spiętych jednym spinaczem obok laptopa
Ilustracja wygenerowana przez AI.
Narzędzie łączy się z API KSeF 2.0 Ministerstwa Finansów Twoim tokenem KSeF. Wklejasz numery KSeF faktur jednego sprzedawcy, narzędzie sprawdza je przed wysłaniem, a KSeF nadaje identyfikator zbiorczy do tytułu przelewu. Możesz też pobrać specyfikację dowolnego identyfikatora (CSV, schowek, PDF) i przejrzeć identyfikatory z ostatnich 100 dni. Całość trwa 2–3 minuty i jest bezpłatna.

Co jest potrzebne

Token wygenerujesz w Aplikacji Podatnika KSeF lub w Module Certyfikatów i Uprawnień, w części poświęconej tokenom. Jeśli identyfikatory będzie tworzyć kilka osób, każda może mieć własny token z minimalnym uprawnieniem. Taki token łatwo potem unieważnić bez wpływu na resztę firmy.

Krok 1. Połączenie z KSeF

  1. Wybierz środowisko. Dla prawdziwych faktur zawsze Produkcyjne. Środowiska Przedprodukcyjne (demo) i Testowe służą do prób i wymagają osobnych tokenów, wygenerowanych właśnie na nich.
  2. Wklej token KSeF. Pole NIP wypełni się samo, jeśli token zawiera NIP (tokeny KSeF 2.0 mają go w środku, w postaci |nip-1234567890|).
  3. Opcjonalnie zaznacz Zapamiętaj token w tej przeglądarce. Rób to tylko na własnym komputerze. Przycisk Zapomnij zapisany token usuwa go z przeglądarki.

Nie trzeba klikać „Zaloguj”. Sesja KSeF otwiera się sama przy pierwszej operacji, a logowanie trwa kilka sekund. Pod formularzem zobaczysz wtedy zielony komunikat Połączono z KSeF z godziną, do której sesja jest ważna. Gdy sesja wygaśnie, narzędzie zaloguje się ponownie bez Twojego udziału. Sesja działa tylko w bieżącej karcie przeglądarki: po jej zamknięciu następna operacja otworzy nową.

Panel Połączenie z KSeF: środowisko produkcyjne, NIP kontekstu, ukryty token i zielony komunikat o aktywnej sesji
Krok 1: po pierwszej operacji pod formularzem pojawia się zielony komunikat o aktywnej sesji. Na zrzutach są przykładowe, fikcyjne dane.

Krok 2. Wklejenie faktur

W zakładce Utwórz identyfikator jest tabela, która działa jak arkusz. Najszybciej jest zaznaczyć w Excelu kolumny i wkleić je w pierwszą komórkę tabeli (Ctrl+V). Kolejność kolumn:

KolumnaWymaganaUwagi
Numer KSeF fakturytak35 znaków; małe litery zamieniane są na wielkie, spacje usuwane
Kwota płatnościnienp. 1 234,56 lub 1234.56
Walutaniekod ISO, np. PLN, EUR; „zł”, „€”, „$” i „£” zamieniane są na kod
Opisniedo 512 znaków, np. numer faktury dostawcy

Wiersz nagłówka z Excela (np. „Numer KSeF”) jest pomijany automatycznie. Wklejać można też do środka tabeli: dane trafiają od zaznaczonej komórki w dół. Między wierszami poruszasz się strzałkami w górę i w dół oraz klawiszem Enter, a przycisk + 10 wierszy dodaje miejsce na kolejne faktury. Jeden identyfikator obejmuje od 2 do 500 faktur.

Tabela z pięcioma wklejonymi fakturami jednego sprzedawcy, przy każdej znacznik poprawności i suma pod tabelą
Krok 2: faktury wklejone z Excela. Każdy poprawny wiersz ma znacznik ✓, a pod tabelą widać liczbę faktur i sumę kwot.

Krok 3. Sprawdzenie i poprawki

Każdy wiersz jest sprawdzany od razu, jeszcze przed wysłaniem do KSeF. Problem pojawia się w kolumnie Uwagi, a pod tabelą widać liczbę faktur, sumę kwot i liczbę błędnych wierszy. Suma obejmuje tylko poprawne wiersze.

Komunikat w kolumnie UwagiCo oznacza i co zrobić
numer KSeF ma 35 znakówNumer jest ucięty albo sklejony z innym tekstem. Skopiuj go ponownie.
zły formatNumer nie pasuje do wzoru NIP-RRRRMMDD-XXXXXXXXXXXX-XX. Często to numer faktury wystawcy zamiast numeru KSeF.
błędna suma kontrolnaOstatnie dwa znaki nie zgadzają się z resztą numeru, czyli gdzieś jest literówka (np. 8 zamiast B).
nieprawidłowy NIP sprzedawcy / nieprawidłowa dataPierwsze 10 cyfr albo data w numerze są błędne. Też oznacza literówkę.
numer powtórzonyTa sama faktura jest w tabeli dwa razy. Usuń jeden wiersz krzyżykiem.
inny sprzedawcaFaktura ma innego wystawcę niż pierwsza faktura w tabeli. Dla każdego sprzedawcy potrzebny jest osobny identyfikator.
nieprawidłowa kwota / nieznany kod walutyPopraw kwotę albo wpisz 3-literowy kod waluty z listy KSeF.

Gdy faktury mają różne waluty, pod tabelą pojawi się żółte ostrzeżenie. KSeF przyjmie taki identyfikator, ale jednym przelewem płaci się zwykle w jednej walucie, więc lepiej zrobić osobny identyfikator dla każdej z nich.

Tabela z czterema błędnymi wierszami: błędna suma kontrolna, numer powtórzony, inny sprzedawca i nieprawidłowa kwota
Krok 3: błędne wiersze są podświetlone, a kolumna Uwagi mówi, co poprawić. Po kliknięciu Generuj pod tabelą pojawia się lista błędów.
Tabela z fakturami w PLN i jednej w EUR, pod nią suma w dwóch walutach i żółte ostrzeżenie o różnych walutach
Faktury w różnych walutach: numery są poprawne, ale pod tabelą pojawia się żółte ostrzeżenie.

Krok 4. Generowanie identyfikatora

Kliknij Generuj identyfikator zbiorczy. Po kilku sekundach KSeF zwróci numer w rodzaju 8992520556-IZ202610-283C18108000-4B. Pierwsze 10 cyfr to zawsze NIP sprzedawcy, także wtedy, gdy identyfikator utworzył nabywca. Po nich jest oznaczenie IZ z rokiem i miesiącem.

Przycisk Kopiuj numer kopiuje identyfikator do schowka, gotowy do wklejenia w tytuł przelewu. Pobierz specyfikację od razu pokazuje listę faktur, które KSeF przypisał do nowego numeru.

Wynik: identyfikator zbiorczy nadany przez KSeF z przyciskami Kopiuj numer i Pobierz specyfikację
Krok 4: identyfikator nadany przez KSeF. Pierwsze 10 cyfr to NIP sprzedawcy.
Uwaga przy środowisku produkcyjnym Identyfikator powstaje w prawdziwym KSeF i jest widoczny dla sprzedawcy. Jedna faktura może należeć najwyżej do 132 identyfikatorów w jednym kontekście, więc nie generuj kolejnych numerów „na próbę” na fakturach produkcyjnych. Do testów użyj środowiska demo albo testowego.

Specyfikacja identyfikatora

Zakładka Pobierz specyfikację działa dla każdego identyfikatora: utworzonego przez Ciebie, przez kontrahenta albo w innym programie. Wklej do 10 numerów, każdy w osobnej linii. Narzędzie najpierw sprawdzi ich format i sumę kontrolną, a jeśli wkleisz numer pojedynczej faktury zamiast identyfikatora, od razu to zgłosi.

Specyfikacja pokazuje numer KSeF każdej faktury, NIP sprzedawcy, kwotę, walutę i opis płatności oraz sumy dla każdej waluty. Kwoty i opisy widzi tylko podmiot, który utworzył identyfikator, albo podmiot występujący na danej fakturze. W pozostałych przypadkach w wierszu pojawi się informacja, że szczegóły płatności są niedostępne.

Zakładka Pobierz specyfikację: lista pięciu faktur identyfikatora z kwotami, opisami, sumą i przyciskami CSV, Kopiuj tabelę, Drukuj / PDF
Specyfikacja identyfikatora: faktury, kwoty, opisy i suma dla waluty oraz przyciski eksportu.

Wynik można wykorzystać na trzy sposoby:

Wydruk specyfikacji identyfikatora zbiorczego KSeF: nagłówek, numer identyfikatora, metryka, tabela faktur z sumą i nota o źródle danych
Specyfikacja zapisana jako PDF (dane przykładowe). Na wydruku są też numery stron.

Sprzedawca, który dostał przelew z identyfikatorem zbiorczym, może w ten sposób rozbić wpłatę na faktury i rozliczyć ją w systemie rozrachunków.

Moje identyfikatory

Zakładka Moje identyfikatory pokazuje identyfikatory utworzone w Twoim kontekście (NIP z kroku 1) oraz te, w których jesteś sprzedawcą, z ostatnich 30 albo 100 dni. KSeF nie pozwala szukać dalej wstecz. Dla każdego numeru widać datę utworzenia, liczbę faktur i to, czy utworzyłeś go Ty, czy inny podmiot. Przycisk Specyfikacja przenosi numer do zakładki specyfikacji i od razu ją pobiera.

Zakładka Moje identyfikatory: trzy identyfikatory z datą utworzenia, liczbą faktur i informacją, kto je utworzył
Moje identyfikatory: lista z ostatnich 30 dni. Przycisk Specyfikacja otwiera szczegóły wybranego numeru.

Bezpieczeństwo danych

Przeglądarka nie może łączyć się z API KSeF bezpośrednio, bo serwery Ministerstwa Finansów na to nie pozwalają. Dlatego żądania przechodzą przez serwer PewnyJPK.pl, który przekazuje je do KSeF i odsyła odpowiedź. Serwer nie zapisuje tokenów, numerów faktur, kwot ani specyfikacji. Przechowuje jedynie liczniki zapytań z danego adresu IP, które chronią narzędzie przed nadużyciami.

W Twojej przeglądarce zostają tylko dwie rzeczy: sesja KSeF w bieżącej karcie (znika po jej zamknięciu) oraz token, jeśli zaznaczysz Zapamiętaj token. Gdy przestaniesz korzystać z narzędzia, możesz unieważnić token w KSeF. Nie wpływa to na wygenerowane już identyfikatory.

Rozwiązywanie problemów

KomunikatPrzyczyna i rozwiązanie
Logowanie do KSeF nie powiodło sięToken jest z innego środowiska niż wybrane, został unieważniony albo NIP nie zgadza się z tokenem. Sprawdź środowisko i NIP, w razie potrzeby wygeneruj nowy token.
Brak uprawnień w KSeFToken nie ma uprawnienia InvoiceRead, InvoiceWrite ani CollectiveIdentifierManage. Wygeneruj token z jednym z nich.
Sesja KSeF wygasłaNarzędzie zwykle loguje się ponownie samo. Jeśli komunikat się powtarza, odśwież stronę.
KSeF ogranicza liczbę żądańLimit po stronie Ministerstwa Finansów. Odczekaj minutę i spróbuj ponownie.
Za dużo prób logowania / żądań z tego adresuLimit narzędzia na godzinę dla jednego adresu IP. Spróbuj ponownie za godzinę.
KSeF nie zwrócił żadnych fakturIdentyfikator istnieje w innym środowisku (np. demo zamiast produkcji) albo numer zawiera literówkę, która nie zmienia sumy kontrolnej. Sprawdź środowisko.

FAQ

Dlaczego logowanie do KSeF się nie udaje?

Najczęściej token pochodzi z innego środowiska niż wybrane (tokeny produkcyjne, demo i testowe są osobne), został unieważniony albo NIP w formularzu nie jest NIP-em, dla którego wygenerowano token.

Czy mogę połączyć faktury od różnych sprzedawców w jeden identyfikator?

Nie. KSeF nadaje identyfikator zbiorczy tylko dla faktur jednego sprzedawcy. Dla każdego sprzedawcy trzeba wygenerować osobny identyfikator.

Dlaczego w specyfikacji nie widzę kwot?

Kwoty, waluty i opisy płatności widzi tylko podmiot, który utworzył identyfikator, albo podmiot występujący na danej fakturze. Pozostali widzą same numery KSeF.

Czy narzędzie zapisuje token KSeF?

Nie. Serwer PewnyJPK.pl przekazuje token do API Ministerstwa Finansów tylko po to, by otworzyć sesję, i niczego nie zapisuje. Token zostaje w przeglądarce wyłącznie wtedy, gdy zaznaczysz „Zapamiętaj token”.

Bezpłatny PDF + newsletter

Lista kontrolna JPK_KR_PD na e-mail

20 punktów, których nie sprawdzi bramka MF, z objaśnieniami i kalendarzem sezonu 2027. Wyślemy ją po potwierdzeniu zapisu, a potem nowe artykuły poradnika i zmiany w JPK_KR_PD. Wypiszesz się jednym kliknięciem z każdej wiadomości.

Zanim wyjdziesz

Zabierz bezpłatny PDF: lista kontrolna JPK_KR_PD

Bezpłatnie
  • 20 punktów, których nie sprawdzi bramka MF
  • Objaśnienia, wskazówki i typowe błędy z praktyki
  • Kalendarz sezonu 2027 – od pliku próbnego do 31 lipca

Podaj e-mail – PDF wyślemy od razu po potwierdzeniu zapisu, a potem nowe artykuły poradnika. Wypiszesz się jednym kliknięciem.