Facturación electrónica en sgcSign 2026.12: crear, validar y firmar la factura

· Componentes
Facturación electrónica en sgcSign 2026.12, crear, validar y firmar facturas en Delphi y .NET

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:

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:

También se cubren dos sistemas fiscales españoles:

FormatoClaseEscrituraLectura
UBL 2.1, factura y factura rectificativaTsgcInvoiceUBLSíSí
UN/CEFACT CII D16BTsgcInvoiceCIISíSí
XRechnung, UBL o CIITsgcInvoiceDocumentSíSí
Peppol BIS Billing 3.0, UBLTsgcInvoiceDocumentSíSí
XML de Factur-X / ZUGFeRD, cinco perfilesTsgcInvoiceFacturXSíSí
Facturae 3.2, 3.2.1 y 3.2.2TsgcInvoiceFacturaeSíNo
FatturaPA 1.2.3TsgcInvoiceFatturaPASíNo
KSeF FA(3)TsgcInvoiceKSeFSíNo
Registros de VeriFactuTsgcInvoiceVeriFactuSíNo
TicketBAI 1.2.2TsgcInvoiceTicketBAISíNo

Enviar la factura

Tres clientes llevan el documento a la administración tributaria:

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:

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.

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.