# BT-117 VAT Category Tax Amount

The VAT amount for a specific VAT category. Calculated as BT-116 (VAT category taxable amount) multiplied by BT-119 (VAT category rate) divided by 100. Critical for VAT compliance, automated processing, and tax reporting across EU member states.

## Quick answer

> **Taxes and totals**: VAT treatment, tax breakdowns, and document totals that validators check closely.

- [Validate XML](/en/xrechnung-validator?source=resource&bt=BT-117)
- [Convert invoice](/en/pdf-to-xrechnung?source=resource&bt=BT-117)

## In plain language

Records the VAT amount for one category and rate. It supports calculation checks and VAT return preparation. The sum of all BT-117 values equals BT-110.

## What you usually enter here

Decimal number with up to 2 decimal places, non-negative

Typical valid values include: 190.00, 0.00, 175.50, 999.99

Mandatory when VAT breakdown is provided according to EN 16931-1. Must be mathematically consistent with BT-116 and BT-119 values.

## Where the field sits

BT-117 belongs to the Totals and tax part of the invoice. UBL 2.1 Syntax: Invoice › cac:TaxTotal › cac:TaxSubtotal › cbc:TaxAmount. CII (UN/CEFACT) Syntax: rsm:CrossIndustryInvoice › rsm:SupplyChainTradeTransaction › ram:ApplicableHeaderTradeSettlement › ram:ApplicableTradeTax › ram:CalculatedAmount.

## What goes wrong often

Avoid values like: -19.00, 19,00, 19.999, EUR 19.00

Relevant rule codes: BR-46, BR-DEC-20, BR-CO-17, BR-S-09, BR-Z-09, BR-E-09, BR-AE-09, BR-G-09, BR-IC-09, BR-O-09

## Valid Examples

- 190.00
- 0.00
- 175.50
- 999.99

## Invalid Examples

- -19.00
- 19,00
- 19.999
- EUR 19.00

## Related Fields

- [BT-116 VAT Category Taxable Amount](/resources/xrechnung/bt-116-vat-category-taxable-amount)
- [BT-118 VAT Category Code](/resources/xrechnung/bt-118-vat-category-code)
- [BT-119 VAT Category Rate](/resources/xrechnung/bt-119-vat-category-rate)
- [BT-110 Invoice Total VAT Amount](/resources/xrechnung/bt-110-invoice-total-vat-amount)

## XML mapping and field facts

Open the technical reference if you need XML paths, validator rule codes, legal wording, or schema-specific mapping details.

### Field ID:
BT-117

### Data Type:
amount

### Cardinality:
1..1

### Requirement:
Mandatory

### Since Version:
XRechnung 1.0+, once a VAT breakdown is present

## XML Implementation

### UBL 2.1 Syntax
```
/Invoice/cac:TaxTotal/cac:TaxSubtotal/cbc:TaxAmount
```

### CII (UN/CEFACT) Syntax
```
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax/ram:CalculatedAmount
```

## Validation Rules

### BR-46
BR-46

### BR-DEC-20
BR-DEC-20

### BR-CO-17
BR-CO-17

### BR-S-09
BR-S-09

### BR-Z-09
BR-Z-09

### BR-E-09
BR-E-09

### BR-AE-09
BR-AE-09

### BR-G-09
BR-G-09

### BR-IC-09
BR-IC-09

### BR-O-09
BR-O-09

## Check whether your XRechnung sets BT-117 correctly

Upload the XML file to the free validator. It applies the KoSIT rules for XRechnung 3.0 and names each finding with its rule ID, for this field for example BR-46, BR-DEC-20. Creating a new invoice instead? The converter checks the invoice against the same rules and shows the findings before download.

- [Validate XML](/en/xrechnung-validator)
- [Convert invoice](/en/pdf-to-xrechnung)

Free, no account needed. XML file up to 2 MB.

## Official sources and tools

- [KoSIT Validator](https://erechnungsvalidator.service-bw.de/)
- [XRechnung Standard](https://xeinkauf.de/xrechnung/)
- [Test Suite](https://github.com/itplr-kosit/xrechnung-testsuite)