KSEF Automatyczne pobieranie faktur

Z OgnikWiki
Wersja z dnia 11:05, 24 cze 2026 autorstwa Ognik.WS (dyskusja | edycje)
(różn.) ← poprzednia wersja | przejdź do aktualnej wersji (różn.) | następna wersja → (różn.)
Przejdź do nawigacji Przejdź do wyszukiwania

Już wkrótce: Opcja automatycznego pobierania faktur będzie dostępna od wersji 1.8.94

Do końca 2026 roku ta opcja nie wymaga dodatkowych opłat

Aby skorzystać z tej opcji wymagane jest posiadanie aktualnego programu OGNIK (W 2026 roku to generacja 13) w wersji dla biur księgowych.

Pobieranie faktur działa wyłącznie w środowisku produkcyjnym KSeF

Podstawowe zasady

1. Dodatek Cron zasadniczo powinien być używany tylko na jednym/głównym serwerze biura.

2. Dodatek Cron - wymaga certyfikatu KSeF wystawionego dla użytkownika/podmiot, któremu to użytkownikowi klienci biura nadali uprawnienia do pobierania faktur z KSeF - wraz z hasłem.

3. Dodatek Cron - może być uruchomiony wyłącznie z poziomu programu OGNIK.


Uruchomienie OGNIK.KSeF.Cron

1. Uruchom program OGNIK i zaloguj się, jako Admin

2. Wejdź do sekcji KSeF - Certyfikaty i upewnij się, że masz wgrany do Ognika certyfikat KSeF z zaznaczoną opcją Automatycznego pobierania faktur - oraz z zachowanym hasłem do certyfikatu.

Certyfikat cron.jpg

Jeśli, chcesz aktywować certyfikat, który został już wgrany do programu, należy najechać kursorem na wybrany certyfikat, kliknąć prawym przyciskiem myszy, a następnie wybrać opcję „Udostępnij ten certyfikat dla Crona”.

Udostepnij certyfikat cron.jpg

3. Uruchom sekcję KSeF - Lista faktur a następnie w górnym menu wybierz Cron, a następni "Uruchom dodatek OGNIK.KSeF.CRON". Uruchomi się główne okno programu Ognik.Cron, który pobierze listę podmiotów oraz certyfikat KSeF z programu OGNIK.

Uruchom cron.jpg

4. Możesz dostosować listę podmiotów, np. usunąć podmioty, dla których nie chcesz automatycznie pobierać faktur.

  • Dodaj firmy - program doda na listę wszystkie podmioty.

Aby usunąć firmę z listy, wystarczy zaznaczyć wybraną firmę i nacisnąć klawisz Delete na klawiaturze.

  • Zapisz listę - służy do zapisania dostosowanej listy firm.
  • Wybierz certyfikat
Cron opcje dodaj firmy.jpg

5. Po kliknięciu Uruchom - Dodatek - wyliczy statystyki juz pobranych faktur i w oparciu o nie ustali sobie harmonogram dla każdej firmy i zacznie pobierać faktury do poszczególnych firm.

Cron uruchom.jpg

Ważne. OGNIK Cron pobiera faktury dla poszczególnych firm z różną częstotliwością, w zależności od liczby już wcześniej pobranych faktur. W uproszczeniu dla firm mających dużo faktur - nawet co 15 minut, dla firm mających miesięcznie kilka czy kilkanaście faktur - raz na dobę.

Jak dokładnie CRON pobiera faktury?

Aby Cron zaczął pobierać faktury w danej firmie - pobierz przynajmniej jedną fakturę w tej firmie "ręcznie" z poziomy listy faktur KSeF SOD.

Na dole okna widzisz trzy ustawienia.

  • Interwał - oznacza co ile minut Cron uruchomi proces pobierania faktur.
  • MOD - Oznacza co ile przebiegów - Cron pobierze faktury w każdej firmie, niezależnie od wyliczonych statystyk, oraz co ile przebiegów Cron zresetuje ewentualne błędy pobierania.
  • Próg. F - JEśli w firmie w ostatnim miesiącu było co najmniej tyle faktur - cron będzie pobierał faktury w każdym przebiegu.

Czyli, przy ustawieniach domyślnych: Interwał: 60 Mod: 24 Próg F.: 100:

  • w firmie, która ma jedną fa miesięcznie - Cron będzie pobierał faktury co 24 przebiegi - czyli mniej więcej raz na 24x60minut = czyli raz na dobę.
  • w firmie, która ma 101 fa miesięcznie - Cron będzie pobierał faktury w każdym przebiegu - czyli mniej więcej raz na dobę.

Jeśli w danym przebiegu Cron trafi na błąd - np. brak uwierzytelnienia, błąd KSeF itd. - oznaczy daną firmę jako Pomiń, aż do kolejnej pełnej pętli wyznaczonej przez Mod - Czyli np. 24 przebieg, po czym - ponowi proces pobierana od nowa, w tym odświeży statystyki pobierania i zresetuje błędy.


6. Cron działa w tle, dlatego aby nie zamykać dodatku i jednocześnie móc dalej korzystać z programu Ognik, użyj przycisku „Minimalizuj okno do zasobnika...”.

Cron minimalizuj.jpg


Minimalizuj okno do zasobnika, czyli do obszaru powiadomień.