Automatyczne pobieranie faktur z KSeF
Automatyczne pobieranie faktur z KSeF polega na tym, że program regularnie łączy się z KSeF przez API, wyszukuje nowe faktury firmy i zapisuje je jako pliki XML, PDF albo dane w tabeli. Nikt nie musi ręcznie logować się do Aplikacji Podatnika. Do samego pobierania wystarczy uprawnienie do przeglądania faktur.
- Inaczej
- pobieranie faktur z KSeF, import faktur z KSeF, eksport faktur z KSeF, przyrostowe pobieranie faktur, synchronizacja faktur z KSeF
Jak to działa
- Uwierzytelnienie. Program łączy się z API KSeF, zwykle tokenem z uprawnieniem „przeglądanie faktur”.
- Wyszukanie. Pyta KSeF o faktury z określonego zakresu dat, w których firma występuje jako sprzedawca, nabywca albo podmiot trzeci. Dostaje metadane: numery, daty, kwoty, kontrahentów.
- Pobranie. Ściąga faktury pojedynczo po numerze KSeF albo zleca eksport paczki faktur.
- Zapis. Zapisuje pliki XML, tworzy z nich PDF-y albo rozkłada dane na kolumny w arkuszu czy systemie księgowym.
- Kolejny cykl. Przy następnym uruchomieniu pobiera tylko nowe faktury. Służy do tego przyrostowe pobieranie w API KSeF.
Ręcznie czy automatycznie
| Ręcznie w Aplikacji Podatnika | Automatycznie przez API | |
|---|---|---|
| Koszt | bezpłatnie | zależy od programu |
| Wysiłek | logowanie i wybieranie faktur za każdym razem | jednorazowa konfiguracja |
| Gdzie trafiają faktury | pliki na dysku | system księgowy, arkusz, dysk w chmurze |
| Kiedy się sprawdza | kilka faktur w miesiącu | regularny napływ faktur, analiza kosztów |
Na co uważać
- Minimalne uprawnienia. Narzędzie do pobierania nie potrzebuje prawa do wystawiania faktur ani zarządzania uprawnieniami.
- Bezpieczeństwo tokenu. Sprawdź, jak dostawca przechowuje token i czy możesz go w każdej chwili unieważnić.
- Gdzie lądują faktury. Dowiedz się, czy narzędzie zapisuje faktury na swoich serwerach, czy przekazuje je prosto do Twojego systemu.
Przykład
Biuro rachunkowe obsługuje 40 firm. Zamiast logować się co tydzień w kontekście każdej z nich, ustawia w programie automatyczne pobieranie: program co noc pobiera nowe faktury kosztowe i sprzedażowe wszystkich klientów, a rano księgowe mają je już w systemie.
Powiązane pojęcia
Odbieranie faktur kosztowych z KSeF
Od 1 lutego 2026 r. faktury kosztowe od dostawców, którzy wystawiają je w KSeF, firmy otrzymują w systemie, a nie mailem ani pocztą. Faktura jest otrzymana w dniu nadania jej numeru KSeF, a nabywca pobiera ją z KSeF: ręcznie w Aplikacji Podatnika albo automatycznie w programie połączonym z systemem.
Integracja z KSeF
Integracja z KSeF to połączenie programu z Krajowym Systemem e-Faktur przez publiczne API KSeF 2.0. Może to być program do fakturowania, system księgowy, ERP albo narzędzie do analizy faktur. Dzięki integracji program sam wysyła faktury do KSeF albo je z niego pobiera, bez ręcznej pracy w Aplikacji Podatnika.
Token KSeF
Token KSeF to poufny ciąg znaków wygenerowany w KSeF, którym program uwierzytelnia się w systemie w imieniu firmy, bez podpisu kwalifikowanego przy każdym połączeniu. Token ma na stałe przypisane uprawnienia wybrane przy jego tworzeniu, np. tylko przeglądanie faktur. Obecnie token nie ma terminu ważności: działa, dopóki ktoś go nie unieważni.
Uprawnienia w KSeF
Uprawnienia w KSeF określają, kto i co może robić w systemie w imieniu firmy: wystawiać faktury, przeglądać je, zarządzać uprawnieniami innych osób albo obsługiwać jednostki podrzędne. Nadaje je właściciel firmy albo osoba z uprawnieniem do zarządzania uprawnieniami, w Aplikacji Podatnika KSeF albo przez API.
XML faktury
XML faktury to plik w formacie XML, w którym zapisana jest cała faktura ustrukturyzowana: dane sprzedawcy i nabywcy, pozycje, kwoty i stawki VAT. Układ pól określa schemat FA(3). Właśnie ten plik wysyła się do KSeF i pobiera z KSeF, a PDF jest tylko jego czytelną wizualizacją.
Data otrzymania faktury w KSeF
Fakturę ustrukturyzowaną uznaje się za otrzymaną w dniu, w którym system nadał jej numer KSeF, niezależnie od tego, kiedy nabywca zajrzał do systemu. Wyjątki dotyczą faktur przekazywanych poza KSeF (np. konsumentowi albo firmie zagranicznej), trybu awaryjnego i awarii całkowitej: wtedy liczy się dzień faktycznego otrzymania.
Najczęstsze pytania
Czy do pobierania faktur z KSeF potrzebuję programu?
Nie. Faktury można pobierać ręcznie w bezpłatnej Aplikacji Podatnika KSeF. Program przydaje się, gdy faktur jest dużo albo chcesz mieć je od razu w arkuszu czy systemie księgowym, bez logowania i klikania.
Czy narzędzie do pobierania faktur może je zmienić albo usunąć?
Nie, jeśli łączy się tokenem z samym uprawnieniem do przeglądania faktur. Takie uprawnienie pozwala wyszukiwać i pobierać faktury, ale nie wystawiać ich ani korygować. Usunąć faktury z KSeF nie da się w ogóle.
Czy pobieranie faktur zmienia datę ich otrzymania?
Nie. Faktura jest otrzymana w dniu nadania numeru KSeF, niezależnie od tego, kiedy ją pobierzesz.
Źródła
- Pobieranie faktur (dokumentacja KSeF API 2.0)Ministerstwo Finansów, repozytorium CIRFMF/ksef-docs
- Przyrostowe pobieranie faktur (dokumentacja KSeF API 2.0)Ministerstwo Finansów, repozytorium CIRFMF/ksef-docs
- Uprawnienia (dokumentacja KSeF API 2.0)Ministerstwo Finansów, repozytorium CIRFMF/ksef-docs
Treść sprawdzona ze źródłami: . Przepisy o KSeF często się zmieniają, więc przed decyzją podatkową sprawdź aktualny stan w źródłach.
Widzisz błąd albo nieaktualną informację? Daj nam znać, a poprawimy.
