Subiekt GT standardowo nie przenosi pól Uwagi i Podtytuł do e-Faktury w KSeF. Jeśli wpisujesz tam numer zamówienia, warunki dostawy albo informację dla księgowości klienta, odbiorca ich nie zobaczy. Rozwiązaniem jest sekcja DodatkowyOpis i krótki skrypt SQL wklejony w parametrach KSeF. Licencja Sfera nie jest potrzebna.

Czego potrzebujesz

  • Subiekt GT w wersji obsługującej KSeF, czyli od 1.87, z włączonym modułem e-Faktur.
  • Uprawnień do parametrów programu.
  • Kilku minut i jednej faktury testowej.

Skrypt tylko odczytuje dane z dokumentu. Niczego w bazie nie zmienia.

Konfiguracja krok po kroku

  1. W menu wybierz Administracja > Parametry > KSeF i przejdź na zakładkę Dane e-Faktur.
  2. W części Zapis dodatkowych informacji zaznacz pole Sekcja “DodatkowyOpis” dla dokumentu. Obok odblokuje się link Definicja SQL.
  3. Kliknij Definicja SQL i wklej skrypt:
SELECT NULL, 'Uwagi do faktury' AS [Klucz], dok_Uwagi
FROM dok__Dokument
WHERE dok_Id = {dok__Dokument.dok_Id}
AND dok_Uwagi != ''
UNION ALL
SELECT NULL, 'Podtytul' AS [Klucz], dok_Podtytul
FROM dok__Dokument
WHERE dok_Id = {dok__Dokument.dok_Id}
AND dok_Podtytul != ''
  1. Zapisz definicję, a potem parametry KSeF przyciskiem OK.

Jak sprawdzić, że działa

Otwórz fakturę sprzedaży albo wystaw nową i wypełnij pola Uwagi oraz Podtytuł. Wygeneruj e-Fakturę przyciskiem Faktura do KSeF, otwórz jej podgląd i przejdź do zakładki Dodatkowy opis. Powinny tam być obie wartości z etykietami „Uwagi do faktury” i „Podtytul”.

Na wizualizacji faktury wysłanej do KSeF te dane pojawią się w części Pozostałe dane na fakturze.

Jak dodać kolejne pola

Etykiety w apostrofach możesz zmienić na dowolne. Kolejne pole dodajesz następnym blokiem:

UNION ALL
SELECT NULL, 'Nazwa pola' AS [Klucz], nazwa_kolumny
FROM dok__Dokument
WHERE dok_Id = {dok__Dokument.dok_Id}
AND nazwa_kolumny != ''

Najczęściej używane kolumny tabeli dok__Dokument:

  • dok_Uwagi: standardowe uwagi, do 500 znaków,
  • dok_UwagiExt: uwagi rozszerzone, do 3500 znaków,
  • dok_Tytul i dok_Podtytul: tytuł i podtytuł dokumentu,
  • dok_InformacjeDodatkowe: dodatkowe informacje, do 255 znaków.

Dwie zasady składni, na których najłatwiej się potknąć. Klamry {dok__Dokument.dok_Id} są obowiązkowe, bo tak Subiekt podstawia bieżący dokument, a zwykły parametr @dok_Id nie zadziała. Zapytanie musi też zwracać dokładnie trzy kolumny w tej kolejności: numer wiersza (NULL dla nagłówka), klucz i wartość.

Najczęstsze problemy

Polskie znaki zamieniają się w znaki zapytania. Pole edycji skryptu nie obsługuje pełnego Unicode. Pisz etykiety bez polskich liter, na przykład „Podtytul” zamiast „Podtytuł”.

Na e-Fakturze nic się nie pojawia. Sprawdź, czy pola na fakturze są wypełnione, bo skrypt celowo pomija puste wartości. Po każdej zmianie skryptu wygeneruj e-Fakturę ponownie przyciskiem Generuj ponownie.

Nie wiesz, jak nazywa się kolumna. Listę kolumn pokaże zapytanie w SQL Server Management Studio:

SELECT COLUMN_NAME
FROM INFORMATION_SCHEMA.COLUMNS
WHERE TABLE_NAME = 'dok__Dokument'
ORDER BY COLUMN_NAME

Chcesz ograniczyć działanie do jednego typu dokumentu. Skrypt obejmuje wszystkie dokumenty sprzedaży obsługujące KSeF: faktury, korekty i zaliczki. Zawężasz go warunkiem AND dok_Typ = X w klauzuli WHERE.

Kiedy oddać to informatykowi

Sama zmiana jest bezpieczna, ale Subiekt GT to zwykle serce firmy: sprzedaż, magazyn i rozliczenia w jednej bazie SQL. Jeśli nikt nie pilnuje jej kopii, aktualizacji programu i uprawnień użytkowników, problem z KSeF jest najmniejszym z ryzyk.

W ramach obsługi informatycznej firm ustawiamy takie rzeczy w ramach zgłoszenia na helpdesk, a serwer z bazą Subiekta obejmujemy administracją i backupem z testami odtwarzania.