Reguły przypisania profili

Gdy system przetwarza dokument z SAP, musi zdecydować który profil mapowania zastosować. Reguły przypisania (Resolution Rules) automatyzują ten wybór.

Problem

Różne typy dokumentów SAP wymagają różnych profili:

• OINV (faktura sprzedaży) — profil standardowy FA(3)
• OINV korekta (Credit Memo powiązane z OINV) — profil korekty
• ODPI (faktura zaliczkowa) — profil z obsługą zaliczek
• Faktura walutowa — profil z polami FC (Foreign Currency)

Jak działają reguły

Reguły są oceniane po priorytecie (od najniższego numeru — najwyższy priorytet). Pierwsza reguła, której warunki są spełnione, określa profil.

Każda reguła składa się z:

Element	Opis	Przykład
Priorytet	Kolejność oceny (niższy = ważniejszy)	10, 20, 30
Warunek	Pole + operator + wartość	DocType eq "OINV"
Akcja	Co zrobić	UseProfile("OINV_FA3_FULL")

Operatory warunków

Operator	Opis	Przykład
eq	Równe	DocType eq "OINV"
neq	Różne	DocCurrency neq "PLN"
contains	Zawiera tekst	CardName contains "Sp. z o.o."
starts_with	Zaczyna się od	DocNum starts_with "FV/"
ends_with	Kończy się na	DocNum ends_with "/2026"
in	Jest w zbiorze (wartości oddzielone przecinkami)	DocType in "OINV,OCSI,ODPI"
not_in	Nie jest w zbiorze	DocType not_in "ORDR,OQUT"
like	Wzorzec (z % jako wildcard)	CardCode like "C%"
is_null	Jest puste	FederalTaxID is_null
is_not_null	Nie jest puste	FederalTaxID is_not_null

Akcje

Akcja	Opis
UseProfile	Użyj wskazanego profilu
Skip	Pomiń ten dokument (nie wysyłaj do KSeF)

Przykładowa konfiguracja

Typowe reguły dla klienta:

Priorytet	Warunek	Akcja	Opis
10	DocType eq "ODPI"	UseProfile("ODPI_FA3_ADVANCE")	Faktury zaliczkowe
20	DocType eq "OINV" AND CANCELED eq "Y"	Skip	Anulowane — nie wysyłaj
30	DocType eq "OINV" AND DocCurrency neq "PLN"	UseProfile("OINV_FA3_FC")	Faktury walutowe
40	DocType eq "OINV"	UseProfile("OINV_FA3_FULL")	Standardowe faktury PLN
100	(brak warunku)	Skip	Catch-all — nieznane typy

Jak to działa w praktyce

Faktura OINV w PLN:

1. Priorytet 10: DocType eq "ODPI"? Nie — dalej
2. Priorytet 20: CANCELED eq "Y"? Nie — dalej
3. Priorytet 30: DocCurrency neq "PLN"? Nie (jest PLN) — dalej
4. Priorytet 40: DocType eq "OINV"? Tak — UseProfile("OINV_FA3_FULL")

Faktura OINV w EUR:

1. Priorytet 10: Nie
2. Priorytet 20: Nie
3. Priorytet 30: DocCurrency neq "PLN"? Tak (EUR) — UseProfile("OINV_FA3_FC")

Brak dopasowania = brak wysyłki

Ważne — brak zachowania domyślnego

Jeśli dokument nie pasuje do żadnej reguły (ani UseProfile, ani Skip), system nie wysyła go do KSeF. Jest to traktowane jako podejrzenie błędu konfiguracji.

W takiej sytuacji:

• Dokument jest zapisywany jako niedopasowany (widoczny na dashboardzie)
• Jeśli skonfigurowany jest Webhook URL — system wysyła powiadomienie (szczegóły)

Każdy typ dokumentu musi mieć jawnie zdefiniowaną regułę. Jeśli pewne dokumenty nie powinny trafiać do KSeF (np. paragony), utwórz regułę z akcją Skip:

Priorytet: 5
Warunek: Series starts_with "PAR/"
Akcja: Skip

Dla dokumentów, które powinny być wysyłane domyślnym profilem, możesz dodać regułę catch-all na końcu (najwyższy priorytet numeryczny):

Priorytet: 100
Warunek: (brak)
Akcja: UseProfile → profil domyślny

Jednak nie jest to obowiązkowe — świadome decydowanie o każdym typie dokumentu jest bezpieczniejsze niż catch-all, który może przypadkowo wysłać do KSeF coś czego nie powinien.

Konfiguracja w dashboardzie

Przejdź do Ustawienia — Router dokumentów i:

1. Kliknij Dodaj regułę
2. Ustaw priorytet, warunek i akcję
3. Zapisz
4. Kolejność reguł można zmieniać drag-and-drop — przeciągnij regułę w górę lub w dół, aby zmienić priorytet

Import i eksport reguł

Reguły można eksportować i importować jako JSON:

• Eksport: menu — Eksportuj JSON — przydatne do backupu lub kopiowania konfiguracji między firmami
• Import: menu — Importuj JSON — wczytuje zestaw reguł z pliku

Panel testowy

Dashboard umożliwia symulację dopasowania reguł:

1. Kliknij Testuj reguły (lub ikonę w nagłówku tabeli reguł)
2. Wprowadź dane dokumentu (typ, walutę, inne pola)
3. System wyświetli, która reguła zostałaby dopasowana i jaki profil wybrany

Testowanie reguł

Przed włączeniem AutoSend przetestuj reguły na kilku dokumentach różnego typu. Upewnij się, że faktury walutowe, zaliczkowe i korekty trafiają do właściwych profili.

Reguły per firma

Reguły są przypisane do firmy (SapConfig). Różne firmy mogą mieć różne zestawy reguł, np. firma A nie wystawia faktur walutowych i nie potrzebuje reguły dla DocCurrency neq "PLN".