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 | ไบต์ XML ใบแจ้งหนี้ที่ฝังอยู่ในสตรีม EmbeddedFile PDF/A-3 โดยตรง โดยรหัสแนะนำ XML หรือโปรไฟล์ต้องตรงกับ ConformanceLevel |
ConformanceLevel | โปรไฟล์ใบแจ้งหนี้หรือระดับการปฏิบัติตามข้อกำหนดที่อนุญาต เช่น EN 16931, EXTENDED, XRECHNUNG หรือ COMFORT สำหรับ ZUGFeRD 1.0 |
FileName | ชื่อไฟล์ XML ที่ฝังซึ่งจะเขียนลงใน /F, /UF, แผนผังชื่อ EmbeddedFiles และค่า DocumentFileName ของ XMP |
คำอธิบาย | ข้อความ Filespec /Desc ทางเลือกที่จะแสดงต่อเครื่องมือใช้งาน |
Relationship | ความสัมพันธ์ของไฟล์ที่เกี่ยวข้องซึ่งเขียนเป็น /AFRelationship และได้รับอนุญาตโดยโปรไฟล์ใบแจ้งหนี้ที่เลือก |
Version | เวอร์ชันเมทาดาตาใบแจ้งหนี้ รวมถึง 1.0, 2p0 หรือเวอร์ชัน XRECHNUNG ที่ตรงกัน เช่น 3.0 |
CountryCode | รหัสโยบายระดับภูมิภาคที่ใช้โดยการตรวจสอบโปรไฟล์ โดยใช้ค่าว่าง, DE หรือ FR |
ค่าที่ส่งกลับ
ส่งคืนพจนานุกรม Filespec ทางอ้อมที่ลงทะเบียนสำหรับ XML ใบแจ้งหนี้หลัก
หมายเหตุการใช้งาน
- ตั้งค่า PDFACompliance เป็น 3A, 3B หรือ 3U และเรียกใช้งาน BeginDoc ก่อนใช้เมธอดนี้
- เมธอดนี้จะปฏิเสธการรวมชื่อไฟล์, โปรไฟล์ และเวอร์ชันเมทาดาตาที่ไม่ถูกต้อง ดังนั้น xrechnung.xml จะถูกใช้กับ XRECHNUNG เท่านั้น, ZUGFeRD-invoice.xml จะถูกใช้กับโปรไฟล์ ZUGFeRD 1.0 เท่านั้น, zugferd-invoice.xml จะถูกใช้กับเวอร์ชัน 2p0 เท่านั้น และ factur-x.xml จะถูกใช้สำหรับโปรไฟล์ Factur-X ปัจจุบัน
- เมธอดนี้จะตรวจสอบรหัสแนะนำ XML หรือโปรไฟล์กับ ConformanceLevel รวมถึง URN ของโปรไฟล์ ZUGFeRD 1.0, URN ของโปรไฟล์ Factur-X ปัจจุบัน, ส่วนย่อย EXTENDED ของฝรั่งเศส, นามแฝง XMP หรือโปรไฟล์ EN16931, URN ของโปรไฟล์ ZUGFeRD 2.0 และ URN ของโปรไฟล์ XRechnung CII หรือ UBL ที่รู้จักซึ่งมีเวอร์ชันเมทาดาตาที่ตรงกัน
- สำหรับ 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
- ส่งค่า CountryCode เป็น DE เมื่อคอนเทนเนอร์ใบแจ้งหนี้ต้องปฏิบัติตามกฎความสัมพันธ์ ZUGFeRD ของเยอรมนี โดย MINIMUM และ BASIC WL กำหนดให้ใช้ Data เป็น AFRelationship ในขณะที่ BASIC, EN 16931, EXTENDED และ XRECHNUNG กำหนดให้ใช้ Alternative
- ส่งค่า CountryCode เป็น FR เมื่อใบแจ้งหนี้ต้องปฏิบัติตามกฎ Factur-X ของฝรั่งเศส โดย XRECHNUNG จะถูกปฏิเสธ และ BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR และ EXTENDED-B2B-FR อาจใช้ Alternative, Source หรือ Data
- เมธอดนี้ใช้ประเภท MIME เป็น text/xml, เขียนค่า /Params /Size, /ModDate และ /CheckSum, ลงทะเบียน Filespec ใน Catalog /AF และเพิ่มรายการ Catalog /Names /EmbeddedFiles สำหรับเครื่องมือดึงข้อมูล XML
- หลังจากลงทะเบียน 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