Jak połączyć program do faktur z KSeF? Instrukcja integracji przez token
Dowiedz się, jak połączyć program do faktur z KSeF przez token, jak działa certyfikat oraz czym różnią się przypisane do nich uprawnienia.
Spis treści
Aby połączyć program do faktur lub aplikację mobilną z Krajowym Systemem e-Faktur (KSeF), wygeneruj token w Aplikacji Podatnika KSeF 2.0 i wprowadź go w programie. Token pozwala uwierzytelnić połączenie z API KSeF w zakresie uprawnień przypisanych podczas jego tworzenia.
Token jest jedną z obsługiwanych metod. Faktino pozwala również uwierzytelniać się certyfikatem KSeF typu 1. Ten artykuł pokazuje konfigurację tokena; w dalszej części wyjaśniamy różnicę między zakresem tokena a uprawnieniami używanymi razem z certyfikatem.
W tym poradniku pokazujemy, czym jest token KSeF, jak go wygenerować i bezpiecznie przekazać do aplikacji. Opisujemy także, jakie uprawnienia mogą być potrzebne do odbierania oraz wystawiania faktur.
Na czym polega integracja oprogramowania z KSeF?
Integracja oznacza, że program komunikujący się z KSeF przez API może uwierzytelnić się tokenem i wykonywać operacje dozwolone przez przypisane mu uprawnienia. Użytkownik nie musi wtedy przechodzić przez logowanie do Aplikacji Podatnika przy każdym połączeniu programu z systemem.
Token KSeF jako klucz dostępu do API
Token to wygenerowany w KSeF ciąg znaków przypisany do podatnika lub uprawnionego podmiotu oraz określonego zakresu dostępu. W zależności od wybranych uprawnień może służyć między innymi do przeglądania faktur lub ich wystawiania przez zintegrowany program.
Token nie jest hasłem do portalu ani nie zastępuje wszystkich metod logowania w każdej sytuacji. Jest metodą uwierzytelnienia programu komunikującego się z KSeF przez API. Pełny token wyświetla się przy generowaniu tylko raz, dlatego skopiuj go od razu i przechowuj jak poufny klucz dostępowy.
Aktualizacja dotycząca ważności tokenów: w FAQ zaktualizowanym przez Ministerstwo Finansów w październiku 2026 r. podano, że tokeny w KSeF 2.0 pozostaną dostępne bezterminowo. Tokeny i certyfikaty KSeF działają równolegle.
Jakie są metody autoryzacji w KSeF? Porównanie techniczne
Token i certyfikat KSeF mogą służyć do uwierzytelnienia połączenia programu z systemem, ale nie są równoważne pod względem uprawnień. Podczas generowania tokena wybierasz jego zakres, na przykład przeglądanie faktur albo ich wystawianie. Certyfikat KSeF typu 1 potwierdza tożsamość, a KSeF sprawdza uprawnienia przypisane do osoby lub podmiotu. Certyfikat typu 2 służy do oznaczania faktur w określonych trybach offline. Tokeny i certyfikaty typu 1 działają równolegle.
| Metoda | Do czego służy | Ważna informacja |
|---|---|---|
| Token KSeF | Uwierzytelnia program lub aplikację przez API. | Podczas generowania wybierasz zakres, nie szerszy niż Twoje uprawnienia w danym kontekście. |
| Certyfikat KSeF | Certyfikat typu 1 uwierzytelnia osobę lub podmiot; typ 2 służy do faktur w określonych trybach offline. | Certyfikat nie zawiera osobno wybieranego zakresu tokena; KSeF sprawdza uprawnienia przypisane do jego identyfikatora. |
| Podpis lub pieczęć kwalifikowana | Może służyć do uwierzytelnienia w KSeF, zależnie od osoby i kontekstu podmiotu. | Wymagania zależą od sytuacji; sprawdź instrukcje MF dla swojego podmiotu. |
Jak połączyć aplikację z KSeF w 3 prostych krokach?
Do konfiguracji potrzebujesz dostępu do Aplikacji Podatnika KSeF 2.0, uprawnienia do działania w kontekście właściwego podatnika oraz programu obsługującego integrację z KSeF. Sposób uwierzytelnienia w aplikacji rządowej dobierz do sytuacji swojej firmy. W Faktino możesz połączyć się tokenem albo certyfikatem KSeF typu 1.
Krok 1: wygeneruj token w Aplikacji Podatnika KSeF 2.0
- Otwórz stronę Aplikacji Podatnika KSeF 2.0 Ministerstwa Finansów i przejdź do aplikacji.
- Zaloguj się dostępną dla Ciebie metodą i wybierz właściwy kontekst podmiotu.
- Otwórz sekcję Tokeny, wybierz Generuj token i wpisz nazwę, która pomoże Ci później rozpoznać jego przeznaczenie.
- Zaznacz wymagane uprawnienia. Do odczytu potrzebne jest przeglądanie faktur; do wystawiania faktur sprzedażowych wymagane jest uprawnienie do ich wystawiania. Możesz przypisać tokenowi jedno lub kilka uprawnień, których sam masz prawo udzielić w danym kontekście.
- Wygeneruj token i od razu go skopiuj. Pełna wartość nie będzie ponownie wyświetlona.
Krok 2: zainstaluj i otwórz program
Zainstaluj wybrany program do faktur lub aplikację mobilną z oficjalnego sklepu albo źródła wskazanego przez dostawcę. Sprawdź, czy oprogramowanie obsługuje integrację z KSeF 2.0 i operacje, których potrzebujesz, na przykład pobieranie albo wystawianie faktur.
Faktino działa bez zakładania dodatkowego konta użytkownika. Token można dodać podczas konfiguracji aplikacji. Faktino obsługuje też certyfikat KSeF typu 1 — wybierz tę metodę w konfiguracji aplikacji zgodnie z jej instrukcją. Zakres działań wynika wtedy z uprawnień przypisanych w KSeF do osoby lub podmiotu, a nie z zakresu ustawianego osobno w certyfikacie.
Krok 3: dodaj token i sprawdź połączenie
- Otwórz w programie ustawienia połączenia z KSeF.
- Wklej token lub użyj obsługiwanej metody jego przekazania.
- Zapisz ustawienia i wykonaj testowe połączenie lub synchronizację zgodnie z instrukcją programu.
Dlaczego architektura Local-First ma znaczenie?
W modelu Local-First dane i środek uwierzytelnienia pozostają na urządzeniu użytkownika, a aplikacja łączy się bezpośrednio z KSeF. Oznacza to brak serwera pośredniczącego Faktino przechowującego kopię tokena i pobranych faktur. Ogranicza to ryzyko związane z przechowywaniem tych informacji w bazie zewnętrznego dostawcy, ale nie usuwa ryzyka utraty lub nieuprawnionego dostępu do samego telefonu.
- Środek uwierzytelnienia pozostaje na urządzeniu: nie przekazuj tokena ani certyfikatu w wiadomościach ani osobom, które nie powinny mieć dostępu do faktur.
- Połączenie prowadzi do KSeF: przesyłanie danych odbywa się pomiędzy aplikacją a systemem Ministerstwa Finansów.
- Dbaj o dostęp do telefonu: stosuj blokadę ekranu, aktualizuj system i unieważnij token w KSeF, jeśli podejrzewasz, że ktoś mógł go przejąć.
Najczęstsze pytania o integrację przez token KSeF
Czy do wygenerowania tokena potrzebuję podpisu kwalifikowanego?
Niekoniecznie. Osoba fizyczna może uwierzytelnić się metodą dostępną w KSeF i posiadającą właściwe uprawnienia. W przypadku spółek lub działania w imieniu innego podmiotu wymagania mogą być inne. Sprawdź instrukcję Ministerstwa Finansów dotyczącą swojego kontekstu.
Czy jeden token może służyć do odczytu i wystawiania faktur?
Tak, podczas generowania można przypisać tokenowi kilka uprawnień, jeśli osoba lub podmiot tworzący token ma do nich prawo. Możesz również rozdzielić zadania między osobne tokeny. Nadawaj tylko te uprawnienia, których wymaga wybrany program.
Czy token KSeF jest ważny bezterminowo?
Według FAQ Ministerstwa Finansów zaktualizowanego w październiku 2026 r. możliwość korzystania z tokenów w KSeF 2.0 pozostaje bezterminowa. Token można unieważnić w systemie, jeżeli nie jest już potrzebny lub mógł zostać ujawniony.
Czy certyfikat KSeF ma taki sam zakres uprawnień jak token?
Nie. Tokenowi można przypisać wybrany zakres podczas generowania. Certyfikat KSeF typu 1 służy do uwierzytelnienia, a KSeF sprawdza uprawnienia przypisane do osoby lub podmiotu. Jeśli potrzebujesz ograniczyć integrację do wybranych czynności, token pozwala określić taki zakres osobno.
Co zrobić, jeśli nie skopiuję tokena albo go zgubię?
Pełny token jest prezentowany tylko raz. Jeśli go nie masz, wygeneruj nowy. Jeżeli nieznany token mógł uzyskać dostęp do danych, unieważnij go w KSeF, o ile masz wymagane uprawnienia.
Czy biuro rachunkowe może korzystać z tego samego tokena?
Token jest przypisany do określonego kontekstu i zakresu uprawnień. Dostęp dla biura rachunkowego ustal zgodnie z zasadami nadawania uprawnień w KSeF oraz polityką bezpieczeństwa firmy. Nie przekazuj tokena bez uzgodnienia, kto i do jakich operacji będzie go używać.
Warto zapamiętać
- Wygeneruj token w Aplikacji Podatnika KSeF 2.0, w odpowiednim kontekście podmiotu.
- Dobierz uprawnienia do potrzeb programu: osobno zwróć uwagę na odczyt i wystawianie faktur.
- Skopiuj token od razu, przechowuj go bezpiecznie i unieważnij, gdy przestanie być potrzebny albo podejrzewasz jego ujawnienie.
- FAQ MF z października 2026 r. wskazuje, że tokeny i certyfikaty będą działały równolegle, a możliwość korzystania z tokenów pozostanie bezterminowa.
Jeśli chcesz przejść przez sam proces tworzenia tokena, zobacz również poradnik: jak wygenerować token KSeF krok po kroku. Więcej o architekturze danych opisujemy w artykule o bezpiecznym wystawianiu faktur w modelu Local-First.
Źródła i przydatne informacje
Chcesz szybciej sprawdzać faktury z KSeF?
Faktino pomaga kontrolować faktury zakupowe i sprzedażowe, terminy płatności oraz statusy dokumentów bez dodatkowego konta i bez reklam. Dane pozostają lokalnie na urządzeniu użytkownika.