THotPDF.AddFacturXAssociatedFile Method
Yöntem özeti: THotPDF.AddFacturXAssociatedFile Method
Bildirim
function AddFacturXAssociatedFile(const XMLBytes : TBytes; const ConformanceLevel : AnsiString; const FileName : AnsiString = 'factur-x.xml'; const Description : AnsiString = 'Factur-X invoice XML'; const Relationship : AnsiString = 'Alternative'; const Version : AnsiString = '1.0'; const CountryCode : AnsiString = ''): THPDFDictionaryObject;Birim
HPDFDoc
Parametreler
| Ad | Amaç |
|---|---|
XMLBytes | PDF/A-3 EmbeddedFile akışına aynen gömülen fatura XML baytları; XML yönergesi veya profil tanımlayıcısı ConformanceLevel ile eşleşmelidir |
ConformanceLevel | ZUGFeRD 1.0 için EN 16931, EXTENDED, XRECHNUNG veya COMFORT gibi izin verilen fatura profili veya uyumluluk düzeyi |
FileName | /F, /UF, EmbeddedFiles ad ağacına ve XMP DocumentFileName değerine yazılan gömülü XML dosya adı |
Açıklama | Okuma araçlarına gösterilen isteğe bağlı Filespec /Desc metni |
Relationship | /AFRelationship olarak yazılan ve seçilen fatura profili tarafından izin verilen ilişkili dosya ilişkisi |
Version | 1.0, 2p0 veya 3.0 gibi eşleşen bir XRECHNUNG sürümü dahil olmak üzere fatura meta veri sürümü |
CountryCode | Profil doğrulama tarafından kullanılan bölgesel politika kodu; boş bir değer, DE veya FR kullanın |
Dönüş değeri
Birincil fatura XML'i için kaydedilen dolaylı Filespec sözlüğünü döndürür
Kullanım notları
- Bu yöntemi kullanmadan önce PDFACompliance özelliğini 3A, 3B veya 3U olarak ayarlayın ve BeginDoc yöntemini çağırın
- Yöntem geçersiz dosya adı, profil ve meta veri sürümü kombinasyonlarını reddeder; böylece xrechnung.xml yalnızca XRECHNUNG ile, ZUGFeRD-invoice.xml yalnızca ZUGFeRD 1.0 profilleri ile, zugferd-invoice.xml yalnızca Sürüm 2p0 ile ve factur-x.xml geçerli Factur-X profilleri ile kullanılır
- Yöntem, ZUGFeRD 1.0 profil URN'lerini, geçerli Factur-X profil URN'lerini, Fransız EXTENDED alt kümelerini, EN16931 XMP veya profil takma adını, ZUGFeRD 2.0 profil URN'lerini ve eşleşen meta veri sürümlerine sahip bilinen XRechnung CII veya UBL profil URN'lerini dahil ederek XML yönergesini veya profil tanımlayıcısını ConformanceLevel ile karşılaştırır
- XRECHNUNG için, fx:Version değerini korumak üzere Version değerini 1.2, 2.0, 2.1, 2.2, 2.3 veya 3.0 olarak geçirin; varsayılan Version değerini 1.0'da bırakan mevcut çağrılar 3.0'a normalize edilir
- ZUGFeRD 1.0 kapsayıcıları için, FileName değerini ZUGFeRD-invoice.xml, Version değerini 1.0 ve ConformanceLevel değerini BASIC, COMFORT veya EXTENDED olarak geçirin
- ZUGFeRD 2.0 kapsayıcıları için, FileName değerini zugferd-invoice.xml ve Version değerini 2p0 olarak geçirin
- Fatura kapsayıcısının Alman ZUGFeRD ilişki kurallarını izlemesi gerektiğinde CountryCode değerini DE olarak geçirin; MINIMUM ve BASIC WL, AFRelationship olarak Data gerektirirken; BASIC, EN 16931, EXTENDED ve XRECHNUNG, Alternative gerektirir
- Faturanın Fransız Factur-X kurallarını izlemesi gerektiğinde CountryCode değerini FR olarak geçirin; XRECHNUNG reddedilir ve BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR ve EXTENDED-B2B-FR; Alternative, Source veya Data kullanabilir
- Yöntem text/xml MIME türünü kullanır, /Params /Size, /ModDate ve /CheckSum yazar, Filespec'i Catalog /AF içine kaydeder ve XML ayıklama araçları için bir Catalog /Names /EmbeddedFiles girdisi ekler
- Birincil fatura XML'i kaydedildikten sonra, sonraki AddPDFA3AssociatedFile çağrıları destekleyici belgeler ekleyebilir; bu ekler önerilen destekleyici belge formatlarının dışında olduğunda ölümcül olmayan MIME türü uyarıları için FacturXWarnings özelliğini inceleyin
- Oluşturulan XMP paketi, profile özgü PDF/A uzantı şemasını ve eşleşen fatura ad alanı altındaki DocumentType, DocumentFileName, Version ve ConformanceLevel alanlarını içerir
- Bu yardımcıyı kullanırken CustomXMP özelliğini ayarlamayın, çünkü çağıran tarafından sağlanan bir XMP paketi oluşturulan fatura meta verilerinin yerini alacaktır
- Bir belge iş akışında bu yardımcı aracılığıyla yalnızca bir birincil fatura XML'i eklenebilir
İlgili API'ler
- THotPDF.AddPDFA3AssociatedFile Method
- THotPDF.FacturXWarnings Property
- THotPDF.AddPDFAOutputIntent Method
- THotPDF.PDFACompliance Property