Pomoc

Pomoc

Rozwiązywanie problemów

Większość poleceń uruchamiasz w PowerShell jako administrator, w katalogu programu:

cd "C:\Program Files\A4G Connect\versions\<wersja>"

(numer wersji widać w nazwie katalogu; po aktualizacji używaj najnowszego).

Pierwszy krok: autotest

.\A4G.Connect.exe check

Sprawdza konfigurację, połączenie z bazą, uprawnienia do tabel i łączność z A4G. Każdy problem jest opisany po polsku.

Brak nowych danych w A4G

  1. Na stronie Źródła danych sprawdź, kiedy przyszła ostatnia paczka.
  2. Sprawdź, czy usługa działa: Get-Service A4GConnect. Jeśli nie — Start-Service A4GConnect.
  3. Uruchom check.
  4. Sprawdź, czy komputer ma dostęp do internetu (wychodzący HTTPS do collect.a4g.io, api.a4g.io, a4g.io).
  5. Zmiany starszych dokumentów przychodzą dopiero po nocnej pełnej synchronizacji — to normalne.

„Brak SELECT” / ostrzeżenie o uprawnieniach

Konto A4G Connect nie ma prawa odczytu którejś tabeli (np. po aktualizacji Connecta, który zaczął czytać nową tabelę). Uruchom ponownie Setup.exe — nada brakujące uprawnienie odczytu, zachowując Twoje ustawienia. Do tego czasu reszta danych działa normalnie.

Restart usługi

Restart-Service A4GConnect

Nie używaj w PowerShell sc stop / sc start — tam sc oznacza inne polecenie. Jeśli potrzebujesz, użyj sc.exe.

KSeF: „invalid_token”

Token wygasł, został unieważniony albo jest błędnie wklejony. Wygeneruj nowy token w aplikacji KSeF (tylko „Przeglądanie faktur”) i zapisz go:

.\A4G.Connect.exe secret set ksef-token
Restart-Service A4GConnect

KSeF: „no_permission” / brak uprawnienia

Token nie ma uprawnienia „Przeglądanie faktur” albo został wygenerowany w kontekście innego NIP-u. Wygeneruj nowy token z tym uprawnieniem w kontekście NIP-u firmy.

KSeF: „http_429” / limit zapytań

KSeF ogranicza liczbę zapytań (m.in. 20 zapytań o listę faktur na godzinę). Connect czeka tyle, ile każe KSeF, i kontynuuje sam. Przy ręcznym dociąganiu historii użyj --wait:

.\A4G.Connect.exe ksef backfill --from 2026-02-01 --wait

Bez --wait polecenie poda godzinę, o której uruchomić je ponownie (kontynuuje od miejsca przerwania). Pamiętaj, że usługa co 2 godziny sama czyta KSeF i korzysta z tego samego limitu.

KSeF: stan pobierania

.\A4G.Connect.exe ksef status

Pokazuje konfigurację (bez tokenu), ostatni sukces, ostatni błąd i liczbę faktur czekających na pobranie treści.

„🔒 Zaszyfrowane” zamiast nazw

To urządzenie nie ma dostępu do kluczy firmy. W Ustawienia → Zabezpieczenie danych wybierz „Przygotuj to urządzenie” i poproś właściciela o zatwierdzenie (porównajcie kod bezpieczeństwa). Zobacz Szyfrowanie.

Ostrzeżenie SmartScreen przy instalacji

Programy nie mają jeszcze podpisu Authenticode. Wybierz „Więcej informacji” → „Uruchom mimo to”. Aktualizacje automatyczne mają własny podpis wydań — zobacz Aktualizacje.

Sprawdzenie aktualizacji

Start-ScheduledTask -TaskPath '\A4G\' -TaskName 'A4G Connect Updater'

Wynik ostatniej aktualizacji widać na stronie Źródła danych.

Dzienniki

Dzienniki A4G Connect są w C:\ProgramData\A4G\Connect\logs (14 dni). Nie zawierają haseł, kluczy ani danych biznesowych — możesz je bezpiecznie przesłać nam przy zgłoszeniu: hello@a4g.io.