When to use S
Use S whenever you charge VAT on the invoice. Typical cases:
- A German agency invoices a German client for design work at 19%.
- A French bakery chain invoices a hotel for bread at the reduced 5.5% rate.
- An online shop sells to a consumer in another EU country and charges that country's VAT under the One-Stop-Shop scheme.
When not to use S
If no VAT is charged, S is the wrong code. A supply at 0% is Z, an exempt supply is E, and a supply where the buyer pays the VAT is AE or K.
The rate rule
Every line, document allowance and document charge in category S needs a rate above zero (BR-S-05, BR-S-06, BR-S-07). The tax amount of each S breakdown is its taxable amount times the rate (BR-S-09). Unlike the other categories, S allows several breakdown groups: one for each rate on the invoice.
Required fields
The seller must be identified for VAT: a seller VAT ID (BT-31) or a tax registration ID (BT-32) is required as soon as one line, allowance or charge is in category S (BR-S-02 to BR-S-04). The breakdown must not carry an exemption reason (BR-S-10).
Request example: two rates on one invoice
A German office supplier sells a desk at 19% and books at the reduced 7% rate. Send the category and rate per line. The API builds two S breakdown groups, one per rate:
"seller": { "vatIdentifier": "DE123456789", ... },
"lines": [
{
"item": { "name": "Standing desk" },
"quantity": 1,
"priceDetails": { "netPrice": 640.00 },
"vatInformation": { "categoryCode": "S", "rate": 19 }
},
{
"item": { "name": "Accounting handbook" },
"quantity": 2,
"priceDetails": { "netPrice": 45.00 },
"vatInformation": { "categoryCode": "S", "rate": 7 }
}
]
A document level discount or shipping charge carries its own vatCategoryCode and vatRate. When it applies to goods at both rates, split it into one entry per rate.
Business rules S triggers
- BR-S-01: the invoice has at least one VAT breakdown group with category S.
- BR-S-02 to BR-S-04: seller VAT ID or tax registration ID.
- BR-S-05 to BR-S-07: rate above zero on lines, allowances and charges.
- BR-S-08: each S group's taxable amount equals the lines, allowances and charges at that rate.
- BR-S-09 and BR-CO-17: tax amount equals taxable amount times rate.
- BR-S-10: no exemption reason.
Common mistakes
- A shipping charge at the wrong rate. Freight on an invoice with mixed goods is booked at 19% while the goods are at 7%. The S group for 7% then misses the charge and BR-S-08 fails. Give each charge the rate of the goods it belongs to.
- S with rate 0 for a tax-free sale. An export or an intra-community delivery is sent as S at 0%, which fails BR-S-05. Use G or K instead.
- A note like "VAT included" as exemption reason. Any reason text on an S breakdown fails BR-S-10. Put such notes in the invoice note (BT-22).
- Hand-made breakdowns that do not add up. VAT is computed per breakdown group, not summed from rounded line amounts. Let the API build the breakdown so BR-CO-14 and BR-CO-15 hold.
Other VAT category codes
- VAT category code Z (Zero rated): Supplies your country taxes at a rate of 0%, with the right to deduct input VAT.
- VAT category code E (Exempt from VAT): Supplies the law exempts from VAT: medical, education, insurance, finance, small-business schemes.
- VAT category code AE (Reverse charge): The buyer owes the VAT: B2B services to another EU country and domestic reverse charge.
- VAT category code K (Intra-community supply): Goods shipped to a VAT-registered business in another EU member state.
- VAT category code G (Export outside the EU): Goods exported to a customer outside the European Union.
- VAT category code O (Not subject to VAT): Transactions outside the scope of VAT, issued without any VAT ID on the invoice.
- All VAT category codes, compared in one table