💬 Eksport komentarzy do KSeF

Moduł Eksport komentarzy umożliwia automatyczne eksportowanie wierszy komentarzy z faktur sprzedaży i faktur korygujących do sekcji DodatkowyOpis w fakturze KSeF. Dzięki temu dodatkowe informacje tekstowe umieszczone na dokumencie sprzedaży trafiają bezpośrednio do struktury XML faktury KSeF.

Najważniejsze możliwości

  • Automatyczny eksport wierszy typu „Komentarz" jako dodatkowych opisów (DodatkowyOpis) w KSeF.
  • Konfigurowalny kierunek przypisywania komentarzy – komentarze powyżej lub poniżej wiersza pozycji.
  • Obsługa zaksięgowanych faktur sprzedaży i faktur korygujących sprzedaży.
  • Konfiguracja bezpośrednio na stronie ustawień KSeF (Polish Localization).

Obsługiwane dokumenty

Dokument Obsługiwany
Zaksięgowana faktura sprzedaży ✅
Zaksięgowana faktura korygująca sprzedaży ✅

Jak to działa

  1. System przechwytuje zdarzenie tworzenia dodatkowych opisów faktury KSeF (zdarzenie z Polish Localization).
  2. Odczytuje ustawienia eksportu komentarzy z ustawień KSeF.
  3. Dla każdego wiersza pozycji (niekomentarzowego) na fakturze system wyszukuje powiązane wiersze komentarzy zgodnie z wybranym kierunkiem:
    • Poniżej – komentarze znajdujące się bezpośrednio po wierszu pozycji są przypisywane do tego wiersza.
    • Powyżej – komentarze znajdujące się bezpośrednio przed wierszem pozycji są przypisywane do tego wiersza.
  4. Znalezione komentarze są eksportowane jako rekordy DodatkowyOpis z etykietą „Komentarz" i treścią wiersza komentarza.

Konfiguracja

  1. Wyszukaj stronę Ustawienia KSeF (ITI NSeI Setup).
  2. Przejdź do sekcji Eksport komentarzy | N24KH.
  3. Skonfiguruj opcje:
    • Eksportuj wiersze komentarzy – włącz, aby aktywować eksport komentarzy do KSeF.
    • Kierunek komentarzy – wybierz, czy komentarze poniżej czy powyżej wiersza pozycji mają być przypisywane do tego wiersza.

Kierunek przypisywania komentarzy

Kierunek Opis
Poniżej (komentarze po wierszu) Komentarze umieszczone bezpośrednio po wierszu pozycji są przypisywane do tego wiersza.
Powyżej (komentarze przed wierszem) Komentarze umieszczone bezpośrednio przed wierszem pozycji są przypisywane do tego wiersza.

Wskazówki

  • Puste wiersze komentarzy (bez tekstu) są pomijane podczas eksportu.
  • W trybie „Powyżej" komentarze na końcu dokumentu (po ostatnim wierszu pozycji) są pomijane.
  • Etykieta opisu w KSeF to zawsze „Komentarz" (stała wartość).
  • Eksport komentarzy działa niezależnie od modułu mapowania pól KSeF – oba mechanizmy mogą być aktywne jednocześnie.