AddFacturXAssociatedFileFromString
文書プロパティ
説明
電子インボイス XML を PDF/A-3 関連ファイルとして書き込み、Factur-X、ZUGFeRD、および XRechnung プロファイルに必要な XMP 電子インボイスメタデータを生成します
構文
Delphi
Function TPDFlib.AddFacturXAssociatedFileFromString(Const XMLBytes: AnsiString; Const ConformanceLevel, FileName, Description, Relationship, Version, CountryCode: WideString): Integer;パラメータ
| XMLBytes | 埋め込む生の UTF-8 XML バイト |
|---|---|
| ConformanceLevel | MINIMUM、BASIC WL、BASIC、EN16931、EXTENDED、XRECHNUNG、EXTENDED-CTC-FR、EXTENDED-B2B-FR などのインボイスプロファイルレベル |
| FileName | 埋め込み XML ファイル名。通常は factur-x.xml、xrechnung.xml、zugferd-invoice.xml、または ZUGFeRD-invoice.xml です。空の値では既定で factur-x.xml を使用します |
| Description | ファイル仕様へ書き込む任意の /Desc テキスト |
| Relationship | /AFRelationship 値。空の値では既定で Alternative を使用します |
| Version | インボイスプロファイルのバージョン。空の値の場合は既定で 1.0 |
| CountryCode | 空文字列、DE、FR などの任意の国プロファイルコード |
戻り値
| 0 | ドキュメントが PDF/A-3 モードでないか、XML とプロファイルの組み合わせが無効か、請求書 XML が追加済みです |
|---|---|
| Non-zero | 新しく作成されたファイル仕様のオブジェクトハンドル |
備考
このメソッドは添付ファイルを書き込む前に、ファイル名、準拠レベル、バージョン、国別プロファイル、および /AFRelationship を検証します
COMFORT は ZUGFeRD-invoice.xml およびバージョン 1.0 との組み合わせでのみ受け入れられます。zugferd-invoice.xml は ZUGFeRD 2.0 プロファイルを選択し、xrechnung.xml は XRECHNUNG プロファイルを選択します
このメソッドは DocumentFileName、DocumentType、Version、ConformanceLevel の XMP フィールドを書き込み、XML ガイドライン ID が選択したプロファイルと一致するか確認します。通常の表示用請求書ページコンテンツは、保存前に引き続き呼び出し側が作成します
例
// Add EN 16931 invoice XML to a PDF/A-3b document
var
FileID: Integer;
begin
PDF.SetPDFAMode(5);
PDF.NewDocument;
FileID := PDF.AddFacturXAssociatedFileFromString(
InvoiceXML,
'EN16931',
'factur-x.xml',
'Factur-X invoice XML',
'Alternative',
'1.0',
'');
if FileID = 0 then Exit;
PDF.SaveToFile('factur-x.pdf');
end;関連項目
AddPDFA3AssociatedFileFromString、DetectFacturXInvoice、ValidateFacturXInvoice、ExtractFacturXXMLToString