# 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

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.

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

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

Core component of VAT processing that enables automated calculation verification, supports VAT return preparation, and ensures compliance with national and EU VAT regulations. 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-2, BR-S-08, BR-DEC-20

## Examples in context

Core component of VAT processing that enables automated calculation verification, supports VAT return preparation, and ensures compliance with national and EU VAT regulations. 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

Core component of VAT processing that enables automated calculation verification, supports VAT return preparation, and ensures compliance with national and EU VAT regulations. 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-2
BR-2

### BR-S-08
BR-S-08

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

## Why the standard cares about this field

### Business Context
Core component of VAT processing that enables automated calculation verification, supports VAT return preparation, and ensures compliance with national and EU VAT regulations. 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/)
- [Invoice Converter](/pdf-to-xrechnung)
- [XRechnung Standard](https://xeinkauf.de/xrechnung/)
- [Test Suite](https://github.com/itplr-kosit/xrechnung-testsuite)