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
  • Stan prawny na
  • Aktualizacja:

Jak to działa

  1. Uwierzytelnienie. Program łączy się z API KSeF, zwykle tokenem z uprawnieniem „przeglądanie faktur”.
  2. 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.
  3. Pobranie. Ściąga faktury pojedynczo po numerze KSeF albo zleca eksport paczki faktur.
  4. Zapis. Zapisuje pliki XML, tworzy z nich PDF-y albo rozkłada dane na kolumny w arkuszu czy systemie księgowym.
  5. 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 PodatnikaAutomatycznie przez API
Kosztbezpłatniezależy od programu
Wysiłeklogowanie i wybieranie faktur za każdym razemjednorazowa konfiguracja
Gdzie trafiają fakturypliki na dyskusystem księgowy, arkusz, dysk w chmurze
Kiedy się sprawdzakilka faktur w miesiącuregularny 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

  1. Pobieranie faktur (dokumentacja KSeF API 2.0)Ministerstwo Finansów, repozytorium CIRFMF/ksef-docs
  2. Przyrostowe pobieranie faktur (dokumentacja KSeF API 2.0)Ministerstwo Finansów, repozytorium CIRFMF/ksef-docs
  3. 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.