THotPDF.AddFacturXAssociatedFile Method
Metodo santrauka: THotPDF.AddFacturXAssociatedFile Method
Deklaracija
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;Unit
HPDFDoc
Parametrai
| Name | Paskirtis |
|---|---|
XMLBytes | Sąskaitos faktūros XML baitai, pažodžiui įterpiami į PDF/A-3 EmbeddedFile srautą; XML gairių arba profilio identifikatorius turi atitikti ConformanceLevel |
ConformanceLevel | Leistinas sąskaitos faktūros profilis arba atitikties lygis, pavyzdžiui, EN 16931, EXTENDED, XRECHNUNG arba COMFORT, skirtas ZUGFeRD 1.0 |
FileName | Įterptojo XML failo pavadinimas, įrašomas į /F, /UF, EmbeddedFiles pavadinimų medį ir XMP DocumentFileName reikšmę |
Aprašas | Pasirenkamas Filespec /Desc tekstas, rodomas apdorojimo įrankiams |
Relationship | Susijusio failo ryšys, įrašomas kaip /AFRelationship ir leidžiamas pasirinktame sąskaitos faktūros profilyje |
Version | Sąskaitos faktūros metaduomenų versija, įskaitant 1.0, 2p0 arba atitinkamą XRECHNUNG versiją, pavyzdžiui, 3.0 |
CountryCode | Regioninės politikos kodas, naudojamas profilio tikrinimui; naudokite tuščią reikšmę, DE arba FR |
Grąžinama reikšmė
Grąžina netiesioginį Filespec žodyną, užregistruotą pagrindiniam sąskaitos faktūros XML
Naudojimo pastabos
- Prieš naudodami šį metodą, nustatykite PDFACompliance į 3A, 3B arba 3U ir iškvieskite BeginDoc
- Metodas atmeta netinkamus failo pavadinimo, profilio ir metaduomenų versijos derinius, todėl xrechnung.xml yra naudojamas tik su XRECHNUNG, ZUGFeRD-invoice.xml – tik su ZUGFeRD 1.0 profiliais, zugferd-invoice.xml – tik su Version 2p0, o factur-x.xml yra naudojamas dabartiniams Factur-X profiliams
- Metodas tikrina XML gaires arba profilio identifikatorių pagal ConformanceLevel, įskaitant ZUGFeRD 1.0 profilio URN, dabartinius Factur-X profilio URN, prancūziškus EXTENDED pohemius, EN16931 XMP arba profilio pseudonimą, ZUGFeRD 2.0 profilio URN bei žinomus XRechnung CII arba UBL profilio URN su atitinkamomis metaduomenų versijomis
- Naudodami XRECHNUNG, nurodykite Version kaip 1.2, 2.0, 2.1, 2.2, 2.3 arba 3.0, kad išsaugotumėte fx:Version; esami iškvietimai, paliekantys numatytąją Version reikšmę 1.0, yra normalizuojami į 3.0
- ZUGFeRD 1.0 talpykloms nurodykite FileName kaip ZUGFeRD-invoice.xml, Version kaip 1.0, o ConformanceLevel kaip BASIC, COMFORT arba EXTENDED
- ZUGFeRD 2.0 talpykloms nurodykite FileName kaip zugferd-invoice.xml, o Version kaip 2p0
- Nurodykite CountryCode kaip DE, kai sąskaitos faktūros talpykla turi atitikti Vokietijos ZUGFeRD ryšio taisykles; MINIMUM ir BASIC WL reikalauja reikšmės Data kaip AFRelationship, o BASIC, EN 16931, EXTENDED ir XRECHNUNG reikalauja Alternative
- Nurodykite CountryCode kaip FR, kai sąskaita faktūra turi atitikti Prancūzijos Factur-X taisykles; XRECHNUNG yra atmetamas, o BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR ir EXTENDED-B2B-FR gali naudoti Alternative, Source arba Data
- Metodas naudoja MIME tipą text/xml, įrašo /Params /Size, /ModDate ir /CheckSum, užregistruoja Filespec kataloge /AF ir prideda Catalog /Names /EmbeddedFiles įrašą, skirtą XML išgavimo įrankiams
- Užregistravus pagrindinį sąskaitos faktūros XML, vėlesni AddPDFA3AssociatedFile iškvietimai gali pridėti papildomus dokumentus; patikrinkite FacturXWarnings dėl neesminių MIME tipo įspėjimų, kai šie priedai neatitinka rekomenduojamų papildomų dokumentų formatų
- Sugeneruotas XMP paketas apima konkrečiam profiliui būdingą PDF/A išplėtimo schemą ir DocumentType, DocumentFileName, Version bei ConformanceLevel laukus atitinkamoje sąskaitos faktūros vardų srityje
- Nenaudokite CustomXMP naudodami šį pagalbinį metodą, nes iškvietėjo pateiktas XMP paketas pakeistų sugeneruotus sąskaitos faktūros metaduomenis
- Dokumento darbo eigoje per šį pagalbinį metodą galima prisegti tik vieną pagrindinį sąskaitos faktūros XML
Susijusios API
- THotPDF.AddPDFA3AssociatedFile Method
- THotPDF.FacturXWarnings Property
- THotPDF.AddPDFAOutputIntent Method
- THotPDF.PDFACompliance Property