API كشوف PDF لتصديرات الحساب والفوترة
أنشئ كشوف حساب وفوترة ونشاط بصيغة PDF مع صفوف متعددة الصفحات وإجماليات وبيانات وصفية وإعدادات PDF/A اختيارية للأرشفة.
/api/v1/pdf/render عرض كشوف PDF للعملاء أو الحسابات أو الفوترة من بيانات الفترة والأرصدة الافتتاحية والبنود والتعديلات والإجماليات، حتى يتمكن المستخدمون من تنزيل سجل متسق للمراجعة أو الاحتفاظ.
متى تستخدم هذه API
- يملك نظامك بالفعل الأرصدة وفترات الكشف وصفوف المعاملات والإجماليات.
- تحتاج إلى تصدير PDF لتاريخ الحساب أو ملخصات الفوترة أو سير المالية.
- تحتاج إلى مخرجات متعددة الصفحات قابلة للإعادة مع ترويسات وتذييلات وأقسام ملخص.
- قد تحتاج إلى مخرجات PDF/A لسير الأرشفة.
ما الذي لا تستبدله
- تحتاج إلى اتصال بنكي أو تسوية دفتر الأستاذ أو نصيحة مالية.
- تحتاج إلى كشوف مشفرة وPDF/A في طلب العرض نفسه. يعامل Render API العام إعدادات الأمن وإعدادات ملف PDF/A كخيارات متعارضة.
- تحتاج إلى تغليف XML لفاتورة إلكترونية. استخدم مسار E-Invoice Render لذلك.
أي مسار API يجب استدعاؤه
/api/v1/pdf/render
JSON Render هو المسار الافتراضي لسير العمل هذا.
/api/v1/template-render
استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.
طلب مختصر
POST /api/v1/pdf/render - صفحة غلاف كشف تتضمن إجماليات الفترة.
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "letter",
"elements": [
{
"type": "text",
"x": 18,
"y": 20,
"content": "Account Statement",
"style": { "font_size": 18, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 18,
"y": 38,
"content": "Period: 2026-05-01 to 2026-05-31\nOpening balance: $1,240.00\nClosing balance: $1,890.25",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
}
]
}
]
}
ما يتولاه gPdf
- عرض DocumentRequest لصفحات الكشوف.
- كتل النص والجداول وأقسام الإجماليات وترقيم الصفحات والبيانات الوصفية وإعدادات PDF/A.
- Template Render لتخطيط كشف مستقر وعقد حقول واضح.
- مخرجات PDF ثنائية مناسبة للتنزيل أو التخزين بواسطة نظامك.
ما يبقى ضمن مسؤولية نظامك
- منطق فترة الكشف وأرصدة الحساب وبيانات المعاملات وقواعد العملة وهوية العميل.
- سياسة الأرشفة والتحكم في الوصول وتسمية الملفات والتسليم الآمن.
- أي تسوية أو موافقة تدقيق أو بيان مالي منظم.
قائمة فحص الإنتاج
- اختبر أوصاف المعاملات الطويلة وكثرة الصفوف والفترات الفارغة والأرصدة السالبة.
- أنشئ معرّف طلب لكل عرض كشف.
- قرر ما إذا كان الكشف سيعرض عند الطلب أو يخزن بعد إغلاق الفترة.
- استخدم PDF/A فقط عندما تتطلب سياسة أرشفة الكشف ذلك.
- أبق التحكم في الوصول ومصادقة العملاء خارج API العرض.
حدود الادعاءات
- لا يحسب gPdf أرصدة الحسابات ولا يسوي دفاتر الأستاذ.
- يعرض API كشوف PDF؛ ويملك نظامك الصحة المالية.
- مخرجات PDF/A إعداد عرض، وليست بديلًا عن سياسة احتفاظ.
الكشوف مستندات فترة
يجب أن تبدأ صفحة الكشف من مجموعة مغلقة من حقائق الأعمال: الحساب، والفترة، والرصيد الافتتاحي، وصفوف النشاط، والتعديلات، والرصيد الختامي. لا يقرر gPdf هذه الحقائق. بل يعرضها داخل تخطيط PDF يمكن للمستخدمين تنزيله أو يمكن لنظامك تخزينه.
التعامل مع مجموعات صفوف كبيرة
عند كثرة الصفوف، صمّم الكشف كتخطيط قابل للإعادة مع مناطق جداول وأقسام ملخص وأرقام صفحات. استخدم JSON Render أثناء ضبط التخطيط. وانتقل إلى Template Render عندما يستقر عقد الحقول.
الأسئلة الشائعة
- هل يستطيع gPdf حساب أرصدة الكشف؟
- لا. يرسل نظامك الفترة والأرصدة والصفوف والإجماليات. يعرض gPdf ملف PDF.
- هل يمكن للكشوف PDF استخدام PDF/A؟
- نعم، يدعم JSON Render إعدادات PDF/A. تحدد سياسة الأرشفة لديك ما إذا كان PDF/A مطلوبًا.
- هل يجب أن تستخدم الكشوف Template Render؟
- عادةً نعم بعد استقرار التخطيط. يتيح Template Render للمتصلين إرسال بيانات الفترة دون تكرار إحداثيات الصفحات.
- هل يخزن gPdf الكشوف؟
- لا. تعيد طلبات العرض القياسية استجابة PDF. يملك نظامك التخزين والتحكم في الوصول.