E-facturatie in sgcSign 2026.12: factuur opstellen, valideren en ondertekenen

· Componenten
E-facturatie in sgcSign 2026.12, facturen opstellen, valideren en ondertekenen in Delphi en .NET

Tot nu toe ondertekende sgcSign een factuur-XML die uw toepassing zelf moest opbouwen. De landprofielen konden een Facturae-, FatturaPA- of TicketBAI-bestand ondertekenen, maar het bestand moest eerst bestaan en het schrijven ervan was uw taak.

Vanaf sgcSign 2026.12 stelt de bibliotheek de factuur ook op. U vult een getypeerde factuur in, de bibliotheek berekent de totalen, controleert de bedrijfsregels en schrijft het document in het formaat dat de ontvanger of de belastingdienst vraagt. De landprofielen ondertekenen het resultaat en drie clients verzenden het. Alles wat in dit bericht staat, is beschikbaar vanaf sgcSign 2026.12, voor Delphi 7 tot en met Delphi 13 en voor .NET, en het is inbegrepen in sgcSign.

E-facturatie in sgcSign in één minuut: het factuurmodel, de formaten, de validatie en het verzenden via Peppol. Ook op YouTube.

Een getypeerde factuur op basis van EN 16931

TsgcInvoice is een getypeerd model van het semantische gegevensmodel van EN 16931: verkoper, koper, begunstigde, betaling, regels, kortingen en toeslagen, btw-specificatie en totalen. Het model bevat geen XML, dus dezelfde factuur kan in meer dan één syntaxis worden geschreven. CalculateTotals vult de nettobedragen van de regels, de btw-specificatie en de documenttotalen, zodat de toepassing alleen hoeveelheden, prijzen en btw-tarieven instelt en zelf niets optelt.

TsgcInvoiceUBL schrijft en leest de UBL 2.1 Invoice en CreditNote (creditnota). TsgcInvoiceCII schrijft en leest de UN/CEFACT Cross Industry Invoice D16B. Het onderstaande voorbeeld vult een factuur in, berekent de totalen, controleert de EN 16931-regels en schrijft een UBL 2.1-bestand.

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 en Factur-X

De meeste ontvangers vragen niet om kale EN 16931. Ze vragen om een profiel ervan. sgcSign 2026.12 schrijft en leest er drie vanuit hetzelfde model:

Het schrijven van een profiel wijzigt de factuur niet, dus één model kan voor de ene klant als XRechnung en voor de volgende als Peppol BIS worden geschreven. Wanneer er een factuur binnenkomt, herkent sgcInvoiceReadAny de syntaxis en het profiel van het bestand en laadt het in het model.

Validatie met de officiële regel-id's

TsgcInvoiceValidator controleert een factuur aan de hand van de bedrijfsregels van EN 16931 en, op verzoek, aan de hand van de regelsets van XRechnung en Peppol BIS Billing 3.0. De regels zijn native gecodeerd en draaien op het model, voordat er XML wordt geschreven. Elke melding bevat het officiële regelnummer, de ernst, de bedrijfsterm, het pad van het veld in het model en de regeltekst, zodat de toepassing de gebruiker kan tonen welk veld moet worden gecorrigeerd.

Het onderstaande voorbeeld valideert dezelfde factuur twee keer. Eerst voldoet ze aan de EN 16931-regels, daarna wordt ze als XRechnung gecontroleerd, wat een contactpersoon van de verkoper vraagt die het kernmodel niet vereist. FillInvoice vult de factuur uit het eerste voorbeeld en voegt de straat en postcode van beide partijen toe, plus een SEPA-overschrijving, die XRechnung vereist. Log drukt een regel af.

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;

De tweede validatie geeft twee meldingen, BR-DE-2 Seller.Contact en BR-DE-TMP-32 Delivery.ActualDeliveryDate. De eerste is een fatale fout, de tweede is een waarschuwing. Zodra de contactpersoon en de leverdatum zijn ingesteld, slaagt de factuur zonder waarschuwingen.

Nationale formaten

Drie landen gebruiken een eigen factuurformaat en elk heeft een schrijver die dezelfde TsgcInvoice accepteert:

Ook twee Spaanse fiscale systemen worden ondersteund:

FormaatKlasseSchrijvenLezen
UBL 2.1 Invoice en CreditNoteTsgcInvoiceUBLJaJa
UN/CEFACT CII D16BTsgcInvoiceCIIJaJa
XRechnung, UBL of CIITsgcInvoiceDocumentJaJa
Peppol BIS Billing 3.0, UBLTsgcInvoiceDocumentJaJa
Factur-X / ZUGFeRD XML, vijf profielenTsgcInvoiceFacturXJaJa
Facturae 3.2, 3.2.1 en 3.2.2TsgcInvoiceFacturaeJaNee
FatturaPA 1.2.3TsgcInvoiceFatturaPAJaNee
KSeF FA(3)TsgcInvoiceKSeFJaNee
VeriFactu-recordsTsgcInvoiceVeriFactuJaNee
TicketBAI 1.2.2TsgcInvoiceTicketBAIJaNee

De factuur verzenden

Drie clients brengen het document naar de belastingdienst:

Verzenden via het Peppol-netwerk

Versie 2026.12 verzendt de factuur ook via het Peppol-netwerk, in Delphi en .NET. De onderdelen zijn aparte klassen, dus u kunt de hele keten gebruiken of slechts één stap ervan:

Er zijn geen externe bibliotheken nodig: de cryptografie-, XML- en AS4-code maken deel uit van de bibliotheek, voor Delphi 7 tot en met Delphi 13. Het voorbeeld hieronder verzendt een factuurbestand met 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;

Lees de vereisten voordat u een project rond deze functie plant. Verzenden op het Peppol-netwerk vereist een geaccrediteerd Peppol-toegangspunt (serviceprovider) met een toegangspuntcertificaat dat door OpenPeppol is uitgegeven. De bibliotheek implementeert het protocol en levert niet het certificaat of de accreditatie. Bedrijven die een serviceprovider gebruiken, verzenden normaal gesproken via die provider. De bibliotheek verzendt alleen: er is geen ontvangend toegangspunt en geen Peppol-rapportage. Het opzoeken van de deelnemer heeft geen certificaat nodig.

De verzender is getest op interoperabiliteit met de opensource AS4-server phase4 (versie 4.9.0) op een lokale test-PKI: elk bericht werd geaccepteerd en elke ontvangstbevestiging gecontroleerd, met de Delphi- en .NET-bibliotheken. Hij is niet uitgevoerd tegen een productie-toegangspunt of met echte Peppol-certificaten. De demo's Demos\Delphi\Peppol en Demos\CBuilder\Peppol worden met de bibliotheek meegeleverd.

Eén component voor de hele keten

TsgcInvoiceDocument voegt de stappen samen. Kies het formaat, vul de factuur in en roep Build aan. De component berekent de totalen, valideert met de regelsets van het formaat, schrijft het document en ondertekent het met het ondertekeningsprofiel van het formaat. Als de validatie mislukt, wordt er niets geschreven, en elke sgcSign-sleutelprovider kan het document ondertekenen.

Het onderstaande voorbeeld schrijft de Factur-X-XML in het EN 16931-profiel en ondertekent die met een certificaat uit een PFX-bestand.

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;

De component leest ook. LoadFromFile neemt een UBL- of CII-bestand, zet Format op wat het bestand is en vult het model, zodat een ontvangen factuur kan worden gevalideerd en in de andere syntaxis opnieuw kan worden geschreven.

Wat niet is inbegrepen

Deze eerste versie heeft beperkingen, en het is beter die te kennen voordat u er een project omheen plant.

Aan de slag

E-facturatie maakt deel uit van sgcSign vanaf versie 2026.12. Het is geen aparte editie: de units worden met sgcSign meegeleverd, met volledige broncode, voor Delphi 7 tot en met Delphi 13 en voor .NET. Een nieuwe EInvoice-demo in de map Demos vult in een formulier één getypeerde factuur in en bouwt die met één component in elk van de formaten.

E-facturatie op de productpagina · Download de proefversie · Changelog

Vragen of feedback? Neem contact op, u krijgt antwoord van de mensen die de code hebben geschreven.