Profile mapowania KSeF → SAP

Profile mapowania KSeF → SAP (menu Ustawienia → Profile KSeF→SAP) opisują, jak dane z faktury FA(3) przekształcić w szkic dokumentu SAP (OPCH lub OCPI). Jest to mapowanie odwrotne względem profili wysyłkowych — tam SAP → KSeF, tu KSeF → SAP.

Profili może być wiele i wiele może być aktywnych jednocześnie. To, który profil zastosować dla danej faktury, decyduje router (reguły KSeF→SAP). Gdy żadna reguła nie pasuje, używany jest profil oznaczony jako domyślny, a faktura bez dopasowania trafia na listę Nieskorelowane KSeF + wysyłany jest webhook.

Lista profili

Kolumna	Zawartość
Nazwa	Nazwa profilu + badge typu (OPCH/OCPI). Badge „Preview failed”, gdy ostatni test nie przeszedł.
Sekcje / pola	Liczba sekcji danych / liczba zmapowanych pól
Wersja	Numer wersji (rośnie przy każdym zapisie)
Status	Aktywny / Nieaktywny + badge „Domyślny”

Akcje w wierszu: edycja, duplikuj, eksportuj JSON, aktywuj (gdy profil przeszedł test), ustaw jako domyślny, usuń. Pasek nad listą pozwala importować/eksportować profile jako JSON.

Tworzenie profilu

Przycisk Nowy profil otwiera okno, w którym podajesz nazwę i wybierasz docelowy dokument:

OPCH (Faktura zakupu) — dla faktur VAT / UPR.
OCPI (Korekta zakupu) — dla korekt KOR.

Nowy profil powstaje jako nieaktywny. Aktywować można go dopiero po udanym teście (walidacja). Typu dokumentu nie da się później zmienić.

Edytor profilu

Edytor ma zakładki:

Sekcje

Tu budujesz mapowanie. Profil składa się z sekcji danych, a każda sekcja z mapowań pól.

Każda sekcja ma:

Alias — krótka nazwa (np. header, lines).
Kotwica XPath (FA3) — punkt zaczepienia w FA(3) (np. Faktura/Fa lub Faktura/Fa/FaWiersz).
Tryb sekcji — Pojedyncza (mapuje pola nagłówka) lub Tablica (powtarzalna) (mapuje kolekcję pozycji; wskazujesz wtedy klucz kolekcji SAP, np. DocumentLines).

Każde mapowanie pola to: źródło FA(3) (XPath) → pole docelowe SAP + opcjonalne transformacje (łączone znakiem |, np. VATMAP | TO_DATE). Ikona różdżki otwiera edytor transformacji z katalogiem funkcji i podglądem na żywo na próbce FA(3). Lista funkcji: Transformacje pól.

VAT

Wspólna tabela mapowania VAT (na poziomie firmy/SapConfig) — kategoria VAT z KSeF → kod VAT SAP. Ta sama tabela obowiązuje dla wysyłki i odbioru. Szczegóły: Mapowanie VAT.

Extras

Konfiguracja danych dodatkowych i podpowiedzi (dane podmiotu trzeciego, podpowiedzi projektu/magazynu) pokazywanych w panelu KSeF w edytorze faktury.

Booking

Domyślne wartości nagłówka stosowane przy tworzeniu szkicu przez ten profil (np. wzór daty dokumentu, seria).

Test

Tu wklejasz przykładowy XML FA(3) i:

Tylko preview — pokazuje zmapowany wynik (nagłówek + przykładowe pozycje, liczby dopasowań, nieuzupełnione pola).
Waliduj profil — pełna walidacja (poprawność pól wobec schematu SAP). Po udanej walidacji profil można aktywować.

Ustawienia

Nazwa profilu, docelowy dokument (tylko do odczytu), przełącznik Aktywny (zablokowany, dopóki profil nie przejdzie testu) oraz strefa zagrożenia: Ustaw jako aktywny, Ustaw jako domyślny (auto-aktywuje), Usuń profil.