Czy KSeF działa na systemach Linux i macOS - sprawdzamy fakty

KSeF w przeglądarce - zero instalacji, ale z obostrzeniami

AITekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Aplikacja Podatnika KSeF online udostępniona przez Ministerstwo Finansów pod adresem jest rozwiązaniem typu WebGUI, które nie wymaga instalacji natywnego oprogramowania na dysku twardym. Logowanie do KSeF z systemów Linux i macOS odbywa się za pośrednictwem bezpiecznego protokołu TLS i wymaga uwierzytelnienia za pomocą podpisu kwalifikowanego, profilu zaufanego lub tokena generowanego w systemie. WebGUI umożliwia realizację podstawowych operacji, takich jak podgląd faktur, pobieranie dokumentów XML oraz ręczna wysyłka pojedynczej faktury, co jest wystarczające dla mikroprzedsiębiorców generujących znikomą liczbę dokumentów miesięcznie.

Mimo uniwersalności dostępu przez przeglądarkę, rozwiązanie to posiada istotne ograniczenia techniczne, z których najpoważniejszym jest brak możliwości masowej wysyłki faktur. W przypadku systemów Unix-like (Linux, macOS, BSD) Ministerstwo Finansów nie udostępnia natywnej aplikacji desktopowej, co wymusza na użytkownikach korzystanie z interfejsu webowego lub zewnętrznych integratorów. WebGUI KSeF działa na każdym systemie z nowoczesną przeglądarką, jednak Ministerstwo Finansów nie udostępnia API w technologii REST dla osób prywatnych - komunikacja zintegrowana odbywa się wyłącznie poprzez protokół SOAP.

Wymagania techniczne dotyczące przeglądarek są precyzyjnie określone dla zapewnienia stabilności sesji i bezpieczeństwa kryptograficznego. Minimalne wspierane wersje oprogramowania to Google Chrome 109, Mozilla Firefox 102 oraz Apple Safari 15. Należy zaznaczyć, że przeglądarka Microsoft Edge uruchamiana w środowisku Linux pod emulatorem Wine nie jest oficjalnie wspierana i może generować błędy podczas próby nawiązania połączenia z modułem uwierzytelniania. Dla poprawnego działania niezbędne jest włączenie obsługi JavaScript oraz wyłączenie mechanizmów blokowania okien typu pop-up, które są wykorzystywane podczas procesów autoryzacji ePUAP.

Użyj przeglądarki w trybie incognito, by uniknąć konfliktów z wtyczkami i zainstaluj dodatek do podpisu kwalifikowanego tylko z oficjalnych repozytoriów dostawców usług zaufania.

Natywne programy księgowe na Linuxa i macOS z integracją KSeF

Przedsiębiorcy poszukujący stabilności operacyjnej powinni rozważyć natywne programy do faktur na Linux i macOS, które eliminują potrzebę korzystania z warstw emulacji. Program FakturaLight jest przykładem nowoczesnej aplikacji opartej na frameworku Qt6, co gwarantuje pełną wydajność na dystrybucjach takich jak Ubuntu 20.04+, Fedora 38+ oraz systemie macOS 12+. Oprogramowanie to umożliwia bezpośrednią integrację z Krajowym Systemem e-Faktur, obsługując automatyczną walidację dokumentów oraz pobieranie Urzędowego Poświadczenia Odbioru (UPO) bez konieczności opuszczania interfejsu programu.

FakturaLight oferuje token KSeF wbudowany bezpośrednio w ustawienia profilu podatnika, co pozwala na autoryzację sesji bez wywoływania zewnętrznych apletów Javy czy dodatkowych sterowników. System zapewnia elastyczność w zarządzaniu bazami danych, oferując współpracę z silnikami PostgreSQL oraz MySQL, co jest standardem w środowiskach Linux. Dzięki temu możliwa jest synchronizacja faktur między wieloma stanowiskami w sieci lokalnej (LAN) lub przez bezpieczne tunele VPN, zapewniając spójność danych w czasie rzeczywistym.

Kolejnym rozwiązaniem jest system Rachunek (Fineco), który dostarcza dedykowane pakiety instalacyjne .deb dla systemów Debian/Ubuntu oraz .rpm dla dystrybucji openSUSE i Fedora. Wersja przeznaczona na systemy Linux nie wymaga technologii Docker ani środowiska Wine, będąc instalowaną bezpośrednio przez systemowy menadżer pakietów. Program automatycznie generuje pliki JPK_FA i przesyła je do infrastruktury MF przez API SOAP, działając w architekturze klient-serwer, co optymalizuje procesy księgowe w większych podmiotach gospodarczych.

• FakturaLight oferuje token KSeF wbudowany w ustawienia - bez osobnej aplikacji.
• Rachunek automatycznie generuje JPK_FA i wysyła go do KSeF przez API SOAP w trybie klient-serwer.
• Obie aplikacje udostępniają 30-dniowy okres testowy bez danych produkcyjnych.

Rozwiązania hybrydowe: Docker, Wine i wirtualizacja

W sytuacjach, gdy przedsiębiorca jest przywiązany do oprogramowania dostępnego wyłącznie na system Windows, np. Subiekt GT, konieczne jest zastosowanie rozwiązań hybrydowych. Środowisko Wine 9.x (Wine Is Not an Emulator) pozwala na uruchamianie binariów Windowsowych bezpośrednio na jądrze Linux. Instalacja stabilnej wersji odbywa się zazwyczaj poprzez systemowy menadżer pakietów, na przykład komendą sudo dnf install wine-9.0 w systemach z rodziny RHEL/Fedora. Należy jednak liczyć się z pułapkami, takimi jak brak natywnej obsługi podpisu kwalifikowanego przez bibliotekę CryptoAPI oraz potencjalne problemy z renderowaniem czcionek TrueType (TTF).

Alternatywą dla bezpośredniej emulacji jest konteneryzacja z wykorzystaniem platformy Docker. Możliwe jest przygotowanie obrazu opartego na Ubuntu 22.04 z zainstalowanym środowiskiem Wine 9.0, co pozwala na izolację aplikacji księgowej od systemu operacyjnego hosta. Taki kontener wymaga skonfigurowania przekierowania gniazda X11 lub Wayland socket, aby umożliwić wyświetlanie interfejsu graficznego (GUI). Choć Wine 9.x poprawnie uruchamia silnik bazodanowy i interfejs Subiekta GT, tokeny USB (np. eTP) często pozostają niewidoczne wewnątrz kontenera ze względu na ograniczenia w mapowaniu urządzeń znakowych.

Najbardziej niezawodnym, choć najbardziej obciążającym zasoby rozwiązaniem, jest pełna wirtualizacja przy użyciu oprogramowania VirtualBox lub VMware. Instalacja Windows 10 Lite w maszynie wirtualnej zużywa około 2 GB pamięci RAM i pozwala na bezproblemowe przekierowanie fizycznego portu USB z tokenem kryptograficznym do systemu gościa. Rozwiązanie to gwarantuje pełną zgodność ze sterownikami dostarczanymi przez producentów certyfikatów kwalifikowanych, co jest kluczowe w procesie autoryzacji w KSeF.

Bezpieczeństwo podpisu i tokenów na Linux/macOS

Autoryzacja w systemie KSeF wymaga zastosowania bezpiecznych mechanizmów podpisu elektronicznego. Na systemach Linux obsługa tokenów USB realizowana jest przez standard PKCS#11. Użytkownicy muszą wskazać w oprogramowaniu księgowym ścieżki do odpowiednich bibliotek współdzielonych, takich jak /usr/lib/opensc-pkcs11.so dla projektów OpenSource lub /usr/local/lib/libeTPkcs11.so dla tokenów Eutron. Weryfikację poprawności wykrycia czytnika kart inteligentnych można przeprowadzić w terminalu za pomocą komendy pkcs11-tool --list-slots. Warto pamiętać, że przeglądarki Firefox od wersji 115 wymuszają ręczne dodanie modułu bezpieczeństwa PKCS11 w ustawieniach prywatności.

Dla użytkowników systemu macOS sytuacja jest ułatwiona od wersji 13.0 (Ventura), która rozpoznaje tokeny Lightning i USB-C jako natywne karty inteligentne (smartcards) bez konieczności instalacji dodatkowego oprogramowania middleware. System Apple integruje te urządzenia z pękiem kluczy (Keychain Access), co pozwala na płynną autoryzację w sesjach przeglądarkowych KSeF. Profil Zaufany pozostaje jednak najbardziej uniwersalną alternatywą, ponieważ nie wymaga żadnych zewnętrznych sterowników USB. Procedura logowania obejmuje wybór opcji „Połącz z KSeF” na portalu MF, a następnie autoryzację poprzez skanowanie kodu QR w aplikacji mobilnej mObywatel lub zatwierdzenie operacji w bankowości elektronicznej.

Bezpieczeństwo danych wrażliwych wymaga również dbałości o kopie zapasowe kluczy prywatnych. Zaleca się eksport certyfikatów do formatu .p12 i przechowywanie ich w zaszyfrowanych sejfach haseł. Tokeny zgodne z PKCS#11, dostarczane przez certyfikowane centra takie jak Certum czy EuroCert, działają w przeglądarkach Chrome i Firefox na systemie Linux bez konieczności instalacji dedykowanych sterowników producenta, o ile w systemie zainstalowany jest demon pcscd.