Nie pobierają się wszystkie faktury z KSeF? Checklista diagnostyczna

TL;DR

Jeżeli w systemie widzisz mniej faktur niż w KSeF, problem może leżeć w uprawnieniach, filtrach dat, błędach integracji albo niepełnym przebiegu synchronizacji. Najważniejsze jest to, aby mieć plan awaryjny: backfill, ręczne pobranie po numerze KSeF lub import XML.

Skąd bierze się ten problem?

Na rynku księgowym od początku 2026 pojawia się wiele sygnałów o tym, że część programów nie pobiera wszystkich dokumentów z KSeF. Czasem brakuje pojedynczych faktur, czasem całych partii dokumentów z określonego okresu.

To nie jest wyłącznie problem „techniczny dla IT”. Dla firmy i biura rachunkowego oznacza to realne ryzyko:

• błędnego rozliczenia kosztów,
• niepełnego archiwum,
• opóźnionej pracy księgowości,
• konfliktów z klientem lub kontrahentem.

Najczęstsze przyczyny

1. Złe lub niepełne uprawnienia

Użytkownik może mieć dostęp do części danych, ale nie do wszystkich potrzebnych dokumentów. To szczególnie częste w modelach biuro rachunkowe + wielu klientów.

2. Zły zakres dat

Niektóre problemy wynikają z tego, że system pobiera tylko część okresu albo pracuje od „ostatniego odbioru”, który nie został poprawnie zapisany.

3. Błąd w synchronizacji po stronie aplikacji

Zdarza się, że API działa, ale aplikacja nie zapisuje kompletu wyników lub nie wykonuje poprawnego retry.

4. Brak manualnego fallbacku

Największy problem pojawia się wtedy, gdy system nie ma planu awaryjnego: nie można dociągnąć dokumentu po numerze KSeF ani zaimportować XML ręcznie.

Checklista diagnostyczna krok po kroku

Krok 1: sprawdź, czy dokument rzeczywiście jest w KSeF

Najpierw trzeba potwierdzić, że faktura jest widoczna w samym systemie KSeF dla właściwego podmiotu.

Krok 2: sprawdź uprawnienia i NIP

Upewnij się, że pracujesz na właściwej firmie i że użytkownik ma dostęp do tej konkretnej jednostki.

Krok 3: sprawdź zakres dat i filtry

Zweryfikuj datę wystawienia, datę odbioru i to, czy synchronizacja nie była ograniczona tylko do części zakresu.

Krok 4: uruchom backfill lub pełny sync za okres

Jeżeli system to umożliwia, trzeba wykonać synchronizację ponowną za konkretny przedział czasu.

Krok 5: pobierz dokument po numerze KSeF

Jeżeli kontrahent ma numer KSeF dokumentu, warto użyć go do ręcznego potwierdzenia, czy faktura jest osiągalna.

Krok 6: użyj importu XML jako planu ratunkowego

Jeżeli aplikacja nadal nie pobiera kompletu danych, ręczny import XML pozwala zachować ciągłość pracy księgowości.

Co powinien mieć dobry system?

Dojrzały hub KSeF powinien zapewniać:

• historię sync-runów,
• możliwość ponownej synchronizacji,
• detekcję braków,
• fallback przez numer KSeF,
• manual import XML,
• pełne logowanie działań.

Jak podchodzić do tematu w biurze rachunkowym?

Biuro rachunkowe powinno mieć prostą procedurę dla klienta:

1. sprawdź, czy faktura istnieje w KSeF,
2. potwierdź, że użytkownik ma właściwe uprawnienia,
3. uruchom ponowny pobór za okres,
4. jeśli trzeba — dołącz dokument ręcznie do paczki dla księgowości.

Jak pomaga KSeF Desk?

Ten problem był jednym z głównych powodów rozwoju KSeF Desk jako niezależnego huba:

• sync-runy i historia pobrań,
• pełne archiwum XML,
• tworzenie paczek faktur dla księgowości,
• plan rozwoju o manual import i kontrolę kompletności sync.

FAQ

Czy brak faktury oznacza, że kontrahent jej nie wystawił?

Nie zawsze. Najpierw trzeba sprawdzić, czy problem jest po stronie widoczności, filtrów lub synchronizacji.

Czy numer KSeF pomaga odnaleźć dokument?

Tak, bardzo często jest to najlepszy punkt wyjścia w diagnostyce.

Czy warto mieć import XML jako plan awaryjny?

Zdecydowanie tak. To jeden z najbardziej praktycznych fallbacków dla księgowości.

Źródła do weryfikacji

• wątki praktyczne z forum InsERT dotyczące brakujących faktur
• Business Insider i publiczne komentarze o problemach KSeF
• dokumentacja producentów systemów księgowych i praktyka rynku

Powiązane tematy i kolejne kroki

Gdy znikają dokumenty lub sync jest niepełny, kontynuuj od tych materiałów:

• Jak uruchomić backfill w KSeF Desk,
• KSeF: odbiór faktur od 1 lutego 2026 — co to znaczy w praktyce,
• Jak działa import XML i archiwum.

Przy ręcznej diagnostyce pomaga też zrozumienie pojęcia numer KSeF.