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.
Dwie pule reguł
Dział zatytułowany „Dwie pule reguł”Reguły są podzielone na dwie niezależne pule (zakładki):
- Faktury zakupu (OPCH) — dla zwykłych faktur kosztowych.
- Korekty zakupu (OCPI) — dla korekt.
Tabela reguł
Dział zatytułowany „Tabela reguł”| Kolumna | Zawartość |
|---|---|
| (uchwyt) | Przeciągnij, aby zmienić priorytet |
| Priorytet | Kolejność oceny (priorytety przeliczają się co 10) |
| Warunki | Podsumowanie warunków (łączone operatorem AND) lub „(wszystkie)“ |
| Akcja | UseProfile (użyj profilu) lub Skip (pomiń) |
| Profil docelowy | Profil użyty przy akcji UseProfile |
Kolejność zmieniasz przeciąganiem za uchwyt. Pasek nad tabelą pozwala importować/eksportować reguły puli jako JSON.
Edytor reguły
Dział zatytułowany „Edytor reguły”W oknie reguły ustawiasz:
- Priorytet — liczba; niższa = wcześniej oceniana.
- Akcja —
UseProfilelubSkip. - 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.
Pola i operatory warunków
Dział zatytułowany „Pola i operatory warunków”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.
Panel testowy
Dział zatytułowany „Panel testowy”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).