**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](https://pomoc.cairo.pl/books/ksef/page/limity-wielkosci-pliku-xml-w-ksef-co-warto-wiedziec)
## 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. ## Automatyczne zaznaczanie z limitem Wprowadzono ułatwienie zaznaczania dokumentów z poziomu: **Kontrahenci -> Dokumenty -> Asygnaty nierozliczone**. Wykonując opcję **Zaznacz według**, system umożliwia automatyczne zaznaczenie dokumentów z uwzględnieniem parametru: - **Nazwa parametru:** `KsefDocumentItemsLimit` - **Wartość domyślna:** 2000 System automatycznie zaznaczy dokumenty, których suma ilości pozycji nie przekracza wartości ustawionej w tym parametrze. Wystarczy zaznaczyć opcje **UWZGLĘDNIJ LIMIT POZYCJI KSEF.** #### [](https://pomoc.cairo.pl/uploads/images/gallery/2026-01/NSCeueygtSObW2Gj-image.png) Weryfikacja ilości pozycji W celu bieżącej kontroli danych dodano nową kolumnę: **ILOŚĆ POZYCJI:** Wyświetlana przy liście dokumentów, wskazuje sumę pozycji dla danej pozycji oraz podsumowanie do listy zaznaczonych dokumentów. [](https://pomoc.cairo.pl/uploads/images/gallery/2026-01/mjEtzxJQ7z120By6-image.png) System pilnuje zdefiniowanych ograniczeń również podczas ręcznej edycji listy. Jeżeli system zaznaczy określoną liczbę dokumentów, a operator doda kolejne i suma pozycji przekroczy zdefiniowaną wartość, podczas konwersji wyświetlony zostanie **stosowny komunikat ostrzegający**. ## [](https://pomoc.cairo.pl/uploads/images/gallery/2026-01/xGD7XZu0bFOte8zw-image.png) Dodatkowe informacje techniczne - **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:** "Prze klikanie" komunikatu pozwala na dalsze procesowanie dokumentu mimo przekroczenia limitu.