E-Rechnung in sgcSign 2026.12: Rechnung erstellen, prüfen und signieren

· Komponenten
E-Rechnung in sgcSign 2026.12, Rechnungen in Delphi und .NET erstellen, prüfen und signieren

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:

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:

Außerdem werden zwei spanische Steuersysteme abgedeckt:

FormatKlasseSchreibenLesen
UBL 2.1 Rechnung und GutschriftTsgcInvoiceUBLJaJa
UN/CEFACT CII D16BTsgcInvoiceCIIJaJa
XRechnung, UBL oder CIITsgcInvoiceDocumentJaJa
Peppol BIS Billing 3.0, UBLTsgcInvoiceDocumentJaJa
Factur-X / ZUGFeRD XML, fünf ProfileTsgcInvoiceFacturXJaJa
Facturae 3.2, 3.2.1 und 3.2.2TsgcInvoiceFacturaeJaNein
FatturaPA 1.2.3TsgcInvoiceFatturaPAJaNein
KSeF FA(3)TsgcInvoiceKSeFJaNein
VeriFactu-DatensätzeTsgcInvoiceVeriFactuJaNein
TicketBAI 1.2.2TsgcInvoiceTicketBAIJaNein

Die Rechnung versenden

Drei Clients übermitteln das Dokument an die Steuerbehörde:

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:

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.

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.