# 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

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.

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.

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.

## 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

## Examples in context

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.

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

## Valid Examples

- 190.00
- 0.00
- 175.50
- 999.99

## Invalid Examples

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

## Related Fields

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.

- [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+ (when VAT breakdown provided)

## XML Implementation

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

### CII (UN/CEFACT) Syntax
```
/CrossIndustryInvoice/SupplyChainTradeTransaction/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.

## Why the standard cares about this field

### Business Context
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.

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

## 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)