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
- W menu wybierz Administracja > Parametry > KSeF i przejdź na zakładkę Dane e-Faktur.
- W części Zapis dodatkowych informacji zaznacz pole Sekcja “DodatkowyOpis” dla dokumentu. Obok odblokuje się link Definicja SQL.
- 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 != ''
- 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_Tytulidok_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.