Hasta ahora sgcSign firmaba un XML de factura que su aplicación tenía que construir por su cuenta. Los perfiles de cada país sabían firmar un archivo Facturae, FatturaPA o TicketBAI, pero el archivo tenía que existir antes, y escribirlo era trabajo suyo.
Desde sgcSign 2026.12 la biblioteca también construye la factura. Usted rellena una factura tipada, la biblioteca calcula los totales, comprueba las reglas de negocio y escribe el documento en el formato que pide el receptor o la administración tributaria. Los perfiles de cada país firman el resultado y tres clientes lo envían. Todo lo que se describe en este artículo está disponible desde sgcSign 2026.12, para Delphi 7 a Delphi 13 y .NET, y está incluido en sgcSign.
Facturación electrónica en sgcSign en un minuto: el modelo de factura, los formatos, la validación y el envío por Peppol. También en YouTube.
Una factura tipada sobre EN 16931
TsgcInvoice es un modelo tipado del modelo semántico de datos de EN 16931: vendedor, comprador, beneficiario del pago, pago, líneas, descuentos y cargos, desglose del IVA y totales. El modelo no contiene XML, de modo que la misma factura puede escribirse en más de una sintaxis. CalculateTotals rellena los importes netos de las líneas, el desglose del IVA y los totales del documento, así que la aplicación indica cantidades, precios y tipos de IVA y no suma nada.
TsgcInvoiceUBL escribe y lee la factura (Invoice) y la factura rectificativa (CreditNote) de UBL 2.1. TsgcInvoiceCII escribe y lee la Cross Industry Invoice D16B de UN/CEFACT. El ejemplo siguiente rellena una factura, calcula los totales, comprueba las reglas de EN 16931 y escribe un archivo 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 y Factur-X
La mayoría de los receptores no piden EN 16931 sin más, piden un perfil de la norma. sgcSign 2026.12 escribe y lee tres de ellos a partir del mismo modelo:
- XRechnung, en la sintaxis UBL o CII.
- Peppol BIS Billing 3.0, en la sintaxis UBL.
- Factur-X / ZUGFeRD, el XML de los cinco perfiles: Minimum, Basic WL, Basic, EN 16931 y Extended, mediante
TsgcInvoiceFacturX.
Escribir un perfil no modifica la factura, por lo que un mismo modelo puede escribirse como XRechnung para un cliente y como Peppol BIS para el siguiente. Cuando llega una factura, sgcInvoiceReadAny detecta la sintaxis y el perfil del archivo y lo carga en el modelo.
Validación con los identificadores oficiales de las reglas
TsgcInvoiceValidator comprueba una factura contra las reglas de negocio de EN 16931 y, si se lo pide, contra los conjuntos de reglas de XRechnung y Peppol BIS Billing 3.0. Las reglas están codificadas de forma nativa y se ejecutan sobre el modelo, antes de escribir ningún XML. Cada mensaje incluye el identificador oficial de la regla, la gravedad, el término de negocio, la ruta del campo en el modelo y el texto de la regla, de modo que la aplicación puede indicar al usuario qué campo debe corregir.
El ejemplo siguiente valida la misma factura dos veces. Primero supera las reglas de EN 16931 y después se comprueba como XRechnung, que exige un contacto del vendedor que el modelo básico no requiere. FillInvoice rellena la factura del primer ejemplo y añade la calle y el código postal de ambas partes y una transferencia SEPA, que XRechnung exige. Log imprime una línea.
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 segunda validación imprime dos mensajes, BR-DE-2 Seller.Contact y BR-DE-TMP-32 Delivery.ActualDeliveryDate. El primero es un error grave y el segundo es una advertencia. Una vez indicados el contacto y la fecha de entrega, la factura se valida sin advertencias.
Formatos nacionales
Tres países usan un formato de factura propio, y cada uno tiene un escritor que recibe el mismo TsgcInvoice:
- Facturae, España:
TsgcInvoiceFacturaeescribe las versiones 3.2, 3.2.1 y 3.2.2. - FatturaPA, Italia:
TsgcInvoiceFatturaPAescribe la versión 1.2.3 para destinatarios privados (FPR12) y para la administración pública (FPA12). - KSeF, Polonia:
TsgcInvoiceKSeFescribe la factura estructurada, esquema FA(3).
También se cubren dos sistemas fiscales españoles:
- VeriFactu:
TsgcInvoiceVeriFactuconstruye los registros de alta y de anulación con el hash SHA-256 encadenado, mantiene la cadena entre registros y genera la URL y la imagen del código QR. - TicketBAI:
TsgcInvoiceTicketBAIconstruye los archivos de factura y de anulación 1.2.2 con el encadenamiento a la factura anterior. Tras la firma entrega el identificador TBAI y el código QR.
| Formato | Clase | Escritura | Lectura |
|---|---|---|---|
| UBL 2.1, factura y factura rectificativa | 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 de Factur-X / ZUGFeRD, cinco perfiles | TsgcInvoiceFacturX | Sí | Sí |
| Facturae 3.2, 3.2.1 y 3.2.2 | TsgcInvoiceFacturae | Sí | No |
| FatturaPA 1.2.3 | TsgcInvoiceFatturaPA | Sí | No |
| KSeF FA(3) | TsgcInvoiceKSeF | Sí | No |
| Registros de VeriFactu | TsgcInvoiceVeriFactu | Sí | No |
| TicketBAI 1.2.2 | TsgcInvoiceTicketBAI | Sí | No |
Enviar la factura
Tres clientes llevan el documento a la administración tributaria:
TsgcVeriFactuClientenvía los registros de VeriFactu al servicio web de la AEAT. Lee el resultado de cada registro, aplica el límite de registros y el tiempo de espera entre envíos, consulta los registros enviados y guarda los justificantes.TsgcSdIClientenvía un archivo FatturaPA al servicio web del Sistema di Interscambio (SdI) italiano, comprueba la regla del nombre de archivo y lee los archivos de notificación que devuelve el SdI.TsgcKSeFOnlineClientenvía facturas a KSeF en una sesión interactiva: abre la sesión, envía la factura, lee su estado y su número de KSeF, cierra la sesión y descarga el justificante UPO.
Envío por la red Peppol
La versión 2026.12 también envía la factura por la red Peppol, en Delphi y .NET. Las piezas son clases independientes, de modo que se puede usar todo el flujo o solo uno de sus pasos:
TsgcPeppolSMPClientbusca al participante mediante SML y SMP y verifica la respuesta SMP firmada.TsgcPeppolSBDHysgcPeppolWrapInvoiceescriben el sobre del mensaje de negocio de Peppol, el SBDH.TsgcPeppolAS4MessageyTsgcPeppolAS4Receiptimplementan el mensaje AS4 del perfil Peppol AS4: firmado con RSA-SHA256, carga útil comprimida con gzip y cifrada con AES-128-GCM, transporte de la clave con RSA-OAEP.TsgcPeppolClientrealiza la búsqueda, el sobre, el envío y la verificación del acuse en una sola llamada, conSendInvoiceyResend. Guarda el acuse firmado y devuelve un objeto de resultado con códigos de error.
No hacen falta bibliotecas externas: el código criptográfico, XML y AS4 forma parte de la biblioteca, para Delphi 7 a Delphi 13. El ejemplo siguiente envía un archivo de factura 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;
Lea los requisitos antes de planificar un proyecto en torno a esto. Enviar por la red Peppol exige ser un punto de acceso Peppol acreditado (proveedor de servicios) con un certificado de punto de acceso emitido por OpenPeppol. La biblioteca implementa el protocolo y no proporciona el certificado ni la acreditación. Las empresas que usan un proveedor de servicios normalmente envían a través de él. La biblioteca solo envía: no hay punto de acceso receptor ni informes Peppol. La búsqueda del participante no necesita certificado.
El emisor se probó para la interoperabilidad con el servidor AS4 de código abierto phase4 (versión 4.9.0) en una PKI de pruebas local: todos los mensajes fueron aceptados y todos los acuses verificados, con las bibliotecas Delphi y .NET. No se ha ejecutado contra un punto de acceso de producción ni con certificados Peppol reales. Las demos Demos\Delphi\Peppol y Demos\CBuilder\Peppol se incluyen con la biblioteca.
Un componente para todo el flujo
TsgcInvoiceDocument reúne los pasos. Elija el formato, rellene la factura y llame a Build. El componente calcula los totales, valida con los conjuntos de reglas del formato, escribe el documento y lo firma con el perfil de firma del formato. No se escribe nada si la validación falla, y cualquier proveedor de claves de sgcSign puede firmar el documento.
El ejemplo siguiente escribe el XML de Factur-X en el perfil EN 16931 y lo firma con un certificado de un archivo 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;
El componente también lee. LoadFromFile admite un archivo UBL o CII, asigna a Format el formato del archivo y rellena el modelo, de manera que una factura recibida puede validarse y escribirse de nuevo en la otra sintaxis.
Qué no está incluido
El alcance de esta primera versión tiene límites, y conviene conocerlos antes de planificar un proyecto a su alrededor.
- Los formatos nacionales son solo de escritura. UBL y CII, con sus variantes XRechnung, Peppol BIS y Factur-X, pueden leerse de nuevo en el modelo. Facturae, FatturaPA, KSeF, VeriFactu y TicketBAI no.
- El envío por Peppol exige un punto de acceso acreditado, y es solo envío. La biblioteca implementa el protocolo y no proporciona el certificado del punto de acceso ni la acreditación. No hay punto de acceso receptor ni informes Peppol.
- Factur-X es solo el XML. Una factura Factur-X o ZUGFeRD es un archivo PDF/A-3 con este XML incrustado. El componente escribe el XML y no lo incrusta en un archivo PDF/A-3.
- El componente envía las facturas de KSeF, pero no las firma, porque KSeF no firma el XML de la factura.
- Los puntos de acceso del SdI no están integrados. El SdI entrega sus puntos de acceso al emisor durante la acreditación del canal, y usted los indica en el cliente.
Cómo obtenerlo
La facturación electrónica forma parte de sgcSign desde la versión 2026.12. No es una edición aparte: las unidades se distribuyen con sgcSign, con el código fuente completo, para Delphi 7 a Delphi 13 y .NET. Una nueva demo EInvoice en la carpeta Demos rellena una factura tipada en un formulario y la construye en cada uno de los formatos con un único componente.
La facturación electrónica en la página del producto · Descargar la versión de prueba · Historial de cambios
¿Preguntas o comentarios? Póngase en contacto con nosotros, le responderán las personas que escribieron el código.
