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 | Byte 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 στον Κατάλογο /AF, και προσθέτει μια καταχώριση Καταλόγου /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