AddFacturXAssociatedFileFromString

Document properties

Description

Kiírja az e-számla XML-t PDF/A-3 társított fájlként, és létrehozza a szükséges XMP e-számla metaadatokat Factur-X, ZUGFeRD és XRechnung profilokhoz

Syntax

Delphi

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

Parameters

XMLBytes	A beágyazandó nyers UTF-8 XML bájtok
ConformanceLevel	A számlaprofil szintje, például `MINIMUM`, `BASIC WL`, `BASIC`, `EN16931`, `EXTENDED`, `XRECHNUNG`, `EXTENDED-CTC-FR` vagy `EXTENDED-B2B-FR`
FileName	A beágyazott XML-fájl neve, általában `factur-x.xml`, `xrechnung.xml`, `zugferd-invoice.xml` vagy `ZUGFeRD-invoice.xml`; üres érték esetén az alapértelmezett a `factur-x.xml`
Description	A fájl-specifikációba írt opcionális `/Desc` szöveg
Relationship	Az `/AFRelationship` érték; üres érték esetén az alapértelmezett a `Alternative`
Version	A számlaprofil verziója; üres érték esetén az alapértelmezett a `1.0`
CountryCode	Opcionális országprofil-kód, például üres karakterlánc, `DE` vagy `FR`

Return values

0	A dokumentum nincs PDF/A-3 módban, az XML vagy profil kombinációja érvénytelen, vagy a számla XML már hozzáadásra került
Non-zero	Az újonnan létrehozott fájl-specifikáció (file specification) objektum-kezelője (handle)

Remarks

A metódus ellenőrzi a fájlnevet, a megfelelőségi szintet, a verziót, az országprofilt és a /AFRelationship bejegyzést a melléklet írása előtt

COMFORT is accepted only with ZUGFeRD-invoice.xml and version 1.0; zugferd-invoice.xml selects the ZUGFeRD 2.0 profile, and xrechnung.xml selects the XRECHNUNG profile

A metódus kiírja a DocumentFileName, DocumentType, Version és ConformanceLevel XMP mezőket, és ellenőrzi, hogy az XML irányelv azonosítója megegyezik-e a kiválasztott profillal; a normál, látható számlaoldal tartalmát a hívónak még a mentés előtt létre kell hoznia

Example

// 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;