Jak aktywować integrację z Krajowym Systemem e-Faktur (KSeF)?

5 min czytania KSeF

Integracja z Krajowym Systemem e-Faktur (KSeF) w aplikacji uepik.ngo pozwala automatycznie pobierać faktury kosztowe oraz bezpiecznie wysyłać Twoje dokumenty do rządowego systemu – bez każdorazowego logowania się do Aplikacji Podatnika.

Zanim rozpoczniesz, upewnij się, że Twoja organizacja złożyła zawiadomienie ZAW-FA w urzędzie skarbowym (lub korzysta z pieczęci kwalifikowanej) oraz że masz dostęp do Aplikacji Podatnika.

Nadanie uprawnień do wystawiania i odbioru faktur

Pierwszym krokiem jest przypisanie odpowiednich uprawnień w Krajowym Systemie e-Faktur. To niezbędne, by certyfikat utworzony w kolejnym etapie mógł poprawnie komunikować się z systemem i miał prawo do przeglądania oraz wystawiania faktur.

Widok nadawania uprawnień KSeF
Widok nadawania uprawnień KSeF
  1. Zaloguj się do Aplikacji Podatnika.
  2. Przejdź do zakładki Uprawnienia → Nadaj uprawnienie.
  3. W polu Rodzaj uprawnienia wybierz: Osobie fizycznej do pracy w KSeF.
  4. W polu Rodzaj podmiotu uprawnianego wybierz: Osoba fizyczna posługująca się Profilem Zaufanym lub certyfikatem zawierającym identyfikator NIP lub PESEL.
  5. Uzupełnij PESEL, imię i nazwisko.
  6. Wskaż odpowiedni zakres uprawnień (jeśli nadajesz je sobie – zaznacz wszystkie). Minimalne uprawnienia wymagane do prawidłowego działania integracji to:
    • wystawianie faktur,
    • przeglądanie faktur.
  7. Zatwierdź przyciskiem Nadaj uprawnienia.
  8. Wyloguj się z Aplikacji Podatnika.

Generowanie certyfikatu w Aplikacji Podatnika

Gdy masz już nadane uprawnienia, utwórz certyfikat, który umożliwi techniczne połączenie między uepik.ngo a KSeF. Wykorzysta on nadane wcześniej uprawnienia do pobierania faktur i wysyłania dokumentów.

  1. Zaloguj się ponownie do Aplikacji Podatnika.
  2. Przejdź do sekcji Certyfikaty → Wnioskuj o certyfikat.
  3. Uzupełnij nazwę certyfikatu (nie ma ona znaczenia dla działania integracji – służy jedynie do rozpoznania certyfikatu na liście w Aplikacji Podatnika).
  4. Uzupełnij hasło i zapamiętaj je – będzie potrzebne do aktywacji integracji!
  5. Naciśnij przycisk Generuj i zapisz wygenerowany klucz (pobieranie powinno rozpocząć się automatycznie).
  6. W kolejnej sekcji, w polu Przeznaczenie certyfikatu wybierz: Uwierzytelnienie w systemie KSeF.
  7. Pole Certyfikat ważny od pozostaw bez zmian (aktualna data).
  8. Naciśnij przycisk Wyślij wniosek o wydanie certyfikatu.
  9. Odczekaj chwilę i naciśnij przycisk Odśwież.
  10. Jeśli KSeF wygenerował już certyfikat, użyj przycisku Pobierz certyfikat i zapisz plik na urządzeniu. Jeśli nie – odczekaj kilkanaście sekund i ponownie naciśnij Odśwież.
Proces generowania certyfikatu (1)
Kroki 2–5 – generowanie klucza
Proces generowania certyfikatu (2)
Kroki 6–8 – generowanie certyfikatu
Proces generowania certyfikatu (3)
Krok 9 – odświeżenie statusu
Proces generowania certyfikatu (4)
Krok 10 – pobranie certyfikatu

Wgranie certyfikatu do uepik.ngo

Gdy certyfikat jest już wygenerowany, a uprawnienia nadane, możesz przejść do konfiguracji integracji z aplikacją.

  1. Zaloguj się do uepik.ngo.
  2. Przejdź do zakładki Ustawienia → Krajowy System e-Faktur.
  3. W sekcji Certyfikat uwierzytelniający naciśnij przycisk Wgraj certyfikat.
  4. W polu Certyfikat wgraj plik z rozszerzeniem .crt.
  5. W polu Klucz prywatny wgraj plik z rozszerzeniem .key.
  6. Wprowadź hasło podane wcześniej w Aplikacji Podatnika.
  7. Kliknij przycisk Zapisz.
Proces wgrania certyfikatu (1)
Krok 2
Proces wgrania certyfikatu (2)
Krok 3
Proces wgrania certyfikatu (3)
Kroki 4–7

Weryfikacja połączenia

Ostatnim etapem jest potwierdzenie poprawnej komunikacji aplikacji uepik.ngo z KSeF. System spróbuje otworzyć krótką sesję testową. Jeśli zakończy się ona powodzeniem, integracja zostanie aktywowana.

  1. Przejdź do zakładki Ustawienia → Krajowy System e-Faktur.
  2. W sekcji Certyfikat uwierzytelniający naciśnij przycisk Weryfikuj certyfikat.
Proces weryfikacji certyfikatu (1)

Pomyślna weryfikacja oznacza, że integracja z KSeF jest w pełni aktywna – teraz pozwól aplikacji pracować za Ciebie! Przejdź do zakładki Ustawienia → Preferencje, aby włączyć automatyczne pobieranie faktur. Od tej pory system będzie samodzielnie sprawdzał, czy w KSeF pojawiły się nowe dokumenty, i wyśle Ci powiadomienie mailowe, gdy pojawią się faktury gotowe do zaksięgowania.

Zobacz także: Jak aktywować automatyczne pobieranie faktur z KSeF?


Rozwiązywanie problemów

Jeśli weryfikacja zakończy się błędem, może to oznaczać, że:

  • pominięto nadanie uprawnień lub nadano je błędnej osobie,
  • wprowadzono błędne hasło do klucza,
  • przez pomyłkę wgrano certyfikat innej organizacji,
  • wgrano certyfikat powiązany z NIP-em, dla którego nie nadano wymaganych uprawnień,
  • data rozpoczęcia ważności certyfikatu jest późniejsza niż data bieżąca.

Prowadź UEPIK online – bez Excela, bez papierów

Testuj wszystkie funkcje programu przez 14 dni bez opłat i bez karty płatniczej.

Przetestuj bezpłatnie