Pola 'DodatkowyOpis' w KSeF - do czego służą? Praktyczny przewodnik po polach opcjonalnych

Czym dokładnie jest pole DodatkowyOpis i kiedy warto je wykorzystać

AITekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Struktura logiczna e-faktury w formacie XML (Extensible Markup Language) przewiduje dedykowane sekcje dla danych o charakterze fakultatywnym. Pole DodatkowyOpis znajduje się w ścieżce XML: /Faktura/DodatkowyOpis i pełni funkcję wolnego pola tekstowego. Z punktu widzenia technicznego, pole to akceptuje rodzaj danych typu string, a jego maksymalna długość została ograniczona do 250 znaków. Należy podkreślić, że KSeF nie weryfikuje wartości liczbowych ani merytorycznej poprawności treści wpisanej w tym miejscu; jedyną stosowaną regułą walidacyjną jest sprawdzenie limitu znaków.

Pod względem prawnym funkcjonowanie pól opcjonalnych reguluje art. 106n § 2 pkt 3 ustawy o podatku od towarów i usług, który wskazuje, że faktura może zawierać inne dane istotne z punktu widzenia przepisów ogólnych lub specyfiki transakcji. Pole DodatkowyOpis nie może jednak zastępować żadnego z obligatoryjnych elementów faktury wymienionych w art. 106e ust. 1 ustawy o VAT. Wprowadzenie danych do tej sekcji ma na celu wyłącznie usprawnienie procesów biznesowych i identyfikację dokumentu w systemach księgowych kontrahenta. Dokument w formacie PDF, pozbawiony ustrukturyzowanej formy XML po dacie wdrożenia obowiązku, nie będzie uznawany za dokument księgowy.

Biznesowe uzasadnienie wykorzystania tego pola wynika z dynamiki obrotu handlowego. Faktura bez numeru zamówienia czy odpowiedniego kodu identyfikacyjnego często nie przechodzi weryfikacji w działach logistyki dużych podmiotów. Sytuacje te nie są teoretyczne - dostawcy do sieci handlowych regularnie spotykają się z odrzuceniem dokumentów, które nie zawierają specyficznych danych referencyjnych. Wykorzystanie pola DodatkowyOpis pozwala na uniknięcie zatorów płatniczych i automatyzację procesu uzgadniania rozrachunków.

W związku z powyższym, zaleca się ustalenie wewnętrznego słownika skrótów, takich jak prefiksy „ZAM-” dla zamówień czy „PRO-” dla projektów. Ustandaryzowanie sposobu wypełniania 250 dostępnych znaków znacząco ułatwi filtrowanie danych w systemach klasy ERP (Enterprise Resource Planning) oraz przyspieszy proces dekretacji dokumentów po ich odebraniu z KSeF.

Jak skonfigurować pole DodatkowyOpis w popularnych programach (Symfonia, myERP, fillup)

Prawidłowa konfiguracja systemów informatycznych jest niezbędna, aby dane z lokalnych baz danych były poprawnie mapowane do struktury XML KSeF. W systemie Symfonia Handel, począwszy od wersji 2025.1.3, proces ten został zautomatyzowany. Administrator systemu musi dokonać aktywacji pól dodatkowych w odpowiednim module konfiguracyjnym, co pozwala na automatyczne zaciąganie danych z dokumentów źródłowych. Należy pamiętać, że wszelkie zmiany w ustawieniach przesyłu danych do Krajowego Systemu e-Faktur wymagają uprawnień administracyjnych oraz aktualnego certyfikatu uwierzytelniającego.

• Wejdź w Sprzedaż → Ustawienia → KSeF → Pola dodatkowe
• Kliknij 'Dodaj pole własne' → wybierz DodatkowyOpis
• W polu 'Źródło danych' wskaż kolumnę ZamówienieKupna
• Zapisz szablon jako domyślny dla danego kontrahenta

W systemie myERP konfiguracja opiera się na definicji reguł automatycznych. Pole to jest widoczne w szablonie faktury pod nazwą „Opis dodatkowy (KSeF)”. System umożliwia ustawienie logiki warunkowej: jeżeli system rozpozna NIP konkretnego kontrahenta (np. dużej sieci handlowej), automatycznie wypełni pole DodatkowyOpis numerem zamówienia powiązanym z daną transakcją. Pozwala to na uniknięcie błędów manualnych przy wystawianiu dużej liczby dokumentów sprzedażowych.

Dla użytkowników korzystających z aplikacji fillup i integracji przez API (Application Programming Interface), konieczne jest uwzględnienie pola w strukturze przesyłanego payloadu. Przykładowy fragment kodu JSON przekazujący dane do pola dodatkowego wygląda następująco: {"DodatkowyOpis":"{{order_number}}"}. Kluczowe jest, aby zmienna order_number była prawidłowo zdefiniowana w logice aplikacji integrującej, co zapewni spójność danych między systemem operacyjnym a bramką Ministerstwa Finansów.

7 najczęstszych błędów przy wypełnianiu pola DodatkowyOpis i jak ich uniknąć

Najpoważniejszym błędem technicznym jest przekroczenie limitu długości pola. W sytuacji, gdy użytkownik próbuje wprowadzić opis towaru lub warunki dostawy przekraczające 250 znaków, faktura zostanie odrzucona przez system KSeF na etapie walidacji strukturalnej. Powoduje to konieczność ponownego wystawienia dokumentu z nową datą, co może wpłynąć na termin płatności. Rozwiązaniem jest stosowanie precyzyjnych skrótów oraz separatorów, takich jak pionowa kreska „|”, w celu oddzielenia różnych informacji wewnątrz jednego pola.

Kolejnym krytycznym zagrożeniem jest umieszczanie w polu DodatkowyOpis danych wrażliwych podlegających ochronie RODO (Ogólne Rozporządzenie o Ochronie Danych). Wpisywanie numerów PESEL osób fizycznych, serii i numerów paszportów lub prywatnych adresów e-mail w polu, które staje się częścią publicznie dostępnego (dla uprawnionych organów i kontrahentów) archiwum państwowego, jest niedopuszczalne. Naruszenie tych zasad może skutkować nałożeniem przez Urząd Ochrony Danych Osobowych sankcji finansowych sięgających 2 mln zł lub 4% rocznego obrotu przedsiębiorstwa.

Brak jednolitego standardu wpisywania danych wewnątrz organizacji prowadzi do chaosu w raportowaniu. Przykładowo, jeśli dział handlowy stosuje oznaczenie „ZAM-123”, a dział logistyki „Order 123”, systemy ERP mogą generować podwójne rekordy, co uniemożliwia automatyczne parowanie płatności. Dlatego zaleca się wdrożenie wewnętrznej procedury ISO oraz stworzenie „Słownika skrótów KSeF” w formie dokumentu PDF, który będzie obowiązywał wszystkich pracowników odpowiedzialnych za fakturowanie.

Check-lista na 1 lutego 2026 - czy Twoje pole DodatkowyOpis jest gotowe?

Przygotowanie do wdrożenia KSeF 2.0, które nastąpi 1 lutego 2026 r., wymaga przeprowadzenia rzetelnych testów w środowisku próbnym. Środowisko KSeF-Sandbox jest dostępne dla przedsiębiorców bez konieczności posiadania podpisu kwalifikowanego - do autoryzacji wystarczy profil zaufany. Zaleca się wysłanie minimum 10 faktur testowych z różnorodnymi wartościami w polu DodatkowyOpis, aby zweryfikować, w jaki sposób dane te są prezentowane w wizualizacji PDF oraz czy są poprawnie interpretowane przez systemy odbiorcze kontrahentów.

Kolejnym krokiem jest uzyskanie formalnego potwierdzenia od kluczowych kontrahentów. Należy wysłać zapytanie z prośbą o weryfikację, czy format danych umieszczany w polu DodatkowyOpis (np. numer umowy lub kod GLN) jest w pełni kompatybilny z ich systemami automatycznego księgowania. Załączenie przykładowego pliku XML pozwoli działom IT kontrahenta na wcześniejsze ustawienie reguł mapowania, co zminimalizuje ryzyko błędów po 1 lutego 2026 r.

Ostatnim etapem przygotowań jest zapewnienie ciągłości danych poprzez backup. Chociaż KSeF przechowuje faktury przez okres 10 lat, posiadanie własnej bazy danych SQL z zarchiwizowanym mapowaniem (relacja: KSeF ID - DodatkowyOpis - Numer Zamówienia) jest niezbędne dla celów szybkiego wyszukiwania informacji i kontroli zarządczej. Warto również rozważyć przeprowadzenie testu obciążeniowego w porozumieniu z działem IT, symulując wysyłkę 100 faktur na minutę, aby upewnić się, że infrastruktura firmy poradzi sobie z generowaniem ustrukturyzowanych dokumentów w czasie rzeczywistym.