Ş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:
- XRechnung, UBL veya CII sözdiziminde.
- Peppol BIS Billing 3.0, UBL sözdiziminde.
- Factur-X / ZUGFeRD, beş profilin XML'i: Minimum, Basic WL, Basic, EN 16931 ve Extended;
TsgcInvoiceFacturXaracılığıyla.
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:
- Facturae, İspanya:
TsgcInvoiceFacturae3.2, 3.2.1 ve 3.2.2 sürümlerini yazar. - FatturaPA, İtalya:
TsgcInvoiceFatturaPA, özel alıcılar (FPR12) ve kamu idaresi (FPA12) için 1.2.3 sürümünü yazar. - KSeF, Polonya:
TsgcInvoiceKSeFyapılandırılmış faturayı, yani FA(3) şemasını yazar.
İki İspanyol mali sistemi de kapsanır:
- VeriFactu:
TsgcInvoiceVeriFactu, zincirlenmiş SHA-256 özetiyle kayıt ve iptal kayıtlarını oluşturur, kayıtlar arasındaki zinciri korur ve QR kodu URL'sini ve görüntüsünü üretir. - TicketBAI:
TsgcInvoiceTicketBAI, önceki faturaya zincirli 1.2.2 fatura ve iptal dosyalarını oluşturur. İmzalamadan sonra TBAI tanımlayıcısını ve QR kodunu verir.
| Biçim | Sınıf | Yazma | Okuma |
|---|---|---|---|
| UBL 2.1 Invoice ve CreditNote | TsgcInvoiceUBL | Evet | Evet |
| UN/CEFACT CII D16B | TsgcInvoiceCII | Evet | Evet |
| XRechnung, UBL veya CII | TsgcInvoiceDocument | Evet | Evet |
| Peppol BIS Billing 3.0, UBL | TsgcInvoiceDocument | Evet | Evet |
| Factur-X / ZUGFeRD XML, beş profil | TsgcInvoiceFacturX | Evet | Evet |
| Facturae 3.2, 3.2.1 ve 3.2.2 | TsgcInvoiceFacturae | Evet | Hayır |
| FatturaPA 1.2.3 | TsgcInvoiceFatturaPA | Evet | Hayır |
| KSeF FA(3) | TsgcInvoiceKSeF | Evet | Hayır |
| VeriFactu kayıtları | TsgcInvoiceVeriFactu | Evet | Hayır |
| TicketBAI 1.2.2 | TsgcInvoiceTicketBAI | Evet | Hayır |
Faturayı Göndermek
Üç istemci belgeyi vergi idaresine ulaştırır:
TsgcVeriFactuClient, VeriFactu kayıtlarını AEAT web servisine gönderir. Her kaydın sonucunu okur, kayıt sınırını ve gönderimler arasındaki bekleme süresini uygular, gönderilen kayıtları sorgular ve makbuzları saklar.TsgcSdIClient, bir FatturaPA dosyasını İtalya'nın Sistema di Interscambio (SdI) web servisine gönderir, dosya adı kuralını denetler ve SdI'nın döndürdüğü bildirim dosyalarını okur.TsgcKSeFOnlineClient, faturaları KSeF'e etkileşimli bir oturumda gönderir: oturumu açar, faturayı gönderir, durumunu ve KSeF numarasını okur, oturumu kapatır ve UPO makbuzunu indirir.
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:
TsgcPeppolSMPClient, katılımcıyı SML ve SMP üzerinden sorgular ve imzalı SMP yanıtını doğrular.TsgcPeppolSBDHvesgcPeppolWrapInvoice, Peppol iş mesajı zarfı olan SBDH'yi yazar.TsgcPeppolAS4MessageveTsgcPeppolAS4Receipt, Peppol AS4 profilindeki AS4 mesajını uygular: RSA-SHA256 ile imzalanır, yük gzip ile sıkıştırılıp AES-128-GCM ile şifrelenir, anahtar aktarımı RSA-OAEP ile yapılır.TsgcPeppolClient,SendInvoiceveResendile sorgulama, zarf, gönderim ve makbuz doğrulamasını tek çağrıda yapar. İmzalı makbuzu saklar ve hata kodlarını içeren bir sonuç nesnesi döndürür.
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.
- Ulusal biçimler yalnızca yazılır. UBL ve CII, XRechnung, Peppol BIS ve Factur-X varyantlarıyla birlikte modele geri okunabilir. Facturae, FatturaPA, KSeF, VeriFactu ve TicketBAI okunamaz.
- Peppol gönderimi akredite bir erişim noktası gerektirir ve yalnızca gönderimdir. Kütüphane protokolü uygular, erişim noktası sertifikasını veya akreditasyonu sağlamaz. Alıcı erişim noktası ve Peppol raporlaması yoktur.
- Factur-X yalnızca XML'dir. Bir Factur-X veya ZUGFeRD faturası, bu XML'in gömülü olduğu bir PDF/A-3 dosyasıdır. Bileşen XML'i yazar, onu bir PDF/A-3 dosyasına gömmez.
- KSeF faturalarını bileşen gönderir, imzalamaz, çünkü KSeF fatura XML'ini imzalamaz.
- SdI uç noktaları yerleşik değildir. SdI, kanalın akreditasyonu sırasında uç noktalarını göndericiye bildirir ve bunları istemcide siz ayarlarsınız.
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.
