AddTradeAllowanceCharge

Methode (Sub)

AddTradeAllowanceCharge ist eine Methode der Klasse Aloaha_ZUGFeRD.XML im Aloaha ZUGFeRD SDK. Sie betrifft BG-20 (Abschläge auf Dokumentenebene), BG-21 (Zuschläge auf Dokumentenebene), BT-93 (Grundbetrag des Abschlags auf Dokumentenebene), BT-100 (Grundbetrag des Zuschlags auf Dokumentenebene).

Beschreibung (Originaltext der englischen SDK-Dokumentation): Adds Document level allowances / charges BG-20, BG-21

Deklaration

Public Sub AddTradeAllowanceCharge(ByVal ChargeIndicator As Boolean, ByVal BasisAmount As String, ByVal BasisAmountCurrencyID As String, ByVal ActualAmount As String, ByVal ActualAmountCurrencyID As String, ByVal TypeCode As String, ByVal CategoryCode As String, ByVal TAXRateApplicablePercent As String, Optional ByVal Reason As String = "", Optional ByVal CalculationPercent As String = "", Optional ByVal ReasonCode As String = "", Optional ByVal SequenceNumeric As String = "")

Parameter

NameTypPflichtBeschreibung
ChargeIndicatorBooleanerforderlichBG-20-0, BG-21-0: Allowances / charges document level Indicator
BasisAmountStringerforderlichBT-93, BT-100: Document level allowances / charges base amount
BasisAmountCurrencyIDStringerforderlichCurrency ID. Usually EUR
ActualAmountStringerforderlichBT-92, BT-99: Document level allowances / charges amount
ActualAmountCurrencyIDStringerforderlichCurrency ID. Usually EUR
TypeCodeStringerforderlichBT-95-0, BT-102-0: VAT type code for document level allowances / charges
CategoryCodeStringerforderlichBT-95, BT-102: VAT category code for document level allowances / charges
TAXRateApplicablePercentStringerforderlichBT-96, BT-103: Document level allowances / charges VAT rate
ReasonStringoptional (Standard: "")BT-97, BT-104: Document level allowances / charges reason
CalculationPercentStringoptional (Standard: "")BT-94, BT-101: Document level allowances / charges percentage
ReasonCodeStringoptional (Standard: "")BT-98, BT-105: Document level allowances / charges reason code UNTDID 5189
SequenceNumericStringoptional (Standard: "")Calculation sequence

Aufruf (VB.NET)

Dim alo As New Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, False, "IHR-LIZENZSCHLUESSEL")
Dim ChargeIndicator As Boolean = False
Dim BasisAmount As String = ""
Dim BasisAmountCurrencyID As String = ""
Dim ActualAmount As String = ""
Dim ActualAmountCurrencyID As String = ""
Dim TypeCode As String = ""
Dim CategoryCode As String = ""
Dim TAXRateApplicablePercent As String = ""
alo.AddTradeAllowanceCharge(ChargeIndicator, BasisAmount, BasisAmountCurrencyID, ActualAmount, ActualAmountCurrencyID, TypeCode, CategoryCode, TAXRateApplicablePercent)

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);
bool chargeIndicator = false;
string basisAmount = "";
string basisAmountCurrencyID = "";
string actualAmount = "";
string actualAmountCurrencyID = "";
string typeCode = "";
string categoryCode = "";
string taxRateApplicablePercent = "";
alo.AddTradeAllowanceCharge(chargeIndicator, basisAmount, basisAmountCurrencyID, actualAmount, actualAmountCurrencyID, typeCode, categoryCode, taxRateApplicablePercent);

Business Terms (EN 16931)

Artikel mit AddTradeAllowanceCharge

AddTradeAllowanceCharge (BG-20, BG-21)

AddTradeAllowanceCharge fügt eine Gruppe von Geschäftstermini hinzu, die Informationen über die anwendbaren Zuschläge oder Rabatte auf den Gesamtbetrag der Rechnung bereitstellen.…

31. Mai 2024BG-20 BG-21 BT-100 BT-102 BT-103 BT-104

Rabatte und Zuschläge: Prozentsatz und Grundcode

Ein Abschlag (Rabatt) oder Zuschlag auf die ganze Rechnung steht in der Gruppe BG-20 (Abschläge) bzw. BG-21 (Zuschläge) . Neben Betrag und Grund kann die Rechnung den Prozentsatz und einen Grundcode enthalten. Das …

7. Oktober 2026BT-94 BT-98 BT-101 BT-105 BG-20 BG-21

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 …

14. Oktober 2026BT-3 BT-118 BT-151 BT-121 BT-120 BT-31

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 …

5. November 2026BG-22 BG-20 BG-21 BG-25 BG-27 BT-20

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 …

12. November 2026BT-120 BT-121 BT-151 BT-118 BT-24 BT-131

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, …

11. November 2026BT-116 BT-120 BT-24 BT-99 BT-131 BT-48

F: Warum meldet der Validator BR-S-08, BR-S-09 und BR-CO-17, wenn die Rechnung einen Rabatt hat?

Kurz: Die drei Regeln BR-S-08 , BR-S-09 und BR-CO-17 melden zusammen fast immer denselben Fehler: In der Umsatzsteuer-Aufschlüsselung (BG-23) steht als Basisbetrag ( BT-116 ) die Summe der Positionen statt des …

15. Oktober 2026BT-116 BT-117 BT-92 BT-106 BT-107 BT-109

F: Wie stelle ich Frachtkosten in der E-Rechnung dar – frei Bau oder ab Werk?

Kurz: Frachtkosten („ab Werk“, Lieferung wird extra berechnet) lassen sich in einer E-Rechnung auf drei Wegen abbilden, die alle in EN 16931 und XRechnung erlaubt sind – ein Wechsel ins Profil EXTENDED ist dafür nicht …

24. Oktober 2026BG-21 BG-28 BT-99 BT-141 BT-104 BT-105

F: Warum meldet der Validator BR-S-01, BR-S-06 oder BR-AE-08, wenn die Rechnung einen Nachlass hat?

Kurz: Ein Nachlass oder Zuschlag auf Rechnungsebene ( BG-20 bzw. BG-21) hat eine eigene Steuerkategorie ( BT-95 ) und einen eigenen Steuersatz ( BT-96 ). Beide müssen zu den Positionen passen, von denen der Nachlass …

20. Oktober 2026BT-95 BT-96 BT-151 BG-20 BT-92 BT-93

F: Muss ich bei AddTradeAllowanceCharge den Parameter SequenceNumeric übergeben?

Kurz: Nein. SequenceNumeric ist der letzte, optionale Parameter von AddTradeAllowanceCharge . Lassen Sie ihn weg oder übergeben Sie einen Leerstring "" ; dann wird das Element nicht in das XML geschrieben. Das Feld gibt …

12. November 2026BG-20 BG-21 BT-92 BT-99

F: Zuschlag wird als Nachlass ausgewiesen – woran liegt das?

Kurz: Ein Zuschlag auf Rechnungsebene gehört in die Gruppe BG-21 und wird allein über den ChargeIndicator = true gekennzeichnet. Der Betrag bleibt dabei immer positiv . Wird der Zuschlag stattdessen als Abschlag ( BG-20 …

9. November 2026BG-21 BG-20 BT-99 BT-108 BT-92 BT-100

„E-Rechnung bereit für den Handel“: Alle 39 VeR-Pflichtfelder mit dem Aloaha ZUGFeRD SDK

Kurz: Der Verband elektronische Rechnung (VeR) hat für die Initiative „E-Rechnung bereit für den Handel“ 39 Felder der EN 16931 festgelegt, die Handelsunternehmen in jeder E-Rechnung erwarten – darunter GLN von …

13. Oktober 2026BT-29 BT-46 BT-13 BT-16 BT-71 BT-157

COM-Schnittstelle

AddTradeAllowanceCharge ist Mitglied der Schnittstelle Aloaha_ZUGFeRD.iXML (Position 71 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.

Quelle: XML-Dokumentationskommentare des Aloaha ZUGFeRD SDK (xml.vb). Gleiche Signatur in VB6/VBA über COM. In C# werden ByRef-Parameter mit ref übergeben, VB-Eigenschaften mit Parametern heißen get_…/set_…, optionale Parameter können entfallen.