AddFacturXAssociatedFileFromString

Dokumento ypatybės

Aprašymas

Įrašo e. sąskaitos XML kaip PDF/A-3 susietą failą ir sugeneruoja privalomus XMP e. sąskaitos metaduomenis Factur-X, ZUGFeRD ir XRechnung profiliams

Sintaksė

Delphi

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

Parametrai

XMLBytes	Neapdoroti UTF-8 XML baitai, kuriuos reikia įterpti
ConformanceLevel	Sąskaitos profilio lygis, pvz., `MINIMUM`, `BASIC WL`, `BASIC`, `EN16931`, `EXTENDED`, `XRECHNUNG`, `EXTENDED-CTC-FR` arba `EXTENDED-B2B-FR`
FileName	Įterpto XML failo vardas, paprastai `factur-x.xml`, `xrechnung.xml`, `zugferd-invoice.xml` arba `ZUGFeRD-invoice.xml`; jei reikšmė tuščia, naudojama `factur-x.xml`
Description	Pasirinktinis `/Desc` tekstas, įrašomas į failo specifikaciją
Relationship	`/AFRelationship` reikšmė; jei reikšmė tuščia, naudojama `Alternative`
Version	Sąskaitos profilio versija; jei reikšmė tuščia, naudojama `1.0`
CountryCode	Pasirinktinis šalies profilio kodas, pvz., tuščia eilutė, `DE` arba `FR`

Grąžinamos reikšmės

0	Dokumentas veikia ne PDF/A-3 režimu, XML ir profilio derinys netinkamas arba sąskaitos XML jau pridėtas
Non-zero	Naujai sukurtos failo specifikacijos objekto rankenėlė

Pastabos

Prieš įrašydamas priedą metodas patikrina failo vardą, atitikties lygį, versiją, šalies profilį ir /AFRelationship

COMFORT priimamas tik su ZUGFeRD-invoice.xml ir 1.0 versija; zugferd-invoice.xml parenka ZUGFeRD 2.0 profilį, o xrechnung.xml – XRECHNUNG profilį

Metodas įrašo XMP laukus DocumentFileName, DocumentType, Version ir ConformanceLevel bei patikrina, ar XML gairės ID sutampa su pasirinktu profiliu. Įprastą matomą sąskaitos puslapio turinį kvietėjas vis tiek sukuria prieš išsaugodamas

Pavyzdys

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

Taip pat žiūrėkite

AddPDFA3AssociatedFileFromString, DetectFacturXInvoice, ValidateFacturXInvoice, ExtractFacturXXMLToString