CreateNewInvoice() – ZUGFeRD SDK API

CreateNewInvoice ist eine Methode der Klasse Aloaha_ZUGFeRD.XML im Aloaha ZUGFeRD SDK. Sie betrifft BT-1 (Rechnungsnummer), BT-83 (Verwendungszweck), BT-22 (Freitext zur Rechnung), BG-1 (Freitext zur Rechnung).

Beschreibung (Originaltext der englischen SDK-Dokumentation): Starts a new invoice like CreateInvoice and reports success as Boolean. The invoice data currently held by this object is replaced.

Rückgabe: True if the new invoice was created (invoice date is set), otherwise False.

Deklaration

Public Function CreateNewInvoice(ByVal InvoiceID As String, Optional ByVal InvoiceNote As String = "", Optional ByVal InvoiceDate As String = "", Optional ByVal InvoiceDateFormat As String = "", Optional ByVal InvoiceName_FreeText As String = "", Optional ByVal InvoiceLanguageID_2Letter_ISO As String = "", Optional ByVal CurrencyID As String = "") As Boolean

Parameter

Name	Typ	Pflicht	Beschreibung
`InvoiceID`	`String`	erforderlich	BT-1: Invoice number. Also used as payment reference (BT-83).
`InvoiceNote`	`String`	optional (Standard: `""`)	BT-22 (BG-1): Optional invoice note. Ignored if empty.
`InvoiceDate`	`String`	optional (Standard: `""`)	BT-2: Invoice date, e.g. YYYYMMDD. If empty, today's date is used with format 102.
`InvoiceDateFormat`	`String`	optional (Standard: `""`)	Date format code of InvoiceDate, 102 for YYYYMMDD.
`InvoiceName_FreeText`	`String`	optional (Standard: `""`)	Document name (free text). Should normally remain empty.
`InvoiceLanguageID_2Letter_ISO`	`String`	optional (Standard: `""`)	Document language as 2-letter ISO code, e.g. DE for German.
`CurrencyID`	`String`	optional (Standard: `""`)	BT-5: Invoice currency code, e.g. EUR. Spaces are removed and the code is upper-cased.

Aufruf (VB.NET)

Dim alo As New Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, False, "IHR-LIZENZSCHLUESSEL")
Dim InvoiceID As String = ""
If Not alo.CreateNewInvoice(InvoiceID) Then
    Console.WriteLine("Fehler: " & alo.Last_Error)
End If

Aufruf (C#)

var alo = new Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, false, "IHR-LIZENZSCHLUESSEL");
string invoiceID = "";
if (!alo.CreateNewInvoice(invoiceID))
{
    Console.WriteLine("Fehler: " + alo.Last_Error);
}

Business Terms (EN 16931)

BT-1 Rechnungsnummer BT-83 Verwendungszweck BT-22 Freitext zur Rechnung BG-1 Freitext zur Rechnung BT-2 Rechnungsdatum BT-5 Code für die Rechnungswährung

Artikel mit CreateNewInvoice

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…

29. April 2024BT-1 BT-122 BT-123 BT-13 BT-17 BT-18

Erstellung einer ZUGFeRD/X-Rechnung XML Datei via COM Schnittstelle (VB6 / VBA) oder .NET (Early Binding)

30. April 2024BT-1 BT-122 BT-123 BT-13 BT-17 BT-18

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

COM-Schnittstelle

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