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, ולערך XMP DocumentFileName |
תיאור | טקסט 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, כולל URNs של פרופילי ZUGFeRD 1.0, URNs של פרופילי Factur-X הנוכحیים, תתי-קבוצות EXTENDED צרפתיות, כינוי הפרופיל או ה-XMP של EN16931, URNs של פרופילי ZUGFeRD 2.0, ו-URNs מוכרים של פרופילי 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