Certyfikat KSeF

Certyfikat KSeF to certyfikat cyfrowy wydawany przez KSeF, który służy do uwierzytelniania się w systemie (typ 1) albo do oznaczania faktur wystawionych w trybie offline kodem QR potwierdzającym tożsamość wystawcy (typ 2). Jest ważny najwyżej 2 lata. W odróżnieniu od tokenu sam nie niesie żadnych uprawnień.

Inaczej
certyfikat uwierzytelniający KSeF, certyfikat offline KSeF, certyfikat typu 1, certyfikat typu 2, certyfikat KSeF 2.0
  • Stan prawny na
  • Aktualizacja:

Dwa typy certyfikatów

Typ 1Typ 2
Do czegouwierzytelnianie w KSeF (sesje interaktywne i wsadowe w API)oznaczanie faktur offline kodem QR „CERTYFIKAT”
Kiedy potrzebnyprogram łączy się z KSeF certyfikatem zamiast tokenufaktura z trybu offline lub awaryjnego trafia do nabywcy przed wysłaniem do KSeF

Każdy typ generuje się osobno: jeden certyfikat nie obsłuży obu zastosowań.

W praktyce

  • Wniosek. Najpierw trzeba uwierzytelnić się w KSeF jako podatnik albo osoba uprawniona: Profilem Zaufanym, podpisem kwalifikowanym albo kwalifikowaną pieczęcią elektroniczną. Od lutego 2026 r. certyfikaty zamawia się i pobiera w Aplikacji Podatnika KSeF 2.0 albo przez API.
  • Właściciel. Certyfikat wydany osobie może zamówić, pobrać i używać tylko ta osoba. Certyfikat firmy (wydany po uwierzytelnieniu pieczęcią) nie jest przypisany do człowieka, więc firma sama pilnuje, komu go udostępnia.
  • Uprawnienia. Certyfikat niczego nie „odblokowuje”. Gdy zmienią się uprawnienia posiadacza, certyfikat dalej jest ważny, a zmienia się tylko to, co jego posiadacz może zrobić.
  • Programy. Systemy, które używają certyfikatów, muszą obsługiwać podpis XAdES przy uwierzytelnianiu w API i generować link weryfikacyjny do kodów QR faktur offline.

Przykład

Sieć serwisów rowerowych wystawia faktury w punktach, gdzie internet bywa zawodny. Pobiera certyfikat KSeF typu 2 i wgrywa go do programu kasowo-fakturowego. Gdy połączenie znika, program wystawia fakturę w trybie offline24 z dwoma kodami QR, a klient od razu dostaje wydruk. Po powrocie internetu faktura trafia do KSeF.

Powiązane pojęcia

  • Token KSeF

    Token KSeF to poufny ciąg znaków wygenerowany w KSeF, którym program uwierzytelnia się w systemie w imieniu firmy, bez podpisu kwalifikowanego przy każdym połączeniu. Token ma na stałe przypisane uprawnienia wybrane przy jego tworzeniu, np. tylko przeglądanie faktur. Obecnie token nie ma terminu ważności: działa, dopóki ktoś go nie unieważni.

  • Kody QR na fakturach KSeF

    Kody QR na fakturach KSeF to kody weryfikujące umieszczane na wizualizacji faktury, np. wydruku albo PDF-ie. KOD I pozwala sprawdzić fakturę w KSeF i ma pod sobą numer KSeF albo napis OFFLINE. KOD II, z napisem CERTYFIKAT, potwierdza tożsamość wystawcy i występuje tylko na fakturach offline przekazanych przed wysłaniem do KSeF.

  • Tryb offline w KSeF

    Tryb offline to wystawienie faktury elektronicznej w strukturze FA(3) poza KSeF i wysłanie jej do systemu później. Ma dwa warianty: offline24, z którego każdy podatnik może skorzystać z dowolnego powodu (termin: następny dzień roboczy po wystawieniu), oraz tryb niedostępności KSeF ogłoszonej przez Ministerstwo Finansów (termin: następny dzień roboczy po jej zakończeniu).

  • Tryb awaryjny KSeF

    Tryb awaryjny to sposób wystawiania faktur w czasie awarii KSeF ogłoszonej przez Ministerstwo Finansów w BIP i w oprogramowaniu interfejsowym. Faktury wystawia się elektronicznie w strukturze FA(3) poza systemem i wysyła do KSeF w ciągu 7 dni roboczych od zakończenia awarii. Inaczej działa awaria całkowita: wtedy faktur w ogóle nie wysyła się do KSeF.

  • Uprawnienia w KSeF

    Uprawnienia w KSeF określają, kto i co może robić w systemie w imieniu firmy: wystawiać faktury, przeglądać je, zarządzać uprawnieniami innych osób albo obsługiwać jednostki podrzędne. Nadaje je właściciel firmy albo osoba z uprawnieniem do zarządzania uprawnieniami, w Aplikacji Podatnika KSeF albo przez API.

  • Integracja z KSeF

    Integracja z KSeF to połączenie programu z Krajowym Systemem e-Faktur przez publiczne API KSeF 2.0. Może to być program do fakturowania, system księgowy, ERP albo narzędzie do analizy faktur. Dzięki integracji program sam wysyła faktury do KSeF albo je z niego pobiera, bez ręcznej pracy w Aplikacji Podatnika.

Najczęstsze pytania

Czy certyfikat KSeF zastępuje token?

Nie, bo działają inaczej. Token zawiera uprawnienia zadeklarowane przy jego tworzeniu, a certyfikat tylko potwierdza tożsamość. To, co może zrobić posiadacz certyfikatu, zależy od jego uprawnień w danym kontekście. Programy mogą uwierzytelniać się w API jednym i drugim.

Jak długo ważny jest certyfikat KSeF?

Najwyżej 2 lata od dnia utworzenia albo od wskazanej przez podatnika daty początku ważności.

Czy certyfikatem zaloguję się do Aplikacji Podatnika KSeF?

Nie. Certyfikat KSeF służy do uwierzytelniania w API (np. w programach) i do oznaczania faktur offline. Do Aplikacji Podatnika loguje się m.in. podpisem kwalifikowanym, Profilem Zaufanym albo w aplikacji mObywatel.

Czy do trybu offline potrzebny jest certyfikat?

Tak, jeśli fakturę offline udostępniasz nabywcy poza KSeF, zanim trafi do systemu. Drugi kod QR z napisem „CERTYFIKAT” generuje się certyfikatem typu 2.

Źródła

  1. Certyfikaty KSeFMinisterstwo Finansów, ksef.podatki.gov.pl
  2. Kody weryfikujące QRMinisterstwo Finansów, ksef.podatki.gov.pl
  3. Certyfikaty KSeF (dokumentacja KSeF API 2.0)Ministerstwo Finansów, repozytorium CIRFMF/ksef-docs

Treść sprawdzona ze źródłami: . Przepisy o KSeF często się zmieniają, więc przed decyzją podatkową sprawdź aktualny stan w źródłach.

Widzisz błąd albo nieaktualną informację? Daj nam znać, a poprawimy.