THotPDF.AddFacturXAssociatedFile-metode
Metodesammendrag: THotPDF.AddFacturXAssociatedFile-metode
Erklæring
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;Enhed
HPDFDoc
Parametre
| Navn | Formål |
|---|---|
XMLBytes | Faktura-XML-bytes indlejret ordret i PDF/A-3 EmbeddedFile-strømmen; XML-retningslinjen eller profil-identifikatoren skal matche ConformanceLevel |
ConformanceLevel | Tilladt fakturaprofil eller overensstemmelsesniveau, såsom EN 16931, EXTENDED, XRECHNUNG eller COMFORT til ZUGFeRD 1.0 |
FileName | Indlejret XML-filnavn skrevet til /F, /UF, EmbeddedFiles-navnetræet og XMP-værdien DocumentFileName |
Beskrivelse | Valgfri Filespec /Desc-tekst, der vises til forbrugende værktøjer |
Relationship | Tilknyttet filforhold skrevet som /AFRelationship og tilladt af den valgte fakturaprofil |
Version | Fakturametadataversion, inklusive 1.0, 2p0 eller en matchende XRECHNUNG-version såsom 3.0 |
CountryCode | Regional politikode anvendt af profilvalidering; brug en tom værdi, DE eller FR |
Returværdi
Returnerer det indirekte Filespec-ordbogsobjekt, der er registreret for den primære faktura-XML
Brugsnotater
- Indstil PDFACompliance til 3A, 3B eller 3U og kald BeginDoc før brug af denne metode
- Metoden afviser ugyldige kombinationer af filnavn, profil og metadataversion, så xrechnung.xml kun bruges med XRECHNUNG, ZUGFeRD-invoice.xml kun bruges med ZUGFeRD 1.0-profiler, zugferd-invoice.xml kun bruges med Version 2p0, og factur-x.xml bruges til aktuelle Factur-X-profiler
- Metoden kontrollerer XML-retningslinjen eller profil-identifikatoren mod ConformanceLevel, inklusive ZUGFeRD 1.0-profil-URN'er, aktuelle Factur-X-profil-URN'er, franske EXTENDED-undersæt, EN16931 XMP eller profilalias, ZUGFeRD 2.0-profil-URN'er og kendte XRechnung CII- eller UBL-profil-URN'er med matchende metadataversioner
- Ved XRECHNUNG skal du angive Version som 1.2, 2.0, 2.1, 2.2, 2.3 eller 3.0 for at bevare denne fx:Version; eksisterende kald, der efterlader standardværdien for Version på 1.0, normaliseres til 3.0
- Til ZUGFeRD 1.0-containere skal du angive FileName som ZUGFeRD-invoice.xml, Version som 1.0 og ConformanceLevel som BASIC, COMFORT eller EXTENDED
- Til ZUGFeRD 2.0-containere skal du angive FileName som zugferd-invoice.xml og Version som 2p0
- Angiv CountryCode som DE, når fakturacontaineren skal følge tyske ZUGFeRD-forholdsregler; MINIMUM og BASIC WL kræver Data som AFRelationship, mens BASIC, EN 16931, EXTENDED og XRECHNUNG kræver Alternative
- Angiv CountryCode som FR, når fakturaen skal følge franske Factur-X-regler; XRECHNUNG afvises, og BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR og EXTENDED-B2B-FR kan bruge Alternative, Source eller Data
- Metoden bruger MIME-typen text/xml, skriver /Params /Size, /ModDate og /CheckSum, registrerer Filespec i Catalog /AF og tilføjer en Catalog /Names /EmbeddedFiles-post til XML-udtræksværktøjer
- Når den primære faktura-XML er registreret, kan senere AddPDFA3AssociatedFile-kald tilføje understøttende dokumenter; gennemgå FacturXWarnings ved ikke-kritiske MIME-typeadvarsler, hvis disse vedhæftede filer ligger uden for de anbefalede formater til understøttende dokumenter
- Det genererede XMP-pakke indeholder det profilspecifikke PDF/A-udvidelsesskema plus felterne DocumentType, DocumentFileName, Version og ConformanceLevel under det matchende fakturanavnerum
- Indstil ikke CustomXMP, når du bruger denne hjælper, da en XMP-pakke leveret af kalderen ville erstatte de genererede fakturametadata
- Kun én primær faktura-XML kan vedhæftes via denne hjælper i et dokumentarbejdsforløb
Relaterede API'er
- THotPDF.AddPDFA3AssociatedFile-metode
- THotPDF.FacturXWarnings-egenskab
- THotPDF.AddPDFAOutputIntent-metode
- THotPDF.PDFACompliance-egenskab