AddFacturXAssociatedFileFromString

Belge özellikleri

Açıklama

E-fatura XML'ini PDF/A-3 ilişkili dosyası olarak yazar ve Factur-X, ZUGFeRD ile XRechnung profilleri için gerekli XMP e-fatura meta verilerini oluşturur

Sözdizimi

Delphi

Function TPDFlib.AddFacturXAssociatedFileFromString(Const XMLBytes: AnsiString; Const ConformanceLevel, FileName, Description, Relationship, Version, CountryCode: WideString): Integer;

Parametreler

XMLBytes	Gömülecek ham UTF-8 XML baytları
ConformanceLevel	`MINIMUM`, `BASIC WL`, `BASIC`, `EN16931`, `EXTENDED`, `XRECHNUNG`, `EXTENDED-CTC-FR` veya `EXTENDED-B2B-FR` gibi fatura profili düzeyi
FileName	Gömülü XML dosya adı; genellikle `factur-x.xml`, `xrechnung.xml`, `zugferd-invoice.xml` veya `ZUGFeRD-invoice.xml`; boş değer varsayılan olarak `factur-x.xml` kullanır
Description	Dosya belirtimine yazılan isteğe bağlı `/Desc` metni
Relationship	`/AFRelationship` değeri; boş bir değer varsayılan olarak `Alternative` olur
Version	Fatura profili sürümü; boş değer varsayılan olarak `1.0` olur
CountryCode	Boş dize, `DE` veya `FR` gibi isteğe bağlı ülke profili kodu

Dönüş değerleri

0	Belge PDF/A-3 modunda değil, XML veya profil birleşimi geçersiz ya da fatura XML'si zaten eklenmiş
Non-zero	Yeni oluşturulan dosya belirtiminin nesne tanıtıcısı

Açıklamalar

Yöntem, eki yazmadan önce dosya adını, uyumluluk düzeyini, sürümü, ülke profilini ve /AFRelationship değerini doğrular

COMFORT yalnızca ZUGFeRD-invoice.xml ve 1.0 sürümüyle kabul edilir; zugferd-invoice.xml ZUGFeRD 2.0 profilini, xrechnung.xml ise XRECHNUNG profilini seçer

Yöntem DocumentFileName, DocumentType, Version ve ConformanceLevel XMP alanlarını yazar ve XML kılavuz kimliğinin seçili profille eşleştiğini denetler. Normal görünür fatura sayfası içeriği, kaydetmeden önce yine çağıran tarafından oluşturulur

Örnek

// Add EN 16931 invoice XML to a PDF/A-3b document
var
  FileID: Integer;
begin
  PDF.SetPDFAMode(5);
  PDF.NewDocument;
  FileID := PDF.AddFacturXAssociatedFileFromString(
    InvoiceXML,
    'EN16931',
    'factur-x.xml',
    'Factur-X invoice XML',
    'Alternative',
    '1.0',
    '');
  if FileID = 0 then Exit;
  PDF.SaveToFile('factur-x.pdf');
end;

Ayrıca bkz

AddPDFA3AssociatedFileFromString, DetectFacturXInvoice, ValidateFacturXInvoice, ExtractFacturXXMLToString