AddTradeTax
Methode (Sub)
AddTradeTax ist eine Methode der Klasse Aloaha_ZUGFeRD.XML im Aloaha ZUGFeRD SDK. Sie betrifft BG-23 (Umsatzsteueraufschlüsselung), BT-117 (Kategoriespezifischer Steuerbetrag), BT-116 (Kategoriespezifischer Steuerbasisbetrag), BT-118 (Code der Umsatzsteuerkategorie).
Beschreibung (Originaltext der englischen SDK-Dokumentation): BG-23: Add VAT BREAKDOWN
Deklaration
Public Sub AddTradeTax(ByVal CalculatedAmount As String, ByVal CalculatedAmountCurrencyID As String, ByVal BasisAmount As String, ByVal BasisAmountCurrencyID As String, ByVal TypeCode As String, ByVal CategoryCode As String, ByVal ApplicablePercent As String, Optional ByVal ExemptionReason As String = "", Optional ByVal TaxPointDate As String = "", Optional ByVal TaxPointDateFormat As String = "", Optional ByVal DueDateTypeCode As String = "", Optional ByVal ExemptionReasonCode As String = "")
Parameter
| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
CalculatedAmount | String | erforderlich | BT-117: VAT category tax amount |
CalculatedAmountCurrencyID | String | erforderlich | CurrencyID, usually EUR |
BasisAmount | String | erforderlich | BT-116: VAT category taxable amount |
BasisAmountCurrencyID | String | erforderlich | CurrencyID, usually EUR |
TypeCode | String | erforderlich | BT-118-0: Type of tax (code) |
CategoryCode | String | erforderlich | BT-118: VAT category code |
ApplicablePercent | String | erforderlich | BT-119: RateApplicablePercent VAT category rate |
ExemptionReason | String | optional (Standard: "") | BT-120: VAT exemption reason text |
TaxPointDate | String | optional (Standard: "") | BT-7: Tax due date YYYYMMDD |
TaxPointDateFormat | String | optional (Standard: "") | BT-7-0: Due date format, usually 102 |
DueDateTypeCode | String | optional (Standard: "") | BT-8: Value added tax point date code |
ExemptionReasonCode | String | optional (Standard: "") | BT-121: VAT exemption reason code |
Aufruf (VB.NET)
Dim alo As New Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, False, "IHR-LIZENZSCHLUESSEL")
Dim CalculatedAmount As String = ""
Dim CalculatedAmountCurrencyID As String = ""
Dim BasisAmount As String = ""
Dim BasisAmountCurrencyID As String = ""
Dim TypeCode As String = ""
Dim CategoryCode As String = ""
Dim ApplicablePercent As String = ""
alo.AddTradeTax(CalculatedAmount, CalculatedAmountCurrencyID, BasisAmount, BasisAmountCurrencyID, TypeCode, CategoryCode, ApplicablePercent)
Aufruf (C#)
var zfStandard = Aloaha_ZUGFeRD.iXML.ZUGFeRDVersion.xInvoice; // Optional ByRef im Konstruktor: in C# mit ref übergeben
var alo = new Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, false, "IHR-LIZENZSCHLUESSEL", ref zfStandard);
string calculatedAmount = "";
string calculatedAmountCurrencyID = "";
string basisAmount = "";
string basisAmountCurrencyID = "";
string typeCode = "";
string categoryCode = "";
string applicablePercent = "";
alo.AddTradeTax(calculatedAmount, calculatedAmountCurrencyID, basisAmount, basisAmountCurrencyID, typeCode, categoryCode, applicablePercent);
Vollständiges Beispiel (VB.NET)
' VB.NET (Konsolenanwendung, Verweis auf Aloaha_ZUGFeRD.dll, .NET Framework 4.7.2)
' Komplette E-Rechnung nach EN 16931: 10 x 5,00 EUR netto zu 19 % Umsatzsteuer
Module ZugferdRechnung
Sub Main()
' Kultur wie in den SDK-Beispielen setzen und am Ende zurückstellen; Beträge immer als Text mit Punkt ("50.00")
Dim kulturSicherung = System.Threading.Thread.CurrentThread.CurrentCulture
System.Threading.Thread.CurrentThread.CurrentCulture = System.Globalization.CultureInfo.GetCultureInfo("de-DE")
Try
Dim alo As New Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, False, "IHR-LIZENZSCHLUESSEL")
' 1. Rechnungskopf: BT-1 Nummer, BT-22 Bemerkung, BT-2 Datum (Format 102), BT-5 Währung
alo.CreateInvoice("RE-2026-0001", "Rechnung gemäß Bestellung", Date.Today.ToString("yyyyMMdd"), "102", "", "", "EUR")
alo.Document_Type = Aloaha_ZUGFeRD.iXML.DocumentType.Invoice ' BT-3 = 380 (andere Typen NACH CreateInvoice setzen)
' 2. Verkäufer mit USt-IdNr. (BT-31) und Käufer
alo.WriteSeller("Muster GmbH", "20095", "Hamburg", "Hauptstr. 1", "", "DE", "DE123456789")
alo.WriteSellerContactPerson("Erika Muster", "Vertrieb", "vertrieb@muster.de", "+49 40 123456")
alo.set_URIUniversalCommunication("rechnung@muster.de", "EM", True) ' BT-34
alo.BuyerName = "Kunde AG"
alo.BuyerAddressLine1 = "Marktplatz 5"
alo.BuyerPostCode = "80331"
alo.BuyerCity = "München"
alo.BuyerCountry = "DE"
alo.set_URIUniversalCommunication("einkauf@kunde.de", "EM", False) ' BT-49
' 3. Zahlung: SEPA-Überweisung (BT-81, BT-84, BT-86), Zahlungsbedingung (BT-20)
alo.AddPaymentMeans(Aloaha_ZUGFeRD.iXML.Payment_Means.SEPA_credit_transfer, "SEPA-Überweisung", _
"DE02120300000000202051", "Muster GmbH", "", "BYLADEM1001")
alo.AddTradePaymentTerms("Zahlbar innerhalb 30 Tagen netto")
alo.PaymentReference = "RE-2026-0001"
' 4. Position (BG-25): 10 Stück (C62) x 5,00 EUR = 50,00 EUR netto, 19 % Kategorie S
Dim mwstKat As String = alo.VatCategoryCode(Aloaha_ZUGFeRD.iXML.VAT_Category.StandardRate)
Dim zeile As Integer = alo.AddProduct_Comfort("1", "", "ART-100", "10.00", "C62", "Papier A4", "500 Blatt", _
"", "EUR", "", "C62", False, "", "", "", _
"5.00", "EUR", "1.00", "C62", _
"VAT", mwstKat, "19.00", "", _
"50.00", "EUR")
If zeile < 0 Then Throw New Exception("Position nicht angelegt: " & alo.Last_Error)
' 5. Umsatzsteuer-Aufschlüsselung (BG-23): Steuer BT-117 = 9,50 auf Basis BT-116 = 50,00
alo.AddTradeTax("9.50", "EUR", "50.00", "EUR", "VAT", mwstKat, "19.00")
' 6. Summen (BG-22): Netto BT-106, Brutto BT-112, Zahlbetrag BT-115, Basis BT-109, Steuer BT-110
alo.WriteTotals("50.00", "59.50", "59.50", "50.00", "9.50")
' 7. XML speichern (voller Pfad mit Backslash, Endung .xml)
Dim xmlDatei As String = "C:\Rechnungen\RE-2026-0001.xml"
If alo.SaveXML(xmlDatei) Then
Console.WriteLine("E-Rechnung gespeichert: " & xmlDatei)
If alo.LastWarning <> "" Then Console.WriteLine("Hinweis: " & alo.LastWarning)
Else
Console.WriteLine("Fehler: " & alo.Last_Error)
End If
Catch ex As Exception
Console.WriteLine("Ausnahme: " & ex.Message)
Finally
System.Threading.Thread.CurrentThread.CurrentCulture = kulturSicherung
End Try
End Sub
End ModuleVollständiges Beispiel (C#)
// C# (Konsolenanwendung, Verweis auf Aloaha_ZUGFeRD.dll, .NET Framework 4.7.2)
// Komplette E-Rechnung nach EN 16931: 10 x 5,00 EUR netto zu 19 % Umsatzsteuer
using System;
using System.Globalization;
using System.Threading;
class ZugferdRechnung
{
static void Main()
{
// Kultur wie in den SDK-Beispielen setzen und am Ende zurückstellen; Beträge immer als Text mit Punkt ("50.00")
var kulturSicherung = Thread.CurrentThread.CurrentCulture;
Thread.CurrentThread.CurrentCulture = CultureInfo.GetCultureInfo("de-DE");
try
{
// Optional ByRef-Parameter (Konstruktor, SaveXML) übergibt C# mit ref
var standard = Aloaha_ZUGFeRD.iXML.ZUGFeRDVersion.xInvoice;
var alo = new Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, false, "IHR-LIZENZSCHLUESSEL", ref standard);
// 1. Rechnungskopf: BT-1 Nummer, BT-22 Bemerkung, BT-2 Datum (Format 102), BT-5 Währung
alo.CreateInvoice("RE-2026-0001", "Rechnung gemäß Bestellung", DateTime.Today.ToString("yyyyMMdd"), "102", "", "", "EUR");
alo.Document_Type = Aloaha_ZUGFeRD.iXML.DocumentType.Invoice; // BT-3 = 380 (andere Typen NACH CreateInvoice setzen)
// 2. Verkäufer mit USt-IdNr. (BT-31) und Käufer
alo.WriteSeller("Muster GmbH", "20095", "Hamburg", "Hauptstr. 1", "", "DE", "DE123456789");
alo.WriteSellerContactPerson("Erika Muster", "Vertrieb", "vertrieb@muster.de", "+49 40 123456");
alo.set_URIUniversalCommunication("rechnung@muster.de", "EM", true); // BT-34
alo.BuyerName = "Kunde AG";
alo.BuyerAddressLine1 = "Marktplatz 5";
alo.BuyerPostCode = "80331";
alo.BuyerCity = "München";
alo.BuyerCountry = "DE";
alo.set_URIUniversalCommunication("einkauf@kunde.de", "EM", false); // BT-49
// 3. Zahlung: SEPA-Überweisung (BT-81, BT-84, BT-86), Zahlungsbedingung (BT-20)
alo.AddPaymentMeans(Aloaha_ZUGFeRD.iXML.Payment_Means.SEPA_credit_transfer, "SEPA-Überweisung",
"DE02120300000000202051", "Muster GmbH", "", "BYLADEM1001");
alo.AddTradePaymentTerms("Zahlbar innerhalb 30 Tagen netto");
alo.PaymentReference = "RE-2026-0001";
// 4. Position (BG-25): 10 Stück (C62) x 5,00 EUR = 50,00 EUR netto, 19 % Kategorie S
// VatCategoryCode ist in VB eine Eigenschaft mit Parameter -> in C# get_VatCategoryCode(...)
string mwstKat = alo.get_VatCategoryCode(Aloaha_ZUGFeRD.iXML.VAT_Category.StandardRate);
int zeile = alo.AddProduct_Comfort("1", "", "ART-100", "10.00", "C62", "Papier A4", "500 Blatt",
"", "EUR", "", "C62", false, "", "", "",
"5.00", "EUR", "1.00", "C62",
"VAT", mwstKat, "19.00", "",
"50.00", "EUR");
if (zeile < 0) throw new Exception("Position nicht angelegt: " + alo.Last_Error);
// 5. Umsatzsteuer-Aufschlüsselung (BG-23): Steuer BT-117 = 9,50 auf Basis BT-116 = 50,00
alo.AddTradeTax("9.50", "EUR", "50.00", "EUR", "VAT", mwstKat, "19.00");
// 6. Summen (BG-22): Netto BT-106, Brutto BT-112, Zahlbetrag BT-115, Basis BT-109, Steuer BT-110
alo.WriteTotals("50.00", "59.50", "59.50", "50.00", "9.50");
// 7. XML speichern; der 3. Parameter ist Optional ByRef -> in C# mit ref übergeben
string xmlDatei = @"C:\Rechnungen\RE-2026-0001.xml";
if (alo.SaveXML(xmlDatei, "", ref standard))
{
Console.WriteLine("E-Rechnung gespeichert: " + xmlDatei);
if (alo.LastWarning != "") Console.WriteLine("Hinweis: " + alo.LastWarning);
}
else
{
Console.WriteLine("Fehler: " + alo.Last_Error);
}
}
catch (Exception ex)
{
Console.WriteLine("Ausnahme: " + ex.Message);
}
finally
{
Thread.CurrentThread.CurrentCulture = kulturSicherung;
}
}
}Worauf es bei AddTradeTax ankommt:
- Ein Aufruf pro Steuerkategorie und Steuersatz (z. B. einmal S 19 %, einmal S 7 %).
- Basis
BasisAmount(BT-116) = Summe der Positions-Nettobeträge dieser Kategorie minus Nachlässe plus Zuschläge auf Belegebene; SteuerCalculatedAmount(BT-117) = Basis × Satz, auf 2 Stellen gerundet. Abweichungen führen zu BR-S-08, BR-S-09 oder BR-CO-17. - Steuerbefreiung: Kategorie
AE(§13b, Reverse Charge) mit BefreiungsgrundExemptionReasonund CodeExemptionReasonCode(z. B. VATEX-EU-AE) – auf dieser Ebene, nicht in der Position. DueDateTypeCode(BT-8) ist ein Code (5, 29 oder 72), kein Datum.
So steht BG-23 im XML (CII):
<ram:ApplicableTradeTax>
<ram:CalculatedAmount>9.50</ram:CalculatedAmount>
<ram:TypeCode>VAT</ram:TypeCode>
<ram:BasisAmount>50.00</ram:BasisAmount>
<ram:CategoryCode>S</ram:CategoryCode>
<ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
</ram:ApplicableTradeTax>Das Beispiel ist dieselbe Rechnung wie im Schnellstart VB.NET – hier als vollständiges Programm mit Fehlerbehandlung, in VB.NET und C#. Prüfen Sie die erzeugte XML mit dem KoSIT-Validator (XRechnung) oder Mustang (EN 16931 / EXTENDED); eine hybride PDF/A-3-Rechnung entsteht anschließend mit MergeXMLIntoPDF.
Business Terms (EN 16931)
Artikel mit AddTradeTax
Beispiel einer einfachen ZUGFeRD XML Rechnungserstellung
Hier finden Sie ein einfaches Beispiel um eine ZUGFeRD XML Rechnung zu erstellen. Sie benötigen mindestens die Aloaha ZUGFeRD Version 7.1.0.2 Wir haben das Beispiel nochmals hier als ASCII Datei zum…
Erstellung einer ZUGFeRD/X-Rechnung XML Datei via COM Schnittstelle (VB6 / VBA) with Late Binding
Um den Einstieg in die Nutzung unseres SDK zu erleichtern, haben wir ein neues Beispiel entwickelt, das demonstriert, wie eine vollständige ZUGFeRD XML-Datei erstellt wird. Für die Erstellung dieses…
Erstellung einer ZUGFeRD/X-Rechnung XML Datei via COM Schnittstelle (VB6 / VBA) oder .NET (Early Binding)
Um den Einstieg in die Nutzung unseres SDK zu erleichtern, haben wir ein neues Beispiel entwickelt, das demonstriert, wie eine vollständige ZUGFeRD XML-Datei erstellt wird. Für die Erstellung dieses…
Erstellung einer ZUGFeRD/XRechnung XML Datei
Um Anfangsschwierigkeiten bei der Benutzung unseres SDK zu verringern haben wir ein neues Beispiel erstellt um eine komplette ZUGFeRD XML Datei zu erstellen. NEU: Beispiel für VB6 / VBA / .NET:…
Q: How do I use the ZUGFeRD SDK?
To use the SDK to create or read ZUGFeRD compliant XML Invoices is pretty easy. First you need to Reference the Object “Aloaha ZUGFeRD Library” or “Aloaha_ZUGFeRD.xml” in .NET. In case your language…
Umsatzsteuer / VAT
Sie müssen natürlich in einer Rechnung die Umsatzsteuer / VAT ausweisen. Es ist wichtig das Sie den Befehl AddTradeTax pro benutztem CategoryCode einmal aufrufen. Dim CalculatedAmount As String =…
Versicherungssteuer und Mineralölsteuer
In ZUGFeRD wird die Steuerart „Umsatzsteuer“ mit dem Code „VAT“ unterstützt. Sollen andere Steuerarten angegeben wie beispielsweise eine Versicherungssteuer oder eine Mineralölsteuer werden muss der…
F: Was bedeuten „zero rated goods“ und „commercial invoice“ bei einer §13b-Abschlagsrechnung?
Kurz: Wenn ein Rechnungsempfänger meldet, Ihre E-Rechnung enthalte „zero rated goods“ statt „VAT reverse charge“ und sei eine „commercial invoice“ statt einer „partial construction invoice“, dann zitiert er die …
F: Bau-Schlussrechnung mit Zwischensummen als ZUGFeRD/XRechnung erstellen
Kurz: Eine ZUGFeRD- bzw. XRechnung ist eine strukturierte XML-Datei im PDF/A-3 , kein gedrucktes Bild – deshalb erzeugt kein Drucker eine gültige E-Rechnung, und einen „Aloaha ZUGFeRD Printer (End-User Version)“ gibt es …
F: Wie setze ich den Befreiungsgrund (ExemptionReasonCode) in den Positionen – und warum warnt der Validator?
Kurz: In EN 16931 und XRechnung gibt es keinen Befreiungsgrund in der Position. Text ( BT-120 ) und Code ( BT-121 , z. B. VATEX-EU-IC ) gehören nur in die Steueraufschlüsselung: Parameter 8 und 12 von AddTradeTax . Die …
F: Was bedeutet BR-CL-06 in der XRechnung?
Kurz: Die Regel BR-CL-06 („Value added tax point date code MUST be coded using a restriction of UNTDID 2475“) meldet, dass im Feld BT-8 (ram:DueDateTypeCode) etwas anderes als ein erlaubter Code steht. Erlaubt sind nur …
F: Validator meldet BR-FXEXT-IC-08 bei einer innergemeinschaftlichen Lieferung – was tun?
Kurz: Die Regel BR-FXEXT-IC-08 gibt es nur im Profil Factur-X/ZUGFeRD EXTENDED . Sie meldet sich typischerweise bei einer steuerfreien innergemeinschaftlichen Lieferung (Kategorie K) mit einem Zuschlag auf Belegebene, …
COM-Schnittstelle
AddTradeTax ist Mitglied der Schnittstelle Aloaha_ZUGFeRD.iXML (Position 70 von 343) und damit auch aus VB6, VBA/Access und anderen COM-Clients über CreateObject("Aloaha_ZUGFeRD.XML") aufrufbar. Neue Mitglieder werden immer am Ende von iXML angefügt, damit bestehende COM-Clients unverändert weiterlaufen; nach einem Update die Typbibliothek neu registrieren.