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

Aktualizacja: 7 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.

Aplikacja Podatnika KSeF – wybór rodzaju uprawnienia i podmiotu uprawnianego
Kroki 2–4 – rodzaj uprawnienia i podmiotu
Aplikacja Podatnika KSeF – dane osoby i zakres uprawnień
Kroki 5–7 – dane osoby i zakres uprawnień
  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. Wniosek otrzyma status W realizacji – po kilku chwilach możesz sprawdzić jego wynik przyciskiem Odśwież.
  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 – od 5 do 100 znaków (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, powtórz je w polu Powtórz hasło i zapamiętaj je – będzie potrzebne do aktywacji integracji! Hasło musi mieć od 15 do 32 znaków, zawierać wielką i małą literę, cyfrę oraz znak specjalny i nie może zawierać polskich znaków.
  5. Naciśnij przycisk Generuj i zapisz wygenerowany klucz (pobieranie powinno rozpocząć się automatycznie). Na ekranie pojawi się komunikat Wygenerowano klucz prywatny.
  6. W kolejnym kroku (Przesłanie wniosku), 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. Wniosek otrzyma status W realizacji. Odczekaj chwilę i naciśnij przycisk Odśwież.
  10. Gdy pojawi się komunikat Zakończono pomyślnie, użyj przycisku Pobierz certyfikat i zapisz plik na urządzeniu. Jeśli nie – odczekaj kilkanaście sekund i ponownie naciśnij Odśwież.
Aplikacja Podatnika KSeF – nazwa certyfikatu, hasło i generowanie klucza prywatnego
Kroki 2–5 – generowanie klucza
Aplikacja Podatnika KSeF – przeznaczenie certyfikatu i wysłanie wniosku
Kroki 6–8 – wniosek o certyfikat
Aplikacja Podatnika KSeF – wniosek o certyfikat w realizacji
Krok 9 – odświeżenie statusu
Aplikacja Podatnika KSeF – certyfikat wydany, przycisk Pobierz certyfikat
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.
uepik.ngo – kafelek Krajowy System e-Faktur w ustawieniach
Krok 2
uepik.ngo – sekcja Certyfikat uwierzytelniający z przyciskiem Wgraj certyfikat
Krok 3
uepik.ngo – wgrywanie plików .crt i .key oraz hasła do klucza
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, pod statusem Wymaga weryfikacji, naciśnij przycisk Weryfikuj certyfikat. Po pomyślnej weryfikacji status zmieni się na Aktywny.
uepik.ngo – certyfikat ze statusem Wymaga weryfikacji i przyciskiem Weryfikuj certyfikat
Krok 2
uepik.ngo – aktywna integracja z KSeF i ustawienia automatycznego pobierania faktur
Integracja aktywna – ustawienia integracji

Pomyślna weryfikacja oznacza, że integracja z KSeF jest w pełni aktywna – teraz pozwól aplikacji pracować za Ciebie! W sekcji Ustawienia integracji, pod danymi certyfikatu, zaznacz Włącz automatyczne pobieranie faktur z KSeF. Od tej pory system będzie samodzielnie sprawdzał, czy w KSeF pojawiły się nowe dokumenty, a po zaznaczeniu opcji Powiadamiaj mnie e-mailem o nowych fakturach wyśle Ci wiadomość, 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