Jusqu'à présent, sgcSign signait un XML de facture que votre application devait construire elle-même. Les profils par pays savaient signer un fichier Facturae, FatturaPA ou TicketBAI, mais le fichier devait d'abord exister, et l'écrire était votre travail.
À partir de sgcSign 2026.12, la bibliothèque construit aussi la facture. Vous remplissez une facture typée, la bibliothèque calcule les totaux, contrôle les règles de gestion et écrit le document dans le format demandé par le destinataire ou par l'administration fiscale. Les profils par pays signent le résultat, et trois clients l'envoient. Tout ce que décrit cet article est disponible à partir de sgcSign 2026.12, pour Delphi 7 à Delphi 13 et .NET, et il est inclus dans sgcSign.
La facturation électronique dans sgcSign en une minute : le modèle de facture, les formats, la validation et l'envoi via Peppol. Également sur YouTube.
Une facture typée sur EN 16931
TsgcInvoice est un modèle typé du modèle sémantique de données d'EN 16931 : vendeur, acheteur, bénéficiaire du paiement, paiement, lignes, remises et frais, ventilation de la TVA et totaux. Le modèle ne contient aucun XML, de sorte que la même facture peut être écrite dans plus d'une syntaxe. CalculateTotals renseigne les montants nets des lignes, la ventilation de la TVA et les totaux du document, si bien que l'application fixe les quantités, les prix et les taux de TVA sans rien additionner.
TsgcInvoiceUBL écrit et lit la facture (Invoice) et l'avoir (CreditNote) UBL 2.1. TsgcInvoiceCII écrit et lit la Cross Industry Invoice D16B d'UN/CEFACT. L'exemple ci-dessous remplit une facture, calcule les totaux, contrôle les règles d'EN 16931 et écrit un fichier UBL 2.1.
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 et Factur-X
La plupart des destinataires ne demandent pas EN 16931 tel quel, mais un profil de cette norme. sgcSign 2026.12 en écrit et en lit trois à partir du même modèle :
- XRechnung, dans la syntaxe UBL ou CII.
- Peppol BIS Billing 3.0, dans la syntaxe UBL.
- Factur-X / ZUGFeRD, le XML des cinq profils : Minimum, Basic WL, Basic, EN 16931 et Extended, via
TsgcInvoiceFacturX.
Écrire un profil ne modifie pas la facture : un même modèle peut donc être écrit en XRechnung pour un client et en Peppol BIS pour le suivant. Quand une facture arrive, sgcInvoiceReadAny détecte la syntaxe et le profil du fichier et le charge dans le modèle.
Validation avec les identifiants officiels des règles
TsgcInvoiceValidator contrôle une facture par rapport aux règles de gestion d'EN 16931 et, à la demande, aux jeux de règles de XRechnung et de Peppol BIS Billing 3.0. Les règles sont codées nativement et s'exécutent sur le modèle, avant l'écriture de tout XML. Chaque message porte l'identifiant officiel de la règle, la gravité, le terme métier, le chemin du champ dans le modèle et le texte de la règle, de sorte que l'application peut indiquer à l'utilisateur quel champ corriger.
L'exemple ci-dessous valide deux fois la même facture. Elle réussit les règles d'EN 16931, puis elle est contrôlée comme XRechnung, qui exige un contact du vendeur que le modèle de base ne demande pas. FillInvoice remplit la facture du premier exemple et ajoute la rue et le code postal des deux parties ainsi qu'un virement SEPA, qu'exige XRechnung. Log affiche une ligne.
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;
La seconde validation affiche deux messages, BR-DE-2 Seller.Contact et BR-DE-TMP-32 Delivery.ActualDeliveryDate. Le premier est une erreur fatale, le second un avertissement. Une fois le contact et la date de livraison renseignés, la facture est validée sans avertissement.
Formats nationaux
Trois pays utilisent un format de facture qui leur est propre, et chacun dispose d'un écrivain qui accepte la même TsgcInvoice :
- Facturae, Espagne :
TsgcInvoiceFacturaeécrit les versions 3.2, 3.2.1 et 3.2.2. - FatturaPA, Italie :
TsgcInvoiceFatturaPAécrit la version 1.2.3 pour les destinataires privés (FPR12) et pour l'administration publique (FPA12). - KSeF, Pologne :
TsgcInvoiceKSeFécrit la facture structurée, schéma FA(3).
Deux systèmes fiscaux espagnols sont également couverts :
- VeriFactu :
TsgcInvoiceVeriFactuconstruit les enregistrements de facturation et d'annulation avec l'empreinte SHA-256 chaînée, maintient la chaîne entre les enregistrements et produit l'URL et l'image du code QR. - TicketBAI :
TsgcInvoiceTicketBAIconstruit les fichiers de facture et d'annulation 1.2.2 avec le chaînage à la facture précédente. Après la signature, il fournit l'identifiant TBAI et le code QR.
| Format | Classe | Écriture | Lecture |
|---|---|---|---|
| UBL 2.1, facture et avoir | TsgcInvoiceUBL | Oui | Oui |
| UN/CEFACT CII D16B | TsgcInvoiceCII | Oui | Oui |
| XRechnung, UBL ou CII | TsgcInvoiceDocument | Oui | Oui |
| Peppol BIS Billing 3.0, UBL | TsgcInvoiceDocument | Oui | Oui |
| XML Factur-X / ZUGFeRD, cinq profils | TsgcInvoiceFacturX | Oui | Oui |
| Facturae 3.2, 3.2.1 et 3.2.2 | TsgcInvoiceFacturae | Oui | Non |
| FatturaPA 1.2.3 | TsgcInvoiceFatturaPA | Oui | Non |
| KSeF FA(3) | TsgcInvoiceKSeF | Oui | Non |
| Enregistrements VeriFactu | TsgcInvoiceVeriFactu | Oui | Non |
| TicketBAI 1.2.2 | TsgcInvoiceTicketBAI | Oui | Non |
Envoyer la facture
Trois clients transmettent le document à l'administration fiscale :
TsgcVeriFactuClientenvoie les enregistrements VeriFactu au service web de l'AEAT. Il lit le résultat de chaque enregistrement, applique la limite d'enregistrements et le délai d'attente entre les envois, interroge les enregistrements envoyés et conserve les accusés de réception.TsgcSdIClientenvoie un fichier FatturaPA au service web du Sistema di Interscambio (SdI) italien, vérifie la règle de nommage du fichier et lit les fichiers de notification que renvoie le SdI.TsgcKSeFOnlineClientenvoie les factures à KSeF dans une session interactive : il ouvre la session, envoie la facture, lit son statut et son numéro KSeF, ferme la session et télécharge l'accusé UPO.
Envoi sur le réseau Peppol
La version 2026.12 envoie aussi la facture sur le réseau Peppol, en Delphi et .NET. Les éléments sont des classes séparées, vous pouvez donc utiliser tout le flux ou une seule de ses étapes :
TsgcPeppolSMPClientrecherche le participant via SML et SMP et vérifie la réponse SMP signée.TsgcPeppolSBDHetsgcPeppolWrapInvoiceécrivent l'enveloppe de message métier Peppol, le SBDH.TsgcPeppolAS4MessageetTsgcPeppolAS4Receiptimplémentent le message AS4 du profil Peppol AS4 : signé avec RSA-SHA256, charge utile compressée avec gzip et chiffrée avec AES-128-GCM, transport de clé RSA-OAEP.TsgcPeppolClienteffectue la recherche, l'enveloppe, l'envoi et la vérification de l'accusé de réception en un seul appel, avecSendInvoiceetResend. Il conserve l'accusé signé et renvoie un objet résultat avec des codes d'erreur.
Aucune bibliothèque externe n'est nécessaire : le code de cryptographie, de XML et d'AS4 fait partie de la bibliothèque, pour Delphi 7 à Delphi 13. L'exemple ci-dessous envoie un fichier de facture avec 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;
Lisez les exigences avant de planifier un projet autour de cette fonction. L'envoi sur le réseau Peppol exige d'être un point d'accès Peppol accrédité (prestataire de services) avec un certificat de point d'accès délivré par OpenPeppol. La bibliothèque implémente le protocole et ne fournit ni le certificat ni l'accréditation. Les entreprises qui font appel à un prestataire envoient normalement par son intermédiaire. La bibliothèque ne fait qu'envoyer : il n'y a ni point d'accès récepteur ni reporting Peppol. La recherche du participant ne nécessite aucun certificat.
L'émetteur a été testé en interopérabilité avec le serveur AS4 open source phase4 (version 4.9.0) sur une PKI de test locale : chaque message a été accepté et chaque accusé de réception vérifié, avec les bibliothèques Delphi et .NET. Il n'a pas été exécuté sur un point d'accès de production ni avec de véritables certificats Peppol. Les démos Demos\Delphi\Peppol et Demos\CBuilder\Peppol sont fournies avec la bibliothèque.
Un composant pour tout le flux
TsgcInvoiceDocument réunit les étapes. Choisissez le format, remplissez la facture et appelez Build. Le composant calcule les totaux, valide avec les jeux de règles du format, écrit le document et le signe avec le profil de signature du format. Rien n'est écrit si la validation échoue, et n'importe quel fournisseur de clés de sgcSign peut signer le document.
L'exemple ci-dessous écrit le XML Factur-X au profil EN 16931 et le signe avec un certificat issu d'un fichier PFX.
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;
Le composant sait aussi lire. LoadFromFile accepte un fichier UBL ou CII, positionne Format sur celui du fichier et remplit le modèle, de sorte qu'une facture reçue peut être validée et réécrite dans l'autre syntaxe.
Ce qui n'est pas inclus
Le périmètre de cette première version a des limites, et mieux vaut les connaître avant de planifier un projet autour d'elle.
- Les formats nationaux sont en écriture seule. UBL et CII, avec leurs variantes XRechnung, Peppol BIS et Factur-X, peuvent être relus dans le modèle. Facturae, FatturaPA, KSeF, VeriFactu et TicketBAI ne le peuvent pas.
- L'envoi Peppol exige un point d'accès accrédité, et il se limite à l'envoi. La bibliothèque implémente le protocole et ne fournit ni le certificat du point d'accès ni l'accréditation. Il n'y a ni point d'accès récepteur ni reporting Peppol.
- Factur-X, c'est uniquement le XML. Une facture Factur-X ou ZUGFeRD est un fichier PDF/A-3 avec ce XML intégré. Le composant écrit le XML et ne l'intègre pas dans un fichier PDF/A-3.
- Les factures KSeF sont envoyées, mais pas signées, par le composant, car KSeF ne signe pas le XML de la facture.
- Les points d'accès du SdI ne sont pas intégrés. Le SdI communique ses points d'accès à l'émetteur lors de l'accréditation du canal, et vous les renseignez sur le client.
Comment l'obtenir
La facturation électronique fait partie de sgcSign à partir de la version 2026.12. Ce n'est pas une édition à part : les unités sont livrées avec sgcSign, avec le code source complet, pour Delphi 7 à Delphi 13 et .NET. Une nouvelle démo EInvoice dans le dossier Demos remplit une facture typée dans un formulaire et la construit dans chacun des formats avec un seul composant.
La facturation électronique sur la page produit · Télécharger la version d'essai · Historique des modifications
Des questions ou des retours ? Contactez-nous, vous recevrez une réponse de la part des personnes qui ont écrit le code.
