الامتثال والأرشفة
API Factur-X للفواتير الإلكترونية الهجينة PDF/A-3b
أنشئ فواتير Factur-X بصيغة PDF/A-3b مع XML EN 16931 CII مضمّن عبر مسار API العام E-Invoice Render.
API الرئيسي E-Invoice Render
مسار API
/api/v1/e-invoice/render الأنظمة ERP / خادم خلفي للفوترة / سير عمل امتثال / خدمة أتمتة مالية
المهمة المطلوبة
تغليف PDF فاتورة معروض كـ Factur-X PDF/A-3b مع XML EN 16931 CII مضمّن بعد أن ينتج نظام ERP أو الفوترة بيانات الفاتورة المنظمة الصحيحة.
متى تستخدم هذه API
- تحتاج إلى مخرجات Factur-X أصلية من مسار API العام E-Invoice Render.
- لدى نظامك بالفعل XML EN 16931 CII صالح للفاتورة.
- تحتاج إلى تغليف PDF/A-3b مع بيانات Factur-X وربط الملف المرتبط.
- تريد أن يؤكد مسار القدرات عقد الفاتورة الإلكترونية المنشور حاليًا.
ما الذي لا تستبدله
- تحتاج إلى أن ينشئ gPdf دلالات أعمال الفاتورة أو قرارات الضرائب نيابة عنك.
- تحتاج إلى XRechnung أو FatturaPA أو KSeF أو Peppol أو ZATCA أو NF-e أو معايير أخرى غير مدرجة في OpenAPI كمخرجات أصلية.
- تحتاج إلى إرسال مباشر إلى Chorus Pro أو بوابة حكومية أخرى.
أي مسار API يجب استدعاؤه
/api/v1/e-invoice/render
E-Invoice Render هو المسار الافتراضي لسير العمل هذا.
/api/v1/e-invoice/capabilities
استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.
طلب مختصر
POST /api/v1/e-invoice/render - شكل حزمة Factur-X بسيط.
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "factur_x",
"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": "Factur-X invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
ما يتولاه gPdf
- تغليف Factur-X عبر E-Invoice Render.
- معالجة ملف PDF/A-3b لفاتورة PDF الهجينة.
- تضمين CII XML كملف مرتبط مع بيانات المعيار.
- تسليم PDF مباشرة أو سلوك تسليم كائنات كما هو موثق.
ما يبقى ضمن مسؤولية نظامك
- صحة XML EN 16931 CII، وأرقام الفواتير، ومنطق الضرائب، وبيانات البائع والمشتري، والأهلية.
- التحقق الخارجي، وقواعد المستلم، وإرسال البوابة، والتفسير القانوني.
- التخزين، وسجل التدقيق، ومنطق إعادة المحاولة، والتسليم إلى العميل أو البوابة.
قائمة فحص الإنتاج
- تحقق من CII XML قبل إرساله إلى gPdf.
- اضبط settings.profile على pdfa-3b أو اتركه فارغًا حتى يطبق افتراض الفاتورة الإلكترونية.
- استخدم settings.e_invoice.standard = factur_x و settings.e_invoice.profile = en16931.
- مرر ملف PDF العائد عبر سير التحقق الخاص بـ Factur-X لديك.
- أبق الإرسال وتوجيه المستلم خارج API العرض.
حدود الادعاءات
- المخرجات الأصلية العامة للفواتير الإلكترونية هي Factur-X أو ZUGFeRD مع XML EN 16931 CII.
- لا يرسل gPdf الفواتير إلى بوابات حكومية أو بوابات مشترين.
- يملك نظامك صحة الأعمال والضرائب وXML.
Factur-X هو سير تغليف فاتورة إلكترونية
يجمع Factur-X بين PDF قابل للقراءة البشرية وXML EN 16931 CII قابل للقراءة آليًا. يغلف مسار API العام في gPdf هذا المزيج داخل مخرجات PDF/A-3b. ولا يقرر دلالات الفاتورة ولا يرسل الملف إلى بوابة.
الأسئلة الشائعة
- أي مسار API يعرض Factur-X؟
- استخدم POST /api/v1/e-invoice/render مع ضبط settings.e_invoice.standard على factur_x.
- هل ينشئ gPdf XML EN 16931؟
- يزوّد نظامك CII XML ويملك صحته التجارية. يغلفه gPdf داخل PDF الهجين.
- هل يدعم gPdf XRechnung في هذه الصفحة؟
- لا. تقتصر هذه الصفحة على عقد Factur-X العام المدرج في OpenAPI.
- هل يرسل gPdf فواتير Factur-X إلى البوابات؟
- لا. يبقى الإرسال وتوجيه المستلمين خارج API العرض.