Od wersji 20.0.380.147 dostępna jest opcja Szablony XML do KSeF, która umożliwia edycję struktury pliku XML, według której będą generowane dokumenty sprzedaży, wysyłane do Krajowego Systemu e-Faktur. Pozwala to na dostosowanie danych znajdujących się na fakturach, do dodatkowych wymagań przedsiębiorstw, np. umów z kontrahentami lub specyfikacji sieci handlowych. Jest to kolejne, po Formularzu dla dodatkowych pól do KSeF, narzędzie umożliwiające modyfikację pliku XML wysyłanego do Krajowego Systemu e-Faktur. Ponadto modyfikacja struktury możliwa jest za pomocą wtyczki do edycji eksportowanego XML, której opis znajduje się w konfiguracji KSeF w systemie Streamsoft.

Opcja pozwala na dowolną ingerencję w dane przesyłane na platformę KSeF - zmian należy dokonywać świadomie i mając na uwadze zgodność z przepisami/wytycznymi MF. 

Z uwagi na zaawansowany poziom edycji elementów, do wprowadzania zmian w szablonach wysyłanych do KSeF zalecana jest znajomość struktury pliku XML wysyłanego do KSeF lub/oraz języka SQL. 

SPIS TREŚCI 

 

 

Definiowanie szablonu XML do KSeF

W menu Sprzedaż → Krajowy System e-Faktur → Szablony XML do KSeF należy utworzyć szablon za pomocą opcji Dodaj (F3).

Dane podstawowe

W oknie edycyjnym, na zakładce 1 Podstawowe należy wprowadzić Nazwę szablonu, opcjonalnie można uzupełnić dodatkowe informacje dotyczące danego szablonu w polu Opis. Za pomocą znacznika Aktywny można sterować widocznością szablonu w systemie.

Elementy szablonu XML

Zakładka 2 Elementy XML umożliwia podgląd, dodanie, edycję lub usunięcie poszczególnych składowych / części w pliku XML. Sekcja służy wyłącznie do edycji pozycji wprowadzających zmiany, nie ma konieczności wprowadzania całej struktury pliku XML.

Istotne znaczenie ma kolejność wprowadzania elementów. Podczas generowania pliku XML według szablonu system wykonuje modyfikacje w strukturze pliku zgodnie z hierarchią ustalona na tej zakładce, tj. zaczynając od czynności z liczbą porządkową 1. Kolejność można zmieniać za pomocą przycisków strzałek .

Edycja elementu szablonu

Element zmieniający strukturę pliku XML należy wprowadzić za pomocą opcji Dodaj (F3). Istniejące pozycje można edytować za pomocą opcji Popraw (F5).

Okno edycyjne elementu XML zawiera pola:

 



Kolejność i hierarchia wierszy w sekcji ma istotne znaczenie podczas walidacji pliku XML na platformie KSeF. System podczas generowania pliku XML według szablonu weryfikuje kolejność wierszy wprowadzoną przez operatora z hierarchią wynikającą z wytycznych KSeF. W przypadku błędnej kolejności system automatycznie wprowadza poprawny porządek w generowanym pliku.

 

 

Przykład zastosowania - dodanie nowej pozycji faktury:

Przykład zastosowania pól Dotyczy i Typ pola - pobranie wartości pola na z cechy kartoteki: 


Dla czynności dotyczących zapytań SQL i wprowadzania nowego bloku XML elementu istnieje możliwość weryfikacji poprawności wprowadzonej treści. 


Weryfikacja zapytania SQL

Na zakładkach Treść zapytania SQL i Treść bloku XML dostępny jest przycisk Test , który sprawdza zapytanie pod względem poprawności technicznej. Weryfikacji podlega wyłącznie treść wprowadzona w zakładce - system nie sprawdza całej struktury pliku XML wraz ze zmienianym fragmentem. Po weryfikacji wyświetlany jest raport z wynikiem, a w przypadku wykrycia błędu zostanie on wskazany w treści komunikatu.

W przypadku zapytań SQL dostępne są parametry, które służą do weryfikacji utworzonego zapytania: 


Opcja Test dotyczy wyłącznie sprawdzenia treści pod względem technicznej poprawności języka SQL. System nie weryfikuje edytowanych elementów w kontekście zgodności ze strukturą (schematem) XML pliku KSeF.


Powiązanie szablonu XML z dokumentem sprzedaży 

Szablony XML można powiązać z Definicją dokumentu, Miejscem sprzedaży lub Kontrahentem. Na podstawie tych powiązań system będzie ustalał szablon, na podstawie którego utworzy plik XML wysyłany do Krajowego Systemu e-Faktur.

W tym celu dodane zostały pola:

I. Szablon XML do KSeF

Pole jest dostępne w oknie edycyjnym danych kontrahenta, definicji miejsca sprzedaży oraz definicji dokumentu. Pozwala na wskazanie domyślnego szablonu dla wszystkich dokumentów sprzedaży wystawianych na danego kontrahenta. Szablon można wybrać z listy rozwijanej lub ze słownika dostępnego pod przyciskiem strzałki → Wybierz (F6).

II. Szablon XML do KSeF dla definicji dokumentu 

Pole jest dostępne w oknie edycyjnym danych kontrahenta oraz definicji miejsca sprzedaży. Umożliwia przypisanie szablonów dla poszczególnych definicji dokumentów wystawianych na kontrahenta. W pierwszej kolejności należy wybrać zdefiniowany w słowniku szablon XML, następnie wskazać definicję dokumentu, dla której ma obowiązywać. 


Opisane powyżej pola znajdują się:

W menu Słowniki → Kontrahenci → zakładka → 18 KSeF:


W menu Słowniki → Słowniki dla dokumentów →  Miejsca sprzedaży → zakładka 10 KSeF:


W menu Słowniki → Definicje dokumentów HM → Sprzedaż towarów handlowych → wybrana definicja dokumentu → zakładka 1 Podstawowe:

Okno edycyjne dokumentu sprzedaży

W oknie edycyjnym dokumentu sprzedaży na zakładce Zestawienie VAT znajduje się pole Szablon XML. Prezentuje ono nazwę szablonu, który został przypisany do dokumentu na podstawie powiązań z danych kontrahenta, miejsca sprzedaży lub definicji dokumentu. Dodatkowo pod przyciskiem strzałki możliwa jest zmiana automatycznie przypisanego szablonu.


Kolejność pobierania szablonu XML na dokument sprzedaży 

System pobiera wartości do pola Szablon XML w dokumencie sprzedaży zgodnie z kolejnością:

  1. Dane kontrahenta - sekcja Szablon XML do KSeF dla definicji dokumentu
  2. Dane kontrahenta - pole Szablon XML 
  3. Miejsce sprzedaży - sekcja Szablon XML do KSeF dla definicji dokumentu
  4. Miejsce sprzedaży - pole Szablon XML 
  5. Definicja dokumentu HM