🗂️ Mapowanie pól KSeF
Moduł Mapowanie pól KSeF umożliwia definiowanie własnych reguł mapowania pól z dokumentów Business Central do odpowiednich sekcji XML faktury KSeF. Dzięki temu możesz elastycznie kontrolować, jakie dane trafiają do faktur elektronicznych, bez konieczności modyfikacji kodu.
Najważniejsze możliwości
- Copilot — tworzenie mapowań za pomocą opisów w języku naturalnym z wykorzystaniem AI (więcej).
- Mapowanie pól z nagłówków i wierszy zaksięgowanych faktur sprzedaży oraz faktur serwisowych.
- Obsługa wielu sekcji KSeF: DodatkowyOpis, DataZamowienia, NrZamowienia, Indeks, NazwaTowaruLubUslugi, GTIN, CN oraz Numer partii towaru.
- Pobieranie informacji z powiązanych danych – np. nazwy spedytora, numeru zamówienia czy oznaczenia zapasów
- Jawne wyczyszczenie wartości pola w strukturze KSeF – np. usunięcie automatycznie generowanego indeksu lub kodu CN
- Predefiniowane wartości – np. automatyczne dodanie numerów seryjnych z śledzenia jako DodatkowyOpis lub eksport wybranych wymiarów jako DodatkowyOpis
- Filtrowanie danych źródłowych – ograniczenie mapowania do dokumentów spełniających określone kryteria.
- Automatyczne filtrowanie po języku dokumentu – gdy tabela powiązana zawiera pole „Kod języka" lub pole z relacją do tabeli Język, system automatycznie filtruje rekordy według języka dokumentu źródłowego.
- Priorytet mapowania – kontrola kolejności stosowania mapowań: gdy wiele konfiguracji dotyczy tej samej etykiety wyjściowej, stosowane jest mapowanie z wyższym priorytetem pasujące do danego rekordu (nagłówka lub wiersza). Niższy priorytet jest pomijany dla rekordów, dla których wyższy priorytet już pasował do filtra.
- Obsługa zarówno faktur, jak i faktur korygujących (korekt).
- Automatyczne sprawdzanie poprawności ustawień – system podpowie, jeśli coś jest skonfigurowane nieprawidłowo.
Obsługiwane obszary dokumentów
| Obszar dokumentu | Poziom zastosowania |
|---|---|
| Sprzedaż | Nagłówek, Wiersz |
| Serwis | Nagłówek, Wiersz |
Obsługiwane sekcje KSeF
| Sekcja | Opis |
|---|---|
| DodatkowyOpis | Dodatkowe opisy na fakturze – mapowane na poziomie nagłówka lub wierszy |
| DataZamowienia | Data zamówienia powiązanego z fakturą |
| NrZamowienia | Numer zamówienia powiązanego z fakturą |
| Indeks | Indeks (kod wewnętrzny) przypisywany do wierszy faktury |
| NazwaTowaruLubUslugi | Nazwa towaru lub usługi przypisywana do wierszy faktury |
| GTIN | Kod GTIN przypisywany do wierszy faktury |
| CN | Kod CN (Nomenklatura Scalona) przypisywany do wierszy faktury |
| Numer partii towaru | Numer partii towaru – umożliwia wyczyszczenie automatycznie generowanej wartości |
Jak to działa
Ogólny przepływ pracy
- Na stronie KSeF Helper - Mapowanie pól KSeF tworzysz nowe mapowanie ręcznie lub za pomocą Copilot, wybierając sekcję KSeF, obszar dokumentu i poziom zastosowania.
- Definiujesz kroki mapowania – wskazujesz, z którego pola (i ewentualnie z jakiej powiązanej tabeli) ma być pobrana wartość.
- Opcjonalnie konfigurujesz filtr rekordów, aby mapowanie działało tylko dla wybranych dokumentów.
- Włączasz mapowanie – od tego momentu system automatycznie uzupełnia dane w fakturach KSeF.
Wielokrokowe mapowanie
Każde mapowanie może składać się z jednego lub wielu kroków nawigacji:
- Krok 1 – wskazuje pole w tabeli źródłowej (np. zaksięgowany nagłówek faktury sprzedaży).
- Krok 2 i kolejne – nawigują do tabel powiązanych przez pole relacji.
Przykład: aby pobrać nazwę spedytora z faktury sprzedaży, krok 1 wskazuje pole Kod spedytora w nagłówku faktury, a krok 2 nawiguje do tabeli Spedytor i odczytuje pole Nazwa.
Wskazówki
- Dla sekcji DataZamowienia, NrZamowienia, Indeks, NazwaTowaruLubUslugi, GTIN, CN i Numer partii towaru poziom zastosowania jest ustawiany automatycznie i nie można go modyfikować.
- Dla sekcji NazwaTowaruLubUslugi dostępne jest dodatkowe pole Separator pola, pozwalające na łączenie wartości z wielu mapowań w jedną nazwę.
- Wyłączenie mapowania (pole Włączone = fałsz) powoduje, że nie jest ono brane pod uwagę podczas generowania XML.
- Priorytet: mapowania są przetwarzane w kolejności malejącej według priorytetu. Gdy mapowanie pasuje do rekordu (filtr zwróci wynik), kolejne mapowania z niższym priorytetem dla tej samej etykiety wyjściowej są pomijane dla tego rekordu. Mapowania o równym priorytecie są uruchamiane wszystkie. Domyślna wartość priorytetu to 0.
Szczegółowy opis pól i stron konfiguracyjnych znajdziesz w sekcji Ustawienia.