Logowanie certyfikatem do KSeF – przeglądarka, instalacja .p12 i typowe kody
Dwie rodziny certyfikatów
- Certyfikat kwalifikowany – przechowywany w systemie lub na nośniku (np. karta, token); wymaga poprawnej instalacji i ważności.
- Certyfikat KSeF – generowany w KSeF i zwykle eksportowany jako plik
.p12; musi być używany w tym samym środowisku (testowym albo produkcyjnym), którego używasz do logowania.
Warto pamiętać, że Firefox korzysta z własnego magazynu certyfikatów – import w Chrome lub systemie nie oznacza automatycznej widoczności w Firefoxie.
Gdzie importować plik .p12 (skrót)
| Środowisko | Gdzie szukać importu |
|---|---|
| Google Chrome | Ustawienia → Prywatność i bezpieczeństwo → Bezpieczeństwo → Zarządzanie certyfikatami → zakładka „Osobiste” → import |
| Microsoft Edge | Ustawienia → Prywatność, wyszukiwanie i usługi → Bezpieczeństwo → Zarządzanie certyfikatami → „Osobiste” → import |
| Mozilla Firefox | Ustawienia → Prywatność i bezpieczeństwo → Certyfikaty → „Wyświetl certyfikaty” → „Twoje certyfikaty” → import |
| Safari (macOS) | Aplikacja „Dostęp do pęku kluczy” (Keychain Access) – import pliku i powiązanie z kluczem prywatnym |
Po imporcie sprawdź, czy certyfikat ma powiązany klucz prywatny i czy nie wygasł.
Typowe kody i co z nimi zrobić (skrót)
| Kod / sytuacja | Najczęstsza przyczyna | Kierunek działania |
|---|---|---|
| 403 | Brak uprawnień do danej czynności mimo poprawnego logowania | Sprawdzenie i ewentualne nadanie uprawnień w KSeF (np. w Aplikacji Podatnika); po zmianie odczekanie kilku minut |
| 400 (brak podpisu) | Problem z podpisem pliku autoryzacyjnego | Pobrać wyzwanie ponownie, podpisać jednym poprawnym podpisem, nie modyfikować pliku po podpisaniu |
| 415 | Osoba podpisująca nie ma wymaganych uprawnień w danym kontekście | Użycie podpisu osoby z odpowiednimi uprawnieniami; w spółkach mogą obowiązywać dodatkowe zasady reprezentacji |
| 21111 | Nieaktualne lub ponownie użyte wyzwanie | Powtórzyć cały proces autoryzacji od początku |
| 21115 | Niewłaściwy certyfikat (np. środowisko testowe zamiast produkcyjnego) | Użyć certyfikatu zgodnego z właściwym środowiskiem |
| 9103 | Więcej niż jeden podpis na pliku autoryzacyjnym | Użyć jednej metody podpisu i jednego podpisu |
Komunikaty po stronie przeglądarki (np. błędy MAC przy nieprawidłowym haśle do .p12) zwykle oznaczają błędne hasło lub uszkodzony plik. W takiej sytuacji pomocne może być wygenerowanie nowego certyfikatu w Aplikacji Podatnika KSeF 2.0: Zapomniane hasło do certyfikatu.
Czego KSeF nie sprawdza
Błędy instalacji certyfikatu lub kody autoryzacji dotyczą dostępu do systemu, a nie poprawności merytorycznej faktur. Poprawne logowanie certyfikatem nie zastępuje kontroli biznesowej dokumentów.
Jak można to zweryfikować automatycznie
W integracjach monitoruj ważność certyfikatów i alerty o błędach podpisu osobno od walidacji treści faktur po ich pobraniu z KSeF.
FAQ
Dlaczego certyfikat widoczny w Chrome nie działa w Firefoxie?
Firefox ma własny magazyn certyfikatów — import w Chrome nie przenosi pliku
.p12 automatycznie do Firefox.
Co oznacza błąd MAC przy imporcie .p12?
Zwykle błędne hasło do pliku lub uszkodzony eksport. Hasła nie da się odzyskać — trzeba wygenerować nowy certyfikat.
Czy certyfikat testowy zadziała w produkcji?
Nie. Certyfikat musi pochodzić z tego samego środowiska (DEMO lub PROD), w którym logujesz się do KSeF.
Powiązane wpisy
- Przewodnik po błędach logowania (hub) – indeks komunikatów i kolejne kroki
- Błąd 401 – kontekst, uprawnienia, token – sesja i token w API
Powiązane artykuły
- KSeF certyfikat – jak wygenerować – skąd wziąć plik .p12
- Zapomniane hasło do certyfikatu KSeF – co zrobić gdy nie pamiętasz hasła
- Logowanie do KSeF 2.0 w Aplikacji Podatnika – jak wejść do portalu i wybrać kontekst NIP
Treść ma charakter informacyjny i edukacyjny. Nie stanowi porady prawnej ani podatkowej.
Przydatne serwisy
Pierwszy serwis prezentuje informacje o statusie samego KSeF, drugi – komunikaty techniczne Ministerstwa Finansów.