System pobierania faktur z systemu KSeF - wersja Polska / English version
- Wstęp
- Tworzenie tokenu w systemie KSeF
- Niezbędne narzędzia
- Pobieranie faktur w formacie XML KSeF
- Pobieranie wykazu faktur w formacie CSV
- Generowanie wizualizacji faktur w formacie PDF
- Skrypt automatyzujący proces pobierania i generowania dokumentów z KSeF w PowerShell
- Tworzenie harmonogramu zadań w systemie Windows realizującego automatyzację
W niniejszym dokumencie opisane zostanie użycie dwóch narzędzi do:
- Pobierania faktur w formacie XML KSeF - KSeF XML Download
- Generowania wizualizacji faktur w formacie PDF na podstawie faktur XML KSeF - KSeF PDF Generator
Opracowanie skupia się na stworzeniu automatyzacji polegającej na cyklicznym (co 4h) sprawdzaniu dostępności nowych faktur (sprzedażowych i zakupowych) w systemie KSeF. Jeśli pojawią się w systemie KSeF nowe faktury (sprzedażowe lub/i zakupowe), skrypt automatyzujący wykonuje następujące 3 czynności:
- Pobiera faktury XML KSeF sprzedażowe lub/i zakupowe do odpowiednich folderów, tj.:
- Sprzedażowe:
[DYSK]:\[LOKALIZACJA]\[ROK]\[MIESIAC]\Faktury-Sprzedaz\(np.C:\KSeF\2026\03\Faktury-Sprzedaz\); - Zakupowe:
[DYSK]:\[LOKALIZACJA]\[ROK]\[MIESIAC]\Faktury-Zakupowe\(np.C:\KSeF\2026\03\Faktury-Zakupowe\);
- Sprzedażowe:
- Uaktualnia bieżący (za dany miesiąc) wykaz faktur do pliku CSV i umieszcza go w katalogu:
[DYSK]:\[LOKALIZACJA]\[ROK]\[MIESIAC]\_KSeF_\ksef_output[ROK][MIESIAC].csv(np.C:\KSeF\2026\03\_KSeF_\ksef_output202603.csv); - Generuje wizualizacje faktur w formacie PDF wg standardu PDF/A-3 (ISO 19005-3:2012) na podstawie pobranych faktur w formacie XML KSeF i umieszcza je w tej samej lokalizacji – patrz punk 1.
Każdy miesiąc będzie posiadał swoją niezależną strukturę katalogów z wykazem faktur KSeF XML, listą dokumentów w pliku CSV oraz reprezentacją wizualną faktur w formacie PDF.
Do poprawnego funkcjonowania narzędzia KSeF XML Download, niezbędne jest skonfigurowanie jednego z dwóch mechanizmów uwierzytelniania w systemie KSeF:
- Uwierzytelnianie Certyfikatem;
- Uwierzytelnianie Tokenem;
Na potrzeby tej automatyzacji wybrano metodę uwierzytelniania Tokenem.
Możesz wykorzystać już posiadany token lub ze względów bezpieczeństwa wygenerować nowy token na potrzeby skryptu.
W tym celu wchodzimy na stronę Krajowego Systemu e-Faktur – https://ksef.podatki.gov.pl/ i wybieramy przycisk „Zaloguj się do KSeF”.
Przeniesie nas na stronę logowania, gdzie wybieramy kafelek „Uwierzytelnij się w Krajowym Systemie e-Faktur”.
Jako sposób logowania wybieramy „Zaloguj przez login.gov.pl”.
Następnie podajemy NIP podmiotu dla którego będziemy pobierać faktury KSeF i klikamy przycisk „Uwierzytelnij”.
W kolejnym kroku wybieramy sposób logowania do usług Ministerstwa Finansów, np. z wykorzystaniem aplikacji mObywatel.
Po uwierzytelnieniu, zalogowało nas w Krajowym Systemie e-Faktur – Aplikacja Podatnika KSeF, gdzie udajemy się do sekcji „Tokeny” i wybieramy „Generuj token”.
Wypełniamy formularz podając:
- Nazwę tokena;
- Ustawiając uprawnienia dla tokena – zaznaczmy „przeglądanie faktur”;
- Klikamy przycisk „
Generuj token”.
Jeśli nie pokaże się token, należy naciskać przycisk „Odśwież”, aż do momentu gdy zobaczymy token.
Przeważnie po jednym lub dwóch odświeżeniach zobaczymy nasz nowy token. Token jest wyświetlany tylko jeden raz, więc musisz go skopiować (przycisk „Kopiuj”) i zapisać w bezpiecznym miejscu, w przeciwnym razie, będziesz musiał go unieważnić i wygenerować ponownie – powtórzyć całą procedurę generowania tokenu od nowa.
Masz wygenerowany token i możesz przystąpić do testów i konfiguracji skryptu.