AddFacturXAssociatedFileFromString

ویژگی‌های سند

توضیحات

XML فاکتور الکترونیکی را به‌عنوان فایل مرتبط PDF/A-3 می‌نویسد و فرادادهٔ XMP لازم فاکتور الکترونیکی را برای پروفایل‌های Factur-X، ZUGFeRD و XRechnung تولید می‌کند

نحو

Delphi

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

پارامترها

XMLBytes	بایت‌های خام XML یونیکد برای تعبیه
ConformanceLevel	سطح پروفایل فاکتور، مانند `MINIMUM`، `BASIC WL`، `BASIC`، `EN16931`، `EXTENDED`، `XRECHNUNG`، `EXTENDED-CTC-FR` یا `EXTENDED-B2B-FR`
FileName	نام فایل XML تعبیه‌شده، معمولاً `factur-x.xml`، `xrechnung.xml`، `zugferd-invoice.xml` یا `ZUGFeRD-invoice.xml`؛ مقدار خالی پیش‌فرضش `factur-x.xml` است
Description	متن اختیاری `/Desc` که در مشخصات فایل نوشته می‌شود
Relationship	مقدار `/AFRelationship`؛ مقدار خالی پیش‌فرضش `Alternative` است
Version	نسخهٔ پروفایل فاکتور؛ مقدار خالی پیش‌فرضش `1.0` است
CountryCode	کد پروفایل کشوری اختیاری، مانند رشتهٔ خالی، `DE` یا `FR`

مقادیر بازگشتی

0	سند در حالت PDF/A-3 نیست، ترکیب XML یا profile نامعتبر است یا XML فاکتور از قبل اضافه شده است
Non-zero	هندل شیء مشخصات فایل تازه‌ساخته‌شده

ملاحظات

متد پیش از نوشتن پیوست، نام فایل، سطح انطباق، نسخه، پروفایل کشوری و /AFRelationship را اعتبارسنجی می‌کند

COMFORT فقط با ZUGFeRD-invoice.xml و نسخهٔ 1.0 پذیرفته می‌شود؛ zugferd-invoice.xml پروفایل ZUGFeRD 2.0 و xrechnung.xml پروفایل XRECHNUNG را انتخاب می‌کند

این متد فیلدهای XMP DocumentFileName، DocumentType، Version و ConformanceLevel را می‌نویسد و بررسی می‌کند شناسه راهنمای XML با پروفایل انتخاب‌شده مطابقت داشته باشد. محتوای عادی و قابل‌مشاهده صفحه فاکتور همچنان پیش از ذخیره‌سازی توسط فراخوان ایجاد می‌شود

مثال

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

همچنین ببینید

AddPDFA3AssociatedFileFromString، DetectFacturXInvoice، ValidateFacturXInvoice، ExtractFacturXXMLToString