Podłączenie KSeF — token tylko do odczytu

A4G może czytać Twoje faktury bezpośrednio z Krajowego Systemu e-Faktur (KSeF): faktury zakupu od dostawców i własne faktury sprzedaży. Dzięki temu widzisz VAT z zakupów, zanim faktura zostanie zaksięgowana, porównasz KSeF z Subiektem i dostaniesz propozycje kosztów stałych.

Pobieraniem zajmuje się A4G Connect na Twoim komputerze — tym samym, który czyta Subiekta.

#Dlaczego to bezpieczne

• Token ma tylko uprawnienie „Przeglądanie faktur”. Taki token pozwala wyłącznie czytać faktury. Nie pozwala wystawić, wysłać, skorygować ani usunąć żadnej faktury i nie daje dostępu do innych uprawnień. Ograniczenie nakłada i egzekwuje KSeF (Ministerstwo Finansów), nie A4G.
• Token nie trafia do A4G. Jest przechowywany zaszyfrowany (Windows DPAPI) wyłącznie na komputerze z A4G Connect. Connect używa go tylko do logowania w KSeF — szyfruje go kluczem publicznym Ministerstwa Finansów i wysyła wyłącznie do KSeF. Nie ma go w konfiguracji, dziennikach ani w danych wysyłanych do A4G.
• A4G Connect tylko czyta. Korzysta wyłącznie z funkcji KSeF do logowania, wyszukiwania faktur i pobierania ich treści. Nie wywołuje żadnej funkcji wysyłania ani zmiany faktur.
• Możesz go unieważnić w każdej chwili w aplikacji KSeF (Tokeny). A4G pokaże wtedy, że token jest nieważny.

#Jak wygenerować token

1. Zaloguj się do Aplikacji Podatnika KSeF: ap.ksef.mf.gov.pl — w kontekście NIP Twojej firmy (profil zaufany, podpis kwalifikowany, pieczęć lub certyfikat KSeF).
2. Wybierz Tokeny → Generuj token. Nazwa: „A4G Connect”.
3. W uprawnieniach zaznacz tylko „Przeglądanie faktur”.
4. Skopiuj token — KSeF pokazuje go tylko raz.
5. Wklej go w instalatorze A4G Connect (krok KSeF: NIP i token).

Jeśli A4G Connect jest już zainstalowany, token można zapisać poleceniem (uruchom, wklej token, Enter — token nie pojawia się w linii poleceń):

.\A4G.Connect.exe secret set ksef-token

Potem w pliku C:\Program Files\A4G Connect\appsettings.json ustaw "Ksef": { "Enabled": true, "Environment": "Prod", "Nip": "<NIP bez kresek>" } i zrestartuj usługę (Restart-Service A4GConnect).

#Co A4G pobiera z KSeF

• Faktury zakupu (od dostawców) i własne faktury sprzedaży — dane z nagłówka: numer, daty, kwoty netto, VAT, brutto, waluta, rodzaj faktury.
• Treść faktur zakupu (plik FA(3)) — po to, by znać VAT w podziale na stawki i VAT w złotych dla faktur w walutach.
• Nazwy i NIP-y sprzedawców i nabywców oraz numery KSeF są szyfrowane jeszcze na Twoim komputerze, gdy ochrona danych jest włączona. Nabywca-konsument (bez NIP) na Twojej fakturze sprzedaży nie jest wysyłany wcale.

A4G nigdy niczego w KSeF nie zmienia i nie usuwa.

#Jak często i od kiedy

• Connect sprawdza KSeF co 2 godziny i pobiera nowe faktury.
• Pierwsze pobranie zaczyna się od 1 lutego 2026 (od tego dnia odbieranie faktur przez KSeF jest obowiązkowe).
• Starsze faktury, np. z okresu dobrowolnego KSeF, można dociągnąć poleceniem:

.\A4G.Connect.exe ksef backfill --from 2022-01-01 --wait

#Limity KSeF

KSeF ogranicza liczbę zapytań — m.in. 20 zapytań o listę faktur na godzinę i 64 pobrania treści faktur na godzinę. A4G Connect przestrzega tych limitów:

• pobiera najwyżej 40 treści faktur w jednym przebiegu, resztę w kolejnych;
• gdy KSeF odpowie, że limit się skończył, Connect zapisuje postęp i czeka tyle, ile każe KSeF — nie ponawia zapytań wcześniej, bo KSeF wydłuża blokadę klientom, którzy nie czekają;
• przy dociąganiu historii opcja --wait sprawia, że Connect sam odczeka i dokończy; bez niej podaje godzinę, o której uruchomić polecenie ponownie (kontynuuje od miejsca przerwania).

#Co widzisz w A4G

• KSeF w aplikacji — porównanie KSeF z Subiektem i problemy z fakturami sprzedaży.
• VAT na bieżąco — faktury zakupu z KSeF, których jeszcze nie ma w Subiekcie, liczą się do VAT z zakupów (z oznaczeniem „do sprawdzenia”).
• Źródła danych — KSeF jest osobnym źródłem danych obok Subiekta GT, z datą ostatniego pobrania i ewentualnym błędem.