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