AddFacturXAssociatedFileFromString

Dokumentegenskaber

Beskrivelse

Skriver XML for e-faktura som en tilknyttet PDF/A-3-fil og genererer de nødvendige XMP-metadata for e-faktura til profilerne Factur-X, ZUGFeRD og XRechnung

Syntaks

Delphi

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

Parametre

XMLBytes	De rå UTF-8-XML-bytes, der skal integreres
ConformanceLevel	Fakturaprofilniveauet, såsom `MINIMUM`, `BASIC WL`, `BASIC`, `EN16931`, `EXTENDED`, `XRECHNUNG`, `EXTENDED-CTC-FR` eller `EXTENDED-B2B-FR`
FileName	Navnet på den indlejrede XML-fil, normalt `factur-x.xml`, `xrechnung.xml`, `zugferd-invoice.xml` eller `ZUGFeRD-invoice.xml`; en tom værdi bruger som standard `factur-x.xml`
Beskrivelse	Den valgfrie `/Desc`-tekst, der skrives til filspecifikationen
Relationship	Værdien `/AFRelationship`; en tom værdi bruger som standard `Alternative`
Version	Fakturaprofilens version; en tom værdi bruger som standard `1.0`
CountryCode	En valgfri landekode for profilen, f.eks. en tom streng, `DE` eller `FR`

Returværdier

0	Dokumentet er ikke i en PDF/A-3-tilstand, kombinationen af XML og profil er ugyldig, eller faktura-XML er allerede tilføjet
Non-zero	Objekthåndtaget for den nyoprettede filspecifikation

Bemærkninger

Metoden validerer filnavnet, overensstemmelsesniveauet, versionen, landeprofilen og /AFRelationship, før den skriver den vedhæftede fil

COMFORT accepteres kun med ZUGFeRD-invoice.xml og version 1.0; zugferd-invoice.xml vælger ZUGFeRD 2.0-profilen, og xrechnung.xml vælger profilen XRECHNUNG

Metoden skriver XMP-felterne DocumentFileName, DocumentType, Version og ConformanceLevel og kontrollerer, at XML-retningslinjens id svarer til den valgte profil. Det normale synlige fakturaindhold oprettes fortsat af kalderen før lagring

Eksempel

// 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 også

AddPDFA3AssociatedFileFromString, DetectFacturXInvoice, ValidateFacturXInvoice, ExtractFacturXXMLToString