Integracja systemu finansowo-księgowego z Krajowym Systemem e-Faktur nie sprowadza się wyłącznie do podania danych logowania i włączenia nowej funkcji w programie. Trzeba ustalić sposób uwierzytelniania, nadać właściwe uprawnienia, zdecydować, które osoby mogą wysyłać i pobierać faktury, sprawdzić zgodność danych ze strukturą KSeF oraz przetestować proces przed rozpoczęciem codziennej pracy.

Dlatego integracje z KSeF warto rozpatrywać jako wdrożenie całego procesu obsługi faktur, a nie pojedynczą czynność techniczną. Dobrze przygotowane połączenie pozwala wystawiać, wysyłać i odbierać faktury z wykorzystywanego na co dzień programu, bez konieczności wykonywania każdej operacji bezpośrednio w aplikacji Ministerstwa Finansów.

Na czym właściwie polega integracja z KSeF?

Integracja umożliwia komunikację z KSeF za pośrednictwem zewnętrznego oprogramowania. Może to być program do fakturowania, system finansowo-księgowy, ERP albo platforma automatyzująca obieg dokumentów.

Od strony technicznej wymiana danych może odbywać się poprzez API KSeF 2.0. Ministerstwo Finansów udostępnia jego dokumentację, środowisko produkcyjne, środowisko integracyjne oraz środowisko przedprodukcyjne Demo. Dzięki temu producenci oprogramowania i przedsiębiorstwa tworzące własne rozwiązania mogą przygotować oraz przetestować komunikację swoich systemów z KSeF.

Nie każda firma musi jednak samodzielnie programować integrację. Jeżeli wykorzystywane oprogramowanie jest już połączone z KSeF, konfiguracja po stronie przedsiębiorstwa może ograniczać się przede wszystkim do uwierzytelnienia, ustawienia uprawnień oraz określenia zasad obsługi dokumentów.

Jak przygotować firmę do uruchomienia KSeF?

Krok 1. Ustal, jak obecnie wygląda obieg faktur

Przed rozpoczęciem konfiguracji warto ustalić, kto faktycznie uczestniczy w procesie fakturowania. W małej działalności może to być jedna osoba, natomiast w większej organizacji dokumenty mogą przechodzić przez dział sprzedaży, księgowość, controlling, osoby zatwierdzające wydatki i zewnętrzne biuro rachunkowe.

Trzeba odpowiedzieć przede wszystkim na kilka praktycznych pytań. Kto wystawia faktury? Kto powinien mieć dostęp do faktur zakupowych? Czy księgowość prowadzona jest wewnętrznie, czy przez biuro rachunkowe? Czy dokumenty wymagają akceptacji przed zaksięgowaniem? Czy firma korzysta z jednego systemu ERP, czy z kilku narzędzi?

To ważne, ponieważ KSeF umożliwia korzystanie z systemu nie tylko samemu podatnikowi, lecz także wskazanym osobom i podmiotom, w tym między innymi biurom rachunkowym.

Krok 2. Wybierz sposób pracy z KSeF

Firma może korzystać bezpośrednio z narzędzi Ministerstwa Finansów albo pracować w zewnętrznym programie zintegrowanym z KSeF.

Drugie rozwiązanie jest szczególnie istotne w przedsiębiorstwach, w których faktura jest częścią większego procesu. Samo wysłanie dokumentu do KSeF może być tylko jednym etapem. W praktyce trzeba jeszcze przypisać dokument do kontrahenta, określić kategorię kosztową, przeprowadzić akceptację, przekazać go do księgowania, sprawdzić płatność i przechowywać informacje dostępne dla odpowiednich pracowników.

Jeżeli celem jest połączenie obsługi KSeF z szerszą automatyzacją księgowości, sprawdź SaldeoSMART i zobacz, jak może wyglądać wysyłanie oraz pobieranie faktur bezpośrednio z jednego środowiska. Połączenie z KSeF, pobieranie dokumentów oraz wysyłanie faktur są dostępne bez konieczności dokupowania odrębnego modułu, a dostęp do funkcji można kontrolować za pomocą uprawnień użytkowników.

Krok 3. Zweryfikuj uprawnienia w KSeF

Samo techniczne połączenie programu z API nie oznacza jeszcze, że konkretny użytkownik może wystawiać albo pobierać faktury. KSeF weryfikuje zarówno tożsamość, jak i posiadane uprawnienia.

Szczególnie ważne jest prawidłowe uporządkowanie uprawnień w spółkach oraz organizacjach, w których z systemu korzysta wiele osób. Jeżeli podmiot nie ma możliwości elektronicznego uwierzytelnienia się odpowiednią pieczęcią kwalifikowaną, w określonych przypadkach pierwszą osobę uprawnioną można wskazać poprzez zawiadomienie ZAW-FA. Osoba posiadająca odpowiednie uprawnienia może następnie nadawać dalsze dostępy elektronicznie.

Nie warto udostępniać wszystkim pracownikom maksymalnego zakresu uprawnień “na wszelki wypadek”. Bezpieczniejszym podejściem jest nadawanie dostępu zgodnie z rzeczywistą rolą użytkownika.

Jak uwierzytelnić system połączony z KSeF?

Krok 4. Wybierz odpowiednią metodę uwierzytelnienia

W KSeF 2.0 dostępnych jest kilka metod uwierzytelnienia, a właściwy sposób zależy między innymi od rodzaju podmiotu i wykorzystywanego oprogramowania.

Jednym z rozwiązań jest certyfikat KSeF. Służy on do uwierzytelniania w systemie, a odpowiedni certyfikat jest również wykorzystywany przy wystawianiu dokumentów w trybach szczególnych, takich jak offline24, tryb offline związany z niedostępnością KSeF oraz tryb awaryjny.

Od lutego 2026 roku wnioskowanie o certyfikat i jego pobieranie jest możliwe poprzez API KSeF 2.0 oraz Aplikację Podatnika KSeF 2.0. Certyfikat jest ważny maksymalnie przez dwa lata, dlatego jego cykl życia powinien zostać uwzględniony w procedurach firmy.

W systemie funkcjonują również tokeny jako metoda uwierzytelnienia. Wybierając rozwiązanie dla firmy, warto jednak zweryfikować, jaką metodę obsługuje konkretny program oraz czy organizacja potrzebuje możliwości pracy w trybach szczególnych.

Jak skonfigurować połączenie w wykorzystywanym programie?

Krok 5. Dodaj dane potrzebne do komunikacji z KSeF

Dokładny przebieg konfiguracji zależy od systemu. Zwykle trzeba wskazać podmiot, którego faktury będą obsługiwane, skonfigurować metodę uwierzytelnienia i przyznać użytkownikom odpowiednie prawa.

W organizacji posiadającej kilka spółek lub oddziałów konfiguracja wymaga dodatkowej uwagi. Należy sprawdzić, w jakim kontekście podatnika wykonywana jest dana operacja oraz czy użytkownik posiada odpowiedni zakres praw do konkretnego podmiotu.

Na tym etapie warto też ustalić, czy faktury będą pobierane automatycznie, w określonych odstępach czasu czy na żądanie użytkownika.

Jak przygotować faktury do wysyłki?

Krok 6. Sprawdź zgodność danych ze strukturą FA(3)

KSeF nie jest repozytorium zwykłych plików PDF. Faktura ustrukturyzowana posiada określoną strukturę danych i jest przekazywana do systemu w formacie XML.

W KSeF 2.0 wykorzystywana jest struktura logiczna FA(3). Oznacza to, że przed wysłaniem dokumentu dane pochodzące z programu do fakturowania muszą zostać prawidłowo przypisane do odpowiednich elementów wymaganych przez strukturę.

Ma to znaczenie szczególnie w przypadku rozbudowanych systemów ERP. Jeżeli w firmowym oprogramowaniu istnieją niestandardowe pola dotyczące kontrahenta, zamówienia, sposobu płatności lub danych podatkowych, przed wdrożeniem trzeba sprawdzić, w jaki sposób zostaną odwzorowane w fakturze ustrukturyzowanej.

Dobre oprogramowanie powinno również walidować dokument przed jego wysłaniem. Pozwala to wykryć brakujące lub niepoprawne dane jeszcze przed próbą przekazania faktury do systemu państwowego.

Dlaczego test integracji jest konieczny?

Krok 7. Przetestuj rzeczywiste scenariusze biznesowe

Test polegający na wysłaniu jednej prostej faktury sprzedażowej nie wystarczy. Przed uruchomieniem procesu produkcyjnego warto sprawdzić wszystkie typowe sytuacje występujące w firmie.

Testy powinny objąć między innymi zwykłą fakturę sprzedaży, fakturę zaliczkową, korektę, dokument z kilkoma stawkami VAT, pobieranie faktur zakupowych oraz sytuację, w której dokument zawiera niepoprawne dane.

W przypadku własnej integracji można wykorzystać udostępnione przez Ministerstwo Finansów środowisko integracyjne oraz środowisko Demo. Dokumentacja API KSeF 2.0 zawiera między innymi endpointy, parametry, schematy danych, kody odpowiedzi oraz przykłady obsługi poszczególnych scenariuszy.

Krok 8. Sprawdź, co dzieje się po wysłaniu faktury

Integracja nie powinna kończyć się w momencie kliknięcia przycisku “Wyślij”. System powinien umożliwiać kontrolowanie statusu dokumentu i odpowiednią obsługę odpowiedzi zwracanych przez KSeF.

Warto ustalić, kto reaguje w przypadku odrzucenia dokumentu, gdzie użytkownik zobaczy informację o błędzie i czy proces przewiduje ponowną wysyłkę po poprawieniu danych.

W przypadku integracji przez API znaczenie ma również obsługa informacji zwracanych po przetworzeniu dokumentu, w tym numeru KSeF oraz danych związanych z wysyłką. Część informacji nie musi być dostępna natychmiast w chwili przekazania faktury, dlatego system powinien poprawnie obsługiwać cały cykl komunikacji.

Jak wdrożyć integrację KSeF bez zakłócania pracy księgowości?

Krok 9. Uruchamiaj proces na podstawie ustalonej procedury

Przed przejściem na codzienną pracę warto przygotować krótką procedurę operacyjną. Powinna wskazywać między innymi:

• kto odpowiada za konfigurację i uprawnienia,
• kto wystawia faktury,
• kto kontroluje dokumenty odrzucone przez system,
• jak obsługiwane są faktury zakupowe,
• co zrobić w przypadku niedostępności KSeF,
• gdzie przechowywane są certyfikaty i kto ma do nich dostęp,
• kto odpowiada za odnowienie certyfikatów,
• jak wygląda współpraca z biurem rachunkowym.

Przykładowo w firmie handlowej faktury mogą powstawać automatycznie na podstawie zamówień w ERP, następnie być walidowane i wysyłane do KSeF bez ręcznego przepisywania danych. Faktury kosztowe pobrane z KSeF mogą z kolei trafiać do osoby odpowiedzialnej za dany dział, a po akceptacji do księgowości. W takim modelu integracja nie tylko spełnia wymóg związany z e-fakturowaniem, ale również porządkuje cały przepływ dokumentów.

Jakich błędów unikać podczas uruchamiania integracji?

Jednym z najczęstszych problemów organizacyjnych jest potraktowanie KSeF wyłącznie jako zadania działu księgowego. Integracja może dotyczyć również sprzedaży, IT, administracji, controllingu i osób zatwierdzających koszty.

Drugim błędem jest brak testów na rzeczywistych przypadkach. Prosta faktura testowa nie wykryje problemów pojawiających się przy korektach, zaliczkach, nietypowych danych kontrahenta czy większej liczbie dokumentów.

Trzeci problem to niekontrolowane zarządzanie dostępami. Certyfikat, token albo szerokie uprawnienie do faktur nie powinny być traktowane tak samo jak zwykłe hasło do programu. Ministerstwo Finansów zwraca uwagę na konieczność właściwego pobierania, przekazywania, używania i unieważniania certyfikatów.

Warto również przygotować proces awaryjny. Organizacja powinna wiedzieć, jak postępować, gdy system jest niedostępny lub gdy standardowa komunikacja online nie może zostać wykorzystana.

Jak skutecznie uruchomić integrację z KSeF?

Skuteczne wdrożenie wymaga połączenia trzech elementów: poprawnej konfiguracji technicznej, odpowiedniego modelu uprawnień oraz dobrze zaplanowanego obiegu dokumentów. Dopiero wtedy KSeF może stać się częścią codziennego procesu księgowego zamiast dodatkowym miejscem, które trzeba ręcznie obsługiwać.

Przed uruchomieniem warto przeanalizować obecny obieg faktur, wybrać sposób integracji, skonfigurować uwierzytelnienie i uprawnienia, zweryfikować zgodność dokumentów z FA(3), przetestować różne scenariusze oraz ustalić procedury na wypadek błędów i niedostępności systemu.

Firmy, które nie chcą budować połączenia z API od podstaw, mogą skorzystać z gotowego rozwiązania zintegrowanego z KSeF. Umów prezentację SaldeoSMART i sprawdź w praktyce, jak połączyć pobieranie i wysyłanie e-faktur z ich dalszą obsługą, akceptacją i przygotowaniem do księgowania.

Źródła

SaldeoSMART – KSeF

https://ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/wsparcie-dla-integratorow

https://ksef.podatki.gov.pl/informacje-ogolne-ksef-20/certyfikaty-ksef

https://ksef.podatki.gov.pl/informacje-ogolne-ksef-20/zakres-obowiazkowego-ksef

https://ksef.podatki.gov.pl/pytania-i-odpowiedzi-ksef-20

https://ksef.podatki.gov.pl/wyjasnienia/publikacja-dokumentacji-api-ksef-20-oraz-struktury-logicznej-fa-3-30062025