Konfiguracja schematów sprzedaży

1. Rozszerzenie mechanizmu eksportu/importu schematów KSeF o opisy dodatkowe

Rozbudowano mechanizm eksportu/ importu Konfiguracji schematów sprzedaży o obsługę dodatkowych opisów, dostępny pod przyciskiem F12 na liście konfiguracji schematów sprzedaży.

Przykład:

Konfiguracja użytkownika FA (3)/1-0E/024 ma włączone uwzględnianie Uwag dokumentu ze zmodyfikowanym Kluczem w KSeF, tj. Uwagi dokumentu – Fabryczne oraz zdefiniowaną przykładową formułę użytkownika o kluczu Nagłówek Test na Liście formuł opisu dodatkowego nagłówka.

Konfiguracja zostaje wyeksportowana do pliku KSEF FA (3) 1-0E 024 20260120 102829.xml.

Następnie zostaje ponownie zaimportowana z wyeksportowanego wcześniej pliku. Ze względu na duplikat tworzona jest kopia z kolejnym wolnym numerem, tj. FA (3)/1-0E/031.

Zaimportowana konfiguracja posiada definicje dodatkowych opisów nagłówka zgodnie z wyeksportowaną konfiguracją, tj. uwzględnianie uwag dokumentu oraz formułę użytkownika.

2. Rozbudowa konfiguracji KSeF o fabryczne definicje opisów dodatkowych nagłówka i pozycji

Rozbudowano mechanizm Listy formuł opisu dodatkowego dostępny dla niefabrycznych Konfiguracji KSeF zarówno dla Definicji dodatkowych opisów nagłówka oraz Definicji dodatkowych opisów pozycji.

Zarówno okno dodatkowych opisów do nagłówka jak i do pozycji, zostało rozdzielone na dwie części dotyczące formuł Fabrycznych oraz Użytkownika.

Tabela Fabryczne, z ustawieniami dodatkowych opisów nagłówka zawiera kolumny:

Uwzględnij – w przypadku zaznaczenia Uwzględnij w dodatkowym opisie, dla ustawienia dodatkowego opisu nagłówka, w polu tym widoczny jest symbol zaznaczenia,

Opis – w polu zawarta jest nazwa ustawienia dodatkowego opisu,
Klucz w KSeF – zawiera Nazwę klucza w KSeF zdefiniowaną dla tagu <Klucz>.
W przypadku ustawienia Cechy pole jest puste, ponieważ nazwa klucza trafiająca do XML uzależniona jest od nazwy wyświetlanej dla poszczególnej cechy nagłówka dokumentu.

Dotychczas utworzone definicje dodatkowych opisów znajdują się w tabeli oznaczoną etykietą Użytkownika i umieszczone są w tabeli poniżej Fabrycznej.

Niezależnie od sposobu definicji dodatkowego opisu dokumentu, tj. Fabryczny lub Użytkownika, struktura węzła <DodatkowyOpis> jest taka sama i składa się z tagów <Klucz> oraz <Wartosc>, a sam węzeł zagnieżdżony jest w węźle <Fa>.

Definicja dodatkowych opisów nagłówka

Tabela Fabryczne zawiera następujące ustawienia dla dodatkowych opisów nagłówka:

Uwagi – opcja z możliwością włączenia/ wyłączenia uwzględniania Uwag dokumentu w Dodatkowym opisie nagłówka oraz definicji nazwy klucza.

Po zaznaczeniu opcji Uwzględnij w dodatkowym opisie, wartość tekstowa wprowadzona w polu Nazwa klucza w KSeF trafi do tagu <Klucz>, natomiast treść uwag faktury sprzedaży do tagu <Wartosc>. Tak zdefiniowane tagi umieszczone zostaną w węźle <DodatkowyOpis> w XML dla KSeF.

Cechy – opcja z możliwością włączenia/ wyłączenia uwzględniania Cech w dodatkowym opisie do nagłówka.

Po zaznaczeniu Uwzględnij w dodatkowym opisie, cechy dla nagłówka faktury będą uwzględniane w XML dla KSeF.

Informacje dotyczące funkcjonalności obsługi cech w Konfiguratorze KSeF znajdują się w oddzielnym punkcie – KSEF – Konfigurator – obsługa cech.

Definicja dodatkowych opisów pozycji

Do formularza Lista formuł opisu dodatkowego dla definicji dodatkowych opisów pozycji dodano tabelę Fabryczne, zawierającą ustawienia dodatkowych opisów pozycji dla KSeF.

Do tej tabeli zostały przeniesione znaczniki włączające uwzględnianie:

opłaty cukrowej,
KGO (Koszty Gospodarowania Odpadami),
numerów seryjnych,
numerów partii jako dodatkowe opisy pozycji w XML dla KSeF.

Dotychczas utworzone własne definicje dodatkowych opisów pozycji, znajdują się w tabeli z etykietą Użytkownika.

Każde z fabrycznych ustawień dodatkowych opisów pozycji zawiera znacznik Uwzględnij w dodatkowym opisie, umożliwiający włączanie/ wyłączanie opcji oraz pole Nazwa klucza w KSeF z możliwością określenia nazwy wpisywanej w tagu <Klucz> w XML dla KSeF.

Tabela Fabryczne zawiera następujące ustawienia dla dodatkowych opisów pozycji:

Nr partii – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z nr partii w XML dla KSeF. Aby numer partii prawidłowo trafił do XML, niezbędne jest wskazanie dostawy, w czasie dodawania pozycji do dokumentu sprzedaży,
Data ważności – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z datą ważności w XML dla KSeF. Aby data ważności prawidłowo trafiła do XML, niezbędne jest wskazanie dostawy, w czasie dodawania pozycji do dokumentu sprzedaży,
Nr seryjny – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z numerem seryjnym w XML dla KSeF,
Nr seryjny zakres – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z zakresem numerów seryjnych w XML dla KSeF,
Opis do pozycji – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z opisem do pozycji w XML dla KSeF,
Nr katalogowy – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z numerem katalogowym w XML dla KSeF,
Nr u kontrahenta – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z numerem u kontrahenta w XML dla KSeF.
Koszt gospodarowania odpadami (KGO) – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z wartością KGO w XML dla KSeF.
Opłata cukrowa – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z wartością opłaty cukrowej w XML dla KSeF.
Opłata alkoholowa – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z wartością opłaty alkoholowej w XML dla KSeF.
Cechy – ustawienie umożliwiające generowanie węzła <DodatkowyOpis> dla pozycji z wartością cechy pozycji w XML dla KSeF.

Przykład. 1 Nr partii jako dodatkowy opis.

Artykuł CC-41 z włączoną Obsługą partii przyjęto dokumentem przychodowym P /W /26/000001 z nr partii 12102253.

Dokument sprzedaży jest wystawiany w rejestrze F /NKS ze wskazanym Identyfikatorem konfiguracji KSeF użytkownika FA (3)/1-0E/024.

Wskazana konfiguracja ma włączone uwzględnianie Nr partii w dodatkowym opisie w Definicji dodatkowych opisów pozycji.

Podczas dodawania pozycji na dokumencie sprzedaży F /NKS/26/000005, pozycja sprzedaży została powiązana z konkretną dostawą, tj. pozycją dokumentu P /W /26/000001.

W efekcie, w wygenerowanym XML’u dla dokumentu F /NKS/26/000005 w węźle Fa znajduje się gałąź DodatkowyOpis zawierająca tagi:

<NrWiersza> odnoszący się do numeru pozycji, której dotyczy dodatkowy opis,
<Klucz> zawierający nazwę klucza w KSeF tj. domyślnie Nr partii,
<Wartosc>, do którego wpisywany jest nr partii z dokumentu przychodowego.

Przykład 2. Data ważności jako dodatkowy opis.

Na pozycji dokumentu przychodowego P /W /26/000001 określono datę ważności pozycji w polu Termin przydatności jako 23.01.2026.

Dokument sprzedaży jest wystawiany w rejestrze F /NKS ze wskazanym Identyfikatorem konfiguracji KSeF użytkownika FA (3)/1-0E/024.

Wskazana konfiguracja ma włączone uwzględnianie Daty ważności w dodatkowym opisie w Definicji dodatkowych opisów pozycji.

Podczas dodawania pozycji na dokumencie sprzedaży F /NKS/26/00006, pozycja sprzedaży została powiązana z konkretną dostawą tj. pozycją dokumentu P /W /26/000001.

W efekcie, w wygenerowanym XML’u dla dokumentu F /NKS/26/000006 w węźle Fa znajduje się gałąź DodatkowyOpis zawierająca tagi:

<NrWiersza> odnoszący się do numeru pozycji, której dotyczy dodatkowy opis,
<Klucz> zawierający nazwę klucza w KSeF, tj. domyślnie Data ważności,
<Wartosc>, do którego wpisywana jest data ważności z dokumentu przychodowego określona w polu Termin przydatności.

Przykład 3. Nr seryjny jako dodatkowy opis.

Artykuł CC-42 z włączoną obsługą numerów seryjnych przyjęto dokumentem przychodowym P /W /26/000002, nadając na pozycji przychodu nr seryjny 1111.

Dokument sprzedaży jest wystawiany w rejestrze F /NKS ze wskazanym Identyfikatorem konfiguracji KSeF użytkownika FA (3)/1-0E/024.

Wskazana konfiguracja ma włączone uwzględnianie Nr seryjnego w dodatkowym opisie w Definicji dodatkowych opisów pozycji.

Podczas dodawania pozycji na dokumencie sprzedaży F /NKS/26/00007, pozycja sprzedaży została powiązana z konkretną dostawą, tj. pozycją dokumentu P /W /26/000002 oraz wskazany został konkretny nr seryjny dla wydawanej pozycji tj. 1111.

W efekcie, w wygenerowanym XML’u dla dokumentu F /NKS/26/000007 w węźle Fa znajduje się gałąź DodatkowyOpis zawierająca tagi:

<NrWiersza> odnoszący się do numeru pozycji, której dotyczy dodatkowy opis,
<Klucz> zawierający nazwę klucza w KSeF tj. domyślnie Nr seryjny,
<Wartosc>, do którego wpisywany jest nr seryjny wskazany podczas dodawania pozycji sprzedaży (nadany na pozycji przychodowej) w tym przypadku 1111.

Przykład 4. Zakres nr seryjnych jako dodatkowy opis.

Artykuł CC-42 z włączoną obsługą numerów seryjnych przyjęto dokumentem przychodowym P /W /26/000003 w ilości 100 szt., nadając nr seryjne od 1 do 100 (całkowita dł. nr seryjnego 4 tj. maska 0000, a więc nr seryjne od 0001 do 0100).

Dokument sprzedaży jest wystawiany w rejestrze F /NKS ze wskazanym Identyfikatorem konfiguracji KSeF użytkownika FA (3)/1-0E/024.

Wskazana konfiguracja posiada włączone uwzględnianie zakresu numerów seryjnych w dodatkowym opisie w Definicji dodatkowych opisów pozycji.

Podczas dodawania pozycji na dokumencie sprzedaży F /NKS/26/00008 w ilości 50 szt., pozycja sprzedaży została powiązana z konkretną dostawą, tj. pozycją dokumentu P /W /26/000003 oraz wskazane zostały numery seryjne dla wydawanej pozycji, tj. nr seryjne od 0051 do 0100.

W efekcie, w wygenerowanym XML’u dla dokumentu F /NKS/26/000008 w węźle Fa znajduje się gałąź DodatkowyOpis zawierająca tagi:

<NrWiersza> odnoszący się do numeru pozycji, której dotyczy dodatkowy opis,
<Klucz> zawierający nazwę klucza w KSeF tj. domyślnie Nr seryjny,
<Wartosc>, do którego wpisywany jest zakres numerów seryjnych, które zostały wskazane podczas dodawania pozycji sprzedaży (nadane w czasie przychodu) w tym przypadku 0051-0100.

Przykład 5. Opis do pozycji jako dodatkowy opis.

Pozycja dokumentu sprzedaży F /NKS/26/000009 została dodana z opisem do pozycji wprowadzonym w polu Dodatkowy opis, tj. Przykładowy dodatkowy opis do pozycji.

Dokument sprzedaży jest wystawiany w rejestrze F /NKS ze wskazanym Identyfikatorem konfiguracji KSeF użytkownika FA (3)/1-0E/024.

Wskazana konfiguracja posiada włączone uwzględnianie Opisu do pozycji w dodatkowym opisie w Definicji dodatkowych opisów pozycji.

W efekcie w wygenerowanym XML’u dla dokumentu F /NKS/26/000009 w węźle Fa znajduje się gałąź DodatkowyOpis zawierająca tagi:

<NrWiersza> odnoszący się do numeru pozycji, której dotyczy dodatkowy opis,
<Klucz> zawierający nazwę klucza w KSeF tj. domyślnie Opis do pozycji,
<Wartosc>, do którego wpisywany jest opis pozycji wprowadzony w polu Dodatkowy opis podczas dodawania pozycji sprzedaży.

Przykład 6. Nr katalogowy jako dodatkowy opis.

Podczas dodawania pozycji dokumentu F /NKS/26/000010 wskazano artykuł CC-42 z nr katalogowym CC1123.

Dokument sprzedaży jest wystawiany w rejestrze F /NKS ze wskazanym Identyfikatorem konfiguracji KSeF użytkownika FA (3)/1-0E/024.

Wskazana konfiguracja posiada włączone uwzględnianie Nr katalogowego w dodatkowym opisie w Definicji dodatkowych opisów pozycji.

W efekcie w wygenerowanym XML’u dla dokumentu F /NKS/26/000010 w węźle Fa znajduje się gałąź DodatkowyOpis zawierająca tagi:

<NrWiersza> odnoszący się do numeru pozycji, której dotyczy dodatkowy opis,
<Klucz> zawierający nazwę klucza w KSeF tj. domyślnie Nr katalogowy,
<Wartosc>, do którego wpisywany jest nr katalogowy danego artykułu określany w kartotece, w tym przypadku CC1123.

Przykład 7. Nr u kontrahenta jako dodatkowy opis.

Artykuł CC-44 ma skonfigurowany Symbol u kontrahenta K00047 tj. COM-1010.

Rejestr F /NKS ma wskazany Identyfikator konfiguracji KSeF użytkownika FA (3)/1-0E/024.

Wskazana konfiguracja posiada włączone uwzględnianie Nr u kontrahenta w dodatkowym opisie w Definicji dodatkowych opisów pozycji.

Dokument sprzedaży F /NKS/26/000011 został wystawiony na Kontrahenta K00047, z 1 szt. artykułu CC-44.

W efekcie w wygenerowanym XML’u dla dokumentu F /NKS/26/000011 w węźle Fa znajduje się gałąź DodatkowyOpis zawierająca tagi:

<NrWiersza> odnoszący się do numeru pozycji, której dotyczy dodatkowy opis,
<Klucz> zawierający nazwę klucza w KSeF tj. domyślnie Nr u kontrahenta,
<Wartosc>, do którego wpisywany jest nr u kontrahenta danego artykułu określany w kartotece artykułu, w tym przypadku COM-1010.

Przykład 8. Koszt gospodarowania odpadami (KGO) jako dodatkowy opis.

Artykuł CC-45 jest oznaczony jako Produkt zawierający KGO (Koszt gospodarowania odpadami).

Rejestr F /NKS ma wskazany Identyfikator konfiguracji KSeF użytkownika FA (3)/1-0E/024.

Wskazana konfiguracja posiada włączone uwzględnianie Kosztu gospodarowania odpadami w dodatkowym opisie w Definicji dodatkowych opisów pozycji.

Dodając pozycję z artykułem CC-45 do dokumentu sprzedaży F /NKS/26/000012, w polu W tym KGO wprowadzona została wartość 10,00 PLN.

W efekcie w wygenerowanym XML’u dla dokumentu F /NKS/26/000012 w węźle Fa znajduje się gałąź DodatkowyOpis zawierająca tagi:

<NrWiersza> odnoszący się do numeru pozycji, której dotyczy dodatkowy opis,
<Klucz> zawierający nazwę klucza w KSeF tj. domyślnie W tym koszt gospodarowania odpadami (KGO),
<Wartosc>, do którego trafia wartość z pola W tym KGO pozycji sprzedaży, w tym przypadku 10,00 PLN.

Przykład 9. Opłata cukrowa jako dodatkowy opis.

Artykuł CC-46 posiada skonfigurowaną Opłatę od środków spożywczych (cukrową), wynoszącą 0,75 PLN za 1 SZT.

Rejestr F /NKS ma wskazany w Definicji rejestru Identyfikator konfiguracji KSeF użytkownika FA (3)/1-0E/024.

Wskazana konfiguracja KSeF posiada włączone uwzględnianie Opłaty cukrowej w dodatkowym opisie w Definicji dodatkowych opisów pozycji.

Na dokumencie F /NKS/26/000013 dodano pozycję z 10 SZT. artykułu CC-46.

W efekcie w wygenerowanym XML’u dla dokumentu F /NKS/26/000013 w węźle Fa znajduje się gałąź DodatkowyOpis zawierająca tagi:

<NrWiersza> odnoszący się do numeru pozycji, której dotyczy dodatkowy opis,
<Klucz> zawierający nazwę klucza w KSeF tj. domyślnie W tym: opłata od środków spożywczych (cukrowa) netto w PLN,
<Wartosc>, do którego trafia wartość z pola Opłata od środków spożywczych (cukrowa) kartoteki artykułu, pomnożona przez ilość pozycji sprzedaży, w tym przypadku 0,75 PLN x 10 SZT = 7,50 PLN.

Przykład 10. Opłata alkoholowa jako dodatkowy opis.

Artykuł o symbolu CC-47 posiada skonfigurowaną opłatę alkoholową wynoszącą 3,5829 PLN za 1 SZT.

Rejestr F /NKS ma wskazany w Definicji rejestru Identyfikator konfiguracji KSeF użytkownika FA (3)/1-0E/024.

Wskazana konfiguracja KSeF posiada włączone uwzględnianie Opłaty alkoholowej w dodatkowym opisie w Definicji dodatkowych opisów pozycji.

Na dokumencie F /NKS/26/000014 dodano pozycję z 10 SZT. artykułu CC-47.

W efekcie, w wygenerowanym XML’u dla dokumentu F /NKS/26/000014 w węźle Fa znajduje się gałąź DodatkowyOpis zawierająca tagi:

<NrWiersza> odnoszący się do numeru pozycji, której dotyczy dodatkowy opis,
<Klucz> zawierający nazwę klucza w KSeF tj. domyślnie W tym: opłata od alkoholi o pojemności poniżej 300ml netto w PLN,
<Wartosc>, do którego trafia wartość z pola Opłata za jednostkę magazynową (zakładka Opł. alk. kartoteki artykułu), pomnożona przez ilość pozycji sprzedaży, w tym przypadku 3,5829 PLN x 10 SZT = 35,83 PLN

3. Nowy model obsługi cech nagłówka i pozycji w schematach KSeF

Tak jak już wspominaliśmy w punkcie Rozbudowa konfiguracji KSeF o fabryczne definicje opisów dodatkowych nagłówka i pozycji, nowa wersja systemu wprowadza zmiany w wyglądzie oraz funkcjonalności opcji Definicji dodatkowych opisów w konfiguratorze schematów KSeF. W poprzedniej wersji okno konfiguracji zawierało pola typu checkbox z dodatkowymi opcjami. Obecnie zostało ono zastąpione listą pozycji, która została rozbudowana o nowe elementy.

Wprowadzone zmiany znacząco upraszczają przenoszenie danych z dokumentu do pliku XML, w szczególności cech dokumentu, zarówno na poziomie pozycji, jak i nagłówka dokumentu.

Dodatkowy opis pozycji – cechy.

Aby uwzględnić cechy w dodatkowych opisach, należy w konfiguracji dodatkowych opisów odnaleźć pozycję Cechy, wejść w jej edycję i zaznaczyć opcję Uwzględnij w dodatkowym opisie.

Po zatwierdzeniu zmian, pozycja ta zostanie oznaczona na liście dodatkowych opisów w kolumnie Uwzględnij, co oznacza jej udział w schemacie.

Dodatkowo, aby dana cecha została przeniesiona z dokumentu do pliku XML, konieczne jest zaznaczenie przy niej opcji Występuje w KSeF. Tylko cechy oznaczone w ten sposób zostaną uwzględnione podczas generowania pliku XML.

Po dodaniu dokumentu zawierającego pozycje z przypisaną cechą, wygenerowany plik XML w sekcji <DodatkowyOpis> zawiera tag <Klucz>, którego wartością jest nazwa cechy, oraz tag <Wartość>, który zawiera wartość cechy.

Po wyświetleniu faktury w formacie PDF informacje z cech są prezentowane w polu Dodatkowy opis i obejmują:

numer wiersza – numer wiersza pozycji dokumentu, do którego jest przypisana cecha,
rodzaj informacji – nazwę cechy,
treść informacji – wartość wpisaną w cechę.

Dodatkowy opis nagłówka – cechy.

Aby uwzględnić cechy w dodatkowych opisach nagłówka, należy w konfiguracji dodatkowych opisów odnaleźć pozycję Cechy, wejść w jej edycję i zaznaczyć opcję Uwzględnij w dodatkowym opisie.

Po zatwierdzeniu zmian pozycja ta zostanie oznaczona na liście dodatkowych opisów w kolumnie Uwzględnij, co oznacza jej udział w schemacie.

Po wyświetleniu faktury w formacie PDF informacje z cech są prezentowane w polu Dodatkowy opis i obejmują:

numer wiersza – pusta wartość oznacza, że cecha przypisana jest do nagłówka dokumentu,
rodzaj informacji – nazwę cechy,
treść informacji – wartość wpisaną w cechę.

Opis zmian HSQL

1. Rozszerzenie mechanizmu eksportu/importu schematów KSeF o opisy dodatkowe

2. Rozbudowa konfiguracji KSeF o fabryczne definicje opisów dodatkowych nagłówka i pozycji

3. Nowy model obsługi cech nagłówka i pozycji w schematach KSeF