Facturation électronique dans sgcSign 2026.12 : créer, valider et signer la facture

· Composants
Facturation électronique dans sgcSign 2026.12, créer, valider et signer des factures en Delphi et .NET

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 :

É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 :

Deux systèmes fiscaux espagnols sont également couverts :

FormatClasseÉcritureLecture
UBL 2.1, facture et avoirTsgcInvoiceUBLOuiOui
UN/CEFACT CII D16BTsgcInvoiceCIIOuiOui
XRechnung, UBL ou CIITsgcInvoiceDocumentOuiOui
Peppol BIS Billing 3.0, UBLTsgcInvoiceDocumentOuiOui
XML Factur-X / ZUGFeRD, cinq profilsTsgcInvoiceFacturXOuiOui
Facturae 3.2, 3.2.1 et 3.2.2TsgcInvoiceFacturaeOuiNon
FatturaPA 1.2.3TsgcInvoiceFatturaPAOuiNon
KSeF FA(3)TsgcInvoiceKSeFOuiNon
Enregistrements VeriFactuTsgcInvoiceVeriFactuOuiNon
TicketBAI 1.2.2TsgcInvoiceTicketBAIOuiNon

Envoyer la facture

Trois clients transmettent le document à l'administration fiscale :

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 :

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.

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.