THotPDF.AddFacturXAssociatedFile Method
方法摘要: THotPDF.AddFacturXAssociatedFile Method
声明
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;单元
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
XMLBytes | 原封不动嵌入到 PDF/A-3 EmbeddedFile 流中的发票 XML 字节；XML 指南或配置文件标识符必须匹配 ConformanceLevel |
ConformanceLevel | 允许的发票配置文件或一致性级别，例如 EN 16931、EXTENDED、XRECHNUNG 或 ZUGFeRD 1.0 的 COMFORT |
FileName | 写入 /F、/UF、EmbeddedFiles 名称树以及 XMP DocumentFileName 值的嵌入式 XML 文件名 |
说明 | 可选的文件规范 /Desc 文本，向读取工具展示 |
Relationship | 作为 /AFRelationship 写入且被所选发票配置文件允许的关联文件关系 |
Version | 发票元数据版本，包括 1.0、2p0 或匹配的 XRECHNUNG 版本（如 3.0） |
CountryCode | 配置文件验证使用的区域策略代码；使用空值、DE 或 FR |
返回值
返回为主发票 XML 注册的间接 Filespec 字典
使用说明
- 在使用此方法前，将 PDFACompliance 设置为 3A、3B 或 3U 并调用 BeginDoc
- 该方法拒绝无效的文件名、配置文件和元数据版本组合，因此 xrechnung.xml 仅用于 XRECHNUNG，ZUGFeRD-invoice.xml 仅用于 ZUGFeRD 1.0 配置文件，zugferd-invoice.xml 仅用于 2p0 版本，而 factur-x.xml 用于当前的 Factur-X 配置文件
- 该方法会根据 ConformanceLevel 检查 XML 指南或配置文件标识符，包括 ZUGFeRD 1.0 配置文件 URN、当前的 Factur-X 配置文件 URN、法国 EXTENDED 子集、EN16931 XMP 或配置文件别名、ZUGFeRD 2.0 配置文件 URN 以及具有匹配元数据版本的已知 XRechnung CII 或 UBL 配置文件 URN
- 对于 XRECHNUNG，将 Version 传入为 1.2、2.0、2.1、2.2、2.3 或 3.0 以保留该 fx:Version；保留默认 Version 值 1.0 的现有调用将被规范化为 3.0
- 对于 ZUGFeRD 1.0 容器，将 FileName 传入为 ZUGFeRD-invoice.xml，Version 传入为 1.0，ConformanceLevel 传入为 BASIC、COMFORT 或 EXTENDED
- 对于 ZUGFeRD 2.0 容器，将 FileName 传入为 zugferd-invoice.xml，Version 传入为 2p0
- 当发票容器必须遵循德国 ZUGFeRD 关联规则时，将 CountryCode 传入为 DE；MINIMUM 和 BASIC WL 要求将 Data 作为 AFRelationship，而 BASIC、EN 16931、EXTENDED 和 XRECHNUNG 则要求 Alternative
- 当发票必须遵循法国 Factur-X 规则时，将 CountryCode 传入为 FR；XRECHNUNG 将被拒绝，而 BASIC、EN 16931、EXTENDED、EXTENDED-CTC-FR 和 EXTENDED-B2B-FR 可以使用 Alternative、Source 或 Data
- 该方法使用 MIME 类型 text/xml，写入 /Params /Size、/ModDate 和 /CheckSum，在 Catalog /AF 中注册 Filespec，并为 XML 提取工具添加 Catalog /Names /EmbeddedFiles 条目
- 在注册主发票 XML 之后，后续的 AddPDFA3AssociatedFile 调用可以添加支持文档；当这些附件超出推荐的支持文档格式时，检查 FacturXWarnings 以获取非致命 MIME 类型警告
- 生成的 XMP 包包括特定于配置文件的 PDF/A 扩展架构，以及匹配发票命名空间下的 DocumentType、DocumentFileName、Version 和 ConformanceLevel 字段
- 使用此辅助函数时请勿设置 CustomXMP，因为调用者提供的 XMP 包将替换生成的发票元数据
- 在文档工作流程中，只能通过此辅助函数附加一个主发票 XML
相关 API
- THotPDF.AddPDFA3AssociatedFile Method
- THotPDF.FacturXWarnings Property
- THotPDF.AddPDFAOutputIntent Method
- THotPDF.PDFACompliance Property