💬 Eksport komentarzy do KSeF

Moduł Eksport komentarzy umożliwia automatyczne eksportowanie wierszy komentarzy z faktur sprzedaży, faktur korygujących, faktur serwisowych i korekt serwisowych do sekcji DodatkowyOpis w fakturze KSeF. Dzięki temu dodatkowe informacje tekstowe umieszczone na dokumencie 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, faktur korygujących sprzedaży, faktur serwisowych i korekt serwisowych.
  • Konfiguracja na dedykowanej stronie KSeF Helper Setup.

Obsługiwane dokumenty

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

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. Na podstawie ustawienia Format komentarza system buduje treść komentarza:
    • Opis – eksportowane jest wyłącznie pole „Opis" wiersza komentarza.
    • Opis + Opis 2 – eksportowane jest pole „Opis" połączone z polem „Opis 2" (rozdzielone spacją).
  5. Znalezione komentarze są eksportowane jako rekordy DodatkowyOpis z etykietą „Komentarz" i treścią wiersza komentarza.

Konfiguracja

  1. Wyszukaj stronę KSeF Helper Setup (lub otwórz ją z poziomu Ustawienia KSeF klikając link Otwórz kartę ustawień KSeF Helper).
  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.
    • Etykieta komentarza – opcjonalna własna etykieta używana w sekcji DodatkowyOpis. Jeśli puste, używana jest domyślna wartość „Komentarz”. - Format komentarza – określa, jakie pola tworzą treść komentarza: samo pole „Opis" lub „Opis + Opis 2" (konkatenacja obu pól rozdzielonych spacją).

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 domyślnie „Komentarz”. Można ją zmienić w polu Etykieta komentarza w ustawieniach.
  • Eksport komentarzy działa niezależnie od modułu mapowania pól KSeF – oba mechanizmy mogą być aktywne jednocześnie.