AddFacturXAssociatedFileFromString

Dokumentegenskaper

Beskrivning

Skriver e-faktura-XML som en PDF/A-3-associerad fil och genererar den krävda XMP e-faktura-metadatan för Factur-X-, ZUGFeRD- och XRechnung-profilerna

Syntax

Delphi

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

Parametrar

XMLBytes	De råa UTF-8 XML-bytena som ska bäddas in
ConformanceLevel	Fakturaprofilens nivå, som `MINIMUM`, `BASIC WL`, `BASIC`, `EN16931`, `EXTENDED`, `XRECHNUNG`, `EXTENDED-CTC-FR` eller `EXTENDED-B2B-FR`
FileName	Det inbäddade XML-filnamnet, vanligtvis `factur-x.xml`, `xrechnung.xml`, `zugferd-invoice.xml` eller `ZUGFeRD-invoice.xml`; ett tomt värde är som standard `factur-x.xml`
Description	Den valfria `/Desc`-text som skrivs till file specification
Relationship	`/AFRelationship`-värdet; ett tomt värde är som standard `Alternative`
Version	Fakturaprofilens version; ett tomt värde är som standard `1.0`
CountryCode	En valfri landsprofilkod, som en tom sträng, `DE` eller `FR`

Returvärden

0	Dokumentet är inte i ett PDF/A-3-läge, kombinationen av XML eller profil är ogiltig, eller faktura-XML har redan lagts till
Non-zero	Object handle för den nyskapade file specification

Anmärkningar

Metoden validerar filnamnet, conformance-nivån, versionen, landsprofilen och /AFRelationship innan bilagan skrivs

COMFORT godtas bara med ZUGFeRD-invoice.xml och version 1.0; zugferd-invoice.xml väljer ZUGFeRD 2.0-profilen, och xrechnung.xml väljer XRECHNUNG-profilen Metoden skriver

DocumentFileName-, DocumentType-, Version- och ConformanceLevel-XMP-fälten och kontrollerar att XML-riktlinje-ID:t matchar den valda profilen. Det normala synliga fakturasidinnehållet skapas fortfarande av anroparen före sparning

Exempel

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

Se även

AddPDFA3AssociatedFileFromString, DetectFacturXInvoice, ValidateFacturXInvoice, ExtractFacturXXMLToString