THotPDF.AddFacturXAssociatedFile Method

Tóm tắt phương thức: THotPDF.AddFacturXAssociatedFile Method

Khai báo

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;

Đơn vị

HPDFDoc

Tham số

Tên	Mục đích
`XMLBytes`	Các byte XML hóa đơn được nhúng nguyên văn trong luồng EmbeddedFile PDF/A-3; hướng dẫn XML hoặc mã nhận dạng cấu hình phải khớp với ConformanceLevel
`ConformanceLevel`	Cấu hình hóa đơn hoặc cấp độ tuân thủ được phép, chẳng hạn như EN 16931, EXTENDED, XRECHNUNG, hoặc COMFORT cho ZUGFeRD 1.0
`FileName`	Tên tệp XML nhúng được ghi vào /F, /UF, cây tên EmbeddedFiles và giá trị DocumentFileName XMP
`Mô tả`	Văn bản Filespec /Desc tùy chọn hiển thị cho các công cụ tiêu thụ
`Relationship`	Mối quan hệ tệp liên kết được ghi là /AFRelationship và được phép bởi cấu hình hóa đơn đã chọn
`Version`	Phiên bản siêu dữ liệu hóa đơn, bao gồm 1.0, 2p0, hoặc phiên bản XRECHNUNG phù hợp chẳng hạn như 3.0
`CountryCode`	Mã chính sách khu vực được sử dụng bởi xác thực cấu hình; sử dụng giá trị trống, DE, hoặc FR

Giá trị trả về

Trả về từ điển Filespec gián tiếp được đăng ký cho XML hóa đơn chính

Ghi chú sử dụng

Đặt PDFACompliance thành 3A, 3B hoặc 3U và gọi BeginDoc trước khi sử dụng phương thức này
Phương thức từ chối các kết hợp tên tệp, cấu hình và phiên bản siêu dữ liệu không hợp lệ để xrechnung.xml chỉ được sử dụng với XRECHNUNG, ZUGFeRD-invoice.xml chỉ được sử dụng với các cấu hình ZUGFeRD 1.0, zugferd-invoice.xml chỉ được sử dụng với Phiên bản 2p0 và factur-x.xml được sử dụng cho các cấu hình Factur-X hiện tại
Phương thức kiểm tra hướng dẫn XML hoặc mã nhận dạng cấu hình với ConformanceLevel, bao gồm các URN cấu hình ZUGFeRD 1.0, các URN cấu hình Factur-X hiện tại, các tập hợp con EXTENDED của Pháp, bí danh XMP hoặc cấu hình EN16931, các URN cấu hình ZUGFeRD 2.0 và các URN cấu hình XRechnung CII hoặc UBL đã biết với các phiên bản siêu dữ liệu phù hợp
Đối với XRECHNUNG, chuyển Version dưới dạng 1.2, 2.0, 2.1, 2.2, 2.3 hoặc 3.0 để giữ nguyên fx:Version đó; các cuộc gọi hiện tại để lại giá trị Version mặc định là 1.0 sẽ được chuẩn hóa thành 3.0
Đối với các vùng chứa ZUGFeRD 1.0, chuyển FileName dưới dạng ZUGFeRD-invoice.xml, Version dưới dạng 1.0 và ConformanceLevel dưới dạng BASIC, COMFORT hoặc EXTENDED
Đối với các vùng chứa ZUGFeRD 2.0, chuyển FileName dưới dạng zugferd-invoice.xml và Version dưới dạng 2p0
Chuyển CountryCode dưới dạng DE khi vùng chứa hóa đơn phải tuân theo các quy tắc liên kết ZUGFeRD của Đức; MINIMUM và BASIC WL yêu cầu Data dưới dạng AFRelationship, trong khi BASIC, EN 16931, EXTENDED và XRECHNUNG yêu cầu Alternative
Chuyển CountryCode dưới dạng FR khi hóa đơn phải tuân theo các quy tắc Factur-X của Pháp; XRECHNUNG bị từ chối và BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR và EXTENDED-B2B-FR có thể sử dụng Alternative, Source hoặc Data
Phương thức sử dụng loại MIME text/xml, ghi /Params /Size, /ModDate và /CheckSum, đăng ký Filespec trong Catalog /AF và thêm mục Catalog /Names /EmbeddedFiles cho các công cụ trích xuất XML
Sau khi XML hóa đơn chính được đăng ký, các cuộc gọi AddPDFA3AssociatedFile sau này có thể thêm tài liệu hỗ trợ; kiểm tra FacturXWarnings để biết cảnh báo loại MIME không nghiêm trọng khi các tệp đính kèm đó nằm ngoài định dạng tài liệu hỗ trợ được khuyến nghị
Gói XMP được tạo bao gồm lược đồ mở rộng PDF/A cụ thể cho cấu hình cộng với các trường DocumentType, DocumentFileName, Version và ConformanceLevel thuộc không gian tên hóa đơn phù hợp
Không đặt CustomXMP khi sử dụng trình trợ giúp này, vì gói XMP do người gọi cung cấp sẽ thay thế siêu dữ liệu hóa đơn được tạo
Chỉ có một XML hóa đơn chính có thể được đính kèm thông qua trình trợ giúp này trong quy trình làm việc tài liệu

API liên quan

THotPDF.AddPDFA3AssociatedFile Method
THotPDF.FacturXWarnings Property
THotPDF.AddPDFAOutputIntent Method
THotPDF.PDFACompliance Property