Współpraca z KSeF


Wymagane lub mocno zalecane minimalne wersje programów współpracujących z KSeF to "na dziś":

CV_SYSTEM - 1.10f41 z 2026-02-08
KSEF_HTTP - 1.1.59 z 2026-02-08
KSEF_CERT - 1.04 z 2026-01-14
CV_KSEF - 1.1.26 z 2026-02-08 - ten moduł nie jest wymagany do pracy CV_SYSTEM ale warto go zainstalować.



Aby uruchomić współpracę z KSeF należy przygotować certyfikaty lub tokeny dostępowe (opcja znacznie mniej skomplikowana) uprawniające do wystawiania (odbierania) faktur dla poszczególnych użytkowników systemu. Można też przygotować tylko jeden certyfikat bądź token, dostępny dla wszystkich użytkowników. Na etapie testów a nawet w pierwszych tygodniach pracy z KSeF może to być zdecydowanie wygodniejsze rozwiązanie. Później... kwestia do decyzji, być może też wystarczy jeden. Dla wygody i... bezpieczeństwa, bo to kto i o której godzinie wystawił fakturę jest rejestrowane również dzisiaj, więc taki certyfikat (token) nie tylko nic nie wnosi jeśli chodzi o kontrolowanie dostępu do wystawiania faktur a niestety (jeśli trafi do rąk użytkownika, który teoretycznie jest jego właścicielem) pozwala na wykorzystanie go również poza firmą i wystawianie faktur co niekoniecznie ma sens.
Certyfikaty i tokeny można wygenerować przy pomocy Aplikacji Podatnika Ministerstwa Finansów (tu link do aplikacji w wersji testowej https://web2te-ksef.mf.gov.pl/web/).
Aplikacja MF dostępna jest dla każdego z trzech trybów współpracy z KSeF czyli dla wersji testowej, wersji demo i wersji produkcyjnej. Dla każdej z tych wersji potrzebne są niezależnie wygenerowane certyfikaty lub tokeny pozwalające na uwierzytelnienie w KSeF.
Wersja testowa pozwala pracować z dowolnym, wymyślonym, formalnie poprawnym NIP-em i służy raczej do testów oprogramowania. Nie powinno się w niej używać prawdziwych danych, gdyż potencjalnie każdy ma do tych danych dostęp.
Wersja demo pozwala pracować z własnym NIP-em (nikt inny nie ma do dostępu do danych) ale dokonane przy jej pomocy wpisy nie będą uznawane przez Ministerstwo Finansów za oficjalne, więc można (i należy) z niej skorzystać w ramach przygotowań do uruchomienia KSeF w wersji produkcyjnej co na dziś oznacza obowiązkowo kwiecień 2026.
W praktyce oznacza to, że w styczniu 2026 powinno się rozpocząć testy czyli uruchomić KSeF w trybie DEMO.

UWAGA: możliwość zdefiniowania certyfikatów lub tokenów w Aplikacji Podatnika Ministerstwa Finansów jest dostępna po wcześniejszym złożeniu w Urzędzie Skarbowym formularza ZAW-FA, na którym podaje się listę osób (wraz z Peselem) uprawnionych do korzystania z tej aplikacji w kontekście danej firmy (czyli jej NIP-u). Po 2-3 dniach od złożenia formularza można już się logować do aplikacji Ministerstwa Finansów własnym Peselem i profilem zaufanym.
Dostęp do wersji testowej nie wymaga żadnych uprawnień. Dostęp do aplikacji w wersji demo i produkcyjnej wymaga uprawnień nadanych za pomocą ZAW_FA.


Uruchomienie komunikacji z KSeF z poziomu programu Comvar-CV_SYSTEM wymaga kolejno:
1 - przygotowania dwóch certyfikatów (lub dwóch dla każdego użytkownika) do pracy on-line i off-line za pomocą właściwej Aplikacji Podatnika Ministerstwa Finansów. Każdy certyfikat to dwa fizyczne pliki (.CRT i .KEY)
Alternatywnie można wygenerować token, który jest ciągiem znaków. Token po pobraniu należy zapisać w Notatniku a potem wkleić do ustawień programu CV_SYSTEM (i/lub CV_KSEF).
2 - zainstalowania aplikacji KSeF_cert dostępnej w zakładce "programy do pobrania" i użycia jej do konwersji certyfikatów uzyskanych w kroku nr.1 do postaci wymaganej przez KSeF (czyli plików .PFX i .CER). Aplikację KSeF_cert wystarczy zainstalować na jednym komputerze, bo jest potrzebna tylko do jednorazowej konwersji certyfikatów, które po wczytaniu do CV_SYSTEM będą przechowywane w bazie danych i stamtąd pobierane do bieżącej pracy.
Tokeny są gotowe do użycia od razu.
3 - zainstalowania aplikacji KSeF_HTTP dostępnej w zakładce "programy do pobrania", która jest elementem pośredniczącym pomiędzy CV_SYSTEM i KSeF. UWAGA: serwer HTTP powinien być zainstalowany na każdym komputerze, który jest przewidziany do wystawiania faktur. To właśnie KSeF_HTTP zajmuje się właściwą komunikacją z KSeF a polecenia otrzymuje od CV_SYSTEM (lub od CV_KSEF) i tam zwraca wyniki.
4 - skonfigurowania CV_SYSTEM czyli wczytania certyfikatów lub tokenów, ustalenia portów komunikacji z serwerem HTTP (czyli z KSeF_HTTP) i trybu współpracy z KSeF (test, demo, produkcyjny).
UWAGA: ponieważ zarówno KSeF_cert jak i KSeF_HTTP tworzą własne katalogi na dysku C komputera w katalogu c:\comvar należy zapewnić możliwość utworzenia na dysku takiego katalogu i przyznać mu pełne uprawnienia. Domyślny port komunikacji z KSeF_HTTP to 8080 ale w razie braku do niego dostępu program będzie próbował użyć kolejnych numerów - warto się upewnić czy używane porty nie są zablokowane na poziomie Windows (raczej nie są).

Informacje szczegółowe

W ustawieniach administratora programu CV_SYSTEM należy wybrać tryb współpracy z KSeF. Widać to na poniższym rysunku.


Rys.1

O ile nie korzystamy jeszcze z KSeF należy zaznaczyć "nie korzystam". Teoretycznie wolno tak postąpić nawet po kwietniu 2026, bo aplikacja Ministerstwa Finansów pozwala wprowadzić fakturę do KSeF ręcznie lub wczytać ją z pliku a CV_SYSTEM generuje takie pliki. Oczywiście nie ma to większego sensu a przy dużej ilości faktur jest wręcz mało realne. Ale mając jedną czy dwie faktury dziennie... czemu nie? KSeF jest przewidziany tylko dla faktur VAT i jak na razie można pomijać faktury VAT wystawione dla osób fizycznych. W wielu przypadkach może to oznaczać niewielką ilość dokumentów, które rzeczywiście muszą być przesłane do KSeF.

Rozszerzone parametry współpracy z KSeF widoczne są na rys.2.

Rys.2

Na ekranie parametrów należy wczytać klucze szyfrowania udostępnione przez Ministerstwo Finansów (przez kliknięcie w link "pobierz klucz publiczny". UWAGA: od wersji 1.10f01 klucze szyfrowania wczytywane są dynamicznie podczas wystawiania faktur) oraz certyfikaty dla poszczególnych trybów pracy (test, demo, produkcyjny). Te certyfikaty będą dostępne dla wszystkich użytkowników CV_SYSTEM o ile nie będą dla nich zdefiniowane certyfikaty indywidualne.
W przypadku przygotowania osobnych certyfikatów dla poszczególnych użytkowników można je wczytać w opcji "pracownicy" na karcie pracownika, w zakładce "KSeF". Można tam również zdefiniować port na którym będzie się odbywać komunikacja z KSeF_HTTP ale nie jest to konieczne chyba że chodzi o pracę na zdalnym pulpicie i sytuację w której dysk C: może być wspólny dla kilku użytkowników a aplikacja KSeF_HTTP może być w używana jednocześnie (na tym samym komputerze) przez więcej niż jednego użytkownika.
Na ekranie parametrów można też upewnić się, że połączenie z wcześniej zainstalowanym serwerem HTTP na podanym porcie działa poprawnie.
UWAGA: serwer HTTP wymaga środowiska NET Core 9.0 co oznacza że będzie działał tylko na komputerze z Windows 10 lub wyższym. Może pojawić się konieczność doinstalowania NET Core 9.0 ale komputer powiadomi o takiej konieczności.




Pobranie tokenów dostępowych - opcja zalecana!
Tokeny są znacznie wygodniejsze od certyfikatów. Po zalogowaniu się do Aplikacji Podatnika należy w menu wybrać opcję "tokeny".

Rys.2a


Następnie po zaznaczeniu opcji "wystawianie faktur" i "przeglądanie faktur" należy wcisnąć "generuj token"

Rys.2b


Ostatni krok to skopiowanie gotowego tokena do schowka Windows i zapisanie gdzieś "ku pamięci"

Rys.2c


Teraz pozostaje wklejenie go w ustawieniach administratora lub u każdego pracownika w opcji "kody dostępu" - na obecnym etapie zdecydowanie zalecane jest to pierwsze rozwiązanie.

Gotowe!, można testować KSeF. Zarówno jeśli chodzi o faktury sprzedaży jak i o pobieranie faktur zakupu (w module CRD, opis na końcu tej strony).

Rys.2d




Przygotowanie certyfikatów - na tym etapie opcja niezalecana! Można ten fragment pominąć.
Przygotowanie certyfikatów składa się z dwóch etapów. Najpierw po zalogowaniu się do aplikacji Ministerstwa Finansów na uprawnieniach właścicielskich należy przydzielić uprawnienia poszczególnym przyszłym użytkownikom (czyli co najmniej jednemu). Widać to na rys.3a, 3b i 3c.

Rys.3a

Rys.3b

Rys.3c


Teraz taki uprawniony użytkownik może już sam zalogować się do Aplikacji użytkownika Ministerstwa Finansów (w tym samym trybie, w którym nadano mu uprawnienia czyli TEST, DEMO lub produkcyjnym - ta ostatnia aplikacja ma być dostępna od 1-go lutego). Należy podać nazwę certyfikatu (na przykład imię i nazwisko użytkownika) i utworzyć hasło, które trzeba będzie podać podczas konwersji certyfikatu do postaci wymaganej przez KSeF. Ponieważ potrzebne są dwa certyfikaty do różnych celów konieczne jest nadanie każdemu z nich innej nazwy. Na przykład: jan_kowalski_online i jan_kowalski_offline. Albo po prostu janek i janek_off. Ważne jest jedynie to by później móc je łatwo rozpoznać w folderze certyfikatów czy to podczas konwersji do formatu wymaganego przez KSeF, czy podczas podpinania do parametrów pracy programu lub kont użytkowników.
Na rys.4a, 4b i 4c widać w jaki sposób uprawniony wcześniej użytkownik loguje się własnym peselem (i profilem zaufanym).


Rys.4a

Rys.4b

Rys.4c


Po pobraniu certyfikatów rys.5a należy wystąpić o drugi certyfikat, do pracy offline - rys.5b.


Rys.5a

Rys.5b

Jak widać na rys.6 każdy gotowy certyfikat to dwa pliki. Jeden o rozszerzeniu CRT a drugi KEY. Te pliki nie nadają się wprost do wczytania do parametrów programu (rys.2) lub do danych użytkownika w opcji "kody dostępu". Muszę zostać przetworzone do postaci roboczej złożonej z plików PFX i CER.

Rys.6

Konwersję do postaci PFX, CER można z robić za pomocą programu KSeF_cert.exe, który należy zainstalować najlepiej w domyślnej lokalizacji czyli w folderze c:\comvar\KSeF_cert (link do instalatora jest tu: - pobierz KSeF_cert).
Pliki CRT i KEY uzyskane za pomocą aplikacji Ministerstwa Finansów należy zapisać w folderze c:\comvar\KSeF_cert\certyfikaty. Po uruchomieniu programu KSeF_cert należy wskazać certyfikat do konwersji. Przykład widoczny jest na rys.7a. Na ekranie wyświetlana jest lista par CRT i KEY dostępnych w folderze c:\comvar\KSeF_cert\certyfikaty jako jedna pozycja. Wystarczy wskazać jej numer na liście. Po dwukrotnym podaniu hasła nadanego w aplikacji Ministerstwa Finansów właściwe pliki zostaną wygenerowane i zapisane w tym samym folderze. Widać to na rys.7a i 7b.
Dla uproszczenia procesu nowe hasło do plików wynikowych PFX i CER zostanie nadane przez program i później automatycznie wykorzystane przez CV_SYSTEM - nie trzeba będzie go nigdzie podawać.
UWAGA: po wygenerowaniu właściwych certyfikatów PFX i CER program proponuje by podać NIP firmy i tryb (TEST, DEMO, PRODUKCYJNY). Ta opcja umieści kopię certyfikatów w folderze c:\comvar\firmy\nip_firmy\certyfikaty gdzie staną się dostępne dla programu CV_KSEF, który można zainstalować jako dodatkowy w celu pobierania z KSeF faktur zakupu i sprzedaży a następnie wyświetlana ich wizualizacji z numerem KSeF i kodem kreskowym, który go zawiera. Taką fakturę można wydrukować lub zapisać w formie PDF.
Nie ma potrzeby instalowania CV_KSEF, gdyż CV_SYSTEM pozwala pobrać faktury (zwłaszcze kosztowe) ale jeśli trzeba mieć dostęp do faktur wielu firm wówczas CV_KSEF, który pozwala mieć ich dowolną ilość (biuro rachunkowe) może być dobrym rozwiązaniem.

Rys.7a

Rys.7b



Działanie

Podstawowym celem komunikacji z KSeF jest przesyłanie w czasie rzeczywistym wystawionych faktur VAT na serwery Ministerstwa Finansów bez możliwości późniejszej ingerencji w ich treść.
Ewentualne zmiany będą polegać wyłącznie na korektach wcześniej wystawionych faktur. Tworząc taką korektę trzeba będzie powołać się na numer nadany przez KSeF fakturze pierwotnej.
Na rys.8 widać w jaki sposób CV_SYSTEM umieszcza numer nadany przez KSeF na wydruku faktury.

Rys.8

Proces wystawiania faktury nie różni się niczym od dotychczasowego. Jedynym nowym elementem będzie znacznik statusu widoczny na formularzu faktury - rys.9. Po kliknięciu w przycisk "rejestracja" na znaczniku statusu będą widoczne kolejne etapy komunikacji z KSeF.

Rys.9

Po zakończeniu rejestracji i wysłaniu faktury do KSeF pojawi się informacja o możliwości pobrania UPO - rys.10. Teoretycznie UPO nie musi być (i pewnie nie będzie) dostępne od razu ale w ramach działania systemu testowego można je rzeczywiście ściągnąć bezpośrednio po rejestracji faktury.

Rys.10

Rejestrację faktury kończy zamknięcie sesji komunikacji z KSeF. Widać to na rys.11.

Rys.11


Wystawione i zapisane w KSeF faktury - rys.12 - oznaczane są w archiwum zielonym wskaźnikiem "ok".

Rys.12

Po wejściu w opcję "KSeF" z poziomu archiwum widoczne są szczegóły sesji i numer nadany przez KSeF. Można też pobrać UPO (jeśli nie było dostępne od razu) a nawet numer KSeF, bo teoretycznie nawet on nie musi być nadany od razu i może być konieczne pobranie go później. Oczywiście w takim przypadku nie pojawi się on na wydruku faktury ale na późniejszymn wydruku duplikatu już tak.

Rys.13


UPO można obejrzeć i ewentualnie (tylko po co?) wydrukować. Można też obejrzeć fakturę w formie w jakiej została wysłana do KSeF.

Korekty faktury
Proces wystawiania korekty do faktury również nie różni się w niczym od dotychczasowego. Podobnie jak w przypadku faktur widoczny jest wskaźnik statusu a rejestrację kończy sugestia pobrania UPO.

Informacje pomocnicze
Faktury które z różnych względów nie trafiły do KSeF (brak uprawnień dla użytkownika, brak programu do komunikacji KSeF_HTTP na komputerze użytkownika, świadoma decyzja o braku wysyłki - rys.14 itp) można wysłać do KSeF później z poziomu archiwum, za pomocą opcji widocznej na rys.15.

Rys.14

Należy pamiętać, że wysyłanie w ten sposób faktur ma sens tylko w tym samym dniu, bo data faktury jest nadawana przez KSeF.

Rys.15

Taka opcja pozwala na przykład ograniczyć kwestię wysyłki do tylko jednego komputera (z zainstalowanym KSeF_HTTP) i tylko do jednej osoby ale w zasadzie nie jest w pełni zgodna z duchem KSeF choć na pewno jest zgodna z jego literą. Pozwala też na wykorzystanie starszych komputerów, które wprawdzie są w stanie zarejestrować fakturę ale nie byłyby w stanie wysłać jej do KSeF. Oznacza to możliwość wykorzystania komputerów z Windows 7 a nawet takich z Windows Xp po zainstalowaniu ograniczonej wersji CV_SYSTEM dla nich przeznaczonej.

Działanie

Głownym celem KSeF jest rejestrowanie wystawionych faktur sprzedaży. Faktura staje się oficjalnie fakturą dopiero po otrzymaniu zwrotnie numeru pod jakim została zarejestrowana w KSeF. Również "data wystawienia" to data, pod którą fakturę zarejestrował KSeF a nie to co podał wystawca faktury.
Ale drugim celem KSeF jest dostarczanie podmiotowi faktur zakupu czyli faktur sprzedaży wystawionych przez dostawców. Te faktury można pobierać z KSeF i zapisywać w systemie zarówno w rejestrze kosztów FTR jak i w przypadku faktur towarowych przyjmować jako w formie PZ w module MGZ.

Testowa wersja opcji przyjmowania faktur zakupowych dostępna jest w module CRD czyli Centralnym Rejestrze Dokumentów. Widać to na rys.16.


Rys.16


Po zalogowaniu do KSeF można pobrać faktury zakupowe wystawione w zadanym okresie czasu i wprowadzić je do Centralnego Rejestru Dokumentów, gdzie później mogą być przekazane dalej (do rejestru kosztów lub do magazynu).
Zamknięcie okna powoduje wylogowanie z KSeF.


Rys.17


Faktury oznaczone jako "dla MGZ" mogą być pobrane automatycznie do magazynu. Indeksy magazynowe zostaną nadane automatycznie lub nie, zależnie od ustawień w parametrach KSeF.


Rys.18