الامتثال والأرشفة
API ZUGFeRD للفواتير الهجينة PDF/A-3b
أنشئ فواتير ZUGFeRD بصيغة PDF/A-3b مع XML EN 16931 CII مضمّن باستخدام مسار API العام E-Invoice Render في gPdf.
API الرئيسي E-Invoice Render
مسار API
/api/v1/e-invoice/render الأنظمة ERP / خادم خلفي للفوترة / سير مالي ألماني / خدمة أتمتة امتثال
المهمة المطلوبة
تغليف مخرجات PDF الفاتورة كـ ZUGFeRD PDF/A-3b مع XML EN 16931 CII مضمّن بعد أن يجهز نظام ERP أو الفوترة بيانات الفاتورة الصحيحة.
متى تستخدم هذه API
- تحتاج إلى مخرجات ZUGFeRD أصلية من مسار API العام E-Invoice Render.
- لدى نظامك بالفعل XML EN 16931 CII صالح للفاتورة.
- تحتاج إلى تغليف PDF/A-3b مع بيانات ZUGFeRD وربط الملف المرتبط.
- تحتاج إلى صفحة شقيقة واضحة للصفحات الأوسع عن الفاتورة الإلكترونية وFactur-X.
ما الذي لا تستبدله
- تحتاج إلى إنشاء XRechnung أصلي أو إرسال إلى بوابة.
- تحتاج إلى أن يحسب gPdf الضرائب أو يستنتج دلالات الفاتورة أو ينشئ XML من سجلات محاسبية.
- تحتاج إلى معايير غير مدرجة في عقد OpenAPI العام.
أي مسار API يجب استدعاؤه
/api/v1/e-invoice/render
E-Invoice Render هو المسار الافتراضي لسير العمل هذا.
/api/v1/e-invoice/capabilities
استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.
طلب مختصر
POST /api/v1/e-invoice/render - شكل حزمة ZUGFeRD بسيط.
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "zugferd",
"profile": "en16931",
"document_type": "invoice",
"xml": {
"format": "cii",
"encoding": "utf8",
"content": "<rsm:CrossIndustryInvoice>...</rsm:CrossIndustryInvoice>"
}
}
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "ZUGFeRD invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
ما يتولاه gPdf
- تغليف ZUGFeRD عبر E-Invoice Render.
- معالجة ملف PDF/A-3b لمخرجات الفاتورة الهجينة.
- تضمين CII XML كملف مرتبط مع بيانات ZUGFeRD.
- سلوك التسليم المباشر لـ PDF أو التسليم ككائن كما هو موثق.
ما يبقى ضمن مسؤولية نظامك
- صحة XML EN 16931 CII وبيانات الفاتورة ومنطق الضرائب ودلالات البائع والمشتري.
- التحقق الخارجي ومتطلبات المستلم وإرسال البوابة والتفسير القانوني.
- سلوك إعادة المحاولة والتخزين وأدلة التدقيق وتسليم العميل.
قائمة فحص الإنتاج
- اضبط settings.e_invoice.standard = zugferd و settings.e_invoice.profile = en16931.
- استخدم CII XML مع format = cii و encoding = utf8.
- اضبط settings.profile على pdfa-3b أو اتركه فارغًا حتى يطبق افتراض الفاتورة الإلكترونية.
- تحقق من PDF العائد عبر سير التحقق الخاص بـ ZUGFeRD لديك.
- أبق عمل XRechnung أو إرسال البوابات خارج هذا المسار.
حدود الادعاءات
- تغطي هذه الصفحة مخرجات ZUGFeRD عبر E-Invoice Render.
- لا تدعي إنشاء XRechnung أصلي.
- يملك نظامك بيانات أعمال الفاتورة وصحة XML.
يستخدم ZUGFeRD مسار عرض الفاتورة الإلكترونية
ZUGFeRD ليس مسارًا جذريًا منفصلًا. يتم اختياره عبر حقل settings.e_invoice.standard على POST /api/v1/e-invoice/render. ينطبق الحد نفسه: يغلف gPdf الفاتورة الهجينة PDF/A-3b؛ ويملك نظامك حقائق الفاتورة وصحة XML.
الأسئلة الشائعة
- أي مسار API يعرض ZUGFeRD؟
- استخدم POST /api/v1/e-invoice/render مع ضبط settings.e_invoice.standard على zugferd.
- هل تغطي هذه الصفحة XRechnung؟
- لا. تقتصر هذه الصفحة على عقد ZUGFeRD العام. لا يتم الادعاء بأن XRechnung مخرج أصلي هنا.
- هل ينشئ gPdf CII XML؟
- يزوّد نظامك XML EN 16931 CII ويملك صحته.
- هل يمكنني التحقق من النتيجة؟
- استخدم سير التحقق الخاص بـ ZUGFeRD لديك وصفحات validator في gPdf لسياق التحقق.