أي مسار API أستخدم لمخرجات PDF/A العامة؟

استخدم POST /api/v1/pdf/render مع قيمة settings.profile المناسبة لمخرجات PDF/A العادية.

متى أحتاج إلى E-Invoice Render؟

استخدم E-Invoice Render عندما يجب أن يكون المستند حزمة Factur-X أو ZUGFeRD PDF/A-3b مع CII XML مضمّن.

هل يتحقق gPdf من قبول الأرشفة؟

لا. يعرض gPdf مخرجات PDF/A. يجب أن يتحقق نظامك من المخرجات مقابل سياسة قبول الأرشيف أو العميل.

هل يمكن دمج PDF/A مع إعدادات الأمن؟

ليس في Render API العام الحالي. settings.profile و settings.security متعارضان، وتفشل التركيبات غير الصالحة في التحقق.

الامتثال والأرشفة

API PDF/A لإنشاء PDF للأرشفة

أنشئ مخرجات PDF/A من طلبات JSON Render لسير الأرشفة، مع حدود واضحة بين ملفات PDF/A وتغليف الفواتير الإلكترونية.

API الرئيسي JSON Render

مسار API /api/v1/pdf/render

الأنظمة خادم خلفي للامتثال / خدمة أرشفة / خدمة تصدير ERP / خدمة أتمتة مستندات

جرّب في Playground اقرأ الوثائق

المهمة المطلوبة

إنشاء مخرجات بملف PDF/A من طلبات مستندات منظمة عندما يحتاج سير عمل تجاري إلى ملفات PDF مناسبة للأرشفة، مع اختيار E-Invoice Render فقط عندما يكون تغليف XML الفاتورة المضمّن مطلوبًا.

متى تستخدم هذه API

يحتاج سير العمل لديك إلى اختيار ملف PDF/A في إعدادات العرض.
تحتاج إلى مخرجات فواتير أو كشوف أو تقارير أو مستندات للأرشفة.
تريد صفحة PDF/A عامة أوسع من تغليف الفواتير الإلكترونية PDF/A-3b.
تستطيع التحقق من الملف الناتج عبر سير قبول الأرشفة الخاص بك.

ما الذي لا تستبدله

تحتاج إلى Factur-X أو ZUGFeRD مع XML EN 16931 CII مضمّن. استخدم E-Invoice Render.
تحتاج إلى سير تحقق فقط. استخدم صفحات validator لسياق التحقق.
تحتاج إلى مخرجات مشفرة وPDF/A في الطلب نفسه. يعامل Render API العام إعدادات الأمن وإعدادات ملف PDF/A كخيارات متعارضة.

أي مسار API يجب استدعاؤه

الرئيسي

/api/v1/pdf/render

JSON Render هو المسار الافتراضي لسير العمل هذا.

ثانوي 1

/api/v1/e-invoice/render

استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.

طلب مختصر

POST /api/v1/pdf/render - إعداد مخرجات PDF/A عادي.

{
  "settings": {
    "profile": "pdfa-2b"
  },
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 20,
          "y": 24,
          "content": "Archive-ready document",
          "style": { "font_size": 16, "font_family": "NotoSans-Regular" }
        }
      ]
    }
  ]
}

ما يتولاه gPdf

إعدادات ملفات PDF/A في طلبات JSON Render.
عرض مستندات بنصوص وجداول وصور وباركود وبيانات وصفية ومخرجات profile.
تغليف فواتير PDF/A-3b الإلكترونية فقط عبر مسار E-Invoice Render.
استجابة PDF ثنائية مع سلوك أخطاء مشترك.

ما يبقى ضمن مسؤولية نظامك

سياسة الأرشفة واختيار الملف وسير التحقق والاحتفاظ والقبول القانوني.
دلالات المستند وبيانات الأعمال وأي أدلة خارجية مطلوبة.
التخزين والتحكم في الوصول وسياسة الترحيل المستقبلية.

قائمة فحص الإنتاج

اختر ملف PDF/A المطلوب من الأرشيف أو العميل.
مرر المخرجات عبر validator وسير قبول الاحتفاظ لديك.
أبق PDF/A وإعدادات الأمن في مسارات عرض منفصلة ما لم تضف الوثائق العامة عقدًا متوافقًا.
استخدم E-Invoice Render عندما يكون CII XML المضمّن مطلوبًا.
خزّن بيانات المصدر أو PDF العائد وفق سياسة الاحتفاظ.

حدود الادعاءات

مخرجات PDF/A ليست مساوية لتغليف الفاتورة الإلكترونية القانونية.
لا يستبدل gPdf سير قبول الأرشفة أو التحقق لديك.
يملك نظامك الاحتفاظ وتفسير الامتثال.

PDF/A اختيار ملف

بالنسبة إلى مستندات الأرشفة العادية، يتم اختيار PDF/A عبر إعدادات العرض. هذا يبقي السير قريبًا من JSON Render: يصف نظامك المستند ويحدد الملف الذي يحتاجه.

تغليف الفواتير الإلكترونية مختلف. عندما يحتاج المستند إلى Factur-X أو ZUGFeRD مع CII XML مضمّن، استخدم مسار E-Invoice Render.

الأسئلة الشائعة

أي مسار API أستخدم لمخرجات PDF/A العامة؟: استخدم POST /api/v1/pdf/render مع قيمة settings.profile المناسبة لمخرجات PDF/A العادية.
متى أحتاج إلى E-Invoice Render؟: استخدم E-Invoice Render عندما يجب أن يكون المستند حزمة Factur-X أو ZUGFeRD PDF/A-3b مع CII XML مضمّن.
هل يتحقق gPdf من قبول الأرشفة؟: لا. يعرض gPdf مخرجات PDF/A. يجب أن يتحقق نظامك من المخرجات مقابل سياسة قبول الأرشيف أو العميل.
هل يمكن دمج PDF/A مع إعدادات الأمن؟: ليس في Render API العام الحالي. settings.profile و settings.security متعارضان، وتفشل التركيبات غير الصالحة في التحقق.