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:
- XRechnung, na sintaxe UBL ou CII.
- Peppol BIS Billing 3.0, na sintaxe UBL.
- Factur-X / ZUGFeRD, o XML dos cinco perfis: Minimum, Basic WL, Basic, EN 16931 e Extended, por meio de
TsgcInvoiceFacturX.
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:
- Facturae, Espanha:
TsgcInvoiceFacturaegrava as versões 3.2, 3.2.1 e 3.2.2. - FatturaPA, Itália:
TsgcInvoiceFatturaPAgrava a versão 1.2.3 para destinatários privados (FPR12) e para a administração pública (FPA12). - KSeF, Polônia:
TsgcInvoiceKSeFgrava a fatura estruturada, esquema FA(3).
Dois sistemas fiscais espanhóis também são cobertos:
- VeriFactu:
TsgcInvoiceVeriFactumonta os registros de emissão e de cancelamento com o hash SHA-256 encadeado, mantém a cadeia entre os registros e produz a URL e a imagem do código QR. - TicketBAI:
TsgcInvoiceTicketBAImonta os arquivos de fatura e de cancelamento da versão 1.2.2, com o encadeamento à fatura anterior. Depois da assinatura, fornece o identificador TBAI e o código QR.
| Formato | Classe | Gravação | Leitura |
|---|---|---|---|
| UBL 2.1 Invoice e CreditNote | TsgcInvoiceUBL | Sim | Sim |
| UN/CEFACT CII D16B | TsgcInvoiceCII | Sim | Sim |
| XRechnung, UBL ou CII | TsgcInvoiceDocument | Sim | Sim |
| Peppol BIS Billing 3.0, UBL | TsgcInvoiceDocument | Sim | Sim |
| Factur-X / ZUGFeRD XML, cinco perfis | TsgcInvoiceFacturX | Sim | Sim |
| Facturae 3.2, 3.2.1 e 3.2.2 | TsgcInvoiceFacturae | Sim | Não |
| FatturaPA 1.2.3 | TsgcInvoiceFatturaPA | Sim | Não |
| KSeF FA(3) | TsgcInvoiceKSeF | Sim | Não |
| Registros VeriFactu | TsgcInvoiceVeriFactu | Sim | Não |
| TicketBAI 1.2.2 | TsgcInvoiceTicketBAI | Sim | Não |
Enviando a fatura
Três clientes levam o documento até a autoridade tributária:
TsgcVeriFactuClientenvia os registros VeriFactu ao serviço web da AEAT. Ele lê o resultado de cada registro, aplica o limite de registros e o tempo de espera entre envios, consulta registros enviados e armazena os recibos.TsgcSdIClientenvia um arquivo FatturaPA ao serviço web do Sistema di Interscambio (SdI) italiano, verifica a regra do nome do arquivo e lê os arquivos de notificação que o SdI devolve.TsgcKSeFOnlineClientenvia faturas ao KSeF em uma sessão interativa: abre a sessão, envia a fatura, lê seu status e o número KSeF, fecha a sessão e baixa o recibo UPO.
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:
TsgcPeppolSMPClientconsulta o participante por SML e SMP e verifica a resposta SMP assinada.TsgcPeppolSBDHesgcPeppolWrapInvoicegravam o envelope de mensagem de negócio Peppol, o SBDH.TsgcPeppolAS4MessageeTsgcPeppolAS4Receiptimplementam a mensagem AS4 do perfil Peppol AS4: assinada com RSA-SHA256, payload compactado com gzip e criptografado com AES-128-GCM, transporte de chave RSA-OAEP.TsgcPeppolClientfaz consulta, envelope, envio e verificação do recibo em uma única chamada, comSendInvoiceeResend. Ele armazena o recibo assinado e retorna um objeto de resultado com códigos de erro.
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.
- Os formatos nacionais são somente de gravação. UBL e CII, com suas variantes XRechnung, Peppol BIS e Factur-X, podem ser lidos de volta para o modelo. Facturae, FatturaPA, KSeF, VeriFactu e TicketBAI não podem.
- O envio Peppol exige um ponto de acesso credenciado e é somente envio. A biblioteca implementa o protocolo e não fornece o certificado do ponto de acesso nem o credenciamento. Não há ponto de acesso receptor nem relatórios Peppol.
- O Factur-X é apenas o XML. Uma fatura Factur-X ou ZUGFeRD é um arquivo PDF/A-3 com esse XML incorporado. O componente grava o XML e não o incorpora em um arquivo PDF/A-3.
- As faturas KSeF são enviadas, e não assinadas, pelo componente, porque o KSeF não assina o XML da fatura.
- Os endpoints do SdI não são embutidos. O SdI informa seus endpoints ao remetente durante o credenciamento do canal, e você os define no cliente.
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.
