THotPDF.AddFacturXAssociatedFile Method
Menetelmän yhteenveto: THotPDF.AddFacturXAssociatedFile Method
Määrittely
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;Yksikkö
HPDFDoc
Parametrit
| Nimi | Tarkoitus |
|---|---|
XMLBytes | Laskun XML-tavut, jotka upotetaan sellaisenaan PDF/A-3 EmbeddedFile -virtaan; XML-ohjeistuksen tai -profiilin tunnisteen on vastattava ConformanceLevel-arvoa |
ConformanceLevel | Sallittu laskuprofiili tai vaatimustenmukaisuustaso, kuten EN 16931, EXTENDED, XRECHNUNG tai ZUGFeRD 1.0 -version COMFORT |
FileName | Upotettavan XML-tiedoston nimi, joka kirjoitetaan kenttiin /F, /UF, EmbeddedFiles-nimipuuhun ja XMP-arvoon DocumentFileName |
Kuvaus | Valinnainen Filespec-määrittelyn /Desc-teksti, joka näytetään vastaanottaville työkaluille |
Relationship | Liitetyn tiedoston suhde, joka kirjoitetaan arvona /AFRelationship ja jonka valittu laskuprofiili sallii |
Version | Laskun metatietojen versio, mukaan lukien 1.0, 2p0 tai vastaava XRECHNUNG-versio kuten 3.0 |
CountryCode | Profiilin validoinnissa käytettävä alueellinen sääntökoodi; käytä tyhjää arvoa, DE tai FR |
Paluuarvo
Palauttaa ensisijaiselle laskun XML-tiedostolle rekisteröidyn epäsuoran Filespec-sanakirjan
Käyttöhuomautukset
- Aseta PDFACompliance-arvoksi 3A, 3B tai 3U ja kutsu BeginDoc-metodia ennen tämän metodin käyttöä
- Metodi hylkää virheelliset tiedostonimen, profiilin ja metatietoversion yhdistelmät, joten tiedostoa xrechnung.xml käytetään vain XRECHNUNG-profiilin kanssa, tiedostoa ZUGFeRD-invoice.xml vain ZUGFeRD 1.0 -profiilien kanssa, tiedostoa zugferd-invoice.xml vain version 2p0 kanssa ja tiedostoa factur-x.xml nykyisten Factur-X-profiilien kanssa
- Metodi tarkistaa XML-ohjeistuksen tai -profiilin tunnisteen ConformanceLevel-arvoa vasten, mukaan lukien ZUGFeRD 1.0 -profiilin URN-tunnisteet, nykyiset Factur-X-profiilin URN-tunnisteet, Ranskan EXTENDED-alajoukot, EN16931 XMP- tai profiilialias-tunnisteet, ZUGFeRD 2.0 -profiilin URN-tunnisteet sekä tunnetut XRechnung CII- tai UBL-profiilin URN-tunnisteet vastaavilla metatietoversioilla
- Siirrä XRECHNUNG-profiilille Version-arvoksi 1.2, 2.0, 2.1, 2.2, 2.3 tai 3.0 säilyttääksesi kyseisen fx:Version-arvon; olemassa olevat kutsut, joissa oletusarvoinen Version-arvo jätetään arvoon 1.0, normalisoidaan arvoon 3.0
- Siirrä ZUGFeRD 1.0 -säiliöille FileName-arvoksi ZUGFeRD-invoice.xml, Version-arvoksi 1.0 ja ConformanceLevel-arvoksi BASIC, COMFORT tai EXTENDED
- Siirrä ZUGFeRD 2.0 -säiliöille FileName-arvoksi zugferd-invoice.xml ja Version-arvoksi 2p0
- Siirrä CountryCode-arvoksi DE, kun laskusäiliön on noudatettava Saksan ZUGFeRD-suhdesääntöjä; MINIMUM ja BASIC WL vaativat arvon Data suhteeksi AFRelationship, kun taas BASIC, EN 16931, EXTENDED ja XRECHNUNG vaativat arvon Alternative
- Siirrä CountryCode-arvoksi FR, kun laskun on noudatettava Ranskan Factur-X-sääntöjä; XRECHNUNG hylätään ja BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR sekä EXTENDED-B2B-FR voivat käyttää arvoja Alternative, Source tai Data
- Metodi käyttää MIME-tyyppiä text/xml, kirjoittaa metatiedot /Params /Size, /ModDate ja /CheckSum, rekisteröi Filespec-määrittelyn Catalog /AF -kohtaan ja lisää Catalog /Names /EmbeddedFiles -merkinnän XML-erotustyökaluja varten
- Kun ensisijainen laskun XML on rekisteröity, myöhemmät AddPDFA3AssociatedFile-kutsut voivat lisätä tukevia dokumentteja; tarkista FacturXWarnings mahdollisten ei-kriittisten MIME-tyyppivaroitusten varalta, kun kyseiset liitteet ovat suositeltujen tukidokumenttiformaattien ulkopuolella
- Luotu XMP-paketti sisältää profiilikohtaisen PDF/A-laajennusskeeman sekä kentät DocumentType, DocumentFileName, Version ja ConformanceLevel vastaavan laskun nimitilan alla
- Älä aseta CustomXMP-arvoa käyttäessäsi tätä apuohjelmaa, koska kutsujan toimittama XMP-paketti korvaisi luodut laskun metatiedot
- Vain yksi ensisijainen laskun XML voidaan liittää tämän apuohjelman kautta dokumentin työnkulussa
Aiheeseen liittyvät API:t
- THotPDF.AddPDFA3AssociatedFile Method
- THotPDF.FacturXWarnings Property
- THotPDF.AddPDFAOutputIntent Method
- THotPDF.PDFACompliance Property