THotPDF.AddFacturXAssociatedFile Method
Sažetak metode: THotPDF.AddFacturXAssociatedFile Method
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;Unit
HPDFDoc
Parametri
| Name | Svrha |
|---|---|
XMLBytes | Bajtovi XML fakture koji se ugrađuju doslovno u PDF/A-3 EmbeddedFile tok; XML smernica ili identifikator profila mora odgovarati ConformanceLevel vrednosti |
ConformanceLevel | Dozvoljeni profil fakture ili nivo usaglašenosti, kao što su EN 16931, EXTENDED, XRECHNUNG ili COMFORT za ZUGFeRD 1.0 |
FileName | Naziv ugrađene XML datoteke upisan u /F, /UF, stablo naziva EmbeddedFiles i XMP DocumentFileName vrednost |
Opis | Opcioni Filespec /Desc tekst koji se prikazuje alatima za potrošnju |
Relationship | Odnos povezane datoteke upisan kao /AFRelationship i dozvoljen izabranim profilom fakture |
Version | Verzija metapodataka fakture, uključujući 1.0, 2p0 ili odgovarajuću verziju XRECHNUNG-a kao što je 3.0 |
CountryCode | Regionalni kod politike koji koristi validacija profila; koristite praznu vrednost, DE ili FR |
Povratna vrednost
Vraća indirektni Filespec rečnik registrovan za primarnu XML fakturu
Napomene za upotrebu
- Postavite PDFACompliance na 3A, 3B ili 3U i pozovite BeginDoc pre upotrebe ove metode
- Metoda odbija nevažeće kombinacije naziva datoteke, profila i verzije metapodataka, tako da se xrechnung.xml koristi samo sa XRECHNUNG-om, ZUGFeRD-invoice.xml se koristi samo sa ZUGFeRD 1.0 profilima, zugferd-invoice.xml se koristi samo sa verzijom 2p0, a factur-x.xml se koristi za trenutne Factur-X profile
- Metoda proverava XML smernicu ili identifikator profila u odnosu na ConformanceLevel, uključujući URN-ove profila ZUGFeRD 1.0, trenutne URN-ove profila Factur-X, francuske EXTENDED podskupove, EN16931 XMP ili alias profila, URN-ove profila ZUGFeRD 2.0 i poznate URN-ove profila XRechnung CII ili UBL sa odgovarajućim verzijama metapodataka
- Za XRECHNUNG, prosledite Version kao 1.2, 2.0, 2.1, 2.2, 2.3 ili 3.0 da biste sačuvali tu fx:Version; postojeći pozivi koji ostavljaju podrazumevanu vrednost za Version na 1.0 se normalizuju na 3.0
- Za ZUGFeRD 1.0 kontejnere, prosledite FileName kao ZUGFeRD-invoice.xml, Version kao 1.0 i ConformanceLevel kao BASIC, COMFORT ili EXTENDED
- Za ZUGFeRD 2.0 kontejnere, prosledite FileName kao zugferd-invoice.xml i Version kao 2p0
- Prosledite CountryCode kao DE kada kontejner fakture mora da sledi nemačka pravila odnosa ZUGFeRD; MINIMUM i BASIC WL zahtevaju Data kao AFRelationship, dok BASIC, EN 16931, EXTENDED i XRECHNUNG zahtevaju Alternative
- Prosledite CountryCode kao FR kada faktura mora da sledi francuska pravila Factur-X; 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, upisuje /Params /Size, /ModDate i /CheckSum, registruje Filespec u Catalog /AF i dodaje stavku Catalog /Names /EmbeddedFiles za alate za ekstrakciju XML-a
- Nakon registracije primarne XML fakture, kasniji pozivi AddPDFA3AssociatedFile mogu dodati prateće dokumente; proverite FacturXWarnings za nefatalna upozorenja o MIME tipu kada su ti prilozi izvan preporučenih formata pratećih dokumenata
- Generisani XMP paket uključuje PDF/A extension šemu specifičnu za profil, plus polja DocumentType, DocumentFileName, Version i ConformanceLevel pod odgovarajućim prostorom imena fakture
- Nemojte podešavati CustomXMP kada koristite ovaj pomoćnik, jer bi XMP paket koji je obezbedio pozivalac zamenio generisane metapodatke fakture
- Samo jedna primarna XML faktura može biti priložena putem ovog pomoćnika u radnom toku dokumenta
Povezani API-ji
- Metoda THotPDF.AddPDFA3AssociatedFile
- Svojstvo THotPDF.FacturXWarnings
- Metoda THotPDF.AddPDFAOutputIntent
- Svojstvo THotPDF.PDFACompliance