Przejdź do treści głównej

Mechanizm ostrzegania o dużej liczbie pozycji

Opis funkcjonalności

Wprowadzono mechanizm ostrzegający operatora o ryzyku problemów z wysyłką dokumentów do systemu KSeF w przypadku wystawiania faktur sprzedaży (FV) zawierających bardzo dużą liczbę pozycji. Komunikat ma charakter informacyjny i nie blokuje dalszych operacji w systemie.

Uwaga: Wysoka liczba pozycji w pliku XML może powodować utrudnienia w komunikacji z bramką KSeF lub odrzucenie dokumentu ze względu na jego rozmiar. Więcej na ten temat przeczytasz w  artykule o limitach

Warunki wyświetlenia komunikatu

Komunikat ostrzegawczy pojawia się wyłącznie przy jednoczesnym spełnieniu poniższych warunków:

  • Łączna liczba pozycji na wynikowym dokumencie FV przekracza limit zdefiniowany w parametrze KsefDocumentItemsLimit.
  • Obsługa KSeF jest aktywna w systemie.
  • Parametr limitu jest zawsze aktywny i zdefiniowany na wartość domyślną 2 tys. pozycji. Za konfigurację odpowiada FLPARAM, zmiana jego wartości jest wykonalna wyłącznie przez serwis. 

Zakres działania mechanizmu

Weryfikacja ilości pozycji odbywa się w następujących miejscach systemu:

  • Ręczna konwersja asygnat (lista zaznaczeń DD).
  • Konwersja pojedynczej asygnaty (DD).
  • Wystawianie faktury sprzedaży (FV) bez asygnaty (weryfikacja w momencie zatwierdzania/wydruku).
  • Wydruk dokumentu FV.
  • Procesy automatyczne: automat tras 

Parametry konfiguracyjne

Mechanizm jest sterowany za pomocą nowego parametru w konfiguracji FLPARAM:

Parametr: KsefDocumentItemsLimit
Wartość domyślna: 2000
Opis: Określa próg liczby pozycji, powyżej którego system wyświetli ostrzeżenie. Wartość ta może być zmieniana przez serwis (np. na 5000). 

Treść komunikatu

W przypadku przekroczenia limitu operator zobaczy komunikat o treści:

Uwaga: Dokument [NR_DOKUMENTU] zawiera pozycje ponad [LIMIT]. Wysyłka do KSeF może być utrudniona.

Gdzie [LIMIT] to wartość pobrana z FLPARAM, a [NR_DOKUMENTU] to numer procesowanej faktury (jeśli jest już znany na danym etapie). Numer dokumentu pokaże się w przypadku powstałej FV, nie będzie informował o numerze asygnaty/asygnat z której następuje próba wykonania konwersji.

Dodatkowe informacje techniczne

  • Weryfikacja końcowa: Liczba pozycji dotyczy wynikowej faktury FV, a nie pojedynczych dokumentów DD (składowych).
  • Korekty i zwroty: Mechanizm obejmuje również dokumenty ZW, jeśli trafiają do KSeF. Nie dotyczy faktur zaliczkowych i korekt zaliczek.
  • Wielokrotność komunikatu: Ostrzeżenie może pojawić się na różnych etapach tego samego procesu (np. najpierw przy konwersji, a następnie przy wydruku/wysyłce), co wynika z weryfikacji danych w różnych punktach styku z modułem KSeF.
  • Brak blokady: Wybranie opcji "OK" lub "Kontynuuj" pozwala na dalsze procesowanie dokumentu mimo przekroczenia limitu.