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:
- XRechnung, nella sintassi UBL o CII.
- Peppol BIS Billing 3.0, nella sintassi UBL.
- Factur-X / ZUGFeRD, l'XML dei cinque profili: Minimum, Basic WL, Basic, EN 16931 ed Extended, tramite
TsgcInvoiceFacturX.
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:
- Facturae, Spagna:
TsgcInvoiceFacturaescrive le versioni 3.2, 3.2.1 e 3.2.2. - FatturaPA, Italia:
TsgcInvoiceFatturaPAscrive la versione 1.2.3 per i destinatari privati (FPR12) e per la pubblica amministrazione (FPA12). - KSeF, Polonia:
TsgcInvoiceKSeFscrive la fattura strutturata, schema FA(3).
Sono coperti anche due sistemi fiscali spagnoli:
- VeriFactu:
TsgcInvoiceVeriFactucostruisce i record di registrazione e di annullamento con l'hash SHA-256 concatenato, mantiene la catena tra i record e produce l'URL e l'immagine del codice QR. - TicketBAI:
TsgcInvoiceTicketBAIcostruisce i file di fattura e di annullamento 1.2.2 con il collegamento alla fattura precedente. Dopo la firma restituisce l'identificativo TBAI e il codice QR.
| Formato | Classe | Scrittura | Lettura |
|---|---|---|---|
| UBL 2.1, fattura e nota di credito | TsgcInvoiceUBL | Sì | Sì |
| UN/CEFACT CII D16B | TsgcInvoiceCII | Sì | Sì |
| XRechnung, UBL o CII | TsgcInvoiceDocument | Sì | Sì |
| Peppol BIS Billing 3.0, UBL | TsgcInvoiceDocument | Sì | Sì |
| XML Factur-X / ZUGFeRD, cinque profili | TsgcInvoiceFacturX | Sì | Sì |
| Facturae 3.2, 3.2.1 e 3.2.2 | TsgcInvoiceFacturae | Sì | No |
| FatturaPA 1.2.3 | TsgcInvoiceFatturaPA | Sì | No |
| KSeF FA(3) | TsgcInvoiceKSeF | Sì | No |
| Registrazioni VeriFactu | TsgcInvoiceVeriFactu | Sì | No |
| TicketBAI 1.2.2 | TsgcInvoiceTicketBAI | Sì | No |
Inviare la fattura
Tre client portano il documento all'amministrazione fiscale:
TsgcVeriFactuClientinvia i record VeriFactu al web service dell'AEAT. Legge l'esito di ogni record, applica il limite di record e il tempo di attesa tra gli invii, interroga i record inviati e conserva le ricevute.TsgcSdIClientinvia un file FatturaPA al web service del Sistema di Interscambio (SdI), controlla la regola sul nome del file e legge i file di notifica che il SdI restituisce.TsgcKSeFOnlineClientinvia le fatture a KSeF in una sessione interattiva: apre la sessione, invia la fattura, legge il suo stato e il suo numero KSeF, chiude la sessione e scarica la ricevuta UPO.
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:
TsgcPeppolSMPClientcerca il partecipante tramite SML e SMP e verifica la risposta SMP firmata.TsgcPeppolSBDHesgcPeppolWrapInvoicescrivono la busta del messaggio di business Peppol, l'SBDH.TsgcPeppolAS4MessageeTsgcPeppolAS4Receiptimplementano il messaggio AS4 del profilo Peppol AS4: firmato con RSA-SHA256, payload compresso con gzip e cifrato con AES-128-GCM, trasporto della chiave con RSA-OAEP.TsgcPeppolClientesegue ricerca, busta, invio e verifica della ricevuta in una sola chiamata, conSendInvoiceeResend. Conserva la ricevuta firmata e restituisce un oggetto risultato con codici di errore.
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.
- I formati nazionali sono solo in scrittura. UBL e CII, con le loro varianti XRechnung, Peppol BIS e Factur-X, possono essere riletti nel modello. Facturae, FatturaPA, KSeF, VeriFactu e TicketBAI no.
- L'invio Peppol richiede un access point accreditato, ed è solo invio. La libreria implementa il protocollo e non fornisce il certificato dell'access point né l'accreditamento. Non esistono un access point ricevente né il reporting Peppol.
- Factur-X è solo l'XML. Una fattura Factur-X o ZUGFeRD è un file PDF/A-3 con questo XML incorporato. Il componente scrive l'XML e non lo incorpora in un file PDF/A-3.
- Le fatture KSeF vengono inviate, ma non firmate, dal componente, perché KSeF non firma l'XML della fattura.
- Gli endpoint del SdI non sono integrati. Il SdI comunica i suoi endpoint al mittente durante l'accreditamento del canale, e voi li impostate sul client.
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.
