sgcSign 2026.12'de E-Fatura: Faturayı Oluşturun, Doğrulayın ve İmzalayın

· Bileşenler
sgcSign 2026.12'de e-fatura, Delphi ve .NET'te fatura oluşturma, doğrulama ve imzalama

Şimdiye kadar sgcSign, uygulamanızın kendisinin oluşturması gereken bir fatura XML'ini imzalıyordu. Ülke profilleri bir Facturae, FatturaPA veya TicketBAI dosyasını nasıl imzalayacağını biliyordu, ancak dosyanın önceden var olması gerekiyordu ve onu yazmak sizin işinizdi.

sgcSign 2026.12 ile birlikte kütüphane faturayı da oluşturuyor. Türü belirli bir faturayı doldurursunuz, kütüphane toplamları hesaplar, iş kurallarını denetler ve belgeyi alıcının veya vergi idaresinin istediği biçimde yazar. Ülke profilleri sonucu imzalar, üç istemci de gönderir. Bu yazıda anlatılan her şey sgcSign 2026.12 ile birlikte Delphi 7'den Delphi 13'e ve .NET için kullanılabilir ve sgcSign'a dahildir.

sgcSign ile e-fatura bir dakikada: fatura modeli, formatlar, doğrulama ve Peppol ile gönderim. YouTube'da da izleyin.

EN 16931 Üzerinde Türlü Bir Fatura

TsgcInvoice, EN 16931 anlamsal veri modelinin türlü bir modelidir: satıcı, alıcı, ödemeyi alan, ödeme, kalemler, indirimler ve ek ücretler, KDV dökümü ve toplamlar. Model XML tutmaz, bu nedenle aynı fatura birden fazla sözdiziminde yazılabilir. CalculateTotals kalem net tutarlarını, KDV dökümünü ve belge toplamlarını doldurur, böylece uygulama miktarları, fiyatları ve KDV oranlarını belirler, hiçbir şeyi kendisi toplamaz.

TsgcInvoiceUBL, UBL 2.1 Invoice ve CreditNote belgelerini yazar ve okur. TsgcInvoiceCII, UN/CEFACT Cross Industry Invoice D16B belgesini yazar ve okur. Aşağıdaki örnek bir faturayı doldurur, toplamları hesaplar, EN 16931 kurallarını denetler ve bir UBL 2.1 dosyası yazar.

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 ve Factur-X

Çoğu alıcı yalın EN 16931 istemez, onun bir profilini ister. sgcSign 2026.12 aynı modelden üç profili yazar ve okur:

Bir profil yazmak faturayı değiştirmez, dolayısıyla tek bir model bir müşteri için XRechnung, bir sonraki için Peppol BIS olarak yazılabilir. Bir fatura geldiğinde sgcInvoiceReadAny dosyanın sözdizimini ve profilini algılar ve modele yükler.

Resmi Kural Kimlikleriyle Doğrulama

TsgcInvoiceValidator, bir faturayı EN 16931 iş kurallarına göre, istediğinizde ise XRechnung ve Peppol BIS Billing 3.0 kural kümelerine göre denetler. Kurallar yerel olarak kodlanmıştır ve herhangi bir XML yazılmadan önce model üzerinde çalışır. Her ileti resmi kural tanımlayıcısını, önem derecesini, iş terimini, alanın modeldeki yolunu ve kural metnini taşır; böylece uygulama kullanıcıya hangi alanı düzeltmesi gerektiğini gösterebilir.

Aşağıdaki örnek aynı faturayı iki kez doğrular. Önce EN 16931 kurallarından geçer, sonra XRechnung olarak denetlenir ve çekirdek modelin gerektirmediği bir satıcı iletişim bilgisi istenir. FillInvoice ilk örnekteki faturayı doldurur, iki tarafın sokak adresini ve posta kodunu ve XRechnung'un zorunlu kıldığı bir SEPA havalesini ekler. Log bir satır yazdırır.

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;

İkinci doğrulama iki ileti yazdırır: BR-DE-2 Seller.Contact ve BR-DE-TMP-32 Delivery.ActualDeliveryDate. Birincisi ölümcül bir hatadır, ikincisi bir uyarıdır. İletişim bilgisi ve teslimat tarihi belirlendiğinde fatura uyarısız geçer.

Ulusal Biçimler

Üç ülke kendi fatura biçimini kullanır ve her birinin aynı TsgcInvoice nesnesini alan bir yazıcısı vardır:

İki İspanyol mali sistemi de kapsanır:

BiçimSınıfYazmaOkuma
UBL 2.1 Invoice ve CreditNoteTsgcInvoiceUBLEvetEvet
UN/CEFACT CII D16BTsgcInvoiceCIIEvetEvet
XRechnung, UBL veya CIITsgcInvoiceDocumentEvetEvet
Peppol BIS Billing 3.0, UBLTsgcInvoiceDocumentEvetEvet
Factur-X / ZUGFeRD XML, beş profilTsgcInvoiceFacturXEvetEvet
Facturae 3.2, 3.2.1 ve 3.2.2TsgcInvoiceFacturaeEvetHayır
FatturaPA 1.2.3TsgcInvoiceFatturaPAEvetHayır
KSeF FA(3)TsgcInvoiceKSeFEvetHayır
VeriFactu kayıtlarıTsgcInvoiceVeriFactuEvetHayır
TicketBAI 1.2.2TsgcInvoiceTicketBAIEvetHayır

Faturayı Göndermek

Üç istemci belgeyi vergi idaresine ulaştırır:

Peppol Ağı Üzerinden Gönderim

2026.12 sürümü faturayı Peppol ağı üzerinden de gönderir, hem Delphi'de hem .NET'te. Parçalar ayrı sınıflardır, bu yüzden akışın tamamını ya da yalnızca bir adımını kullanabilirsiniz:

Harici kütüphane gerekmez: kriptografi, XML ve AS4 kodu kütüphanenin parçasıdır, Delphi 7 ile Delphi 13 için. Aşağıdaki örnek, TsgcPeppolClient ile bir fatura dosyasını gönderir.

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;

Bir projeyi buna göre planlamadan önce gereksinimleri okuyun. Peppol ağında gönderim yapmak için OpenPeppol tarafından verilmiş bir erişim noktası sertifikasına sahip, akredite bir Peppol erişim noktası (hizmet sağlayıcı) olmak gerekir. Kütüphane protokolü uygular, sertifikayı veya akreditasyonu sağlamaz. Bir hizmet sağlayıcı kullanan şirketler normalde o sağlayıcı üzerinden gönderir. Kütüphane yalnızca gönderir: alıcı erişim noktası ve Peppol raporlaması yoktur. Katılımcı sorgulaması sertifika gerektirmez.

Gönderici, açık kaynaklı phase4 AS4 sunucusuyla (sürüm 4.9.0) yerel bir test PKI üzerinde birlikte çalışabilirlik açısından test edildi: Delphi ve .NET kütüphaneleriyle her mesaj kabul edildi ve her makbuz doğrulandı. Üretim ortamındaki bir erişim noktasıyla veya gerçek Peppol sertifikalarıyla çalıştırılmadı. Demos\Delphi\Peppol ve Demos\CBuilder\Peppol demoları kütüphaneyle birlikte gelir.

Tüm Akış İçin Tek Bir Bileşen

TsgcInvoiceDocument adımları bir araya getirir. Biçimi seçin, faturayı doldurun ve Build çağırın. Bileşen toplamları hesaplar, biçimin kural kümeleriyle doğrular, belgeyi yazar ve biçimin imza profiliyle imzalar. Doğrulama başarısız olursa hiçbir şey yazılmaz ve belgeyi herhangi bir sgcSign anahtar sağlayıcısı imzalayabilir.

Aşağıdaki örnek EN 16931 profilinde Factur-X XML'ini yazar ve bir PFX dosyasındaki sertifikayla imzalar.

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;

Bileşen okuma da yapar. LoadFromFile bir UBL veya CII dosyası alır, Format değerini dosyanın biçimine ayarlar ve modeli doldurur; böylece alınan bir fatura doğrulanabilir ve diğer sözdiziminde yeniden yazılabilir.

Neler Dahil Değil

Bu ilk sürümün kapsamının sınırları var ve bir projeyi buna göre planlamadan önce bunları bilmek daha iyidir.

Nasıl Edinilir

E-fatura, 2026.12 sürümünden itibaren sgcSign'ın bir parçasıdır. Ayrı bir sürüm değildir: birimler sgcSign ile birlikte, tam kaynak koduyla, Delphi 7'den Delphi 13'e ve .NET için gelir. Demos klasöründeki yeni bir EInvoice demosu, bir formda türlü tek bir faturayı doldurur ve tek bir bileşenle her bir biçimde oluşturur.

Ürün sayfasında e-fatura · Deneme sürümünü indirin · Değişiklik günlüğü

Sorularınız veya geri bildiriminiz mi var? Bizimle iletişime geçin, yanıtı kodu yazan kişilerden alırsınız.