Bisher hat sgcSign eine Rechnungs-XML signiert, die Ihre Anwendung selbst erzeugen musste. Die Länderprofile konnten eine Facturae-, FatturaPA- oder TicketBAI-Datei signieren, aber die Datei musste zuerst existieren, und sie zu schreiben war Ihre Aufgabe.
Ab sgcSign 2026.12 erstellt die Bibliothek die Rechnung auch selbst. Sie füllen eine typisierte Rechnung aus, die Bibliothek berechnet die Summen, prüft die Geschäftsregeln und schreibt das Dokument in dem Format, das der Empfänger oder die Steuerbehörde verlangt. Die Länderprofile signieren das Ergebnis, und drei Clients übermitteln es. Alles, was in diesem Beitrag beschrieben wird, ist ab sgcSign 2026.12 verfügbar, für Delphi 7 bis Delphi 13 und .NET, und in sgcSign enthalten.
E-Rechnung in sgcSign in einer Minute: das Rechnungsmodell, die Formate, die Prüfung und der Versand über Peppol. Auch auf YouTube.
Eine typisierte Rechnung auf Basis von EN 16931
TsgcInvoice ist ein typisiertes Modell des semantischen Datenmodells von EN 16931: Verkäufer, Käufer, Zahlungsempfänger, Zahlung, Positionen, Nachlässe und Zuschläge, Umsatzsteueraufschlüsselung und Summen. Das Modell enthält kein XML, daher lässt sich dieselbe Rechnung in mehr als einer Syntax schreiben. CalculateTotals füllt die Netto-Positionsbeträge, die Umsatzsteueraufschlüsselung und die Dokumentsummen, sodass die Anwendung nur Mengen, Preise und Steuersätze setzt und nichts selbst addiert.
TsgcInvoiceUBL schreibt und liest die UBL-2.1-Rechnung (Invoice) und -Gutschrift (CreditNote). TsgcInvoiceCII schreibt und liest die UN/CEFACT Cross Industry Invoice D16B. Das folgende Beispiel füllt eine Rechnung, berechnet die Summen, prüft die Regeln von EN 16931 und schreibt eine UBL-2.1-Datei.
uses
Classes, SysUtils,
sgcSign_Invoice, sgcSign_Invoice_UBL, sgcSign_Invoice_Validator;
procedure CreateInvoice;
var
oInvoice: TsgcInvoice;
oLine: TsgcInvoiceLine;
oValidator: TsgcInvoiceValidator;
oUBL: TsgcInvoiceUBL;
begin
oInvoice := TsgcInvoice.Create;
oValidator := TsgcInvoiceValidator.Create;
oUBL := TsgcInvoiceUBL.Create;
try
oInvoice.Number := 'INV-2026-0001';
oInvoice.IssueDate := EncodeDate(2026, 11, 11);
oInvoice.DueDate := EncodeDate(2026, 12, 11);
oInvoice.CurrencyCode := 'EUR';
oInvoice.SpecificationIdentifier :=
CS_SGC_INVOICE_UBL_CUSTOMIZATION_EN16931;
oInvoice.BuyerReference := 'PO-7781';
oInvoice.Seller.Name := 'Seller Company SL';
oInvoice.Seller.VATID := 'ESB12345674';
oInvoice.Seller.Address.City := 'Madrid';
oInvoice.Seller.Address.CountryCode := 'ES';
oInvoice.Buyer.Name := 'Buyer Company GmbH';
oInvoice.Buyer.VATID := 'DE123456789';
oInvoice.Buyer.Address.City := 'Berlin';
oInvoice.Buyer.Address.CountryCode := 'DE';
oLine := oInvoice.Lines.Add;
oLine.ID := '1';
oLine.Item.Name := 'Consulting';
oLine.Quantity := 10;
oLine.UnitCode := CS_SGC_INVOICE_UNIT_HOUR;
oLine.Price.NetPrice := 85;
oLine.VATCategoryCode := CS_SGC_INVOICE_VAT_STANDARD;
oLine.VATRate := 21;
// line amounts, VAT breakdown and totals
oInvoice.CalculateTotals;
// EN 16931 business rules
if not oValidator.Validate(oInvoice) then
raise Exception.Create(oValidator.AsText);
// UBL 2.1 document
oUBL.WriteToFile(oInvoice, 'invoice.xml');
finally
oUBL.Free;
oValidator.Free;
oInvoice.Free;
end;
end;
XRechnung, Peppol BIS und Factur-X
Die meisten Empfänger verlangen nicht einfach EN 16931, sondern ein Profil davon. sgcSign 2026.12 schreibt und liest drei davon aus demselben Modell:
- XRechnung, in der UBL- oder der CII-Syntax.
- Peppol BIS Billing 3.0, in der UBL-Syntax.
- Factur-X / ZUGFeRD, das XML der fünf Profile Minimum, Basic WL, Basic, EN 16931 und Extended, über
TsgcInvoiceFacturX.
Das Schreiben eines Profils verändert die Rechnung nicht, daher kann ein Modell für einen Kunden als XRechnung und für den nächsten als Peppol BIS geschrieben werden. Wenn eine Rechnung eingeht, erkennt sgcInvoiceReadAny die Syntax und das Profil der Datei und lädt sie in das Modell.
Prüfung mit den offiziellen Regel-IDs
TsgcInvoiceValidator prüft eine Rechnung gegen die Geschäftsregeln von EN 16931 und, auf Wunsch, gegen die Regelsätze von XRechnung und Peppol BIS Billing 3.0. Die Regeln sind nativ codiert und laufen auf dem Modell, bevor irgendein XML geschrieben wird. Jede Meldung enthält die offizielle Regel-ID, den Schweregrad, den Geschäftsbegriff, den Pfad des Feldes im Modell und den Regeltext, sodass die Anwendung dem Benutzer zeigen kann, welches Feld zu korrigieren ist.
Das folgende Beispiel prüft dieselbe Rechnung zweimal. Sie besteht die Regeln von EN 16931 und wird dann als XRechnung geprüft, die einen Ansprechpartner des Verkäufers verlangt, den das Kernmodell nicht fordert. FillInvoice füllt die Rechnung des ersten Beispiels und ergänzt Straße und Postleitzahl beider Parteien sowie eine SEPA-Überweisung, die XRechnung verlangt. Log gibt eine Zeile aus.
uses
SysUtils, Classes,
sgcSign_Invoice, sgcSign_Invoice_Validator, sgcSign_Invoice_Variants;
procedure RuleSetsSample;
var
oInvoice: TsgcInvoice;
oValidator: TsgcInvoiceValidator;
i: Integer;
begin
oInvoice := TsgcInvoice.Create;
oValidator := TsgcInvoiceValidator.Create;
try
FillInvoice(oInvoice);
oInvoice.CalculateTotals;
Log(BoolToStr(oValidator.Validate(oInvoice), True)); // True
// the same invoice as XRechnung
sgcInvoiceApplyVariant(oInvoice, ivXRechnung, isUBL);
oValidator.RuleSets := [vrsEN16931, vrsXRechnung];
if not oValidator.Validate(oInvoice) then
for i := 0 to oValidator.Messages.Count - 1 do
Log(oValidator.Messages[i].RuleID + ' ' + oValidator.Messages[i].Path);
// what XRechnung asks for and the core model does not
oInvoice.Seller.Contact.Name := 'Ana Lopez';
oInvoice.Seller.Contact.Telephone := '+34 910 000 000';
oInvoice.Seller.Contact.Email := 'ana@seller.example';
oInvoice.Delivery.ActualDeliveryDate := EncodeDate(2026, 11, 10);
Log(BoolToStr(oValidator.Validate(oInvoice), True)); // True
Log(IntToStr(oValidator.WarningCount)); // 0
finally
oValidator.Free;
oInvoice.Free;
end;
end;
Die zweite Prüfung gibt zwei Meldungen aus, BR-DE-2 Seller.Contact und BR-DE-TMP-32 Delivery.ActualDeliveryDate. Die erste ist ein schwerer Fehler, die zweite eine Warnung. Sobald Ansprechpartner und Lieferdatum gesetzt sind, besteht die Rechnung ohne Warnungen.
Nationale Formate
Drei Länder verwenden ein eigenes Rechnungsformat, und jedes hat einen Writer, der dieselbe TsgcInvoice übernimmt:
- Facturae, Spanien:
TsgcInvoiceFacturaeschreibt die Versionen 3.2, 3.2.1 und 3.2.2. - FatturaPA, Italien:
TsgcInvoiceFatturaPAschreibt die Version 1.2.3 für private Empfänger (FPR12) und für die öffentliche Verwaltung (FPA12). - KSeF, Polen:
TsgcInvoiceKSeFschreibt die strukturierte Rechnung, Schema FA(3).
Außerdem werden zwei spanische Steuersysteme abgedeckt:
- VeriFactu:
TsgcInvoiceVeriFactuerstellt die Registrierungs- und Stornodatensätze mit dem verketteten SHA-256-Hash, pflegt die Kette zwischen den Datensätzen und erzeugt die URL und das Bild des QR-Codes. - TicketBAI:
TsgcInvoiceTicketBAIerstellt die Rechnungs- und Stornodateien in Version 1.2.2 mit der Verkettung zur vorherigen Rechnung. Nach der Signatur liefert es die TBAI-Kennung und den QR-Code.
| Format | Klasse | Schreiben | Lesen |
|---|---|---|---|
| UBL 2.1 Rechnung und Gutschrift | TsgcInvoiceUBL | Ja | Ja |
| UN/CEFACT CII D16B | TsgcInvoiceCII | Ja | Ja |
| XRechnung, UBL oder CII | TsgcInvoiceDocument | Ja | Ja |
| Peppol BIS Billing 3.0, UBL | TsgcInvoiceDocument | Ja | Ja |
| Factur-X / ZUGFeRD XML, fünf Profile | TsgcInvoiceFacturX | Ja | Ja |
| Facturae 3.2, 3.2.1 und 3.2.2 | TsgcInvoiceFacturae | Ja | Nein |
| FatturaPA 1.2.3 | TsgcInvoiceFatturaPA | Ja | Nein |
| KSeF FA(3) | TsgcInvoiceKSeF | Ja | Nein |
| VeriFactu-Datensätze | TsgcInvoiceVeriFactu | Ja | Nein |
| TicketBAI 1.2.2 | TsgcInvoiceTicketBAI | Ja | Nein |
Die Rechnung versenden
Drei Clients übermitteln das Dokument an die Steuerbehörde:
TsgcVeriFactuClientübermittelt VeriFactu-Datensätze an den Webservice der AEAT. Er liest das Ergebnis jedes Datensatzes, beachtet die Datensatzgrenze und die Wartezeit zwischen den Übermittlungen, fragt übermittelte Datensätze ab und speichert die Quittungen.TsgcSdIClientsendet eine FatturaPA-Datei an den Webservice des italienischen Sistema di Interscambio (SdI), prüft die Regel für den Dateinamen und liest die Benachrichtigungsdateien, die das SdI zurückgibt.TsgcKSeFOnlineClientsendet Rechnungen in einer interaktiven Sitzung an KSeF: Er öffnet die Sitzung, sendet die Rechnung, liest ihren Status und ihre KSeF-Nummer, schließt die Sitzung und lädt die UPO-Quittung herunter.
Versand über das Peppol-Netzwerk
Version 2026.12 versendet die Rechnung auch über das Peppol-Netzwerk, in Delphi und .NET. Die Teile sind eigene Klassen, sodass Sie den ganzen Ablauf oder nur einen seiner Schritte nutzen können:
TsgcPeppolSMPClientsucht den Teilnehmer über SML und SMP und prüft die signierte SMP-Antwort.TsgcPeppolSBDHundsgcPeppolWrapInvoiceschreiben den Peppol-Geschäftsnachrichten-Umschlag, den SBDH.TsgcPeppolAS4MessageundTsgcPeppolAS4Receiptimplementieren die AS4-Nachricht des Peppol-AS4-Profils: signiert mit RSA-SHA256, Nutzdaten mit gzip komprimiert und mit AES-128-GCM verschlüsselt, Schlüsseltransport mit RSA-OAEP.TsgcPeppolClienterledigt Suche, Umschlag, Versand und Prüfung der Quittung in einem Aufruf, mitSendInvoiceundResend. Er speichert die signierte Quittung und liefert ein Ergebnisobjekt mit Fehlercodes.
Es werden keine externen Bibliotheken benötigt: Kryptografie, XML und AS4-Code sind Teil der Bibliothek, für Delphi 7 bis Delphi 13. Das folgende Beispiel versendet eine Rechnungsdatei mit TsgcPeppolClient.
uses
Classes, SysUtils,
sgcSign_Interfaces, sgcSign_Peppol_Client;
procedure SendInvoiceToPeppol(const aAccessPointKey: IsgcKeyProvider);
var
oClient: TsgcPeppolClient;
oResult: TsgcPeppolSendResult;
begin
oClient := TsgcPeppolClient.Create(nil);
oResult := TsgcPeppolSendResult.Create;
try
// key and certificate of the sending access point
oClient.KeyProvider := aAccessPointKey;
oClient.TestNetwork := True;
// the company that issues the invoice and its country
oClient.SenderID := '0088:7315458756324';
oClient.CountryC1 := 'ES';
// lookup, envelope, AS4 message, POST and receipt in one call
if oClient.SendInvoiceFile('invoice.xml', '9915:receiver', oResult) then
WriteLn('Delivered, message ' + oResult.MessageId)
else
WriteLn(oResult.ErrorCode + ': ' + oResult.ErrorText);
finally
oResult.Free;
oClient.Free;
end;
end;
Lesen Sie die Anforderungen, bevor Sie ein Projekt darauf aufbauen. Für den Versand im Peppol-Netzwerk ist ein akkreditierter Peppol Access Point (Dienstanbieter) mit einem von OpenPeppol ausgestellten Access-Point-Zertifikat erforderlich. Die Bibliothek implementiert das Protokoll und liefert weder das Zertifikat noch die Akkreditierung. Unternehmen, die einen Dienstanbieter nutzen, senden normalerweise über diesen Anbieter. Die Bibliothek kann nur senden: Es gibt keinen empfangenden Access Point und kein Peppol-Reporting. Die Teilnehmersuche benötigt kein Zertifikat.
Der Sender wurde auf Interoperabilität gegen den Open-Source-AS4-Server phase4 (Version 4.9.0) auf einer lokalen Test-PKI getestet: Jede Nachricht wurde akzeptiert und jede Quittung geprüft, mit den Delphi- und .NET-Bibliotheken. Er wurde weder gegen einen Produktions-Access-Point noch mit echten Peppol-Zertifikaten ausgeführt. Die Demos Demos\Delphi\Peppol und Demos\CBuilder\Peppol gehören zur Bibliothek.
Eine Komponente für den gesamten Ablauf
TsgcInvoiceDocument fasst die Schritte zusammen. Wählen Sie das Format, füllen Sie die Rechnung aus und rufen Sie Build auf. Die Komponente berechnet die Summen, prüft mit den Regelsätzen des Formats, schreibt das Dokument und signiert es mit dem Signaturprofil des Formats. Schlägt die Prüfung fehl, wird nichts geschrieben, und jeder sgcSign-Schlüsselanbieter kann das Dokument signieren.
Das folgende Beispiel schreibt das Factur-X-XML im Profil EN 16931 und signiert es mit einem Zertifikat aus einer PFX-Datei.
uses
Classes, SysUtils,
sgcSign_Types, sgcSign_KeyProvider_PFX,
sgcSign_Invoice, sgcSign_Invoice_Document;
procedure BuildSignedInvoice;
var
oKeyProvider: TsgcPFXKeyProvider;
oDocument: TsgcInvoiceDocument;
begin
oKeyProvider := TsgcPFXKeyProvider.Create(nil);
oDocument := TsgcInvoiceDocument.Create(nil);
try
oKeyProvider.FileName := 'certificate.pfx';
oKeyProvider.Password := 'secret';
oKeyProvider.LoadFromFile;
// FillInvoice sets seller, buyer and lines as in the previous example
FillInvoice(oDocument.Invoice);
oDocument.Format := ifFacturXEN16931;
oDocument.Sign := True;
oDocument.KeyProvider := oKeyProvider;
// totals, validation, Factur-X XML and XAdES signature
oDocument.BuildToFile('factur-x.xml');
finally
oDocument.Free;
oKeyProvider.Free;
end;
end;
Die Komponente kann auch lesen. LoadFromFile übernimmt eine UBL- oder CII-Datei, setzt Format auf das Format der Datei und füllt das Modell, sodass eine empfangene Rechnung geprüft und in der anderen Syntax erneut geschrieben werden kann.
Was nicht enthalten ist
Der Umfang dieser ersten Version hat Grenzen, und es ist besser, sie zu kennen, bevor Sie ein Projekt darauf aufbauen.
- Die nationalen Formate sind nur schreibend. UBL und CII mit ihren Varianten XRechnung, Peppol BIS und Factur-X können wieder in das Modell eingelesen werden. Facturae, FatturaPA, KSeF, VeriFactu und TicketBAI nicht.
- Der Peppol-Versand braucht einen akkreditierten Access Point und ist nur Versand. Die Bibliothek implementiert das Protokoll und liefert weder das Access-Point-Zertifikat noch die Akkreditierung. Es gibt keinen empfangenden Access Point und kein Peppol-Reporting.
- Factur-X ist nur das XML. Eine Factur-X- oder ZUGFeRD-Rechnung ist eine PDF/A-3-Datei mit eingebettetem XML. Die Komponente schreibt das XML und bettet es nicht in eine PDF/A-3-Datei ein.
- KSeF-Rechnungen werden von der Komponente gesendet, aber nicht signiert, weil KSeF das Rechnungs-XML nicht signiert.
- Die SdI-Endpunkte sind nicht integriert. Das SdI teilt dem Absender seine Endpunkte bei der Akkreditierung des Kanals mit, und Sie setzen sie am Client.
So erhalten Sie es
Die E-Rechnung ist ab Version 2026.12 Teil von sgcSign. Es ist keine eigene Edition: Die Units werden mit sgcSign ausgeliefert, mit vollständigem Quellcode, für Delphi 7 bis Delphi 13 und .NET. Eine neue Demo EInvoice im Ordner Demos füllt in einem Formular eine typisierte Rechnung aus und erstellt sie mit einer einzigen Komponente in jedem der Formate.
E-Rechnung auf der Produktseite · Testversion herunterladen · Änderungsprotokoll
Fragen oder Feedback? Nehmen Sie Kontakt auf, Sie erhalten eine Antwort von den Menschen, die den Code geschrieben haben.
