Fatturazione elettronica in sgcSign 2026.12: creare, validare e firmare la fattura

· Componenti
Fatturazione elettronica in sgcSign 2026.12, creare, validare e firmare fatture in Delphi e .NET

Finora sgcSign firmava un XML di fattura che la vostra applicazione doveva costruire da sola. I profili dei singoli paesi sapevano firmare un file Facturae, FatturaPA o TicketBAI, ma il file doveva esistere prima, e scriverlo era compito vostro.

Da sgcSign 2026.12 la libreria costruisce anche la fattura. Compilate una fattura tipizzata, la libreria calcola i totali, controlla le regole di business e scrive il documento nel formato richiesto dal destinatario o dall'amministrazione fiscale. I profili dei singoli paesi firmano il risultato e tre client lo inviano. Tutto ciò che è descritto in questo articolo è disponibile da sgcSign 2026.12, per Delphi 7 fino a Delphi 13 e .NET, ed è incluso in sgcSign.

Fatturazione elettronica in sgcSign in un minuto: il modello di fattura, i formati, la validazione e l'invio tramite Peppol. Anche su YouTube.

Una fattura tipizzata su EN 16931

TsgcInvoice è un modello tipizzato del modello semantico dei dati di EN 16931: venditore, acquirente, beneficiario del pagamento, pagamento, righe, sconti e addebiti, riepilogo dell'IVA e totali. Il modello non contiene XML, quindi la stessa fattura può essere scritta in più di una sintassi. CalculateTotals compila gli importi netti delle righe, il riepilogo dell'IVA e i totali del documento, così l'applicazione imposta quantità, prezzi e aliquote IVA e non somma nulla.

TsgcInvoiceUBL scrive e legge la fattura (Invoice) e la nota di credito (CreditNote) UBL 2.1. TsgcInvoiceCII scrive e legge la Cross Industry Invoice D16B di UN/CEFACT. L'esempio seguente compila una fattura, calcola i totali, controlla le regole di EN 16931 e scrive un file 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 e Factur-X

La maggior parte dei destinatari non chiede EN 16931 semplice, ma un suo profilo. sgcSign 2026.12 ne scrive e ne legge tre a partire dallo stesso modello:

Scrivere un profilo non modifica la fattura, quindi un unico modello può essere scritto come XRechnung per un cliente e come Peppol BIS per il successivo. Quando arriva una fattura, sgcInvoiceReadAny rileva la sintassi e il profilo del file e lo carica nel modello.

Validazione con gli identificativi ufficiali delle regole

TsgcInvoiceValidator controlla una fattura rispetto alle regole di business di EN 16931 e, su richiesta, rispetto ai set di regole di XRechnung e Peppol BIS Billing 3.0. Le regole sono codificate in modo nativo e vengono eseguite sul modello, prima che venga scritto qualsiasi XML. Ogni messaggio riporta l'identificativo ufficiale della regola, la gravità, il termine di business, il percorso del campo nel modello e il testo della regola, così l'applicazione può indicare all'utente quale campo correggere.

L'esempio seguente valida due volte la stessa fattura. Supera le regole di EN 16931, poi viene controllata come XRechnung, che richiede un contatto del venditore che il modello di base non esige. FillInvoice compila la fattura del primo esempio e aggiunge via e CAP di entrambe le parti e un bonifico SEPA, richiesto da XRechnung. Log stampa una riga.

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 seconda validazione stampa due messaggi, BR-DE-2 Seller.Contact e BR-DE-TMP-32 Delivery.ActualDeliveryDate. Il primo è un errore bloccante, il secondo un avviso. Una volta impostati il contatto e la data di consegna, la fattura supera i controlli senza avvisi.

Formati nazionali

Tre paesi usano un formato di fattura proprio, e ciascuno ha un writer che accetta la stessa TsgcInvoice:

Sono coperti anche due sistemi fiscali spagnoli:

FormatoClasseScritturaLettura
UBL 2.1, fattura e nota di creditoTsgcInvoiceUBLSìSì
UN/CEFACT CII D16BTsgcInvoiceCIISìSì
XRechnung, UBL o CIITsgcInvoiceDocumentSìSì
Peppol BIS Billing 3.0, UBLTsgcInvoiceDocumentSìSì
XML Factur-X / ZUGFeRD, cinque profiliTsgcInvoiceFacturXSìSì
Facturae 3.2, 3.2.1 e 3.2.2TsgcInvoiceFacturaeSìNo
FatturaPA 1.2.3TsgcInvoiceFatturaPASìNo
KSeF FA(3)TsgcInvoiceKSeFSìNo
Registrazioni VeriFactuTsgcInvoiceVeriFactuSìNo
TicketBAI 1.2.2TsgcInvoiceTicketBAISìNo

Inviare la fattura

Tre client portano il documento all'amministrazione fiscale:

Invio sulla rete Peppol

La versione 2026.12 invia la fattura anche sulla rete Peppol, in Delphi e .NET. Le parti sono classi separate, quindi si può usare l'intero flusso o uno solo dei suoi passi:

Non servono librerie esterne: il codice crittografico, XML e AS4 fa parte della libreria, per Delphi 7 fino a Delphi 13. L'esempio seguente invia un file di fattura con 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;

Leggete i requisiti prima di pianificare un progetto su questa funzione. L'invio sulla rete Peppol richiede di essere un access point Peppol accreditato (service provider) con un certificato di access point rilasciato da OpenPeppol. La libreria implementa il protocollo e non fornisce il certificato né l'accreditamento. Le aziende che usano un service provider normalmente inviano tramite quel provider. La libreria si limita all'invio: non esistono un access point ricevente né il reporting Peppol. La ricerca del partecipante non richiede certificati.

Il mittente è stato testato per l'interoperabilità con il server AS4 open source phase4 (versione 4.9.0) su una PKI di test locale: ogni messaggio è stato accettato e ogni ricevuta verificata, con le librerie Delphi e .NET. Non è stato eseguito contro un access point di produzione né con certificati Peppol reali. Le demo Demos\Delphi\Peppol e Demos\CBuilder\Peppol sono incluse nella libreria.

Un solo componente per l'intero flusso

TsgcInvoiceDocument riunisce i passaggi. Scegliete il formato, compilate la fattura e chiamate Build. Il componente calcola i totali, valida con i set di regole del formato, scrive il documento e lo firma con il profilo di firma del formato. Se la validazione fallisce non viene scritto nulla, e qualsiasi key provider di sgcSign può firmare il documento.

L'esempio seguente scrive l'XML Factur-X nel profilo EN 16931 e lo firma con un certificato preso da un file 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;

Il componente sa anche leggere. LoadFromFile accetta un file UBL o CII, imposta Format sul formato del file e compila il modello, così una fattura ricevuta può essere validata e scritta di nuovo nell'altra sintassi.

Cosa non è incluso

L'ambito di questa prima versione ha dei limiti, ed è meglio conoscerli prima di pianificare un progetto su di essa.

Come ottenerlo

La fatturazione elettronica fa parte di sgcSign dalla versione 2026.12. Non è un'edizione separata: le unit sono distribuite con sgcSign, con il codice sorgente completo, per Delphi 7 fino a Delphi 13 e .NET. Una nuova demo EInvoice nella cartella Demos compila una fattura tipizzata in un form e la costruisce in ciascuno dei formati con un solo componente.

La fatturazione elettronica nella pagina del prodotto · Scarica la versione di prova · Cronologia delle modifiche

Domande o feedback? Mettetevi in contatto, riceverete una risposta da chi ha scritto il codice.