THotPDF.AddFacturXAssociatedFile Method
Metodsammanfattning: THotPDF.AddFacturXAssociatedFile Method
Deklaration
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;Enhet
HPDFDoc
Parametrar
| Namn | Syfte |
|---|---|
XMLBytes | Faktura-XML-byte inbäddade ordagrant i PDF/A-3-strömmen EmbeddedFile; XML-riktlinjen eller profilidentifieraren måste matcha ConformanceLevel |
ConformanceLevel | Tillåten fakturaprofil eller överensstämmelsenivå, till exempel EN 16931, EXTENDED, XRECHNUNG eller COMFORT för ZUGFeRD 1.0 |
FileName | Inbäddat XML-filnamn skrivet till /F, /UF, namnträdet EmbeddedFiles och XMP-värdet DocumentFileName |
Beskrivning | Valfri Filespec /Desc-text som visas för läsverktyg |
Relationship | Associerad filrelation skriven som /AFRelationship och tillåten av den valda fakturaprofilen |
Version | Version för fakturametadata, inklusive 1.0, 2p0 eller en matchande XRECHNUNG-version som 3.0 |
CountryCode | Regional policykod som används av profilvalidering; använd ett tomt värde, DE eller FR |
Returvärde
Returnerar den indirekta Filespec-ordboken registrerad för den primära fakturans XML
Användningsinformation
- Sätt PDFACompliance till 3A, 3B eller 3U och anropa BeginDoc innan du använder denna metod
- Metoden avvisar ogiltiga kombinationer av filnamn, profil och metadataversion så att xrechnung.xml endast används med XRECHNUNG, ZUGFeRD-invoice.xml endast används med ZUGFeRD 1.0-profiler, zugferd-invoice.xml endast används med version 2p0 och factur-x.xml används för aktuella Factur-X-profiler
- Metoden kontrollerar XML-riktlinjen eller profilidentifieraren mot ConformanceLevel, inklusive URN:er för ZUGFeRD 1.0-profiler, aktuella URN:er för Factur-X-profiler, franska EXTENDED-delmängder, EN16931 XMP eller profilalias, URN:er för ZUGFeRD 2.0-profiler och kända URN:er för XRechnung CII- eller UBL-profiler med matchande metadataversioner
- För XRECHNUNG, skicka Version som 1.2, 2.0, 2.1, 2.2, 2.3 eller 3.0 för att bevara fx:Version; befintliga anrop som lämnar standardvärdet för Version på 1.0 normaliseras till 3.0
- För ZUGFeRD 1.0-behållare, skicka FileName som ZUGFeRD-invoice.xml, Version som 1.0 och ConformanceLevel som BASIC, COMFORT eller EXTENDED
- För ZUGFeRD 2.0-behållare, skicka FileName som zugferd-invoice.xml och Version som 2p0
- Skicka CountryCode som DE när fakturabehållaren måste följa tyska ZUGFeRD-relationsregler; MINIMUM och BASIC WL kräver Data som AFRelationship, medan BASIC, EN 16931, EXTENDED och XRECHNUNG kräver Alternative
- Skicka CountryCode som FR när fakturan måste följa franska Factur-X-regler; XRECHNUNG avvisas och BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR och EXTENDED-B2B-FR kan använda Alternative, Source eller Data
- Metoden använder MIME-typen text/xml, skriver /Params /Size, /ModDate och /CheckSum, registrerar Filespec i Catalog /AF och lägger till en Catalog /Names /EmbeddedFiles-post för XML-extraheringsverktyg
- Efter att den primära fakturans XML har registrerats kan senare anrop till AddPDFA3AssociatedFile lägga till stödjande dokument; inspektera FacturXWarnings för icke-ödesdigra MIME-typsvarningar när dessa bilagor ligger utanför de rekommenderade formaten för stödjande dokument
- Det genererade XMP-paketet innehåller det profilspecifika PDF/A-tilläggsschemat plus fälten DocumentType, DocumentFileName, Version och ConformanceLevel under det matchande fakturanamnrymden
- Ställ inte in CustomXMP när du använder denna hjälpare, eftersom ett XMP-paket som tillhandahålls av anroparen skulle ersätta de genererade fakturametadata
- Endast en primär faktura-XML kan bifogas via denna hjälpare i ett dokumentarbetsflöde
Relaterade API:er
- THotPDF.AddPDFA3AssociatedFile Method
- THotPDF.FacturXWarnings Property
- THotPDF.AddPDFAOutputIntent Method
- THotPDF.PDFACompliance Property