ATW-VAT-CATEGORY-UNSUPPORTED — E-Invoice Validation Rule & Fix

Fixture ID: splitPaymentCategory · XPath: /ubl:Invoice/cac:InvoiceLine[1]/cac:Item/cac:ClassifiedTaxCategory/cbc:ID

1. Why This Rule Triggers (Diagnostic Message)

Line 1 uses VAT category "B" (split payment), which this build does not support. "B" is a valid EN 16931 code — BR-CL-17 and BR-CL-18 both admit it — but it is the one category of the ten with no rule family of its own beyond BR-B-01 and BR-B-02, and both of those exist only to confine it: BR-B-01 restricts it to domestic Italian invoices, and BR-B-02 forbids it from sharing a document with any other category. Split payment ("scissione dei pagamenti") means the Italian public-sector buyer pays the net amount to you and the VAT directly to the Agenzia delle Entrate, so the invoice states VAT that you will never receive. Getting that wrong is not a formatting error, it is a payment that goes to the wrong party.

2. How to Fix ATW-VAT-CATEGORY-UNSUPPORTED

Use category "S" and handle the split-payment mechanics outside this library, or produce the document with a tool that implements the Italian FatturaPA rules. If the supply is not Italian public-sector, "B" is the wrong code regardless.

3. Valid Code / Payload Example

"vatCategory": "S", "vatRate": 22