N24 KSeF Helper

Wersja _NextVersion -- 21.04.2026

💡 - Zgłoszenie od naszego klienta
- Nasze własne ulepszenie
Skontaktuj się z nami, jeśli masz jakiekolwiek pomysły lub zgłoszenia. Chętnie je rozważymy. Wyślij e-mail na: produkty@nav24.pl

Nowe funkcje

💡 Pomijanie wierszy w KSeF – walidacja kwoty wiersza

Dodaliśmy walidację, która uniemożliwia oznaczenie wiersza do pominięcia w KSeF, jeśli wiersz ma niezerową kwotę. Walidacja działa również w drugą stronę — jeśli wiersz jest już oznaczony flagą Pomiń w KSeF, zmiana kwoty na wartość różną od zera jest blokowana. Pomijanie wierszy z kwotą naruszałoby strukturę dokumentu KSeF. Walidacja działa na dokumentach sprzedaży i serwisowych.


Nowe funkcje

💡 Mapowania KSeF – obsługa danych umowy

Dodaliśmy obsługę sekcji umowy w module mapowania pól KSeF. Nowe typy sekcji umożliwiają przekazanie numeru i daty umowy do struktury XML faktury KSeF.


Nowe sekcje KSeF:
  • 📝 DataUmowy – data umowy powiązanej z fakturą
  • 📝 NrUmowy – numer umowy powiązanej z fakturą

Obsługiwane dokumenty:
  • 📄 Zaksięgowane faktury sprzedaży
  • 📄 Zaksięgowane faktury korygujące sprzedaży
  • 📄 Zaksięgowane faktury serwisowe
  • 📄 Zaksięgowane faktury korygujące serwisowe

[[N24 Product Bugfix]]

🐛 Załączniki PDF/XML e-mail – poprawka dla faktur korygujących

Naprawiono błąd w module generatora PDF i załączników e-mail, który powodował nieprawidłowe działanie przy wysyłaniu e-mail z zaksięgowanych faktur korygujących sprzedaży. System niepoprawnie odczytywał dane z nagłówka faktury zamiast z nagłówka faktury korygującej, co mogło prowadzić do błędów lub nieprawidłowych załączników. Po poprawce załączniki PDF i XML dla korekt są generowane na podstawie właściwego dokumentu, a nazwy plików poprawnie odzwierciedlają numer korekty.


Nowe funkcje

💡 Dziennik zmian dla ustawień i mapowań

Włączyliśmy automatyczne śledzenie zmian w dzienniku zmian (Change Log) dla kluczowych tabel rozszerzenia:

  • KSeF Helper - Ustawienia — rejestrowanie wstawiania, zmian i usuwania wszystkich pól
  • Mapowania pól KSeF — rejestrowanie usuwania wpisów

Dziennik zdarzeń jest włączany automatycznie podczas instalacji lub aktualizacji rozszerzenia. Historię zmian można przeglądać na standardowej stronie Zapisy dziennika zmian w Business Central.

Nowe funkcje

💡 Załączniki e-mail – ukrywanie standardowego załącznika PDF

Dodaliśmy nową opcję Ukryj standardowy załącznik faktury w ustawieniach poczty KSeF Helper. Po włączeniu tej opcji standardowy raport PDF faktury jest usuwany z wiadomości e-mail, gdy dołączany jest podgląd PDF KSeF. Dzięki temu odbiorca otrzymuje tylko wizualizację faktury KSeF, bez duplikatu standardowego raportu. Opcja działa tylko gdy pole Dołącz PDF do e-maila jest włączone.


Nowe funkcje

💡 Mapowanie pól KSeF – formatowanie wartości

Dodaliśmy pole Format w krokach mapowania pól KSeF. Pozwala ono zastosować ciąg formatu AL do wartości pola, np.:

  • <Month Text> <Year4> — wyświetla datę jako nazwę miesiąca i rok (np. „marzec 2026")
  • <Year4>-<Month,2>-<Day,2> — wyświetla datę w formacie ISO (np. „2026-03-16")
  • <Precision,2:2><Standard Format,0> — formatuje liczbę z 2 miejscami po przecinku
Formatowanie uwzględnia język dokumentu — nazwy miesięcy pojawiają się w języku faktury.

Dodaliśmy również 3 nowe przykłady konfiguracji demonstrujące formatowanie dat i liczb.

[[N24 Product Bugfix]]

🐛 Mapowanie pól KSeF – błąd przy dużej liczbie numerów seryjnych

Poprawiliśmy błąd, który występował przy łączeniu wielu wartości (np. numerów seryjnych) w jedną wartość dodatkowego opisu KSeF. Gdy połączone wartości przekraczały 250 znaków, system zgłaszał błąd walidacji długości tekstu. Po poprawce, gdy łączna wartość przekroczy dopuszczalną długość, system automatycznie tworzy kolejne wpisy dodatkowego opisu — dzięki temu wszystkie numery seryjne trafiają do faktury KSeF bez utraty danych.


Nowe funkcje

💡 Mapowanie pól KSeF – filtrowanie powiązanych tabel

Dodaliśmy filtrowanie tabel w wyszukiwaniu podczas konfiguracji wielokrokowego mapowania pól KSeF. Od teraz, przy wyborze tabeli w kroku 2 i kolejnych, system domyślnie pokazuje tylko tabele powiązane z bieżącą tabelą źródłową (na podstawie relacji pól). Ułatwia to konfigurację i zmniejsza ryzyko wybrania nieprawidłowej tabeli.


Zachowanie można wyłączyć polem Filtruj powiązane tabele w wyszukiwaniu na stronie KSeF Helper - Ustawienia w sekcji Ogólne. Dla istniejących instalacji pole jest domyślnie wyłączone — dla nowych instalacji jest włączone.