| Authentication | Offline | |
|---|---|---|
| Do czego służy | Logowanie do KSeF przez API | Faktury offline (KOD II na wizualizacji) |
| Czy pozwala się zalogować | Tak | Nie |
| Kto go potrzebuje | Programy i integracje działające bez udziału człowieka | Firmy korzystające z offline24 lub trybu awaryjnego |
Certyfikaty KSeF: typ Authentication i Offline, jak je uzyskać i po co są firmie
Certyfikat KSeF ma jeden z dwóch typów: do logowania albo do faktur offline. Kto może go uzyskać, jak wygląda wniosek, jakie są limity i kiedy go unieważnić.
Certyfikat KSeF to wewnętrzny certyfikat wydawany przez sam system. Nie jest kwalifikowany, ale KSeF honoruje go przy logowaniu, a przy fakturach offline potwierdza nim tożsamość wystawcy. Jedna ważna zasada z dokumentacji: każdy certyfikat ma tylko jeden typ, Authentication albo Offline. Certyfikatem do logowania nie wygenerujesz drugiego kodu QR na fakturze offline, a certyfikatem Offline się nie zalogujesz.
Dwa typy certyfikatów KSeF
Do czego służy KOD II i jak wygląda faktura offline, opisałem w tekście o trybie offline24.
Kto może złożyć wniosek o certyfikat
Wniosek składa się wyłącznie we własnym imieniu. Dane do certyfikatu KSeF pobiera się z certyfikatu użytego przy logowaniu, a ich zmiana powoduje odrzucenie wniosku. Logowanie musi odbyć się podpisem (XAdES): kwalifikowanym certyfikatem osoby fizycznej, pieczęcią firmową, Profilem Zaufanym albo istniejącym certyfikatem KSeF. Logowanie tokenem KSeF nie pozwala złożyć wniosku o certyfikat.
- 1
Sprawdzenie limitów
KSeF zwraca, ile certyfikatów możesz mieć i czy możesz złożyć kolejny wniosek.
- 2
Pobranie danych do wniosku
System podaje dane identyfikacyjne, które musi zawierać żądanie certyfikacyjne (CSR).
- 3
Wniosek i odbiór
Wysyłasz CSR z wybranym typem certyfikatu i pobierasz gotowy certyfikat.
Limity certyfikatów
- Identyfikator NIP100 certyfikaty
- Identyfikator PESEL6 certyfikaty
- Odcisk palca certyfikatu6 certyfikaty
Limit wniosków jest wyższy: 300 dla NIP-u i 12 dla PESEL-u. Osoba fizyczna, która obsługuje kilka firm, szybko zużyje swoje 6 certyfikatów, jeśli dla każdej integracji robi nowy. Wtedy lepiej zaplanować, który certyfikat do czego służy, albo wystąpić o zwiększenie limitu na uzasadniony wniosek.
Unieważnienie i najczęstsze błędy
- Certyfikat unieważnia właściciel: przy wycieku klucza prywatnego, końcu używania albo zmianie w firmie. Unieważnionego nie da się przywrócić.
- Odrzucony certyfikat przy logowaniu to status 460, opisany w tekście o błędzie uwierzytelnienia. Najczęściej certyfikat wygasł albo jest typu Offline.
- Klucz prywatny certyfikatu trzymany w zwykłym pliku na serwerze sklepu to ryzyko. Powinien być w bezpiecznym magazynie, tak jak token KSeF.
Certyfikat KSeF czy podpis kwalifikowany w integracji
Podpis kwalifikowany należy do konkretnej osoby i zwykle leży na jej karcie albo w chmurze dostawcy, więc nie nadaje się do programu, który loguje się sam o trzeciej w nocy. Do takiej pracy służy certyfikat KSeF typu Authentication albo token KSeF. Certyfikat ma tę przewagę, że ma termin ważności i własny klucz prywatny, którego nie przesyła się nigdzie przy logowaniu. Token jest prostszy w konfiguracji. W obu przypadkach liczy się to, kto go wygenerował i jakie ma uprawnienia.
Ile certyfikatów potrzebuje firma
| Authentication | Offline | |
|---|---|---|
| Sklep internetowy | Jeden dla integracji (albo token) | Jeden, jeśli sklep wystawia faktury offline |
| Firma z kilkoma systemami | Osobno dla każdego systemu | Dla systemów wystawiających offline |
| Biuro rachunkowe | Dla programu biura i księgowych | Zwykle niepotrzebny |
Osobny certyfikat dla każdego systemu daje jedną ważną korzyść: gdy jeden system trzeba odciąć, np. po wycieku klucza albo zakończeniu umowy z dostawcą, unieważniasz jego certyfikat, a reszta działa dalej.
Ważność i odnowienie certyfikatu
We wniosku można wskazać datę początku ważności, a bez niej certyfikat jest ważny od chwili wystawienia. Certyfikat ma też datę końca ważności, po której przestaje działać przy logowaniu i przy kodzie QR II. Najczęstszy scenariusz przestoju integracji to certyfikat, który wygasł w weekend. Dlatego w każdej integracji ustawiam przypomnienie kilka tygodni przed końcem ważności i procedurę wymiany bez przerwy w wysyłce: nowy certyfikat wydany i wgrany, zanim stary przestanie działać.
Na środowisku testowym KSeF można logować się certyfikatem samopodpisanym, więc certyfikat KSeF na TEST da się uzyskać bez podpisu kwalifikowanego. Na produkcji wniosek wymaga logowania podpisem, który identyfikuje Cię naprawdę: kwalifikowanym, pieczęcią firmową albo Profilem Zaufanym. To celowe ograniczenie: certyfikat KSeF ma reprezentować prawdziwą osobę albo firmę.
Źródła: certyfikaty KSeF i limity w dokumentacji Ministerstwa Finansów.
›Czy certyfikat KSeF to to samo co podpis kwalifikowany?
Nie. Certyfikat KSeF wydaje sam system i nie jest kwalifikowany. Działa tylko w KSeF.
›Czy mogę dostać certyfikat dla firmy, w której nie jestem właścicielem?
Certyfikat wystawiasz dla siebie, a dostęp do firmy daje Ci uprawnienie w jej kontekście, nadane zgodnie z tekstem o nadawaniu uprawnień w KSeF.
›Czy sklep potrzebuje certyfikatu, czy wystarczy token?
Do logowania wystarczy token. Certyfikat Offline jest potrzebny, jeśli sklep ma wystawiać faktury offline z KOD II. Obie opcje konfiguruję w integracji KSeF z WooCommerce.
›Czy certyfikat KSeF wygasa?
Tak, ma datę końca ważności. Po niej nie zadziała ani przy logowaniu, ani przy kodzie QR II, więc odnowienie trzeba zaplanować wcześniej.
›Czy mogę użyć jednego certyfikatu w kilku firmach?
Certyfikat reprezentuje Ciebie, a nie firmę. Możesz logować się nim w kontekście różnych NIP-ów, o ile w każdym z nich masz nadane uprawnienia.
Chcesz przegadać swój projekt?
Odpowiadam osobiście w ciągu 24h w dni robocze — bez handlowca po drodze.