Metoda THotPDF.AddFacturXAssociatedFile
Sažetak metode: Metoda THotPDF.AddFacturXAssociatedFile
Deklaracija
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;Jedinica
HPDFDoc
Parametri
| Naziv | Svrha |
|---|---|
XMLBytes | Bajtovi XML-a računa ugrađeni doslovno u PDF/A-3 EmbeddedFile tok; identifikator XML smjernica ili profila mora odgovarati ConformanceLevel |
ConformanceLevel | Dopušteni profil računa ili razina sukladnosti, kao što su EN 16931, EXTENDED, XRECHNUNG ili COMFORT za ZUGFeRD 1.0 |
FileName | Naziv ugrađene XML datoteke zapisan u /F, /UF, stablo naziva EmbeddedFiles i XMP vrijednost DocumentFileName |
Opis | Neobavezni Filespec /Desc tekst prikazan alatima koji ga koriste |
Relationship | Odnos povezane datoteke zapisan kao /AFRelationship i dopušten odabranim profilom računa |
Version | Verzija metapodataka računa, uključujući 1.0, 2p0 ili odgovarajuću verziju XRECHNUNG kao što je 3.0 |
CountryCode | Regionalni kod politike koji koristi provjera valjanosti profila; koristite praznu vrijednost, DE ili FR |
Povratna vrijednost
Vraća neizravni Filespec rječnik registriran za primarni XML računa
Napomene o korištenju
- Postavite PDFACompliance na 3A, 3B ili 3U i pozovite BeginDoc prije korištenja ove metode
- Metoda odbija nevažeće kombinacije naziva datoteke, profila i verzije metapodataka, tako da se xrechnung.xml koristi samo s XRECHNUNG, ZUGFeRD-invoice.xml koristi se samo s profilima ZUGFeRD 1.0, zugferd-invoice.xml koristi se samo s Version 2p0, a factur-x.xml koristi se za trenutne profile Factur-X
- Metoda provjerava identifikator XML smjernica ili profila u odnosu na ConformanceLevel, uključujući URN-ove profila ZUGFeRD 1.0, trenutne URN-ove profila Factur-X, francuske podskupove EXTENDED, XMP ili profilni pseudonim EN16931, URN-ove profila ZUGFeRD 2.0 i poznate URN-ove profila XRechnung CII ili UBL s odgovarajućim verzijama metapodataka
- Za XRECHNUNG, proslijedite Version kao 1.2, 2.0, 2.1, 2.2, 2.3 ili 3.0 kako biste očuvali taj fx:Version; postojeći pozivi koji ostavljaju zadani Version na 1.0 normaliziraju se na 3.0
- Za spremnike ZUGFeRD 1.0, proslijedite FileName kao ZUGFeRD-invoice.xml, Version kao 1.0 i ConformanceLevel kao BASIC, COMFORT ili EXTENDED
- Za spremnike ZUGFeRD 2.0, proslijedite FileName kao zugferd-invoice.xml i Version kao 2p0
- Proslijedite CountryCode kao DE kada spremnik računa mora slijediti njemačka ZUGFeRD pravila o odnosima; MINIMUM i BASIC WL zahtijevaju Data kao AFRelationship, dok BASIC, EN 16931, EXTENDED i XRECHNUNG zahtijevaju Alternative
- Proslijedite CountryCode kao FR kada račun mora slijediti francuska Factur-X pravila; XRECHNUNG se odbija, a BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR i EXTENDED-B2B-FR mogu koristiti Alternative, Source ili Data
- Metoda koristi MIME tip text/xml, zapisuje /Params /Size, /ModDate i /CheckSum, registrira Filespec u Catalog /AF i dodaje unos Catalog /Names /EmbeddedFiles za alate za izdvajanje XML-a
- Nakon što se registrira primarni XML računa, kasniji pozivi AddPDFA3AssociatedFile mogu dodati prateće dokumente; provjerite FacturXWarnings za ne-fatalna upozorenja o MIME tipu kada su ti privitci izvan preporučenih formata pratećih dokumenata
- Generirani XMP paket uključuje shemu PDF/A proširenja specifičnu za profil te polja DocumentType, DocumentFileName, Version i ConformanceLevel pod odgovarajućim prostorom naziva računa
- Nemojte postavljati CustomXMP kada koristite ovog pomoćnika, jer bi XMP paket koji isporuči pozivatelj zamijenio generirane metapodatke računa
- Samo jedan primarni XML računa može se priložiti putem ovog pomoćnika u tijeku rada s dokumentom
Povezani API-ji
- Metoda THotPDF.AddPDFA3AssociatedFile
- Svojstvo THotPDF.FacturXWarnings
- Metoda THotPDF.AddPDFAOutputIntent
- Svojstvo THotPDF.PDFACompliance