Powrót do Bazy Wiedzy
Integracje4 min czytania

Jak zintegrować Prevacash z KSeF

Instrukcja krok po kroku: wygeneruj token w Aplikacji Podatnika KSeF, połącz z Prevacash i importuj faktury sprzedażowe oraz kosztowe z Krajowego Systemu e-Faktur.

Integracja Prevacash z Krajowym Systemem e-Faktur (KSeF) umożliwia automatyczny import faktur sprzedażowych oraz kosztowych bezpośrednio z rządowego systemu e-Faktur. Dane trafiają do Twoich prognoz cash flow - bez pośrednictwa zewnętrznych systemów księgowych.

Cały proces zajmuje ok. 3-5 minut. Potrzebujesz jedynie:

  • Aktywnego konta w Aplikacji Podatnika KSeF na ap.ksef.mf.gov.pl
  • Aktywnego konta w Prevacash (dowolny plan)
  • NIP-u firmy, dla której chcesz importować faktury

Część 1: Wygeneruj token w Aplikacji Podatnika KSeF

Token KSeF to unikalny klucz autoryzacyjny, dzięki któremu Prevacash może bezpiecznie łączyć się z Krajowym Systemem e-Faktur i pobierać Twoje faktury przez API.

Krok 1. Zaloguj się do Aplikacji Podatnika KSeF

Przejdź na stronę ap.ksef.mf.gov.pl i zaloguj się za pomocą Profilu Zaufanego, e-Dowodu lub podpisu kwalifikowanego. Po zalogowaniu zobaczysz panel Aplikacji Podatnika z menu bocznym.

Aplikacja Podatnika KSeF - strona główna po zalogowaniu z menu bocznym zawierającym sekcję Tokeny

Panel Aplikacji Podatnika KSeF po zalogowaniu. W menu bocznym znajdziesz sekcję Tokeny.

Krok 2. Przejdź do generowania tokena

W menu bocznym kliknij Tokeny, a następnie Generuj token. Otworzy się formularz generowania nowego tokena API.

Krok 3. Wypełnij formularz i wygeneruj token

Na stronie generowania tokena:

  1. W polu Nazwa tokena wpisz np. prevacash_token
  2. W sekcji Wybierz uprawnienia powiązane z tokenem zaznacz przeglądanie faktur
  3. Kliknij Generuj token
Formularz generowania tokena w KSeF - nazwa prevacash_token, zaznaczone uprawnienie przeglądanie faktur i przycisk Generuj token

Formularz generowania tokena - wpisz nazwę prevacash_token, zaznacz przeglądanie faktur i kliknij Generuj token.

Ważne: Prevacash potrzebuje wyłącznie uprawnienia do przeglądania faktur. Nie zaznaczaj pozostałych uprawnień (wystawianie faktur, zarządzanie uprawnieniami itp.) - nie są potrzebne, a ich ograniczenie zwiększa bezpieczeństwo Twojego konta.

Krok 4. Skopiuj token

Po pomyślnym wygenerowaniu KSeF wyświetli token. Skopiuj go natychmiast klikając przycisk Kopiuj - token wyświetlany jest tylko raz. Po opuszczeniu strony nie będzie można go ponownie wyświetlić.

Token KSeF wygenerowany pomyślnie - przycisk Kopiuj po prawej stronie

Token wygenerowany pomyślnie. Kliknij Kopiuj i zapisz token - nie będzie można go ponownie wyświetlić.

Część 2: Połącz KSeF z Prevacash

Krok 5. Wklej NIP i token w Prevacash

  1. Zaloguj się do Prevacash
  2. W menu bocznym kliknij Ustawienia
  3. Przejdź do zakładki Integracje
  4. Rozwiń sekcję KSeF
  5. W polu NIP firmy wpisz NIP, dla którego wygenerowałeś token
  6. W polu Token KSeF wklej skopiowany token
  7. Wybierz Okres synchronizacji (np. Ostatnie 5 lat)
  8. Kliknij Połącz z KSeF
Panel integracji w Prevacash - sekcja KSeF z polami NIP firmy, Token KSeF, Okres synchronizacji i przyciskiem Połącz z KSeF

Panel integracji w Prevacash - wpisz NIP, wklej token KSeF, wybierz okres synchronizacji i kliknij „Połącz z KSeF".

Po kliknięciu Prevacash automatycznie zweryfikuje token i uruchomi pierwszą synchronizację. Twoje faktury sprzedażowe i kosztowe z KSeF zostaną zaimportowane i uwzględnione w prognozach cash flow.

Co dalej?

  • Automatyczna synchronizacja - po połączeniu Prevacash na bieżąco synchronizuje dane z KSeF. Nowe faktury będą automatycznie importowane do Twoich prognoz
  • Dane w aplikacji - zaimportowane faktury pojawią się w zakładce Faktury z oznaczeniem źródła „KSeF"
  • Niezależność od systemu księgowego - KSeF to rządowe źródło faktur, więc integracja działa niezależnie od tego, jakiego programu do fakturowania używasz
  • Rozłączenie - w każdej chwili możesz odłączyć integrację przyciskiem Rozłącz

Bezpieczeństwo: Twój token KSeF jest szyfrowany i przechowywany bezpiecznie. Prevacash korzysta wyłącznie z uprawnienia do przeglądania faktur - nie wystawia, nie modyfikuje ani nie usuwa żadnych dokumentów w KSeF.

Najczęstsze pytania

Czy mogę używać KSeF zamiast integracji z iFirmą / inFaktem?

Tak. Jeśli Twoje faktury trafiają do KSeF, możesz importować je bezpośrednio stamtąd - bez konieczności łączenia się z systemem księgowym. KSeF jest centralnym rejestrem faktur ustrukturyzowanych w Polsce.

Jakie faktury importuje Prevacash z KSeF?

Prevacash importuje zarówno faktury sprzedażowe (wystawione przez Ciebie), jak i kosztowe (otrzymane od kontrahentów), które zostały zarejestrowane w Krajowym Systemie e-Faktur.

Co oznacza „Okres synchronizacji"?

To zakres czasowy, z którego Prevacash pobierze faktury przy pierwszej synchronizacji. Możesz wybrać np. ostatnie 5 lat, aby zaimportować pełną historię faktur dostępnych w KSeF.


Potrzebujesz pomocy z integracją? Napisz do nas na support@prevacash.com - chętnie pomożemy.

Inne artykuły