🗂️ 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
- 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 oraz Indeks.
- Wielokrokowe ścieżki mapowania – nawigacja przez powiązane tabele, aby dotrzeć do konkretnego pola.
- Filtrowanie rekordów źródłowych – ograniczenie mapowania do dokumentów spełniających określone kryteria.
- Obsługa zarówno faktur, jak i faktur korygujących (korekt).
- Wbudowana walidacja i diagnostyka konfiguracji.
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 |
| 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 |
Jak to działa
Ogólny przepływ pracy
- Na stronie N24KH Lista mapowań pól KSeF tworzysz nowe mapowanie, 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
- Etykieta wyjściowa musi być unikalna w ramach danej sekcji KSeF.
- Dla sekcji Indeks mapowanie działa na poziomie wierszy faktury.
- Dla sekcji DataZamowienia i NrZamowienia mapowanie działa na poziomie nagłówka.
- Wyłączenie mapowania (pole Włączone = fałsz) powoduje, że nie jest ono brane pod uwagę podczas generowania XML.
Szczegółowy opis pól i stron konfiguracyjnych znajdziesz w sekcji Ustawienia.