THotPDF.AddFacturXAssociatedFile Método

Resumen del método: THotPDF.AddFacturXAssociatedFile Método

Declaración

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

Unidad

HPDFDoc

Parámetros

Nombre	Propósito
`XMLBytes`	Bytes XML de la factura incrustados literalmente en el flujo EmbeddedFile de PDF/A-3; el identificador de la guía o perfil XML debe coincidir con ConformanceLevel
`ConformanceLevel`	Perfil de factura o nivel de conformidad permitido, como EN 16931, EXTENDED, XRECHNUNG o COMFORT para ZUGFeRD 1.0
`FileName`	Nombre de archivo XML incrustado escrito en /F, /UF, el árbol de nombres EmbeddedFiles y el valor XMP DocumentFileName
`Descripción`	Texto opcional Filespec /Desc que se muestra a las herramientas consumidoras
`Relationship`	Relación de archivo asociado escrita como /AFRelationship y permitida por el perfil de factura seleccionado
`Version`	Versión de metadatos de factura, incluyendo 1.0, 2p0 o una versión coincidente de XRECHNUNG como 3.0
`CountryCode`	Código de política regional utilizado por la validación del perfil; use un valor vacío, DE o FR

Valor de retorno

Devuelve el diccionario Filespec indirecto registrado para el XML de factura principal

Notas de uso

Establezca PDFACompliance en 3A, 3B o 3U y llame a BeginDoc antes de usar este método
El método rechaza combinaciones no válidas de nombre de archivo, perfil y versión de metadatos, por lo que xrechnung.xml solo se usa con XRECHNUNG, ZUGFeRD-invoice.xml solo se usa con perfiles de ZUGFeRD 1.0, zugferd-invoice.xml solo se usa con la versión 2p0 y factur-x.xml se usa para los perfiles actuales de Factur-X
El método comprueba la guía XML o el identificador de perfil con ConformanceLevel, incluidos los URN de perfil de ZUGFeRD 1.0, los URN de perfil de Factur-X actuales, los subconjuntos EXTENDED franceses, el alias de perfil o XMP EN16931, los URN de perfil de ZUGFeRD 2.0 y los URN de perfil de XRechnung CII o UBL conocidos con versiones de metadatos coincidentes
Para XRECHNUNG, pase Version como 1.2, 2.0, 2.1, 2.2, 2.3 o 3.0 para preservar ese fx:Version; las llamadas existentes que dejen el valor de Version predeterminado en 1.0 se normalizan a 3.0
Para contenedores ZUGFeRD 1.0, pase FileName como ZUGFeRD-invoice.xml, Version como 1.0 y ConformanceLevel como BASIC, COMFORT o EXTENDED
Para contenedores ZUGFeRD 2.0, pase FileName como zugferd-invoice.xml y Version como 2p0
Pase CountryCode como DE cuando el contenedor de la factura deba seguir las reglas de relación alemanas de ZUGFeRD; MINIMUM y BASIC WL requieren Data como AFRelationship, mientras que BASIC, EN 16931, EXTENDED y XRECHNUNG requieren Alternative
Pase CountryCode como FR cuando la factura deba seguir las reglas francesas de Factur-X; XRECHNUNG se rechaza y BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR y EXTENDED-B2B-FR pueden usar Alternative, Source o Data
El método usa el tipo MIME text/xml, escribe /Params /Size, /ModDate y /CheckSum, registra el Filespec en el Catalog /AF y agrega una entrada de Catalog /Names /EmbeddedFiles para las herramientas de extracción de XML
Después de registrar el XML de la factura principal, las llamadas posteriores a AddPDFA3AssociatedFile pueden agregar documentos de respaldo; inspeccione FacturXWarnings para detectar advertencias de tipo MIME no fatales cuando esos archivos adjuntos estén fuera de los formatos recomendados de documentos de respaldo
El paquete XMP generado incluye el esquema de extensión PDF/A específico del perfil más los campos DocumentType, DocumentFileName, Version y ConformanceLevel bajo el espacio de nombres de la factura coincidente
No establezca CustomXMP al usar este ayudante, porque un paquete XMP proporcionado por el llamador reemplazaría los metadatos de la factura generados
Solo se puede adjuntar un XML de factura principal a través de este ayudante en un flujo de trabajo de documento

APIs relacionadas

THotPDF.AddPDFA3AssociatedFile Método
THotPDF.FacturXWarnings Property
THotPDF.AddPDFAOutputIntent Método
THotPDF.PDFACompliance Property