THotPDF.AddFacturXAssociatedFile Method
Factur-X 또는 ZUGFeRD 송장 XML 페이로드를 Associated File로 PDF/A-3 문서에 넣고 그에 맞는 송장 XMP 메타데이터를 추가합니다
선언
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 | 허용되는 송장 프로파일 또는 conformance 수준입니다. ZUGFeRD 1.0의 EN 16931, EXTENDED, XRECHNUNG, COMFORT 등 |
FileName | /F, /UF, EmbeddedFiles name tree, XMP DocumentFileName 값에 기록되는 내장 XML 파일 이름 |
Description | 소비 도구에 보이는 선택적 Filespec /Desc 텍스트 |
Relationship | /AFRelationship로 기록되며 선택한 송장 프로파일이 허용하는 associated-file relationship |
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 프로파일에 쓰입니다
- 이 메서드는 XML 가이드라인 또는 프로파일 식별자를 ConformanceLevel과 대조합니다. 여기에는 ZUGFeRD 1.0 프로파일 URN, 현재 Factur-X 프로파일 URN, 프랑스 EXTENDED 하위 집합, EN16931 XMP 또는 프로파일 별칭, ZUGFeRD 2.0 프로파일 URN, 메타데이터 버전이 맞는 알려진 XRechnung CII·UBL 프로파일 URN이 포함됩니다
- XRECHNUNG에서는 fx:Version을 보존하도록 Version을 1.2, 2.0, 2.1, 2.2, 2.3, 3.0 중 하나로 넘기십시오. 기본 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 relationship 규칙을 따라야 하면 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을 기록하며, Filespec을 Catalog /AF에 등록하고, XML 추출 도구를 위해 Catalog /Names /EmbeddedFiles 항목을 추가합니다
- 기본 송장 XML이 등록된 뒤 이어지는 AddPDFA3AssociatedFile 호출로 지원 문서를 추가할 수 있습니다. 첨부가 권장 지원 문서 형식을 벗어나면 FacturXWarnings에서 치명적이지 않은 MIME 타입 경고를 확인하십시오
- 생성된 XMP 패킷에는 프로파일 전용 PDF/A extension schema와 함께, 맞는 송장 네임스페이스 아래의 DocumentType, DocumentFileName, Version, ConformanceLevel 필드가 들어갑니다
- 이 헬퍼를 쓸 때는 CustomXMP를 설정하지 마십시오. 호출자가 넘긴 XMP 패킷이 생성된 송장 메타데이터를 덮어씁니다
- 문서 워크플로에서 이 헬퍼로 붙일 수 있는 기본 송장 XML은 하나뿐입니다