Informacje ogólne
Dokumenty, które
mogą być wysyłane do KSeF:
- Faktury sprzedaży (w przypadku, gdy faktura posiada powiązania z wydaniami zewnętrznymi, do KSeF wysyłana jest również informacja o numerach dokumentów WZ)
- Faktury VAT marża
- Faktury zaliczkowe
- Korekty wystawione do wyżej wymienionych dokumentów za wyjątkiem korekty danych
Przed wysłaniem faktury do KSeF, każdorazowo wyżej wymienione dokumenty zostaną zweryfikowane co do zgodności ze strukturą. Po pozytywnej weryfikacji poprawności dokumentu, będzie on mógł zostać przesłany do KSeF.
Istnieją dwie możliwości wysyłki faktur do KSeF:
- automatycznie po zatwierdzeniu dokumentu – wymagane jest zaznaczenie parametrów na karcie operatora, na zakładce [Parametry] w podzakładce [Wspólne]:
- Prawo do wysyłania e- faktur/odbioru UPO
- Wysyłanie przy zatwierdzaniu dokumentu.
Podczas wysyłki automatycznej program także weryfikuje dokumenty pod kątem zgodności ze strukturą KSeF. Jeśli są rozbieżności, pojawi się komunikat:
Faktura jest niezgodna ze strukturą e-Faktury. Faktura nie może zostać wysłana do KSeF. Czy chcesz poprawić błędy i zatwierdzić dokument. Tak Nie
Wybór opcji
Tak skutkuje powróceniem do edycji dokumentu.
Po zaznaczeniu opcji
Nie – faktura zostaje zatwierdzona, a program wyświetli ostrzeżenie:
Nie udało się wysłać dokumentu do KSeF ze szczegółami dotyczącymi nieprawidłowości w strukturze wysyłanego dokumentu
. Po zatwierdzeniu, dokumentu nie będzie można już edytować.
Istnieje także możliwość seryjnego zatwierdzania dokumentów. W przypadku korzystania z wysyłki automatycznej, faktury będą wysyłane natychmiastowo po ich zatwierdzeniu). Podczas wykonywania operacji seryjnego zatwierdzania dokumentów, faktury niezgodne ze strukturą KSeF nie zostaną zatwierdzone ani rozliczone. Zostanie wyświetlony komunikat blokujący to działanie:
Faktura jest niezgodna ze strukturą e-Faktury. Faktura nie może zostać wysłana do KSeF
- ręcznie w wybranym przez operatora terminie – po naciśnięciu ikony
z poziomu listy faktur
Operator ma możliwość nie tylko wysyłki pojedynczego dokumentu, ale także opcję seryjnego wysyłania faktur do KSeF po zaznaczeniu wybranych faktur na liście. Podczas takiej wysyłki nie ma możliwości uwierzytelnienia przy pomocy tokenu. Również podczas tego typu wysyłki system sprawdzi zgodność dokumentu ze strukturą KSeF. W przypadku rozbieżności pojawi się komunikat:
Faktura jest niezgodna ze strukturą e-Faktury. Faktura nie może zostać wysłana do KSeF.
Po wysłaniu faktury do KSeF oraz pobraniu UPO, na formularzu faktury bądź faktury korygującej, na zakładce
[KSeF] automatycznie zostaną uzupełnione pola dotyczące danych faktury w KSeF.

Na wydruku sPrint, faktur, które zostały wysłane do KSeF i dla których pobrano UPO umieszczane są dodatkowe informacje: numer KSeF oraz link weryfikacyjny. Na podstawie linku weryfikacyjnego generowany jest kod QR, który umożliwia weryfikację faktury w systemie KSeF.

Podczas konfigurowania szablonu wiadomości e-mail oraz SMS dla faktur sprzedaży, faktur zakupu i w Rejestrach VAT istnieje możliwość dodania makra z numerem KSeF.
W celu dodania numeru KSeF do szablonu wiadomości, należy na otwartym formularzu szablonu kliknąć prawym przyciskiem myszy, a następnie z menu kontekstowego wybrać opcję
Wstaw makro. Z wyświetlonej listy makr należy następnie wybrać pozycję
Numer dokumentu KSeF.
Faktury korygujące
Wysłanie do KSeF faktury korygującej możliwe jest, jeśli do faktury korygowanej, która została wcześniej wysłana do KSeF, zostało pobrane UPO. W przeciwnym wypadku korekta nie zostanie wysłana, a program wyświetli stosowną informację:

Jeśli faktura sprzedaży, do której wystawiana jest korekta, nie została wcześniej wysłana do KSeF z poziomu programu, należy w pierwszej kolejności wystawić fakturę pierwotną sprzedaży, a następnie ręcznie uzupełnić jej numer KSeF na zakładce
[KSeF] dostępnej na jej formularzu. Podczas wysyłania korekty do faktury pierwotnej, numer ten jest pobierany do pliku w celu powiązania korekty z dokumentem korygowanym na platformie KSeF. Na podstawie tej informacji dokument wysłany do KSeF otrzyma odpowiedni znacznik. Jeżeli użytkownik nie posiada numeru KSeF dla dokumentu źródłowego to identyfikacja odbywa się na podstawie numeru pierwotnego lub numeru systemowego.
Faktury zaliczkowe
W sytuacji gdy do KSeF została wysłana faktura zaliczkowa do której nie zostało pobrane UPO, program uniemożliwi wysyłkę faktury sprzedaży rozliczającej daną zaliczkę. Podczas próby wysyłki faktury sprzedaży pojawi się informacja: [Numer faktury] – nie odebrano UPO dla dokumentu zaliczki.
Przekazywanie do KSeF informacji o Podmiocie 3
Zgodnie ze strukturą logiczną faktur przesyłanych do KSeF Podmiot 3 przeznaczony jest do uzupełnienia informacji o podmiotach trzecich, innych niż sprzedawca (Podmiot1) i nabywca (Podmiot2), które są powiązane z daną fakturą.
Na dokumentach handlowych na zakładce
[KSeF], dostępna jest podzakładka
[Dodatkowe dane].
Na tej zakładce w sekcji
Dodatkowy podmiot użytkownik ma możliwość wprowadzenia danych dodatkowego podmiotu związanego z transakcją. Uzupełnienie tych informacji jest opcjonalne. Na jednej fakturze można wskazać maksymalnie 100 podmiotów trzecich.

W sekcji dostępne są następujące kolumny widoczne domyślnie:
Rola
W polu rola istnieje możliwość wskazania następujących wartości:
- Faktor
- Odbiorca
- Podmiot pierwotny
- Dodatkowy nabywca
- Wystawca faktury
- Dokonujący płatności
- JST – wystawca
- JST – odbiorca
- GV – wystawca
- GV – odbiorca
- Pracownik
- Rola inna
Imię i nazwisko (nazwa)
Pole wymagane. Służy do określenia imienia i nazwiska lub nazwy podmiotu. Użytkownik ma możliwość ręcznego wpisania wartości, bądź wybrania podmiotu z listy kontrahentów.
Adres
Pole służy do wprowadzenia adresu Podmiotu 3. Jeśli podmiot został wybrany z listy, adres zostanie automatycznie pobrany z kartoteki kontrahenta, natomiast jeśli podmiot został wpisany ręcznie, adres należy wprowadzić samodzielnie.
Typ identyfikatora
W polu
Typ identyfikatora dane pobierane są automatycznie z kartoteki kontrahenta, jeśli został on wybrany z listy.
Istnieje również możliwość ręcznego wyboru jednej z poniższych wartości:
- NIP
- Numer VAT-UE
- Identyfikator podatkowy inny
- Identyfikator wewnętrzny
Kod kraju
Pole przeznaczone na wskazanie kodu kraju właściwego dla identyfikatora.
Dane identyfikacyjne
Pole służy do uzupełnienia numeru zgodnego z wybranym typem identyfikatora.
Opis roli
Pole staje się aktywne i wymagane, gdy w polu Rola wybrano wartość Rola inna. W pozostałych przypadkach pozostaje nieaktywne.
Przekazywanie do KSeF informacji o warunkach transakcji
Na formularzu faktury sprzedaży oraz korekty, na zakładce
[KSeF] w pionowej zakładce
[Dodatkowe dane], dostępna jest sekcja
Informacje dodatkowe. Ma ona strukturę drzewa, w ramach którego pogrupowano poszczególne kategorie danych.
Aby dodać nowe informacje, należy skorzystać z rozwijanego menu dostępnego przy ikonie plusa

lub ustawić się na odpowiedniej gałęzi drzewa w której użytkownik chce wprowadzić dane po czym nacisnąć ikonę zielonego plusa

.
W sekcji tej użytkownik może zdefiniować następujące dane:
- Lista umów – pozwala na wprowadzenie daty i numeru umowy, której dotyczy faktura.
- Lista zamówień – umożliwia wpisanie daty i numeru zamówienia.
- Lista numerów partii towaru – pole tekstowe na numer partii.
- Kurs umowny – pozwala na podanie kursu i kodu waluty (gdy jest inny niż systemowy).
- Lista transportów – rozbudowana sekcja umożliwiająca określenie rodzaju transportu (np. drogowy, morski, kolejowy), opisu ładunku, jednostek opakowania oraz dat rozpoczęcia i zakończenia transportu.
- Warunki dostawy – dodatkowe pole tekstowe opisujące warunki dostarczenia towaru.
- Podmiot pośredniczący – znacznik informujący o udziale podmiotu trzeciego w transakcji.

Poprawność wprowadzonych danych (np. format daty) jest weryfikowana przez system w momencie wysyłki faktury do KSeF.
Przekazywanie do KSeF informacji o nowych środkach transportu
Przepisy wymagają, aby przy sprzedaży unijnej nowych środków transportu poza standardowymi elementami faktury uwzględnić także dodatkowe dane identyfikujące środek transportu.
Na formularzu pozycji faktury sprzedaży na zakładce
[KSeF] w sekcji
Dodatkowe dane dostępna jest lista
Nowy środek transportu pozwalającą na uzupełnienie stosownych informacji. Ma ona strukturę drzewa, która pozwala na precyzyjne określenie parametrów pojazdu.
Dane zostały pogrupowane według typu środka transportu:
- Pojazd lądowy – umożliwia wprowadzenie takich informacji jak: przebieg, typ pojazdu, VIN (lub numer nadwozia/podwozia/ramy), data dopuszczenia do użytku, marka, model, kolor, numer rejestracyjny oraz rok produkcji.
- Jednostka pływająca – pozwala na określenie: daty dopuszczenia do użytku, liczby godzin roboczych, numeru kadłuba, a także marki, modelu, koloru, numeru rejestracyjnego oraz roku produkcji.
- Statek powietrzny – obejmuje dane takie jak: data dopuszczenia do użytku, liczba godzin roboczych, numer fabryczny, marka, model, kolor, numer rejestracyjny oraz rok produkcji.

Wybór konkretnego typu z listy powoduje wyświetlenie odpowiednich pól dedykowanych dla danej kategorii.
Poprawność danych uzupełnionych w polu wartość walidowana jest w momencie wysyłania faktury do KSeF.
Przekazywanie do KSeF informacji o identyfikatorze wewnętrznym odbiorcy
Na formularzu kontrahenta, w zakładce
[Ogólne] w sekcji
Inne dodano pole
Identyfikator wewnętrzny. Umożliwia ono wpisanie indywidualnego identyfikatora podmiotu, który będzie przekazywany do KSeF.
Podczas wysyłania faktury do KSeF, gdy na dokumencie wskazano zarówno nabywcę, jak i odbiorcę, system przekazuje dane zgodnie z poniższymi zasadami:
- Nabywca i odbiorca mają ten sam numer NIP – do KSeF przekazywana jest informacja o roli odbiorcy wraz z Identyfikatorem wewnętrznym (jeśli został uzupełniony). W tym przypadku numer NIP nie jest przekazywany.
- Nabywca i odbiorca mają różne numery NIP – do KSeF przekazywana jest informacja o roli odbiorcy wraz z jego numerem NIP.
- Odbiorca nie posiada numeru NIP – do KSeF przekazywana jest informacja o roli odbiorcy z adnotacją Brak identyfikatora.
Przekazywanie do KSeF dodatkowego opisu
W programie istnieje możliwość przekazywania do KSeF dodatkowych informacji w węźle
<DodatkowyOpis>. W ten sposób użytkownik może ręcznie zdefiniować dowolne informacje, dla których nie przewidziano dedykowanych pól w standardowej strukturze KSeF. Dane te wprowadza się jako parę: nazwa pola (Klucz) oraz jego treść (Wartość).
Przykład
Klucz: Numer_Projektu | Wartość: PL-2026-X1
Klucz: Nr_Rejestracyjny | Wartość: WA12345
Klucz: Miejsce_Dostawy | Wartość: Rampa_Nr_4
Formularz faktury sprzedaży
Na formularzu faktury sprzedaży oraz korekty na zakładce
[KSeF] w podzakładce
[Dodatkowe dane], w sekcji
Informacje dodatkowe dodana została gałąź
Lista dodatkowy opis. Umożliwia ona ręczne definiowanie dodatkowych informacji w strukturze „Klucz-Wartość”.
Aby dodać nowy wiersz w którym uzupełnione zostaną dodatkowe dane, należy wskazać na gałęzi opcję
Lista dodatkowy opis, a następnie wybrać ikonę zielonego plusa

.
Wiersz dodatkowego opisu można dodać również poprzez opcję
Dodaj opis dostępną z poziomu rozwijanego menu dostępnego przy ikonie plusa.

Lista
dodatkowy opis składa się z pól:
- Klucz – nazwa dodatkowej informacji dla odbiorcy dokumentu (np. Numer projektu, Kod sklepu, ID dostawcy).
- Wartość – konkretna treść tej informacji.
faktury odnoszą się do całego dokument. Podczas generowania faktury ustrukturyzowanej XML trafiają do sekcji <Fa>/<DodatkowyOpis> bez znacznika <NrWiersza>.
W programie możliwe jest również przesyłanie do KSeF tekstowego opisu faktury zdefiniowanego na formularzu faktury, na zakładce
. Pozwala ona na dodanie specyficznych informacji dotyczących konkretnego towaru lub usługi (np. Kod towaru u nabywcy, Marka, Kolor).
Zasady obsługi tej listy (dodawanie oraz edycja wierszy) są analogiczne jak w przypadku nagłówka dokumentu.
W tym przypadku do pliku XML przekazywany jest dodatkowo numer wiersza faktury, którego dotyczy opis.
Integracja programu z KSeF pozwala na obsłużenie wysyłki części pól opcjonalnych. Od wersji 2026.1.1 umożliwione zostało przekazywanie informacji o następujących polach:
, istnieje możliwość określania okresu obowiązywania umowy – czyli przedziału dat, którego dotyczy faktura. Wprowadzone wartości są wysyłane do KSeF i odpowiadają polom P_6_Od (data początkowa) oraz P_6_Do (data końcowa) w strukturze logicznej FA(3). Dzięki temu możliwe jest prawidłowe przesyłanie dokumentów związanych z usługami ciągłymi, abonamentowymi i okresowymi. Należy podkreślić, że wprowadzone daty obowiązują dla całej faktury, a nie osobno dla poszczególnych pozycji. Dodatkowo, jeśli na fakturze wprowadzono okres obowiązywania umowy, podczas wysyłki faktury do KSeF nie jest przekazywana data sprzedaży podana na zakładce [Ogólne] formularza dokumentu.
umożliwiająca przypisanie do towaru kodu GTU oraz procedury przewidzianej w strukturze e-faktur. We wskazanych polach istnieje możliwość wybrania z listy odpowiednich wartości, które są zgodne z danymi udostępnionymi przez Ministerstwo Finansów.
W momencie dodania towaru na dokument kod GTU oraz procedury są automatycznie przenoszone na formularz faktury na zakładkę
Jeżeli jednak kod GTU lub procedura zostanie później zmieniona z poziomu formularza pozycji dokumentu, to zmiana ta nie jest przenoszona na zakładkę
formularza faktury. Oznacza to, że do KSeF zawsze trafią dane widoczne bezpośrednio na pozycji dokumentu w zakładce
Jeśli na pozycji faktury wprowadzono PKWiU, dane te zostaną przekazane wraz z fakturą do systemu KSeF.
[/su_list]