addItemSpecifiedTradeAllowanceCharge
Methode (Function) · gibt Integer zurück
addItemSpecifiedTradeAllowanceCharge ist eine Methode der Klasse Aloaha_ZUGFeRD.XML im Aloaha ZUGFeRD SDK. Sie betrifft BG-27 (Abschläge auf Ebene der Rechnungsposition), BG-28 (Zuschläge auf Ebene der Rechnungsposition), BT-138 (Prozentualer Abschlag auf Ebene der Rechnungsposition), BT-143 (Prozentualer Zuschlag auf Ebene der Rechnungsposition).
Beschreibung (Originaltext der englischen SDK-Dokumentation): BG-27, BG-28: Adds an allowance or charge to an invoice line.
Rückgabe: Zero-based index of the new allowance/charge within the line, or -1 if the line index is invalid.
Hinweis: Non-empty amounts and the percentage are normalized to 2 decimals.
Deklaration
Public Function addItemSpecifiedTradeAllowanceCharge(ByVal ItemIndex As Integer, ByVal isCharge As Boolean, ByVal CalculationPercent As String, ByVal BasisAmount As String, ByVal ActualAmount As String, ByVal ReasonCode As String, ByVal Reason As String) As Integer
Parameter
| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ItemIndex | Integer | erforderlich | Zero-based line item index |
isCharge | Boolean | erforderlich | True adds a charge (BG-28), False an allowance (BG-27) |
CalculationPercent | String | erforderlich | BT-138, BT-143: Percentage |
BasisAmount | String | erforderlich | BT-137, BT-142: Base amount |
ActualAmount | String | erforderlich | BT-136, BT-141: Amount |
ReasonCode | String | erforderlich | BT-140, BT-145: Reason code |
Reason | String | erforderlich | BT-139, BT-144: Reason |
Aufruf (VB.NET)
Dim alo As New Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, False, "IHR-LIZENZSCHLUESSEL")
Dim ItemIndex As Integer = 0
Dim isCharge As Boolean = False
Dim CalculationPercent As String = ""
Dim BasisAmount As String = ""
Dim ActualAmount As String = ""
Dim ReasonCode As String = ""
Dim Reason As String = ""
Dim ergebnis = alo.addItemSpecifiedTradeAllowanceCharge(ItemIndex, isCharge, CalculationPercent, BasisAmount, ActualAmount, ReasonCode, Reason)
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);
int itemIndex = 0;
bool isCharge = false;
string calculationPercent = "";
string basisAmount = "";
string actualAmount = "";
string reasonCode = "";
string reason = "";
var ergebnis = alo.addItemSpecifiedTradeAllowanceCharge(itemIndex, isCharge, calculationPercent, basisAmount, actualAmount, reasonCode, reason);
Business Terms (EN 16931)
Artikel mit addItemSpecifiedTradeAllowanceCharge
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 …
Zu- und Abschläge je Rechnungsposition (BG-27, BG-28)
Abschläge und Zuschläge können statt auf die ganze Rechnung auch auf eine einzelne Rechnungsposition wirken: zum Beispiel ein Mengenrabatt auf einen Artikel oder ein Expresszuschlag auf eine Lieferung. Dafür gibt es die …
COM-Schnittstelle
addItemSpecifiedTradeAllowanceCharge ist Mitglied der Schnittstelle Aloaha_ZUGFeRD.iXML (Position 308 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.