KSeF

Numer KSeF w przelewach i identyfikator zbiorczy

Jak panel wpisuje numer KSeF faktury do tytułu przelewu, opisu płatności online i wezwania do zapłaty, jak pobrać identyfikator zbiorczy KSeF dla kilku faktur, znaczniki numeru KSeF w e-mailach i kontrola faktury bez numeru KSeF przed wydaniem klientowi.

Zrzuty ekranu

Dostępność: każdy pakiet. Plik przelewów Elixir i dopasowanie wpłat z wyciągu — pakiet Max (oraz Księgowość).

Po co numer KSeF w przelewie?

Od 1 stycznia 2027 r. płacący za fakturę z KSeF podaje w tytule przelewu numer KSeF tej faktury, a przy jednym przelewie za kilka faktur może podać identyfikator zbiorczy nadany przez KSeF (art. 108g ustawy o VAT).

Panel wpisuje numer KSeF sam wszędzie tam, gdzie sam składa tytuł przelewu albo opis płatności. Faktura, która nie ma numeru KSeF, dostaje tytuł taki jak dotąd.

Ustawienie: tytuł przelewu za fakturę z numerem KSeF

Ustawienia → Integracje → KSeF → pole Tytuł przelewu za fakturę z numerem KSeF. Po zmianie kliknij Zapisz ustawienia.

WartośćPrzykładowy tytuł
numer KSeF i numer faktury (domyślnie)5265877635-20250826-0100001AF629-AF Faktura nr 12/01/2027
sam numer KSeF5265877635-20250826-0100001AF629-AF
numer faktury i numer KSeFFaktura nr 12/01/2027 5265877635-20250826-0100001AF629-AF
bez numeru KSeF (jak dotąd)Faktura nr 12/01/2027

Ustawienie obowiązuje w opisie płatności online, w pliku przelewów Elixir, w wezwaniu do zapłaty i w znaczniku {tytul_przelewu} w e-mailach. Każdy profil firmy ma własne ustawienie.

Gdy tekst jest za długi (np. limit opisu w bramce płatności), panel skraca resztę tytułu — numer KSeF zostaje zawsze cały.

Gdzie panel wpisuje numer KSeF

MiejsceCo zawiera
Opis płatności online (link do zapłaty faktury, każda bramka)„Opłata za fakturę …” z numerem KSeF według ustawienia. Przy Braintree opis widać na stronie płatności w linii Tytuł płatności. Link utworzony przez program Faktura VAT 2027 też dostaje opis z numerem KSeF.
Plik przelewów Elixir (Księgowość → Bank → Przelewy do realizacji)numer KSeF w osobnej linii tytułu przelewu, obok „Faktura …” — patrz Eksport przelewów do banku (Elixir)
Wezwanie do zapłaty PDF (lista dokumentów → ⋮ Więcej akcji)linia Tytułem z numerem KSeF faktury. Wezwanie za kilka faktur ma tytuł jak dotąd.
E-maile do fakturyznaczniki {ksef_number} i {tytul_przelewu} — niżej

Numer KSeF opłacanej faktury wkleisz też sam w bankowości: na liście dokumentów przy dokumencie z numerem KSeF jest ikona Kopiuj numer KSeF — kopiuje numer do schowka.

Rozliczenie wpłaty online działa jak dotąd — opis płatności nie wpływa na to, której faktury dotyczy wpłata.

Przelew za kilka faktur — identyfikator zbiorczy

Identyfikator zbiorczy nadaje KSeF dla zestawu faktur jednego sprzedawcy (od 2 do 500 faktur). Ma 35 znaków i zaczyna się od NIP-u sprzedawcy, np. 7777777777-IZ202704-FFFFFFFFFFFF-FF. Wpisany w tytule zastępuje numery KSeF wszystkich faktur z zestawu.

Zanim go pobierzesz, pamiętaj:

  • każde pobranie daje NOWY identyfikator — także dla tych samych faktur,
  • identyfikatora nie da się zmienić ani usunąć,
  • jedna faktura może być najwyżej w 132 identyfikatorach.

Dlatego panel zapisuje każdy pobrany identyfikator i dla tego samego zestawu faktur używa zapisanego — bez nowego zapytania do KSeF.

Identyfikator zbiorczy wymaga połączenia z KSeF (Ustawienia → Integracje → KSeF).

Z listy dokumentów — gdy płacisz ręcznie w banku

  1. Na liście dokumentów zaznacz co najmniej 2 faktury z numerem KSeF tego samego sprzedawcy (faktury zakupu albo sprzedaży).
  2. Kliknij ⋮ Więcej akcji i wybierz Identyfikator zbiorczy dla zaznaczonych (do schowka).
  3. Panel sprawdza zaznaczone faktury bez łączenia z KSeF: każda musi mieć numer KSeF, wszystkie tego samego sprzedawcy i musi być co zapłacić. Jeśli nie — pokazuje, czego brakuje. Identyfikatora nie pobierzesz dla faktur już zapłaconych („do zapłaty razem 0,00”) ani dla sprzedawcy, którego numer KSeF nie zaczyna się od 10-cyfrowego NIP-u — takie faktury zapłać pojedynczymi przelewami z numerem KSeF w tytule.
  4. Jeśli ten sam zestaw faktur ma już zapisany identyfikator, panel pokazuje go od razu.
  5. W przeciwnym razie zobaczysz pytanie z podsumowaniem: NIP sprzedawcy, lista faktur i Do zapłaty razem (osobno dla każdej waluty). Kliknij Pobierz identyfikator.
  6. Identyfikator trafia do schowka i do okna z podsumowaniem — wklej go w tytuł przelewu w banku.

Lista dokumentów — dwie zaznaczone faktury jednego dostawcy i menu „Więcej akcji” z pozycją „Identyfikator zbiorczy dla zaznaczonych (do schowka)”

Bez połączenia z KSeF pozycja w menu jest nieaktywna.

W pliku przelewów Elixir

Opcja Łącz faktury tego samego dostawcy w jeden przelew robi z kilku faktur dostawcy jeden przelew z identyfikatorem zbiorczym w tytule. Szczegóły: Eksport przelewów do banku (Elixir).

Wpłata od klienta z identyfikatorem zbiorczym

Gdy klient zapłaci za kilka Twoich faktur jednym przelewem z identyfikatorem zbiorczym, Auto-dopasuj w module Bank odczyta z KSeF, których faktur dotyczy, i zaproponuje rozliczenie całego zestawu. Szczegóły: Auto-dopasowanie transakcji bankowych do faktur.

Gdy KSeF nie odpowie jednoznacznie albo odmówi

Panel zapisuje ślad zapytania o identyfikator zanim je wyśle. Dzięki temu drugie okno albo druga osoba na tym samym koncie nie pobierze w tym czasie drugiego identyfikatora dla tych samych faktur.

  • Brak jednoznacznej odpowiedzi (zerwane połączenie, KSeF nie podał wyniku, zapytanie przerwane w trakcie) — identyfikator mógł mimo to powstać. Panel nie ponawia takiego zapytania, a kolejne dla tych samych faktur jest możliwe dopiero po godzinie.
  • Odmowa KSeF — kolejne zapytanie dla tych samych faktur jest możliwe po 24 godzinach od odmowy.
  • Limit zapytań KSeF — panel czeka, aż minie (komunikat podaje, za ile sekund ponowić). Limit przekroczony przy identyfikatorach zbiorczych nie wstrzymuje wysyłki faktur do KSeF.

Gdy KSeF utworzy identyfikator, ale panel nie zdoła go zapisać, okno podaje ten identyfikator — zachowaj go, bo panel nie użyje go przy kolejnym eksporcie.

Numer KSeF w e-mailach — znaczniki

W e-mailach, które panel wysyła razem z fakturą, działają dwa znaczniki:

ZnacznikCo wstawia
{ksef_number}numer KSeF faktury (pusty, gdy faktura go nie ma)
{tytul_przelewu}tytuł przelewu według ustawienia z Ustawienia → Integracje → KSeF; dla faktury bez numeru KSeF — „Faktura nr …”

Panel podstawia je w e-mailu z fakturą (z listy dokumentów i z formularza faktury), w przypomnieniu o płatności (także automatycznym) i w podziękowaniu za płatność — w temacie i w treści. Domyślne treści e-maili się nie zmieniły: numer KSeF pojawia się tylko tam, gdzie treść e-maila zawiera znacznik.

Treść tych e-maili zmienisz w CRM → Szablony e-maili (własna wersja e-maila z fakturą, przypomnienia albo podziękowania — pakiet Max; edytor pokazuje oba znaczniki na liście Dostępne tagi) albo w Ustawienia → Słowniki i wygląd → Wysyłany tekst wiadomości (treść e-maila z fakturą). We własnych szablonach mailingu do kontrahentów znaczniki faktury nie działają — mailing nie dotyczy konkretnej faktury.

Faktura sprzedaży bez numeru KSeF — kontrola przed wydaniem

Ustawienia → Integracje → KSeF → pole Faktura sprzedaży bez numeru KSeF (druk, PDF, e-mail):

WartośćCo robi panel
nie sprawdzajnic — jak dotąd
ostrzegaj (domyślnie)przed Drukuj i Wyślij (e-mailem) pyta, co zrobić z fakturą, która nie ma jeszcze numeru KSeF
wymagaj numeru KSeFnie pozwala wydać klientowi faktury bez numeru KSeF, dopóki numeru nie ma

Przy „ostrzegaj”

Na liście dokumentów okno Faktura bez numeru KSeF ma przyciski:

  • Wyślij do KSeF — wysyła fakturę do KSeF; gdy numer KSeF zostanie nadany od razu, druk albo e-mail idzie dalej bez pytania,
  • Mimo to — drukuje albo wysyła fakturę bez numeru KSeF,
  • Anuluj — nic nie robi.

Okno „Faktura bez numeru KSeF” na liście dokumentów — przyciski Anuluj, Mimo to i Wyślij do KSeF

Faktura, która czeka już na numer KSeF albo została odrzucona przez KSeF, ma w oknie tylko Mimo to i Anuluj. W formularzu faktury okno nie proponuje wysyłki do KSeF — fakturę zapisz i wyślij przyciskiem KSeF na liście dokumentów.

Przy „wymagaj numeru KSeF”

  • Na liście dokumentów okno proponuje tylko Wyślij do KSeF albo Anuluj; faktury czekającej na numer albo odrzuconej nie da się wydrukować ani wysłać.
  • Tak samo blokowane są: druk faktury z faktur cyklicznych, wysyłka przez asystenta w panelu i pobieranie faktury przez klienta w portalu B2B (klient zobaczy, że faktura będzie dostępna po nadaniu numeru KSeF).
  • API: pobranie PDF i wysyłka e-mailem przez REST (GET /documents/{id}/pdf, POST /documents/{id}/send) zwracają kod 409 z polem kod: ksef_brak_numeru i stanem faktury w polu ksef_stan (niewyslana, czeka, odrzucona). W starszym API SOAP metoda doGetPdf zwraca błąd ERR_KSEF_NO_NUMBER. Fakturę wyślij najpierw do KSeF (POST /ksef/send) i ponów żądanie po nadaniu numeru — patrz API REST.
  • Automat faktur do zamówień ze sklepów wysyła e-mail z fakturą dopiero po nadaniu numeru KSeF; e-mail czekający dłużej niż 72 godziny jest pomijany. Jak działa przy tym wtyczka WooCommerce — WooCommerce.
  • Podgląd działa zawsze — faktura bez numeru KSeF ma wtedy napis „PODGLĄD — faktura nie ma jeszcze numeru KSeF”.

Których faktur kontrola nie dotyczy

  • faktur wystawionych w trybie offline (czekających na dosłanie do KSeF),
  • faktur z programu Faktura VAT (synchronizacja), których panel nie wysyłał do KSeF — wysyła je program, a numer KSeF wraca z synchronizacją,
  • faktur wystawionych przed 1 lutego 2026 r.,
  • dokumentów, których panel nie wysyła do KSeF (np. pro forma, rachunek, paragon, faktura zakupu),
  • kont bez włączonej integracji KSeF.

Numer KSeF na fakturze zakupu wpisanej ręcznie

Gdy faktura od dostawcy ma numer KSeF, a nie została pobrana z KSeF, numer wpiszesz w formularzu faktury zakupu — trafi wtedy do tytułu przelewu i do pliku Elixir. Opis pola i kontroli: Pobieranie i import faktur z KSeF, sekcja „Numer KSeF na fakturze zakupu wpisanej ręcznie”.

Synchronizacja z programem Faktura VAT 2027

  • Numer KSeF faktury przechodzi przy synchronizacji na drugą stronę, gdy tam go jeszcze nie ma — także wtedy, gdy fakturę wysłano do KSeF po drugiej stronie.
  • Dwóch różnych numerów KSeF tej samej faktury synchronizacja nie nadpisuje — pokazuje ostrzeżenie.
  • Ustawienia tytułu przelewu i kontroli faktury bez numeru KSeF nie są synchronizowane — w programie i w panelu ustawiasz je osobno.

Zobacz także