Pobieranie z KSeF: co 15 minut, limity, wstrzymania, wznowienia
Pobieranie z KSeF działa w tle, osobno dla każdej firmy, na poświadczeniu biura. Nie wymaga klikania. Wymaga za to zrozumienia limitów KSeF, bo to one decydują, kiedy faktury się pojawiają, a kiedy widzisz wstrzymane do HH:MM. Ta strona opisuje rytm, budżety, stany automatu i ręczne pobieranie.
Co, kiedy i od kiedy
- Rytm
- Planer rusza co 5 minut. Zdrowe źródło jest należne po około 12 minutach od końca poprzedniego przebiegu, więc każda firma pobiera co 15 minut. W jednym takcie startuje najwyżej jedna firma na dany NIP.
- Co pobiera
- Zakupy firmy (gdzie jest nabywcą) i jej sprzedaż (gdzie jest sprzedawcą). Zakupy idą pierwsze. Pobrana faktura dostaje w obiegu kierunek
ZakupalboSprzedaż. - Od kiedy
- Do 12 miesięcy wstecz, ale nie wcześniej niż okres startowy biura minus 3 miesiące, oknami po 89 dni. Faktur z miesiąca przed okresem startowym nie zobaczysz na liście
Odebrane. - Ile na przebieg
- Najwyżej 3 strony listy (po 100 pozycji) i 12 faktur. Nowa firma z dużą historią potrzebuje kilku przebiegów, zanim dogoni bieżący miesiąc.
Jeden przebieg pobierania
Krok 1
Logowanie w kontekście NIP firmy
Na poświadczeniu biura albo własnym poświadczeniu firmy, jeśli je ma.
Limity KSeF i budżety godzinowe per NIP
KSeF liczy zapytania dla pary: NIP kontekstu i adres, z którego pyta Taxso. Adres jest jeden, więc wszystkie źródła tego samego NIP-u dzielą jedną pulę. Taxso zostawia zapas i nigdy nie zużywa całości.
| Rodzaj zapytania | Limit KSeF na godzinę | Automat Taxso | Ręczne `Pobierz z KSeF` |
|---|---|---|---|
| Lista faktur (strony po 100) | 20 | 15 | 18 |
| Pobranie jednej faktury | 64 | 48 | 62 |
Testuj połączenie | 1 z puli listy | nie dotyczy | zostawione 2 zapytania |
Między zapytaniami tego samego typu Taxso czeka 3,75 sekundy. Gdy budżet godzinowy NIP-u jest wyczerpany, przebieg jest pomijany bez komunikatu na ekranie, a firma dostaje kolej, gdy okno godzinowe się przesunie.
Słownik stanów pobierania
To, co widzisz przy firmie na ekranie KSeF, w linii zdrowia nad listą i w karcie Synchronizacja w Obiegu.
- pobiera automatycznie
- Ostatni przebieg doszedł do końca, także bez nowych faktur. Następny za 15 minut.
- pobrano ostatnio DD.MM.RRRR
- Data ostatniego kompletnego przebiegu tej firmy.
- czeka na pierwsze pobranie
- Firma włączona, pierwszy przebieg jeszcze nie skończył się sukcesem.
- ponawiamy o HH:MM
- Chwilowy błąd KSeF (awaria, przekroczony czas, sieć). Taxso ponawia samo po 5, 15, 60, 240 minutach, potem co 4 godziny. Nic nie trzeba robić.
- wstrzymane do HH:MM
- KSeF odpowiedział 429. Pauza dla całego NIP-u do podanej godziny. Ponawianie wydłuża blokadę.
- Wymaga działania
- Automat nie przejdzie dalej bez człowieka. Obok etykieta przyczyny i strona: klienta albo biura. Ponowna próba co 6 godzin albo zaraz po naprawie. Nikt nie zdejmuje tego stanu ręcznie.
- brak uprawnień w KSeF
- Po stronie klienta: musi nadać biuru odczyt faktur. Jak.
- KSeF odrzuca poświadczenie biura
- Po stronie biura: certyfikat albo token jest nieważny, unieważniony lub wygasł. Wgraj nowy, pobieranie wznowi się samo.
- brak poświadczenia KSeF
- Po stronie biura: nie ma wgranego certyfikatu ani tokenu.
- brak lub błędny NIP firmy
- Po stronie biura: uzupełnij NIP na karcie firmy. Pobieranie wznowi się samo.
- brak pobrań od N dni
- Od tylu dni żaden automatyczny przebieg nie zakończył się powodzeniem. Sprawdź uprawnienia firmy w KSeF i certyfikat biura.
- wyłączone
- Pobieranie dla firmy wyłączone przyciskiem przy firmie. Automat ją pomija.
- Odrzucona na stałe
- Na zakładce
Pominięte: faktura nie wróci przy kolejnych pobraniach. Cofasz przyciskiemCofnij odrzucenie.
Statusy samej faktury na liście Odebrane są te same co w Obiegu: Nowa, W odczycie, Odczytana, Do akceptacji, Zaakceptowana, Wysłana do ERP, po pominięciu Pominięta. Znaczenie: Statusy dokumentu.
Samowznawianie i alarm po 7 dniach
Automat rozróżnia błąd chwilowy od takiego, który wymaga człowieka. Chwilowy (awaria KSeF, przekroczony czas, sieć, zużyte wyzwanie logowania) ponawia sam bez limitu prób. Odmowa uprawnień, odrzucone poświadczenie, brak NIP-u albo brak poświadczenia dają stan Wymaga działania z czerwoną ramką „Wymaga działania - pozostałe firmy pobierają dalej, te wznowią się same po naprawie” i jednym powiadomieniem na epizod dla administratora i księgowych.
Po 7 dniach bez udanego przebiegu przychodzi raz na tydzień powiadomienie „<firma>: brak pobrań z KSeF od N dni” albo „KSeF: N firm bez udanego pobrania od 7+ dni” z podpowiedzią „Sprawdź certyfikat biura i ewentualną blokadę limitu.” Liczy się od ostatniego udanego przebiegu, utworzenia źródła albo początku okresu startowego, co późniejsze. Firmy w stanie Wymaga działania mają osobny alarm.
Ręczne pobranie: Pobierz z KSeF
GdziePanel biuraObiegikona Odśwież: KSeF i OptimaOdśwież teraz
Ikona odświeżania w Obiegu otwiera kartę Synchronizacja z wierszem KSeF (ostatni czas pobrania, wstrzymane do <czas>, wyłączone albo brak pobrań i ewentualny „Błąd pobierania (<czas>): …”) i wierszem Optima. Przycisk Odśwież teraz, w pełnym wariancie Pobierz z KSeF, robi trzy rzeczy: przelicza eksporty względem lustra rejestru Optimy, prosi connector o odświeżenie rejestru firmy z ekranu i kolejkuje pobranie z KSeF, najpierw dla firmy z ekranu, potem dla pozostałych włączonych.
- Nic nie dzieje się na ekranie od razu: „Pobieranie z KSeF ruszyło w tle dla N firm. Lista odświeży się sama.” Ręczny przebieg widać w
Kolejkapod Twoim nazwiskiem jako „Pobranie faktur z KSeF”. - Ręczny przebieg ma wyższy budżet (62 faktury i 18 stron na godzinę), ale podlega tej samej pauzie po 429. Przy wyczerpanym budżecie kończy się bez pobrania i bez komunikatu.
- „KSeF nie jest włączony.” oznacza, że żadna firma nie ma włączonego pobierania albo biuro nie ma poświadczenia.
Duplikaty, Pomiń i Odrzuć na stałe
KSeF jest rejestrem, więc wersja z KSeF zawsze wygrywa z kopią papierową. Taxso porównuje dokumenty kluczem: NIP sprzedawcy, numer, brutto, data. Gdy klient wgrał PDF, a ta sama faktura przyszła potem z KSeF, nietknięta kopia znika, a wątek i załączniki przechodzą do wersji z KSeF. Gdy kopia była już ruszona albo jest w Optimie, oba dokumenty dostają wstrzymanie „Ta faktura jest już w Taxso jako inny dokument…” i żaden nie idzie do Optimy, dopóki nie usuniesz jednego. Szczegóły: Dokumenty spoza KSeF.
Pomiń- Faktura przechodzi do zakładki
Pominięteze statusemPominięta. Przywrócisz ją przyciskiemPrzywróć, wróci jakoDo akceptacji. Jeśli jest już w Optimie, dialog ostrzega, że wpis w rejestrze VAT zostaje. Odrzuć na stałe- Jak wyżej, ale faktura o tym numerze KSeF nie wróci przy kolejnych pobraniach. Jest pole
Powód (opcjonalnie). Cofasz wPominięteprzyciskiemCofnij odrzucenie. Obie decyzje zostają w dzienniku. Korekta do odrzuconej ma własny numer KSeF i wejdzie normalnie. Usuń fakturęna karcie- Też zapisuje trwałe odrzucenie, z powodem „Usunięta z Taxso”. Usunięty bez tego dokument wróciłby przy następnym przebiegu.
Faktura jest w KSeF od rana, a w Taxso jej nie ma. Ile czekać?+
Zwykle do 15 minut. Dłużej, gdy firma jest wstrzymane do HH:MM (limit), ponawiamy o HH:MM (awaria KSeF) albo dogania historię (12 faktur na przebieg). Gdy plakietki są zielone, a faktury nadal nie ma, kliknij w Obiegu Pobierz z KSeF.
Dlaczego nie mogę klikać `Testuj połączenie` do woli?+
KSeF daje 20 zapytań o listę na godzinę dla NIP-u i adresu Taxso. Automat zużywa do 15, test bierze z tej samej puli. Kilka testów pod rząd oznacza, że pobieranie tej firmy stanie do końca godziny albo dłużej po 429.
Przesunąłem okres startowy wstecz. Co się stanie?+
Automat dolistuje wcześniejsze miesiące (do 12 wstecz) i pobierze faktury, których nie ma w Taxso. Część może być już w Optimie; różnice pokażą Dopasowania.
Co znaczy „brak pobrań od N dni”, skoro firma ma `autoryzacja OK`?+
Autoryzacja mówi o ostatnim logowaniu. Alarm mówi, że od tygodnia żaden przebieg nie zakończył się w całości, najczęściej przez długą serię 429 przy wielu firmach na jednym NIP-ie albo wygasły certyfikat. Sprawdź kartę poświadczenia i godziny wstrzymań.