THotPDF.AddFacturXAssociatedFile-metode
Metodesammendrag: THotPDF.AddFacturXAssociatedFile-metode
Deklarasjon
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
Parametere
| Navn | Formål |
|---|---|
XMLBytes | Faktura XML-byte bygd inn ordrett i PDF/A-3 EmbeddedFile-strømmen; XML-retningslinjen eller profilidentifikatoren må samsvare med ConformanceLevel |
ConformanceLevel | Tillatt fakturaprofil eller samsvarsnivå, som EN 16931, EXTENDED, XRECHNUNG eller COMFORT for ZUGFeRD 1.0 |
FileName | Innebygd XML-filnavn skrevet til /F, /UF, EmbeddedFiles-navnetreet og verdien for XMP DocumentFileName |
Beskrivelse | Valgfri Filespec /Desc-tekst som vises til forbrukende verktøy |
Relationship | Tilknyttet filforhold skrevet som /AFRelationship og tillatt av den valgte fakturaprofilen |
Version | Faktura-metadataversjon, inkludert 1.0, 2p0 eller en samsvarende XRECHNUNG-versjon som 3.0 |
CountryCode | Regional retningslinjekode brukt av profilvalidering; bruk en tom verdi, DE eller FR |
Returverdi
Returnerer den indirekte Filespec-ordboken registrert for den primære fakturaen XML
Bruksmerknader
- Sett PDFACompliance til 3A, 3B eller 3U og kall BeginDoc før du bruker denne metoden
- Metoden avviser ugyldige kombinasjoner av filnavn, profil og metadataversjon slik at xrechnung.xml bare brukes med XRECHNUNG, ZUGFeRD-invoice.xml bare brukes med ZUGFeRD 1.0-profiler, zugferd-invoice.xml bare brukes med versjon 2p0, og factur-x.xml brukes for gjeldende Factur-X-profiler
- Metoden sjekker XML-retningslinjen eller profilidentifikatoren mot ConformanceLevel, inkludert ZUGFeRD 1.0-profil-URN-er, gjeldende Factur-X-profil-URN-er, franske EXTENDED-delsett, EN16931 XMP eller profilalias, ZUGFeRD 2.0-profil-URN-er og kjente XRechnung CII- eller UBL-profil-URN-er med samsvarende metadataversjoner
- For XRECHNUNG, send Version som 1.2, 2.0, 2.1, 2.2, 2.3 eller 3.0 for å bevare den fx:Version; eksisterende kall som etterlater standard Version-verdi på 1.0 normaliseres til 3.0
- For ZUGFeRD 1.0-beholdere, send FileName som ZUGFeRD-invoice.xml, Version som 1.0 og ConformanceLevel som BASIC, COMFORT eller EXTENDED
- For ZUGFeRD 2.0-beholdere, send FileName som zugferd-invoice.xml og Version som 2p0
- Send CountryCode som DE når fakturabeholderen må følge tyske ZUGFeRD-forholdsregler; MINIMUM og BASIC WL krever Data som AFRelationship, mens BASIC, EN 16931, EXTENDED og XRECHNUNG krever Alternative
- Send CountryCode som FR når fakturaen må følge franske Factur-X-regler; XRECHNUNG avvises og BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR og EXTENDED-B2B-FR kan bruke Alternative, Source eller Data
- Metoden bruker MIME-type text/xml, skriver /Params /Size, /ModDate og /CheckSum, registrerer Filespec i Catalog /AF og legger til en Catalog /Names /EmbeddedFiles-oppføring for XML-uttrekkingsverktøy
- Etter at den primære fakturaen XML er registrert, kan senere AddPDFA3AssociatedFile-kall legge til støttedokumenter; undersøk FacturXWarnings for ikke-kritiske MIME-typeadvarsler når disse vedleggene er utenfor de anbefalte formatene for støttedokumenter
- Den genererte XMP-pakken inkluderer det profilspesifikke PDF/A-utvidelsesskjemaet pluss felt for DocumentType, DocumentFileName, Version og ConformanceLevel under den samsvarende fakturanavnerommet
- Ikke sett CustomXMP når du bruker denne hjelperen, fordi en XMP-pakke levert av kalleren ville erstatte de genererte fakturametadataene
- Bare én primær faktura XML kan legges ved via denne hjelperen i en dokumentarbeidsflyt
Relaterte API-er
- THotPDF.AddPDFA3AssociatedFile-metoden
- THotPDF.FacturXWarnings-egenskapen
- THotPDF.AddPDFAOutputIntent-metoden
- THotPDF.PDFACompliance-egenskapen