API PDF/A-3b للأرشفة وسير الفواتير الإلكترونية
أنشئ مخرجات PDF/A-3b باستخدام gPdf وافهم متى يكون PDF/A-3b مجرد ملف أرشفة ومتى يكون غلافًا لفاتورة إلكترونية.
/api/v1/pdf/render إنشاء مستندات PDF/A-3b لسير الأرشفة، واختيار مسار API الفواتير الإلكترونية عندما يجب أن يحمل PDF/A-3b XML EN 16931 الخاص بـ Factur-X أو ZUGFeRD مضمّنًا.
متى تستخدم هذه API
- تحتاج إلى ملف PDF/A-3b للأرشفة لمستند معروض.
- تحتاج إلى توضيح الحد الفاصل بين PDF/A العادي وتغليف الفاتورة الإلكترونية.
- يتحقق سير الامتثال لديك من ملفات PDF المولدة عبر veraPDF أو محرك مرجعي آخر.
- تحتاج إلى صفحة عامة توجه نية البحث عن PDF/A-3b إلى مسار API الصحيح.
ما الذي لا تستبدله
- تحتاج إلى عمليات مرفقات ملفات عشوائية غير موثقة في API العام.
- تحتاج إلى فواتير Factur-X أو ZUGFeRD الإلكترونية عبر JSON Render. استخدم E-Invoice Render.
- تحتاج إلى API للتحقق فقط. سطح التحقق العام الحالي هو صفحة /validator/.
أي مسار API يجب استدعاؤه
/api/v1/pdf/render
JSON Render هو المسار الافتراضي لسير العمل هذا.
/api/v1/e-invoice/render
استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.
طلب مختصر
POST /api/v1/pdf/render - طلب مخرجات PDF/A-3b لمستند معروض.
{
"settings": {
"profile": "pdfa-3b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive copy",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
ما يتولاه gPdf
- اختيار ملف PDF/A عبر إعدادات JSON Render.
- تغليف فواتير PDF/A-3b الإلكترونية عند استخدام POST /api/v1/e-invoice/render.
- مخرجات PDF قابلة للعرض ومناسبة للتحقق بمحركات مرجعية خارجية.
- فصل واضح بين ملف الأرشفة وسير الفاتورة الإلكترونية القانونية.
ما يبقى ضمن مسؤولية نظامك
- سياسة الاحتفاظ وسبب الحاجة إلى PDF/A-3b.
- أي بيانات أعمال أو دلالات XML أو معايير قبول امتثال خارجية.
- أدلة التحقق وسجلات التدقيق والتخزين طويل الأجل بعد العرض.
قائمة فحص الإنتاج
- اختر JSON Render لمخرجات PDF/A-3b العادية.
- اختر E-Invoice Render عندما يكون XML EN 16931 المضمّن مطلوبًا.
- تحقق من مخرجات PDF/A عبر /validator/ أو سير veraPDF الخاص بك.
- سجّل الملف المطلوب ومعرّف الطلب مع المستند المخزن.
- تجنب ادعاء دعم المرفقات العشوائية ما لم تدرجها الوثائق العامة.
حدود الادعاءات
- PDF/A-3b ملف أرشفة؛ وتغليف الفاتورة الإلكترونية سير أضيق فوقه.
- لا توحِ بأن كل سير ملفات مضمّنة عشوائي مدعوم.
- مسار الفواتير الإلكترونية مطلوب لحزم Factur-X و ZUGFeRD PDF/A-3b.
PDF/A-3b هو الغلاف، وليس السير بأكمله
PDF/A-3b هو ملف أرشفة PDF. أهميته أنه يمكن أن يعمل كغلاف للفواتير الإلكترونية الهجينة، لكن الملف وحده لا يجعل المستند فاتورة إلكترونية قانونية. يمكن لمستند مؤرشف عادي استخدام PDF/A-3b من دون XML فاتورة مضمّن.
بالنسبة إلى Factur-X و ZUGFeRD، استخدم POST /api/v1/e-invoice/render. هذا المسار مسؤول عن البيانات الوصفية الخاصة بالفاتورة الإلكترونية وربط الملف المرتبط.
اختر مسار API بحسب النية
استخدم JSON Render عندما يكون هدفك “اعرض هذا المستند كـ PDF/A-3b”. واستخدم E-Invoice Render عندما يكون هدفك “غلّف هذه الفاتورة كـ Factur-X أو ZUGFeRD مع XML EN 16931 CII”. هذا الفصل يبقي الكود واضحًا ويمنع وظائف الأرشفة العادية من حمل افتراضات الفواتير الإلكترونية عن طريق الخطأ.
تحقق خارجيًا
يجب التحقق من PDF/A بمحرك مرجعي، لا بادعاء تسويقي. استخدم validator العام أو خط التحقق الخاص بك وخزّن التقرير مع أدلة التدقيق.
الأسئلة الشائعة
- هل PDF/A-3b دائمًا فاتورة إلكترونية؟
- لا. PDF/A-3b ملف PDF للأرشفة. تستخدم فواتير Factur-X و ZUGFeRD الإلكترونية PDF/A-3b كغلاف لـ XML EN 16931 المضمّن.
- أي مسار API ينشئ PDF/A-3b؟
- استخدم POST /api/v1/pdf/render مع settings.profile لمخرجات PDF/A-3b العادية. استخدم POST /api/v1/e-invoice/render عندما يجب أن تكون المخرجات فاتورة إلكترونية Factur-X أو ZUGFeRD.
- هل يمكنني إرفاق ملفات عشوائية عبر هذه الصفحة؟
- لا تفترض دعم المرفقات العشوائية ما لم تدرج الوثائق العامة ذلك السير. تركز هذه الصفحة على PDF/A-3b وسير الفواتير الإلكترونية الموثقين.
- كيف أتحقق من مخرجات PDF/A؟
- استخدم /validator/ أو خط محركات مرجعية خاص بك. بالنسبة إلى الفواتير الإلكترونية، تحقق من طبقة PDF/A وطبقة XML المضمّنة.