Poradnik OtoFaktura

Jak dodać certyfikaty KSeF w OtoFakturze.

Aby dodać certyfikaty KSeF, rozwiń w menu zakładkę Konfiguracja i wybierz Certyfikaty KSeF. Na tej stronie możesz skonfigurować osobno środowisko testowe i produkcyjne.

Załóż konto Wszystkie poradniki
KS

Najkrótsza odpowiedź

  • wejdź w Konfiguracja → Certyfikaty KSeF
  • wybierz środowisko TEST albo PROD
  • ustaw tryb autoryzacji online
  • wgraj certyfikaty online i offline

Środowisko

Wybierz właściwe środowisko KSeF.

Na górze strony wybierz środowisko, dla którego chcesz zapisać certyfikaty:

  • TEST - do próbnej konfiguracji i testów,
  • PROD - do rzeczywistej pracy z KSeF.

Upewnij się, że dodajesz certyfikaty do właściwego środowiska. Certyfikaty testowe i produkcyjne są rozdzielone, dlatego certyfikat testowy dodawaj tylko w środowisku TEST, a certyfikat produkcyjny tylko w środowisku PROD.

Autoryzacja online

Wybierz tryb autoryzacji online.

W sekcji Tryb autoryzacji ONLINE wybierz sposób logowania do KSeF:

  • Token (Bearer) - jeśli korzystasz z tokena autoryzacyjnego,
  • Certyfikat + token jako bearer - jeśli korzystasz z certyfikatu do uwierzytelnienia w KSeF.

Jeżeli nie masz pewności, wybierz tryb zgodny z konfiguracją otrzymaną z KSeF lub od osoby obsługującej księgowość.

W polu NIP wyświetlany jest NIP firmy pobrany z konfiguracji.

Certyfikaty

Dodaj certyfikat online i offline.

Certyfikat online służy do uwierzytelnienia połączenia z KSeF, a certyfikat offline do podpisywania linku lub kodu QR do weryfikacji faktury offline.

Certyfikat online

W sekcji CERTYFIKAT ONLINE wgraj pliki potrzebne do uwierzytelnienia połączenia z KSeF.

  • Online CRT/CER - plik certyfikatu, np. .crt, .cer albo .pem,
  • Online KEY - plik klucza prywatnego, np. .key albo .pem,
  • Hasło do Online KEY - jeśli klucz prywatny jest zabezpieczony hasłem.

Jeśli klucz nie ma hasła, zostaw pole hasła puste.

Certyfikat offline

W sekcji CERTYFIKAT OFFLINE wgraj pliki używane do podpisywania linku lub QR do weryfikacji faktury offline.

  • Offline CRT/CER - plik certyfikatu, np. .crt, .cer albo .pem,
  • Offline KEY - plik klucza prywatnego, np. .key albo .pem,
  • Hasło do Offline KEY - jeśli klucz prywatny jest zabezpieczony hasłem.

Po zapisaniu aplikacja odczyta numer seryjny certyfikatu offline oraz algorytm klucza, jeśli dane są poprawne.

Zapis ustawień

Zapisz konfigurację certyfikatów KSeF.

Po uzupełnieniu danych kliknij Zapisz ustawienia. Jeżeli pliki są poprawne, zobaczysz komunikat o zapisaniu konfiguracji.

Jeżeli po zapisaniu pojawi się błąd, sprawdź, czy wybrano właściwy plik, czy certyfikat i klucz do siebie pasują oraz czy hasło do klucza jest poprawne.

Ważne informacje

O czym pamiętać przy wgrywaniu certyfikatów.

Pliki certyfikatu i klucza

  • Certyfikat i klucz prywatny muszą być parą.
  • Plik certyfikatu nie może zawierać klucza prywatnego.
  • Klucz prywatny wgrywaj tylko w polu KEY.

Formaty i rozmiar plików

  • Dopuszczalne formaty certyfikatu: .crt, .cer, .pem.
  • Dopuszczalne formaty klucza: .key, .pem.
  • Maksymalny rozmiar pojedynczego pliku to 64 KB.

TEST i PROD

  • Certyfikat produkcyjny dodawaj tylko w środowisku PROD.
  • Certyfikat testowy dodawaj tylko w środowisku TEST.
  • Przed zapisem zawsze sprawdź aktywne środowisko.

FAQ

Certyfikaty KSeF - najczęstsze pytania

Gdzie dodać certyfikaty KSeF w OtoFakturze?

Certyfikaty KSeF dodasz w aplikacji w sekcji Konfiguracja → Certyfikaty KSeF.

Czy certyfikaty TEST i PROD są rozdzielone?

Tak. Certyfikaty testowe i produkcyjne są rozdzielone. Certyfikat testowy dodawaj w środowisku TEST, a produkcyjny w środowisku PROD.

Czy muszę podać hasło do klucza prywatnego?

Tylko wtedy, gdy klucz prywatny jest zabezpieczony hasłem. Jeżeli klucz nie ma hasła, zostaw pole hasła puste.

Co oznacza błąd po zapisaniu certyfikatu?

Najczęściej oznacza wybranie niewłaściwego pliku, niedopasowanie certyfikatu i klucza prywatnego albo błędne hasło do klucza. Sprawdź też, czy konfigurujesz właściwe środowisko TEST albo PROD.

Skonfiguruj KSeF i wystawiaj faktury w OtoFakturze.

OtoFaktura pozwala obsługiwać faktury, magazyn i KSeF w jednym panelu online.

Załóż konto