THotPDF.AddFacturXAssociatedFile Method
Ringkasan metode: THotPDF.AddFacturXAssociatedFile Method
Deklarasi
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;Unit
HPDFDoc
Parameter
| Nama | Tujuan |
|---|---|
XMLBytes | Byte XML faktur yang disematkan secara verbatim dalam aliran EmbeddedFile PDF/A-3; panduan XML atau pengidentifikasi profil harus cocok dengan ConformanceLevel |
ConformanceLevel | Profil faktur atau tingkat kepatuhan yang diperbolehkan, seperti EN 16931, EXTENDED, XRECHNUNG, atau COMFORT untuk ZUGFeRD 1.0 |
FileName | Nama file XML tersemat yang ditulis ke /F, /UF, pohon nama EmbeddedFiles, dan nilai DocumentFileName XMP |
Deskripsi | Teks Filespec /Desc opsional yang ditampilkan ke alat konsumen |
Relationship | Hubungan file terkait yang ditulis sebagai /AFRelationship dan diizinkan oleh profil faktur yang dipilih |
Version | Versi metadata faktur, termasuk 1.0, 2p0, atau versi XRECHNUNG yang cocok seperti 3.0 |
CountryCode | Kode kebijakan regional yang digunakan oleh validasi profil; gunakan nilai kosong, DE, atau FR |
Nilai balik
Mengembalikan kamus Filespec tidak langsung yang terdaftar untuk XML faktur utama
Catatan penggunaan
- Atur PDFACompliance ke 3A, 3B, atau 3U dan panggil BeginDoc sebelum menggunakan metode ini
- Metode ini menolak kombinasi nama file, profil, dan versi metadata yang tidak valid sehingga xrechnung.xml hanya digunakan dengan XRECHNUNG, ZUGFeRD-invoice.xml hanya digunakan dengan profil ZUGFeRD 1.0, zugferd-invoice.xml hanya digunakan dengan Versi 2p0, dan factur-x.xml digunakan untuk profil Factur-X saat ini
- Metode ini memeriksa panduan XML atau pengidentifikasi profil terhadap ConformanceLevel, termasuk URN profil ZUGFeRD 1.0, URN profil Factur-X saat ini, subset EXTENDED Prancis, alias profil atau XMP EN16931, URN profil ZUGFeRD 2.0, dan URN profil XRechnung CII atau UBL yang dikenal dengan versi metadata yang cocok
- Untuk XRECHNUNG, teruskan Version sebagai 1.2, 2.0, 2.1, 2.2, 2.3, atau 3.0 untuk mempertahankan fx:Version tersebut; panggilan yang ada yang membiarkan nilai Version default di 1.0 dinormalisasi menjadi 3.0
- Untuk kontainer ZUGFeRD 1.0, teruskan FileName sebagai ZUGFeRD-invoice.xml, Version sebagai 1.0, dan ConformanceLevel sebagai BASIC, COMFORT, atau EXTENDED
- Untuk kontainer ZUGFeRD 2.0, teruskan FileName sebagai zugferd-invoice.xml dan Version sebagai 2p0
- Teruskan CountryCode sebagai DE ketika kontainer faktur harus mengikuti aturan hubungan ZUGFeRD Jerman; MINIMUM dan BASIC WL memerlukan Data sebagai AFRelationship, sedangkan BASIC, EN 16931, EXTENDED, dan XRECHNUNG memerlukan Alternative
- Teruskan CountryCode sebagai FR ketika faktur harus mengikuti aturan Factur-X Prancis; XRECHNUNG ditolak dan BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR, dan EXTENDED-B2B-FR dapat menggunakan Alternative, Source, atau Data
- Metode ini menggunakan tipe MIME text/xml, menulis /Params /Size, /ModDate, dan /CheckSum, mendaftarkan Filespec di Catalog /AF, dan menambahkan entri Catalog /Names /EmbeddedFiles untuk alat ekstraksi XML
- Setelah XML faktur utama terdaftar, panggilan AddPDFA3AssociatedFile di kemudian hari dapat menambahkan dokumen pendukung; periksa FacturXWarnings untuk peringatan tipe MIME non-fatal ketika lampiran tersebut berada di luar format dokumen pendukung yang direkomendasikan
- Paket XMP yang dihasilkan mencakup skema ekstensi PDF/A khusus profil ditambah bidang DocumentType, DocumentFileName, Version, dan ConformanceLevel di bawah namespace faktur yang cocok
- Jangan atur CustomXMP saat menggunakan pembantu ini, karena paket XMP yang disediakan pemanggil akan menggantikan metadata faktur yang dihasilkan
- Hanya satu XML faktur utama yang dapat dilampirkan melalui pembantu ini dalam alur kerja dokumen
API terkait
- THotPDF.AddPDFA3AssociatedFile Method
- THotPDF.FacturXWarnings Property
- THotPDF.AddPDFAOutputIntent Method
- THotPDF.PDFACompliance Property