Przejdź do głównej zawartości

Reguły wyboru profilu (KSeF → SAP)

Reguły KSeF→SAP (menu Ustawienia → Reguły KSeF→SAP) to router faktur kosztowych. Decydują, który profil mapowania zastosować dla danej faktury z KSeF, na podstawie faktów z nagłówka faktury (NIP wystawcy, waluta, kwota brutto itd.).

Reguły są oceniane w kolejności priorytetu (najniższy numer pierwszy). Wygrywa pierwsza reguła, której wszystkie warunki są spełnione. Gdy żadna reguła nie pasuje, używany jest aktywny profil domyślny danego typu, a faktura trafia na listę Nieskorelowane KSeF.

Reguły są podzielone na dwie niezależne pule (zakładki):

  • Faktury zakupu (OPCH) — dla zwykłych faktur kosztowych.
  • Korekty zakupu (OCPI) — dla korekt.
KolumnaZawartość
(uchwyt)Przeciągnij, aby zmienić priorytet
PriorytetKolejność oceny (priorytety przeliczają się co 10)
WarunkiPodsumowanie warunków (łączone operatorem AND) lub „(wszystkie)“
AkcjaUseProfile (użyj profilu) lub Skip (pomiń)
Profil docelowyProfil użyty przy akcji UseProfile

Kolejność zmieniasz przeciąganiem za uchwyt. Pasek nad tabelą pozwala importować/eksportować reguły puli jako JSON.

W oknie reguły ustawiasz:

  • Priorytet — liczba; niższa = wcześniej oceniana.
  • AkcjaUseProfile lub Skip.
  • Profil — profil docelowy (tylko aktywne profile; pole nieaktywne przy akcji Skip).
  • Opis — opcjonalny opis (np. „faktury kosztowe od ORLEN”).
  • Warunki — lista warunków łączonych AND. Brak warunków = reguła pasuje do każdej faktury.

Warunki odwołują się do faktów z nagłówka faktury KSeF: IssuerNip (NIP wystawcy), BuyerNip (NIP nabywcy), Currency (waluta), TotalGross (kwota brutto), InvoiceType (typ faktury), SubjectType (podmiot).

Dostępne operatory: eq (równe), ne (różne), gt / lt / gte / lte (porównania liczbowe), contains (zawiera), in (jest w zbiorze), is_null, is_not_null.

W karcie Test reguł wklejasz fakty nagłówka w formacie JSON (np. {"IssuerNip":"...","Currency":"PLN","TotalGross":0}) i uruchamiasz test. Wynik pokazuje dopasowany profil (badge MATCH) albo brak dopasowania (SKIP → fallback do aktywnego profilu OPCH).