AddFacturXAssociatedFileFromString

Propiedades del documento

Descripción

Escribe XML de factura electrónica como archivo asociado PDF/A-3 y genera los metadatos XMP de factura electrónica requeridos para los perfiles Factur-X, ZUGFeRD y XRechnung

Sintaxis

Delphi

Function TPDFlib.AddFacturXAssociatedFileFromString(Const XMLBytes: AnsiString; Const ConformanceLevel, FileName, Description, Relationship, Version, CountryCode: WideString): Integer;

Parámetros

XMLBytes	Los bytes XML UTF-8 sin procesar que se incrustarán
ConformanceLevel	El nivel del perfil de factura, como `MINIMUM`, `BASIC WL`, `BASIC`, `EN16931`, `EXTENDED`, `XRECHNUNG`, `EXTENDED-CTC-FR` o `EXTENDED-B2B-FR`
FileName	Nombre del XML incrustado, normalmente `factur-x.xml`, `xrechnung.xml`, `zugferd-invoice.xml` o `ZUGFeRD-invoice.xml`; vacío usa `factur-x.xml`
Description	El texto opcional `/Desc` escrito en la especificación de archivo
Relationship	El valor `/AFRelationship`; un valor vacío utiliza `Alternative` de forma predeterminada
Version	La versión del perfil de factura; un valor vacío utiliza `1.0` de forma predeterminada
CountryCode	Código opcional de perfil de país, como una cadena vacía, `DE` o `FR`

Valores devueltos

0	El documento no está en un modo PDF/A-3, la combinación de XML y perfil no es válida o ya se añadió el XML de factura
Non-zero	El identificador de objeto de la especificación de archivo recién creada

Observaciones

El método valida el nombre de archivo, nivel de conformidad, versión, perfil de país y /AFRelationship antes de escribir el archivo adjunto

COMFORT solo se admite con ZUGFeRD-invoice.xml y versión 1.0; zugferd-invoice.xml selecciona ZUGFeRD 2.0 y xrechnung.xml XRECHNUNG

Escribe campos XMP DocumentFileName, DocumentType, Version y ConformanceLevel y valida que el ID XML coincida; el llamador crea el contenido visible

Ejemplo

// Add EN 16931 invoice XML to a PDF/A-3b document
var
  FileID: Integer;
begin
  PDF.SetPDFAMode(5);
  PDF.NewDocument;
  FileID := PDF.AddFacturXAssociatedFileFromString(
    InvoiceXML,
    'EN16931',
    'factur-x.xml',
    'Factur-X invoice XML',
    'Alternative',
    '1.0',
    '');
  if FileID = 0 then Exit;
  PDF.SaveToFile('factur-x.pdf');
end;

Véase también

AddPDFA3AssociatedFileFromString, DetectFacturXInvoice, ValidateFacturXInvoice, ExtractFacturXXMLToString