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 KSeF | 5265877635-20250826-0100001AF629-AF |
| numer faktury i numer KSeF | Faktura 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
| Miejsce | Co 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 faktury | znaczniki {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
- Na liście dokumentów zaznacz co najmniej 2 faktury z numerem KSeF tego samego sprzedawcy (faktury zakupu albo sprzedaży).
- Kliknij ⋮ Więcej akcji i wybierz Identyfikator zbiorczy dla zaznaczonych (do schowka).
- 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.
- Jeśli ten sam zestaw faktur ma już zapisany identyfikator, panel pokazuje go od razu.
- W przeciwnym razie zobaczysz pytanie z podsumowaniem: NIP sprzedawcy, lista faktur i Do zapłaty razem (osobno dla każdej waluty). Kliknij Pobierz identyfikator.
- Identyfikator trafia do schowka i do okna z podsumowaniem — wklej go w tytuł przelewu w banku.
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:
| Znacznik | Co 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 sprawdzaj | nic — 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 KSeF | nie 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.
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ą kod409z polemkod: ksef_brak_numerui stanem faktury w poluksef_stan(niewyslana,czeka,odrzucona). W starszym API SOAP metodadoGetPdfzwraca błądERR_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.