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:
- XRechnung, in de UBL- of de CII-syntaxis.
- Peppol BIS Billing 3.0, in de UBL-syntaxis.
- Factur-X / ZUGFeRD, de XML van de vijf profielen: Minimum, Basic WL, Basic, EN 16931 en Extended, via
TsgcInvoiceFacturX.
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:
- Facturae, Spanje:
TsgcInvoiceFacturaeschrijft de versies 3.2, 3.2.1 en 3.2.2. - FatturaPA, Italië:
TsgcInvoiceFatturaPAschrijft versie 1.2.3 voor particuliere ontvangers (FPR12) en voor de overheid (FPA12). - KSeF, Polen:
TsgcInvoiceKSeFschrijft de gestructureerde factuur, schema FA(3).
Ook twee Spaanse fiscale systemen worden ondersteund:
- VeriFactu:
TsgcInvoiceVeriFactubouwt de registratie- en annuleringsrecords met de geketende SHA-256-hash, onderhoudt de keten tussen de records en levert de URL en de afbeelding van de QR-code. - TicketBAI:
TsgcInvoiceTicketBAIbouwt de factuur- en annuleringsbestanden van versie 1.2.2 met de keten naar de vorige factuur. Na het ondertekenen levert het de TBAI-identificatie en de QR-code.
| Formaat | Klasse | Schrijven | Lezen |
|---|---|---|---|
| UBL 2.1 Invoice en CreditNote | TsgcInvoiceUBL | Ja | Ja |
| UN/CEFACT CII D16B | TsgcInvoiceCII | Ja | Ja |
| XRechnung, UBL of CII | TsgcInvoiceDocument | Ja | Ja |
| Peppol BIS Billing 3.0, UBL | TsgcInvoiceDocument | Ja | Ja |
| Factur-X / ZUGFeRD XML, vijf profielen | TsgcInvoiceFacturX | Ja | Ja |
| Facturae 3.2, 3.2.1 en 3.2.2 | TsgcInvoiceFacturae | Ja | Nee |
| FatturaPA 1.2.3 | TsgcInvoiceFatturaPA | Ja | Nee |
| KSeF FA(3) | TsgcInvoiceKSeF | Ja | Nee |
| VeriFactu-records | TsgcInvoiceVeriFactu | Ja | Nee |
| TicketBAI 1.2.2 | TsgcInvoiceTicketBAI | Ja | Nee |
De factuur verzenden
Drie clients brengen het document naar de belastingdienst:
TsgcVeriFactuClientdient VeriFactu-records in bij de AEAT-webservice. Hij leest het resultaat van elk record, past de recordlimiet en de wachttijd tussen indieningen toe, raadpleegt ingediende records en bewaart de ontvangstbewijzen.TsgcSdIClientverstuurt een FatturaPA-bestand naar de webservice van het Italiaanse Sistema di Interscambio (SdI), controleert de regel voor de bestandsnaam en leest de notificatiebestanden die SdI terugstuurt.TsgcKSeFOnlineClientverstuurt facturen naar KSeF in een interactieve sessie: hij opent de sessie, verstuurt de factuur, leest de status en het KSeF-nummer, sluit de sessie en downloadt het UPO-ontvangstbewijs.
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:
TsgcPeppolSMPClientzoekt de deelnemer op via SML en SMP en controleert het ondertekende SMP-antwoord.TsgcPeppolSBDHensgcPeppolWrapInvoiceschrijven de Peppol-envelop voor zakelijke berichten, de SBDH.TsgcPeppolAS4MessageenTsgcPeppolAS4Receiptimplementeren het AS4-bericht van het Peppol AS4-profiel: ondertekend met RSA-SHA256, payload gecomprimeerd met gzip en versleuteld met AES-128-GCM, sleuteltransport met RSA-OAEP.TsgcPeppolClientdoet opzoeken, envelop, verzenden en controle van de ontvangstbevestiging in één aanroep, metSendInvoiceenResend. Hij bewaart de ondertekende ontvangstbevestiging en geeft een resultaatobject met foutcodes terug.
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.
- De nationale formaten zijn alleen schrijfbaar. UBL en CII, met hun varianten XRechnung, Peppol BIS en Factur-X, kunnen weer in het model worden ingelezen. Facturae, FatturaPA, KSeF, VeriFactu en TicketBAI niet.
- Verzenden via Peppol vereist een geaccrediteerd toegangspunt en is alleen verzenden. De bibliotheek implementeert het protocol en levert niet het toegangspuntcertificaat of de accreditatie. Er is geen ontvangend toegangspunt en geen Peppol-rapportage.
- Factur-X is alleen de XML. Een Factur-X- of ZUGFeRD-factuur is een PDF/A-3-bestand met deze XML erin ingebed. De component schrijft de XML en bedt die niet in een PDF/A-3-bestand in.
- KSeF-facturen worden door de component verzonden, niet ondertekend, omdat KSeF de factuur-XML niet ondertekent.
- De SdI-eindpunten zijn niet ingebouwd. SdI geeft zijn eindpunten aan de afzender tijdens de accreditatie van het kanaal, en u stelt ze in op de client.
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.
