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

NameTypPflichtBeschreibung
ItemIndexIntegererforderlichZero-based line item index
isChargeBooleanerforderlichTrue adds a charge (BG-28), False an allowance (BG-27)
CalculationPercentStringerforderlichBT-138, BT-143: Percentage
BasisAmountStringerforderlichBT-137, BT-142: Base amount
ActualAmountStringerforderlichBT-136, BT-141: Amount
ReasonCodeStringerforderlichBT-140, BT-145: Reason code
ReasonStringerforderlichBT-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

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.

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.