THotPDF.AddFacturXAssociatedFile Methode

Methodeoverzicht: THotPDF.AddFacturXAssociatedFile Methode

Declaratie

function AddFacturXAssociatedFile(const XMLBytes : TBytes; const ConformanceLevel : AnsiString; const FileName : AnsiString = 'factur-x.xml'; const Beschrijving : AnsiString = 'Factur-X invoice XML'; const Relationship : AnsiString = 'Alternative'; const Version : AnsiString = '1.0'; const CountryCode : AnsiString = ''): THPDFDictionaryObject;

Eenheid

HPDFDoc

Parameters

Naam	Doel
`XMLBytes`	Factuur XML-bytes die letterlijk in de PDF/A-3 EmbeddedFile-stream zijn ingesloten; de XML-richtlijn of profielidentificatie moet overeenkomen met ConformanceLevel
`ConformanceLevel`	Toegestaan factuurprofiel of conformiteitsniveau, zoals EN 16931, EXTENDED, XRECHNUNG of COMFORT voor ZUGFeRD 1.0
`FileName`	Ingebedde XML-bestandsnaam geschreven naar /F, /UF, de EmbeddedFiles-naamboom en de XMP DocumentFileName-waarde
`Beschrijving`	Optionele Filespec /Desc tekst getoond aan verwerkende tools
`Relationship`	Associated File relatie geschreven als /AFRelationship en toegestaan door het geselecteerde factuurprofiel
`Version`	Factuur metadataversie, inclusief 1.0, 2p0 of een overeenkomstige XRECHNUNG-versie zoals 3.0
`CountryCode`	Regionale beleidscode gebruikt door profielvalidatie; gebruik een lege waarde, DE of FR

Retourwaarde

Retourneert het indirecte Filespec-woordenboek dat is geregistreerd voor de primaire factuur-XML

Gebruiksopmerkingen

Stel PDFACompliance in op 3A, 3B of 3U en roep BeginDoc aan voordat u deze methode gebruikt
De methode weigert ongeldige combinaties van bestandsnaam, profiel en metadataversie, zodat xrechnung.xml alleen wordt gebruikt met XRECHNUNG, ZUGFeRD-invoice.xml alleen met ZUGFeRD 1.0-profielen, zugferd-invoice.xml alleen met Version 2p0 en factur-x.xml voor de huidige Factur-X-profielen
De methode controleert de XML-richtlijn of profielidentificatie tegen ConformanceLevel, inclusief ZUGFeRD 1.0-profiel-URN's, huidige Factur-X-profiel-URN's, Franse EXTENDED-subsets, de EN16931 XMP- of profielalias, ZUGFeRD 2.0-profiel-URN's en bekende XRechnung CII of UBL-profiel-URN's met overeenkomstige metadataversies
Geef voor XRECHNUNG de Version door als 1.2, 2.0, 2.1, 2.2, 2.3 of 3.0 om die fx:Version te behouden; bestaande aanroepen die de standaard Version-waarde op 1.0 laten, worden genormaliseerd naar 3.0
Geef voor ZUGFeRD 1.0-containers de FileName door als ZUGFeRD-invoice.xml, Version als 1.0 en ConformanceLevel als BASIC, COMFORT of EXTENDED
Geef voor ZUGFeRD 2.0-containers de FileName door als zugferd-invoice.xml en Version als 2p0
Geef CountryCode door als DE wanneer de factuurcontainer de Duitse ZUGFeRD-relatieregels moet volgen; MINIMUM en BASIC WL vereisen Data als AFRelationship, terwijl BASIC, EN 16931, EXTENDED en XRECHNUNG Alternative vereisen
Geef CountryCode door als FR wanneer de factuur de Franse Factur-X-regels moet volgen; XRECHNUNG wordt geweigerd en BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR en EXTENDED-B2B-FR mogen Alternative, Source of Data gebruiken
De methode gebruikt het MIME-type text/xml, schrijft /Params /Size, /ModDate en /CheckSum, registreert de Filespec in Catalog /AF en voegt een Catalog /Names /EmbeddedFiles-item toe voor XML-extractietools
Nadat de primaire factuur-XML is geregistreerd, kunnen latere AddPDFA3AssociatedFile-aanroepen ondersteunende documenten toevoegen; controleer FacturXWarnings op niet-fatale waarschuwingen voor het MIME-type wanneer die bijlagen buiten de aanbevolen formaten voor ondersteunende documenten vallen
Het gegenereerde XMP-pakket bevat het profielspecifieke PDF/A-uitbreidingsschema plus de velden DocumentType, DocumentFileName, Version en ConformanceLevel onder de bijbehorende factuurnamespace
Stel CustomXMP niet in bij het gebruik van deze helper, omdat een door de beller geleverd XMP-pakket de gegenereerde factuurmetadata zou vervangen
Er kan slechts één primaire factuur-XML worden gekoppeld via deze helper in een documentworkflow

Gerelateerde API's

THotPDF.AddPDFA3AssociatedFile Methode
THotPDF.FacturXWarnings Property
THotPDF.AddPDFAOutputIntent Methode
THotPDF.PDFACompliance Property