Skip to content

Automatyczne dosyłanie

This content is not available in your language yet.

Gdy KSeF powraca do stanu Available, BizFlow NH automatycznie dosyła wszystkie faktury wystawione w trybie offline.

Serwis działający w tle (OfflineResendService) odpowiada za automatyczne dosyłanie:

  • Interwał sprawdzania: co 60 sekund
  • Warunek uruchomienia: KSeF w stanie Available + istnieją faktury ze statusem OfflinePending
  • Tryb wysyłki: sesja zbiorcza (batch) z flagą offlineMode: true
  1. Wykrycie przywrócenia KSeF

    OfflineResendService wykrywa zmianę stanu Latarni na Available.

  2. Pobranie faktur offline

    System pobiera wszystkie faktury ze statusem OfflinePending, posortowane chronologicznie.

  3. Sesja zbiorcza

    Faktury wysyłane są w sesji zbiorczej KSeF (batch session). Flaga offlineMode: true informuje KSeF, że są to faktury dosyłane.

  4. Aktualizacja statusów

    Po potwierdzeniu przez KSeF:

    • Zaakceptowane — status Accepted, przypisany numer KSeF
    • Odrzucone — status Rejected, log błędu

BizFlow NH automatycznie oblicza terminy zgodnie z CIRFMF:

Typ niedostępnościTermin
Planowana przerwa (Maintenance)Następny dzień roboczy po przywróceniu
Awaria (Failure/TotalFailure)7 dni roboczych od przywrócenia

System uwzględnia:

  • Dni robocze (pomija weekendy i święta)
  • Kaskadowe awarie (przeliczanie terminów)
  • Strefę czasową (Europe/Warsaw)

Mechanizm bezpieczeństwa SafetyNet sprawdza, czy nie ma faktur, które “przeleciały” przez standardowy mechanizm dosyłania:

  • Uruchamia się co 15 minut
  • Szuka faktur OfflinePending starszych niż 5 minut po przywróceniu KSeF
  • Próbuje dosłać je ponownie
  • Loguje ostrzeżenie, jeśli znajdzie zaległe faktury

Statusy offline widoczne są jako badge na standardowych listach dokumentów SAP i stronach szczegółów faktury. Filtruj po statusie Offline aby zobaczyć faktury oczekujące na dosłanie.

W Panelu serwisowym (zakładka Submissions) dostępna jest pełna historia wysyłek z możliwością ponowienia (retry) nieudanych.

  1. Sprawdź stan Latarni: czy KSeF jest oznaczony jako Available? Status widoczny w selektorze firm (CompanySelector) w nagłówku dashboardu.
  2. Sprawdź logi serwisu: ./ctl.sh logs api | grep OfflineResend
  3. Sprawdź czy certyfikat auth nie wygasł
  4. Sprawdź połączenie sieciowe z KSeF

Najczęstsze przyczyny:

  • XML nie przechodzi walidacji KSeF (zmieniony schemat?)
  • Duplikat — faktura o tym samym identyfikatorze już istnieje w KSeF
  • Przekroczony termin dosyłania

W przypadku odrzucenia: sprawdź komunikat błędu, popraw dane i prześlij ponownie ręcznie.