هل هذا endpoint منفصل؟

واجهة API لـ إيصالات PDF يربط workflow بمسار API عام في gPdf. توضح الصفحة أي path يجب استدعاؤه وما الذي يملكه request.

هل يمكن استخدام templates؟

نعم. استخدم JSON Render عندما يتغير layout، ثم Template Render بعد اعتماد layout وإرسال callers لبيانات العمل فقط.

ما الذي يجب التحقق منه قبل الإنتاج؟

تحقق ببيانات حقيقية وبالطابعات، الماسحات، validators، أنظمة المحاسبة أو marketplace حسب workflow.

Invoicing and finance

واجهة API لـ إيصالات PDF في أنظمة الإنتاج

أنشئ إيصالات PDF من بيانات backend منظمة بدون متصفح، مع فصل واضح بين PDF rendering الذي ينفذه gPdf ومنطق العمل في نظامك.

API الرئيسي JSON Render

ENDPOINT /api/v1/pdf/render

الأنظمة backend تشغيلي / نظام مالي / workflow امتثال / خدمة مستندات

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

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

إنشاء إيصالات PDF كملف PDF قابل لإعادة الإنتاج من بيانات منظمة. يتولى gPdf إخراج PDF، بينما يبقى معنى البيانات وحالة workflow في نظامك.

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

لدى backend بيانات إيصالات PDF بالفعل ويحتاج إلى استجابة PDF ثابتة.
تريد تجنب Chromium أو HTML-to-PDF في مستندات التشغيل.
تحتاج إلى output قابل للإعادة للطباعة، التدقيق أو المعالجة الدفعية.

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

gPdf لا يشتري الشحن، لا يقدّم ضرائب، لا ينشئ أوامر خارجية ولا يعمل كنظام ضريبي.
لا يستبدل data validation أو business rules أو تكاملات marketplace.

أي endpoint يجب استدعاؤه

الرئيسي

/api/v1/pdf/render

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

ثانوي 1

/api/v1/template-render

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

Request مختصر

/api/v1/pdf/render - إيصالات PDF

{
  "pages": [
    {
      "size": "a6",
      "elements": [
        {
          "type": "text",
          "x": 10,
          "y": 12,
          "content": "Receipt R-2026-1001",
          "style": { "font_size": 16, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "text",
          "x": 10,
          "y": 28,
          "content": "Order total: $82.40\nPaid by card ending 4242\nTax: $6.10",
          "style": { "font_size": 10, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "qrcode",
          "content": "https://example.com/receipts/R-2026-1001",
          "x": 10,
          "y": 58,
          "width": 28,
          "height": 28
        }
      ]
    }
  ]
}

ما يتولاه gPdf

PDF rendering لـ إيصالات PDF من request منظم.
النصوص، الجداول، الخطوط، الباركود، الصفحات، metadata وخيارات الإخراج حسب request.
Output حتمي للـ retry وإعادة الطباعة والتدقيق.

ما يملكه نظامك

البيانات الصحيحة لـ إيصالات PDF، قواعد العمل وحالة العملية.
Authentication، التخزين، workflows الخارجية والتحقق لدى النظام المستقبل.

Checklist الإنتاج

اختبر ببيانات حقيقية وبالأنظمة التي ستستهلك PDF.
احتفظ بـ request IDs وأدلة التحقق للدعم، التدقيق وإعادة الطباعة.
حوّل layout المعتمد إلى template عندما تعيد عدة أنظمة استخدامه.

حدود الادعاء

gPdf يرندر PDF من request؛ لا يستبدل product workflow أو database أو business validation.
Data semantics، retries، storage وfinal acceptance تبقى في نظامك.

شكل API

واجهة API لـ إيصالات PDF هو production workflow مبني على APIs العامة في gPdf. يصف request البيانات، layout، settings وأجزاء PDF المطلوب render لها. ينشئ gPdf ملف PDF؛ ويبقى معنى business event في نظامك.

اختيار endpoint

الـ endpoint الافتراضي لهذا workflow هو /api/v1/pdf/render. استخدم Template Render بعد اعتماد layout وإعادة استخدامه بين الأنظمة. استخدم E-Invoice Render فقط عند الحاجة إلى Factur-X / ZUGFeRD PDF/A-3b مع EN 16931 CII XML مدمج.

التحقق قبل الإنتاج

تحقق من إيصالات PDF ببيانات حقيقية وبالأنظمة downstream. احتفظ بـ request IDs، output وأدلة validation للدعم، التدقيق وإعادة الطباعة.

FAQ

هل هذا endpoint منفصل؟: واجهة API لـ إيصالات PDF يربط workflow بمسار API عام في gPdf. توضح الصفحة أي path يجب استدعاؤه وما الذي يملكه request.
هل يمكن استخدام templates؟: نعم. استخدم JSON Render عندما يتغير layout، ثم Template Render بعد اعتماد layout وإرسال callers لبيانات العمل فقط.
ما الذي يجب التحقق منه قبل الإنتاج؟: تحقق ببيانات حقيقية وبالطابعات، الماسحات، validators، أنظمة المحاسبة أو marketplace حسب workflow.