Mapowanie VAT

SAP Business One i KSeF używają różnych systemów klasyfikacji stawek VAT. BizFlow NH zapewnia tabelę mapowania, która tłumaczy kody VAT z SAP na kategorie wymagane przez schemat FA(3).

Gdzie skonfigurować

Mapowanie VAT jest zakładką wewnątrz edytora profilu mapowania. Aby skonfigurować:

Przejdź do Ustawienia — Profile mapowania
Otwórz profil (lub utwórz nowy)
Przejdź do zakładki VAT
Dodaj mapowania kodów SAP na kategorie KSeF

Kody VAT w SAP vs KSeF

SAP Business One

SAP używa kodów VAT (Tax Codes) definiowanych przez administratora. Każda firma może mieć inne kody:

Kod SAP	Stawka	Opis (przykład)
`Dzw`	23%	Dostawa towarów i usług, stawka podstawowa
`E23`	23%	Eksport z VAT 23%
`F23`	23%	Faktura 23%
`E8`	8%	Stawka obniżona 8%
`E5`	5%	Stawka obniżona 5%
`EZw`	0%	Zwolniony z VAT
`Exp`	0%	Eksport (0%)
`ENp`	—	Nie podlega VAT

KSeF (FA wersja 3)

KSeF wymaga jednolitych kategorii w polach P_12 (stawka na pozycji) i sekcjach podsumowania:

Kategoria KSeF	Znaczenie	Sekcja XML
`23`	VAT 23%	`P_13_1` (netto), `P_14_1` (VAT)
`22`	VAT 22%	`P_13_2`, `P_14_2`
`8`	VAT 8%	`P_13_3`, `P_14_3`
`7`	VAT 7%	`P_13_4`, `P_14_4`
`5`	VAT 5%	`P_13_5`, `P_14_5`
`0`	VAT 0%	`P_13_6_1`
`zw`	Zwolniony	`P_13_7`
`oo`	Odwrotne obciążenie	`P_13_8`
`np`	Nie podlega	`P_13_9`
`np_kp`	Nie podlega (kraj pochodzenia)	`P_13_10`
`inna`	Inna stawka	`P_13_11`

Tabela mapowania

Pole	Opis
Kod SAP	Kod VAT z SAP B1 (np. `Dzw`)
Kategoria KSeF	Docelowa kategoria (np. `23`)
Opis	Opis dla konsultanta (np. “Dostawa towarów 23%“)

Przykładowa tabela

Kod SAP	—	Kategoria KSeF
`Dzw`	—	`23`
`E23`	—	`23`
`F23`	—	`23`
`E8`	—	`8`
`E5`	—	`5`
`EZw`	—	`zw`
`E0`	—	`0`
`Exp`	—	`0`
`ENp`	—	`np`
`EOo`	—	`oo`

Transformacja VATMAP

W profilach mapowania transformacja VATMAP automatycznie korzysta z tabeli:

VatGroup|VATMAP

System pobiera VatGroup z SAP (np. Dzw), szuka go w tabeli mapowania i zwraca kategorię KSeF (np. 23).

Co się dzieje, gdy kod nie jest zmapowany?

Jeśli system napotka kod VAT, którego nie ma w tabeli mapowania:

Generowanie XML kończy się błędem
W logu pojawia się komunikat: VAT code 'XYZ' not found in mapping table
Faktura nie zostanie wysłana

Mapowanie per firma

Tabela mapowania jest per SapConfig (per firma). Każda firma może mieć inne kody VAT, więc tabele mogą się różnić.

Przy tworzeniu nowej firmy w BizFlow NH tabela mapowania jest pusta — trzeba ją wypełnić ręcznie lub zaimportować z istniejącej konfiguracji.

VAT a sekcje podsumowania XML

Kategoria KSeF determinuje, do których pól XML trafiają kwoty podsumowania:

Faktura z pozycjami 23% i 8% będzie miała wypełnione sekcje P_13_1/P_14_1 (23%) oraz P_13_3/P_14_3 (8%)
Faktura ze zwolnieniem będzie miała P_13_7
Faktury eksportowe: P_13_6_1 (0%) lub P_13_9 (np — nie podlega)

Transformacje VATFILTER i SUM w profilu automatycznie grupują dane po kategoriach KSeF i wyliczają sumy.