Reference
Markdown exportBT-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.
Quick actions
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
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
/Invoice/cac:TaxTotal/cac:TaxSubtotal/cbc:TaxAmount/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax/ram:CalculatedAmountValidation 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
Next step
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.
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.