AddFacturXAssociatedFileFromString

Vlastnosti dokumentu

Popis

Zapíše XML e-faktury jako associated file PDF/A-3 a vygeneruje požadovaná metadata e-faktur XMP pro profily Factur-X, ZUGFeRD a XRechnung

Syntaxe

Delphi

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

Parametry

XMLBytes	Surové bajty XML v UTF-8 k vložení
ConformanceLevel	Úroveň profilu faktury, například `MINIMUM`, `BASIC WL`, `BASIC`, `EN16931`, `EXTENDED`, `XRECHNUNG`, `EXTENDED-CTC-FR` nebo `EXTENDED-B2B-FR`
FileName	Název vloženého XML souboru, obvykle `factur-x.xml`, `xrechnung.xml`, `zugferd-invoice.xml` nebo `ZUGFeRD-invoice.xml`; prázdná hodnota defaultně `factur-x.xml`
Description	Nepovinný text /Desc zapsaný do specifikace souboru
Relationship	Hodnota `/AFRelationship`; prázdná hodnota defaultně `Alternative`
Version	Verze profilu faktury; prázdná hodnota defaultně `1.0`
CountryCode	An optional country profile code, such as an empty string, `DE`, or `FR`

Návratové hodnoty

0	Dokument není v režimu PDF/A-3, kombinace XML nebo profilu je neplatná, případně již bylo přidáno fakturační XML
Non-zero	Handle objektu nově vytvořené specifikace souboru

Poznámky

Metoda zvaliduje název souboru, úroveň shody, verzi, kód země profilu i /AFRelationship dřív, než zapíše přílohu

COMFORT se přijímá jen s ZUGFeRD-invoice.xml a verzí 1.0; zugferd-invoice.xml volí profil ZUGFeRD 2.0 a xrechnung.xml volí profil XRECHNUNG

Metoda zapíše do polí XMP DocumentFileName, DocumentType, Version a ConformanceLevel a ověří, že identifikátor XML směrnice odpovídá vybranému profilu. Běžný viditelný obsah fakturační stránky stále vytvoří volající před uložením

Příklad

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

Viz také

AddPDFA3AssociatedFileFromString, DetectFacturXInvoice, ValidateFacturXInvoice, ExtractFacturXXMLToString