Fatura eletrônica no sgcSign 2026.12: gerar, validar e assinar a fatura

· Componentes
Fatura eletrônica no sgcSign 2026.12, gere, valide e assine faturas em Delphi e .NET

Até agora, o sgcSign assinava um XML de fatura que a sua aplicação precisava montar por conta própria. Os perfis de cada país sabiam assinar um arquivo Facturae, FatturaPA ou TicketBAI, mas o arquivo tinha de existir antes, e gerá-lo era tarefa sua.

A partir do sgcSign 2026.12, a biblioteca também gera a fatura. Você preenche uma fatura tipada, a biblioteca calcula os totais, verifica as regras de negócio e grava o documento no formato exigido pelo destinatário ou pela autoridade tributária. Os perfis de cada país assinam o resultado e três clientes o enviam. Tudo o que é descrito neste artigo está disponível a partir do sgcSign 2026.12, para Delphi 7 a Delphi 13 e .NET, e está incluído no sgcSign.

Faturamento eletrônico no sgcSign em um minuto: o modelo de fatura, os formatos, a validação e o envio pelo Peppol. Também no YouTube.

Uma fatura tipada baseada na EN 16931

TsgcInvoice é um modelo tipado do modelo semântico de dados da EN 16931: vendedor, comprador, beneficiário, pagamento, linhas, descontos e encargos, detalhamento do IVA e totais. O modelo não contém XML, de modo que a mesma fatura pode ser gravada em mais de uma sintaxe. CalculateTotals preenche os valores líquidos das linhas, o detalhamento do IVA e os totais do documento, e assim a aplicação define apenas quantidades, preços e alíquotas de IVA, sem somar nada.

TsgcInvoiceUBL grava e lê a Invoice e a CreditNote (nota de crédito) do UBL 2.1. TsgcInvoiceCII grava e lê a Cross Industry Invoice D16B da UN/CEFACT. O exemplo abaixo preenche uma fatura, calcula os totais, verifica as regras da EN 16931 e grava um arquivo 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

A maioria dos destinatários não pede a EN 16931 pura. Pede um perfil dela. O sgcSign 2026.12 grava e lê três deles a partir do mesmo modelo:

Gravar um perfil não altera a fatura, portanto um mesmo modelo pode ser gravado como XRechnung para um cliente e como Peppol BIS para o seguinte. Quando uma fatura chega, sgcInvoiceReadAny detecta a sintaxe e o perfil do arquivo e o carrega no modelo.

Validação com os identificadores oficiais das regras

TsgcInvoiceValidator verifica uma fatura segundo as regras de negócio da EN 16931 e, quando solicitado, segundo os conjuntos de regras da XRechnung e do Peppol BIS Billing 3.0. As regras são codificadas de forma nativa e executadas sobre o modelo, antes de qualquer XML ser gravado. Cada mensagem traz o identificador oficial da regra, a gravidade, o termo de negócio, o caminho do campo no modelo e o texto da regra, de modo que a aplicação pode mostrar ao usuário qual campo corrigir.

O exemplo abaixo valida a mesma fatura duas vezes. Ela passa nas regras da EN 16931 e depois é verificada como XRechnung, que exige um contato do vendedor que o modelo básico não exige. FillInvoice preenche a fatura do primeiro exemplo e acrescenta a rua e o código postal das duas partes e uma transferência SEPA, exigida pela XRechnung. Log imprime uma linha.

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;

A segunda validação imprime duas mensagens, BR-DE-2 Seller.Contact e BR-DE-TMP-32 Delivery.ActualDeliveryDate. A primeira é um erro fatal, a segunda é um aviso. Depois de definidos o contato e a data de entrega, a fatura passa sem avisos.

Formatos nacionais

Três países usam um formato de fatura próprio, e cada um tem um gravador que recebe a mesma TsgcInvoice:

Dois sistemas fiscais espanhóis também são cobertos:

FormatoClasseGravaçãoLeitura
UBL 2.1 Invoice e CreditNoteTsgcInvoiceUBLSimSim
UN/CEFACT CII D16BTsgcInvoiceCIISimSim
XRechnung, UBL ou CIITsgcInvoiceDocumentSimSim
Peppol BIS Billing 3.0, UBLTsgcInvoiceDocumentSimSim
Factur-X / ZUGFeRD XML, cinco perfisTsgcInvoiceFacturXSimSim
Facturae 3.2, 3.2.1 e 3.2.2TsgcInvoiceFacturaeSimNão
FatturaPA 1.2.3TsgcInvoiceFatturaPASimNão
KSeF FA(3)TsgcInvoiceKSeFSimNão
Registros VeriFactuTsgcInvoiceVeriFactuSimNão
TicketBAI 1.2.2TsgcInvoiceTicketBAISimNão

Enviando a fatura

Três clientes levam o documento até a autoridade tributária:

Envio pela rede Peppol

A versão 2026.12 também envia a fatura pela rede Peppol, em Delphi e .NET. As partes são classes separadas, portanto você pode usar o fluxo inteiro ou apenas uma de suas etapas:

Nenhuma biblioteca externa é necessária: o código de criptografia, XML e AS4 faz parte da biblioteca, para Delphi 7 a Delphi 13. O exemplo abaixo envia um arquivo de fatura com 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;

Leia os requisitos antes de planejar um projeto em torno deste recurso. O envio na rede Peppol exige ser um ponto de acesso Peppol credenciado (provedor de serviços) com um certificado de ponto de acesso emitido pela OpenPeppol. A biblioteca implementa o protocolo e não fornece o certificado nem o credenciamento. As empresas que usam um provedor de serviços normalmente enviam por meio dele. A biblioteca apenas envia: não há ponto de acesso receptor nem relatórios Peppol. A consulta do participante não precisa de certificado.

O remetente foi testado quanto à interoperabilidade com o servidor AS4 de código aberto phase4 (versão 4.9.0) em uma PKI de teste local: toda mensagem foi aceita e todo recibo verificado, com as bibliotecas Delphi e .NET. Ele não foi executado em um ponto de acesso de produção nem com certificados Peppol reais. As demos Demos\Delphi\Peppol e Demos\CBuilder\Peppol acompanham a biblioteca.

Um componente para todo o fluxo

TsgcInvoiceDocument reúne as etapas. Escolha o formato, preencha a fatura e chame Build. O componente calcula os totais, valida com os conjuntos de regras do formato, grava o documento e o assina com o perfil de assinatura do formato. Nada é gravado quando a validação falha, e qualquer provedor de chaves do sgcSign pode assinar o documento.

O exemplo abaixo grava o XML Factur-X no perfil EN 16931 e o assina com um certificado de um arquivo 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;

O componente também lê. LoadFromFile recebe um arquivo UBL ou CII, define Format conforme o arquivo e preenche o modelo, de modo que uma fatura recebida pode ser validada e gravada novamente na outra sintaxe.

O que não está incluído

O escopo desta primeira versão tem limites, e é melhor conhecê-los antes de planejar um projeto em torno dela.

Como obter

A fatura eletrônica faz parte do sgcSign a partir da versão 2026.12. Não é uma edição separada: as units acompanham o sgcSign, com o código-fonte completo, para Delphi 7 a Delphi 13 e .NET. Uma nova demo EInvoice na pasta Demos preenche uma fatura tipada em um formulário e a gera em cada um dos formatos com um único componente.

Fatura eletrônica na página do produto · Baixe a versão de avaliação · Histórico de alterações

Dúvidas ou comentários? Entre em contato, você receberá a resposta das pessoas que escreveram o código.