THotPDF.AddFacturXAssociatedFile メソッド
メソッドの要約: THotPDF.AddFacturXAssociatedFile メソッド
宣言
function AddFacturXAssociatedFile(const XMLBytes : TBytes; const ConformanceLevel : AnsiString; const File名前 : 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 | ZUGFeRD 1.0 の EN 16931、EXTENDED、XRECHNUNG、または COMFORT など、許可されるインボイスプロファイルまたは適合性レベル |
File名前 | /F、/UF、EmbeddedFiles ネームツリー、および XMP の DocumentFile名前 値に書き込まれる埋め込み XML ファイル名 |
説明 | 消費ツールに表示されるオプションの Filespec /Desc テキスト |
Relationship | /AFRelationship として書き込まれ、選択されたインボイスプロファイルによって許可される、関連ファイルの関連性 |
Version | 1.0、2p0、または 3.0 などの一致する XRECHNUNG バージョンを含む、インボイスのメタデータバージョン |
CountryCode | プロファイル検証で使用される地域ポリシーコード。空の値、DE、または FR を使用します |
戻り値
プライマリインボイス XML 用に登録された間接 Filespec ディクショナリを返します
使用上の注意
- このメソッドを使用する前に、PDFACompliance を 3A、3B、または 3U に設定し、BeginDoc を呼び出します
- このメソッドは、無効なファイル名、プロファイル、およびメタデータバージョンの組み合わせを拒否します。したがって、xrechnung.xml は XRECHNUNG でのみ使用され、ZUGFeRD-invoice.xml は ZUGFeRD 1.0 プロファイルでのみ使用され、zugferd-invoice.xml は Version 2p0 でのみ使用され、factur-x.xml は現在の Factur-X プロファイルで使用されます
- このメソッドは、ZUGFeRD 1.0 プロファイル URN、現在の Factur-X プロファイル URN、フランスの EXTENDED サブセット、EN16931 XMP またはプロファイルエイリアス、ZUGFeRD 2.0 プロファイル URN、および一致するメタデータバージョンを持つ既知の XRechnung CII または UBL プロファイル URN などを含む ConformanceLevel に対して、XML ガイドラインまたはプロファイル識別子をチェックします。
- XRECHNUNG の場合、その fx:Version を保持するために、Version として 1.2、2.0、2.1、2.2、2.3、または 3.0 を渡します。デフォルトの Version 値を 1.0 のままにする既存の呼び出しは、3.0 に正規化されます
- ZUGFeRD 1.0 コンテナーの場合、File名前 を ZUGFeRD-invoice.xml、Version を 1.0、ConformanceLevel を BASIC、COMFORT、または EXTENDED として渡します
- ZUGFeRD 2.0 コンテナーの場合、File名前 を zugferd-invoice.xml、Version を 2p0 として渡します
- インボイスコンテナーがドイツの ZUGFeRD の関連性ルールに従う必要がある場合は、CountryCode として DE を渡します。MINIMUM および BASIC WL では AFRelationship として Data が必要ですが、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 を書き込み、カタログ /AF に Filespec を登録し、XML 抽出ツール用にカタログ /名前s /EmbeddedFiles エントリを追加します
- プライマリインボイス XML が登録された後、後続の AddPDFA3AssociatedFile 呼び出しでサポートドキュメントを追加できます。これらの添付ファイルが推奨されるサポートドキュメント形式の範囲外である場合は、致命的でない MIME タイプの警告について FacturXWarnings を検査します
- 生成された XMP パケットには、プロファイル固有の PDF/A 拡張スキーマに加えて、一致するインボイス名前空間の下にある DocumentType、DocumentFile名前、Version、および ConformanceLevel フィールドが含まれます
- 呼び出し元が提供した XMP パケットが生成されたインボイスのメタデータを置き換えてしまうため、このヘルパーを使用する場合は CustomXMP を設定しないでください
- ドキュメントワークフローでこのヘルパーを介してアタッチできるプライマリインボイス XML は1つだけです
関連 API
- THotPDF.AddPDFA3AssociatedFile メソッド
- THotPDF.FacturXWarnings プロパティ
- THotPDF.AddPDFAOutputIntent メソッド
- THotPDF.PDFACompliance プロパティ