THotPDF.AddFacturXAssociatedFile Metodo

Riepilogo del metodo: THotPDF.AddFacturXAssociatedFile Metodo

Dichiarazione

function AddFacturXAssociatedFile(const XMLBytes : TBytes; const ConformanceLevel : AnsiString; const FileName : AnsiString = 'factur-x.xml'; const Descrizione : AnsiString = 'Factur-X invoice XML'; const Relationship : AnsiString = 'Alternative'; const Version : AnsiString = '1.0'; const CountryCode : AnsiString = ''): THPDFDictionaryObject;

Unità

HPDFDoc

Parametri

Nome	Scopo
`XMLBytes`	Invoice XML bytes embedded verbatim in the PDF/A-3 EmbeddedFile stream; the XML guideline or profile identifier must match ConformanceLevel
`ConformanceLevel`	Allowed invoice profile or conformance level, such as EN 16931, EXTENDED, XRECHNUNG, or COMFORT for ZUGFeRD 1.0
`FileName`	Embedded XML filename written to /F, /UF, the EmbeddedFiles name tree, and the XMP DocumentFileName value
`Descrizione`	Optional Filespec /Desc text shown to consuming tools
`Relationship`	Associated-file relationship written as /AFRelationship and allowed by the selected invoice profile
`Version`	Invoice metadata version, including 1.0, 2p0, or a matching XRECHNUNG version such as 3.0
`CountryCode`	Regional policy code used by profile validation; use an empty value, DE, or FR

Valore restituito

Restituisce il dictionary Filespec indiretto registrato per l'XML primario della fattura

Note sull'utilizzo

Impostare PDFACompliance su 3A, 3B o 3U e chiamare BeginDoc prima di usare questo metodo
Il metodo rifiuta combinazioni non valide di filename, profile e metadata-version, così xrechnung.xml viene usato solo con XRECHNUNG, ZUGFeRD-invoice.xml solo con profili ZUGFeRD 1.0, zugferd-invoice.xml solo con Version 2p0 e factur-x.xml per i profili Factur-X correnti
Il metodo controlla l'identificatore guideline o profile XML rispetto a ConformanceLevel, includendo ZUGFeRD 1.0 profile URNs, Factur-X profile URNs correnti, subset francesi EXTENDED, alias XMP o profile EN16931, ZUGFeRD 2.0 profile URNs e URNs XRechnung CII o UBL noti con metadata versions corrispondenti
Per XRECHNUNG, passare Version come 1.2, 2.0, 2.1, 2.2, 2.3 o 3.0 per preservare quel fx:Version; le chiamate esistenti che lasciano il valore Version predefinito a 1.0 vengono normalizzate a 3.0
Per contenitori ZUGFeRD 1.0, passare FileName come ZUGFeRD-invoice.xml, Version come 1.0 e ConformanceLevel come BASIC, COMFORT o EXTENDED
Per contenitori ZUGFeRD 2.0, passare FileName come zugferd-invoice.xml e Version come 2p0
Passare CountryCode come DE quando il contenitore fattura deve seguire le regole di relazione ZUGFeRD tedesche; MINIMUM e BASIC WL richiedono Data come AFRelationship, mentre BASIC, EN 16931, EXTENDED e XRECHNUNG richiedono Alternative
Passare CountryCode come FR quando la fattura deve seguire le regole Factur-X francesi; XRECHNUNG viene rifiutato e BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR ed EXTENDED-B2B-FR possono usare Alternative, Source o Data
Il metodo usa MIME type text/xml, scrive /Params /Size, /ModDate e /CheckSum, registra Filespec in Catalog /AF e aggiunge una entry Catalog /Names /EmbeddedFiles per gli strumenti di estrazione XML
Dopo la registrazione dell'XML primario della fattura, chiamate successive ad AddPDFA3AssociatedFile possono aggiungere documenti di supporto; ispezionare FacturXWarnings per warnings MIME type non fatali quando tali allegati sono fuori dai formati supporting-document consigliati
Il packet XMP generato include lo schema PDF/A extension specifico del profile più i campi DocumentType, DocumentFileName, Version e ConformanceLevel sotto il namespace fattura corrispondente
Non impostare CustomXMP quando si usa questo helper, perché un packet XMP fornito dal chiamante sostituirebbe i metadata fattura generati
Solo un XML fattura primario può essere allegato tramite questo helper in un workflow documento

API correlate

THotPDF.AddPDFA3AssociatedFile Metodo
THotPDF.FacturXWarnings Property
THotPDF.AddPDFAOutputIntent Metodo
THotPDF.PDFACompliance Property