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 الخام بترميز UTF-8 المطلوب تضمينها
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 وملف تعريف غير صالحة أو أُضيف XML فاتورة سلفًا
Non-zeroمقبض كائن مواصفة الملف المنشأة حديثًا

ملاحظات

يتحقق التابع من اسم الملف ومستوى الامتثال والإصدار وملف تعريف البلد و/AFRelationship قبل كتابة المرفق

400 نوع الصورة، و401 العرض بالبكسل، و402 الارتفاع بالبكسل، و403 البتات لكل بكسل، و404 نوع فضاء اللون، و405 مقبض الصورة، أو 406 معرّف صورة ثابت، أو 407 رقم كائن الصورة

تكتب الطريقة حقول 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