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
| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ChargeIndicator | Boolean | erforderlich | BG-20-0, BG-21-0: Allowances / charges document level Indicator |
BasisAmount | String | erforderlich | BT-93, BT-100: Document level allowances / charges base amount |
BasisAmountCurrencyID | String | erforderlich | Currency ID. Usually EUR |
ActualAmount | String | erforderlich | BT-92, BT-99: Document level allowances / charges amount |
ActualAmountCurrencyID | String | erforderlich | Currency ID. Usually EUR |
TypeCode | String | erforderlich | BT-95-0, BT-102-0: VAT type code for document level allowances / charges |
CategoryCode | String | erforderlich | BT-95, BT-102: VAT category code for document level allowances / charges |
TAXRateApplicablePercent | String | erforderlich | BT-96, BT-103: Document level allowances / charges VAT rate |
Reason | String | optional (Standard: "") | BT-97, BT-104: Document level allowances / charges reason |
CalculationPercent | String | optional (Standard: "") | BT-94, BT-101: Document level allowances / charges percentage |
ReasonCode | String | optional (Standard: "") | BT-98, BT-105: Document level allowances / charges reason code UNTDID 5189 |
SequenceNumeric | String | optional (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.…
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 …
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: 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, …
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 …
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 …
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 …
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 …
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 …
„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 …
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.