Fragen und Antworten
40 Artikel in dieser Kategorie.
Artikel (40)
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: Leistungszeitraum oder Rechnungsdatum als 01.01.0001 – welches Datumsformat erwartet das SDK?
Kurz: Das Aloaha ZUGFeRD SDK erwartet alle Datumswerte im Format 102, also JJJJMMTT (z. B. 20261020 für den 20.10.2026) – das Rechnungsdatum (BT-2, Invoice issue date), den Leistungs- bzw. Abrechnungszeitraum (BG-14 mit …
F: Validator meldet bei SEPA-Lastschrift CII-SR-382, CII-SR-464 und einen Schemafehler bei AccountName – was tun?
Kurz: Bei einer SEPA-Lastschrift (Zahlungsart 59, BT-81 ) kennen EN 16931 und XRechnung für das belastete Konto des Kunden nur die IBAN ( BT-91 , PayerPartyDebtorFinancialAccount/IBANID ). Stehen dort zusätzlich der …
F: 0 % Umsatzsteuer in der E-Rechnung – welche Kategorie: Z, E, K, AE, G oder O?
Kurz: Eine Rechnung ohne Umsatzsteuer braucht die Steuerkategorie, die den Grund für die 0 % nennt – nicht „S“ (Normalsatz) mit 0 %, das meldet der Validator als BR-S-05 bzw. BR-S-08. Die Kategorie ( BT-151 in der …
F: Welche SDK-Version ist beim Kunden installiert – und wie installiere ich Updates automatisch?
Kurz: Die Version des Aloaha ZUGFeRD SDK erkennen Sie an der Dateiversion (FileVersion) von Aloaha_ZUGFeRD.dll , z. B. 11.0.0.11 – nicht an der AssemblyVersion: Die bleibt aus Gründen der COM-Kompatibilität in allen …
F: XRechnung für Behörden und ZUGFeRD für Unternehmen – wie bediene ich beide aus einer Software?
Kurz: Sie brauchen keine zwei Programmversionen. Entscheiden Sie je Rechnung anhand des Empfängers , am besten über ein Kennzeichen im Kundenstamm: Für Behörden und andere öffentliche Auftraggeber (B2G) erzeugen Sie …
F: Wie gebe ich Skonto in der XRechnung an? Das #SKONTO#-Format im SDK
Kurz: In einer XRechnung steht Skonto (Zahlungsrabatt, Skontoabzug, englisch early payment discount oder cash discount ) als eigene Zeile in den Zahlungsbedingungen ( BT-20 , Payment terms ), und zwar in einem festen …
F: Validator meldet „UTF-8 mit BOM“ – ist meine E-Rechnung ungültig?
Kurz: Nein, die Rechnung bleibt gültig. Der Hinweis „Die Datei liegt im Zeichensatz UTF-8 BOM vor“ (bei valitool zum Beispiel [VD-Valitool-130] ) bedeutet nur, dass das XML mit drei unsichtbaren Bytes beginnt, dem Byte …
PDF an einer bestimmten Stelle signieren: sichtbare Unterschrift mit CodeB Wallet im Aloaha PDF Editor
Kurz: Im Aloaha PDF Editor ziehen Sie mit der Maus ein Rechteck an der Stelle auf, an der die Unterschrift stehen soll, klicken hinein und wählen Sign Document . Ist in den Signatur-Einstellungen CodeB Wallet gewählt, …
F: Access meldet nach dem Update Laufzeitfehler 430 oder einen fehlenden Verweis auf Aloaha_ZUGFeRD.tlb – was tun?
Kurz: Wenn Access, Excel oder VB6 nach dem Update des Aloaha ZUGFeRD SDK einen fehlenden oder falschen Verweis auf „Aloaha_ZUGFeRD.tlb“ (z. B. „Version 9.0“) meldet oder bei einem Aufruf mit Laufzeitfehler 430 („Klasse …
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: MergeXMLIntoPDF gibt False zurück und erzeugt kein PDF – was tun?
Kurz: Wenn MergeXMLIntoPDF False zurückgibt, steht die Ursache in alo.LastError – lesen Sie es direkt nach dem Aufruf am selben Objekt . Die häufigsten Gründe: Die Zieldatei existiert schon und DoOverWrite ist False , …
F: Access oder VBA meldet „Prozedur zu groß“ beim ZUGFeRD-Code – was tun?
Kurz: Die Meldung „Prozedur zu groß“ (englisch „Procedure too large“) kommt von VBA selbst, nicht vom Aloaha ZUGFeRD SDK. Eine einzelne Prozedur ( Sub oder Function ) darf in VBA und VB6 höchstens etwa 64 KB übersetzten …
F: Wie setze ich USt-IdNr. und Steuernummer des Verkäufers (BT-31, BT-32) – und was gehört in SellerID?
Kurz: Die Umsatzsteuer-Identifikationsnummer ( BT-31 ) und die Steuernummer ( BT-32 ) des Verkäufers setzen Sie im Aloaha ZUGFeRD SDK mit der Methode AddSellerTAX : als zweiten Parameter "VA" für die USt-IdNr. und "FC" …
ZUGFeRD-Rechnung mit CodeB Wallet am Telefon signieren – QES mit Signaturkarte oder fortgeschritten ohne Karte
Kurz: Eine ZUGFeRD- oder Factur-X-Rechnung ist ein PDF – und lässt sich deshalb mit CodeB Wallet , der EUDI-Wallet von Aloaha für Android, direkt am Telefon digital signieren : als PAdES-Signatur mit vertrauenswürdigem …
XRechnung 4.0: Zeitplan, Änderungen und was das für das Aloaha ZUGFeRD SDK bedeutet
Kurz: Die KoSIT hat am 15. September 2026 eine Vorabversion der XRechnung 4.0 veröffentlicht – ausdrücklich nicht für den produktiven Einsatz. Die finale Version wird für das Frühjahr 2027 erwartet; die XRechnung 3.0 …
F: Wie übergebe ich die Positionsnummer aus der Bestellung des Kunden (BT-132) in der Rechnungsposition?
Kurz: Viele Kunden, vor allem mit SAP, verlangen auf der E-Rechnung zu jeder Position die Positionsnummer aus ihrer Bestellung. Das ist der Business Term BT-132 („Referenced purchase order line reference“, auch …
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: Warum erstellt das SDK meine XRechnung oder EN-16931-Rechnung als Factur-X EXTENDED?
Kurz: Das Aloaha ZUGFeRD SDK stellt eine Rechnung automatisch auf das Profil Factur-X/ZUGFeRD EXTENDED um, sobald Sie ein Feld setzen, das es nur in EXTENDED gibt – damit keine Angabe verloren geht. Eine solche Rechnung …
F: Wie erstelle ich ZUGFeRD-Rechnungen und XRechnungen per CSV und zugcmd aus meiner eigenen Anwendung?
Kurz: Ihre Anwendung – egal ob Delphi, VB6, Access, COBOL oder eine andere Sprache – schreibt die Rechnungsdaten in vier CSV-Dateien und ruft das Kommandozeilenwerkzeug zugcmd auf. zugcmd liest die Dateien, erzeugt das …
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: 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: Warum warnt der Validator vor einem leeren ApplicableHeaderTradeDelivery (PEPPOL-EN16931-R008)?
Kurz: Die Warnung PEPPOL-EN16931-R008 („Document MUST not contain empty elements“) beim Element ApplicableHeaderTradeDelivery bedeutet: Der Lieferblock ist vorhanden, aber leer. Der Block ist im Schema Pflicht und muss …
F: Was bedeutet „One of ApplicableHeaderTradeDelivery is expected“ im Prüfbericht?
Kurz: Der Prüfbericht meldet „Invalid content was found starting with element ApplicableHeaderTradeSettlement. One of ApplicableHeaderTradeDelivery is expected“ (Fehlercode cvc-complex-type.2.4.a ), wenn im XML der …
F: Was bedeutet BR-CL-06 in der XRechnung?
Kurz: Die Regel BR-CL-06 („Value added tax point date code MUST be coded using a restriction of UNTDID 2475“) meldet, dass im Feld BT-8 (ram:DueDateTypeCode) etwas anderes als ein erlaubter Code steht. Erlaubt sind nur …
F: Wie erstelle ich eine XRechnung, die verrechnet statt bezahlt wird?
Kurz: Wird der Rechnungsbetrag nicht überwiesen, sondern mit einer Abrechnung oder Gutschrift verrechnet (einbehalten), verwenden Sie als Zahlungsart ( BT-81 ) den Code 97 „Verrechnung zwischen Partnern“. Den Hinweis …
F: Warum meldet der Validator BR-CO-15 und BR-CO-16, wenn ich den Rechnungsbetrag runde?
Kurz: Der Rundungsbetrag ( BT-114 ) darf nur den Zahlbetrag (BT-115) verändern, nie den Bruttobetrag (BT-112) . Wer den Bruttobetrag auf einen „glatten“ Wert setzt und die Differenz als Rundung angibt, verletzt zwei …
F: Warum wird meine XRechnung wegen CII-SR-465 oder CII-SR-466 abgelehnt?
Kurz: Im Ansprechpartner des Verkäufers ( BT-41 ) bzw. des Käufers ( BT-56 ) steht in der CII-Syntax entweder ein Personenname ( PersonName ) oder eine Abteilung ( DepartmentName ). Sind beide gesetzt, meldet der …
F: Wie gebe ich eine SEPA-Lastschrift in der E-Rechnung richtig an?
Kurz: Bei einer SEPA-Lastschrift ist die Zahlungsart ( BT-81 ) der Code 59 , nicht 58 (Überweisung). Dazu gehören die Mandatsreferenz ( BT-89 ), Ihre Gläubiger-Identifikationsnummer ( BT-90 ) und die IBAN des Kontos, …
F: Wie prüfe ich meine XRechnung vor dem Versand?
Kurz: Verbindlich ist der Prüfbericht des offiziellen KoSIT-Validators mit der aktuellen XRechnung-Prüfkonfiguration . Diese Kombination nutzen auch viele Rechnungseingangsplattformen. Prüfen Sie Ihre Dateien damit, …
Differenzbesteuerung nach § 25a UStG
Ein Kunde hatte die folgende Frage betreffend der Differenzbesteuerung nach § 25a UStG. Da diese vermutlich auch andere Kunden betrifft, haben wir uns entschlossen, Frage und Antwort hier zu posten:…
UnitCodes für die Menge in ZUGFeRD / XRechnung / XInvoice
Für alle öffentlichen Auftragnehmer war der 27. November 2020 eine wichtigste Deadline, denn bis dahin konnten sie ihre Rechnungen freiwillig elektronisch einreichen, danach wurde es Pflicht. Nun…
GrossPrice vs. NetPrice
Es kommt immer wieder die Frage auf wie sich GrossPrice von NetPrice unterscheiden. NetPrice: Der Preis eines Postens, ohne Umsatzsteuer, nach Abzug des für diese Rechnungsposition geltenden Rabatts.…
F: Was muss ich in TAXType und TypeCode eintragen?
Frage: Es gibt bei uns zwei Felder, bei denen wir nicht genau wissen, was für Werte erwartet werden. Es handelt sich um die Felder: TaxType(bsp. Buyer.TAX(0).TAXType)undTypeCode(bsp.…
Ich brauche einen einfachen Weg um an eine PDF Datei einen Anhang anzuhängen.
F: Ich brauche einen einfachen Weg um an eine PDF Datei einen Anhang anzuhängen. Kann ich dazu Ihre Bibliothek benutzen? A: Natürlich können Sie das. Es gibt bei uns eine einfache API in…
F: Ich habe PDF Dateien. Wie erhalte ich nun PDF/A?
A: Das Toolkit wandelt PDF direkt nach PDF/A. Ganz OHNE einen virtuellen Drucker benutzen zu
F: Was brauche ich wenn ich schon PDF/A Dateien habe?
A: Dann brauchen Sie NUR unser Toolkit. Die DLL enthält die Erstellung und das Lesen der XML Datein. Weiterhin kann die DLL die XML Dateien in das PDF einbetten bzw. extrahieren. Natürlich wandelt…
F: Kann ich mit der ZUGFeRD Bibliothek PDF/A Dateien erstellen?
A: Natürlich geht das. Sie finden in der XML Klasse der ZUGFeRD Bibliothek die Funktion PDF2ASCII. Im Prinzip ist diese Funktion ein Wrapper für die identische Funktion der Aloaha PDF Suite: Das…
F: Was benötige ich, um ZUGFeRD-Dateien zu lesen?
A: Um ZUGFeRD-PDFs oder -XML-Dateien zu lesen, benötigen Sie lediglich unser Toolkit: Mehr Informationen finden Sie unter: https://www.zugferdpro.com/tooldownloads/ Ein Codebeispiel zur Extrahierung…
F: Was brauche ich wenn ich schon eine Software zur PDF/A Erstellung habe?
A: Wenn Sie schon eine Software zur PDF/A Erstellung haben brauchen Sie nur das Toolkit. Die PDF Suite brauchen Sie dann nicht zu