الفاتورة

لمحة سريعة

يُنتج ⁨NextPDF Enterprise⁩ فواتير مختلطة مُنظَّمة بصيغ ⁨ZUGFeRD / Factur-X / Peppol-UBL⁩ ويتحقّق من ⁨XML⁩ الفاتورة مقابل النموذج البياني ⁨EN 16931⁩ ومجموعات قواعد ⁨Schematron.⁩ يُنتج فواتير مُنظَّمة مطابقة للنموذج البياني المُعرَّف في ⁨EN 16931⁩؛ وهو ليس أداة تحقّق تابعة لسلطة ضريبية ولا يُصادق على أي مستند.

التوفّر والترخيص

تُشحن هذه الإمكانية في ⁨NextPDF Enterprise⁩ (nextpdf/enterprise) وتُفعَّل بحزمة ترخيص من فئة ⁨Enterprise⁩. ولا يُحمِّل نشرٌ يفتقر إلى ذلك الاستحقاق أصناف هذه الإمكانية. قارن الإصدارات واحصل على ترخيص.

التثبيت

composer require nextpdf/enterprise:^3

يستخدم محرك ⁨Schematron⁩ امتداد ⁨PHP⁩ ‏ext-xsl. ثبّته وفعّله قبل تشغيل التحقّق عبر ⁨Schematron.⁩

نظرة مفاهيمية عامة

لوحدة الفاتورة ثلاثة أسطح مستقلة: تضمين الفاتورة المُنظَّمة، والتحقّق من ⁨XML⁩ وفق ⁨EN 16931⁩، وتنفيذ قواعد ⁨Schematron⁩.

التضمين. يُرفِق ZugferdEmbedder حمولة ⁨XML⁩ من نوع ⁨ZUGFeRD 2.4 / Factur-X 1.08 UN/CEFACT CII⁩ يزوّدها المستدعي إلى حامل ⁨PDF/A⁩، فيُنتج فاتورة مختلطة. يُدعم شكلا حامل: ⁨PDF/A-4f⁩ (⁨ISO 19005-4:2020⁩)، الحامل الحديث المُفضَّل، و⁨PDF/A-3b⁩ (⁨ISO 19005-3:2012⁩) للتوافق الخلفي. يحقن ZugferdXmpSchema إعلان مخطط امتداد ⁨Factur-X XMP⁩ الذي يحتاجه الحامل. ويؤدّي PeppolEmbedder الدور نفسه لحمولة ⁨XML⁩ من نوع فاتورة أو إشعار دائن ⁨Peppol BIS Billing 3.0 UBL 2.1⁩ يزوّدها المستدعي، فيُرفِقها بعلاقة الملف المُرتبط الصحيحة ونوع ⁨MIME⁩ الصحيح. لا يُركّب ⁨NextPDF⁩ ⁨XML⁩ الفاتورة؛ بل يزوّد المستدعي ⁨XML⁩ صالحًا ويبقى هو مُصدِر الفاتورة.

التحقّق. يفحص InvoiceXmlValidator ⁨XML⁩ الفاتورة مقابل النموذج البياني الدلالي ⁨EN 16931⁩ وتوقّعات حاوية ⁨ZUGFeRD / Factur-X⁩، بما في ذلك مُعرِّف المواصفة ⁨BT-24⁩ الذي تُلزِم به قاعدة العمل ⁨BR-1⁩ في ⁨EN 16931.⁩ ويعمل بأحد وضعين: COMPAT (الافتراضي؛ تُبلَّغ نتائج عددية حدّية وفق ⁨EN 16931⁩ كتحذيرات للحفاظ على التوافق الخلفي مع التجهيزات القائمة) وSTRICT (عدد ⁨BT-24⁩ خطأ صارم، يحاكي دلالات أداة التحقّق الخارجية). الوضع قابل للاختيار لكل استدعاء، أو بتجاوز بيئي، أو بسياسة مطابقة.

⁨Schematron⁩. يُشغِّل SchematronValidator مجموعات قواعد ⁨Schematron⁩ مُجمَّعة مُسبقًا (قواعد ⁨CEN EN 16931⁩ ‏.sch المُجمَّعة إلى ⁨XSLT⁩ في وقت البناء) على ⁨XML⁩ الفاتورة باستخدام معالج ⁨XSLT⁩ في ⁨PHP⁩ داخل العملية، ويُحلِّل تقرير ⁨SVRL⁩ إلى نتائج مُنظَّمة. ويُمثِّل التعداد ZugferdProfile ملفات تعريف المطابقة — ⁨MINIMUM⁩، و⁨BASIC WL⁩، و⁨BASIC⁩، و⁨EN 16931⁩، و⁨EXTENDED⁩، والملف الألماني ⁨XRechnung B2G CIUS⁩ فوق ⁨EN 16931.⁩

ما الذي تدّعيه هذه الوحدة وما لا تدّعيه

تُنتج هذه الوحدة بيانات فاتورة مُنظَّمة وتفحصها. وهي لا تؤكّد أن أي مستند فاتورة مطابقة قانونيًا، ولا أنها مُعتمَدة من سلطة ضريبية، ولا أن قبولها لدى أي سلطة مضمون.

• يفحص المُتحقِّق النموذج الدلالي ⁨EN 16931⁩ وحاوية ⁨ZUGFeRD / Factur-X / UBL⁩ فقط. وهو ليس أداة تحقّق تابعة لسلطة ضريبية. والامتدادات الوطنية ومنصّات المقاصّة — مثل ⁨SDI⁩ الإيطالي، و⁨Chorus Pro⁩ الفرنسي، ونقل ⁨XRechnung⁩ الألماني — خارج النطاق على مستوى النقل.
• وكما ينصّ ⁨EN 16931-1⁩ نفسه، يحمل النموذج الدلالي الأساسي المعلومات الجوهرية التي تحتاجها الفاتورة الإلكترونية لدعم الامتثال القانوني والضريبي؛ مُصدِر الفاتورة مسؤول عن الوفاء بقواعد التشريعات ذات الصلة. هذه ليست أداة تحقّق تابعة لسلطة ضريبية.
• دعم معيار ما ليس كمطابقته. استشر مستشاريك الضريبيين والامتثاليين للحكم على الكفاية التنظيمية في ولايتك القضائية.

لماذا يعمل بهذه الطريقة

تتعمّد الوحدة ألا تُركّب ⁨XML⁩ الفاتورة مطلقًا. فالتضمين، والتحقّق وفق ⁨EN 16931⁩، وتنفيذ ⁨Schematron⁩ ثلاثة أسطح مستقلة فوق ⁨XML⁩ يزوّده المستدعي ويملكه. وهذا يُبقي ⁨NextPDF⁩ مُنتِجًا وفاحصًا، لا مُصدِرًا أبدًا، لأن المسؤولية القانونية لا يمكن تفويضها إلى مكتبة. ويأخذ التحقّق COMPAT افتراضيًا، فتكون النتيجة العددية الحدّية تحذيرًا لا تراجعًا. وSTRICT اختياري عند حاجتك إلى دلالات أداة التحقّق الخارجية. والنتيجة فصلٌ نظيف: يُبلِّغ ⁨NextPDF⁩ عمّا يلاحظه، ويقرّر المُصدِر ما إذا كان المستند يفي بالقانون. خلفية التصميم: الفواتير والفوترة الإلكترونية.

سطح الـ ⁨API⁩

الصنف	المسؤولية
ZugferdEmbedder	إرفاق ⁨ZUGFeRD / Factur-X CII XML⁩ بحامل ⁨PDF/A-4f⁩ أو ⁨PDF/A-3b.⁩
ZugferdXmpSchema	حقن إعلان مخطط امتداد ⁨Factur-X XMP.⁩
ZugferdProfile	تعداد ملف تعريف المطابقة (⁨MINIMUM … EXTENDED⁩، ⁨XRECHNUNG⁩).
PeppolEmbedder	إرفاق ⁨XML⁩ فاتورة / إشعار دائن ⁨Peppol BIS 3.0 UBL⁩ بحامل ⁨PDF/A.⁩
InvoiceXmlValidator	فحص ⁨XML⁩ مقابل النموذج البياني ⁨EN 16931⁩؛ وضع COMPAT أو STRICT.
InvoiceValidatorMode	تعداد وضع التحقّق: COMPAT (الافتراضي) أو STRICT.
SchematronValidator	تشغيل مجموعات قواعد ⁨Schematron⁩ مُجمَّعة مُسبقًا؛ وتحليل نتائج ⁨SVRL.⁩
InvoiceValidationResult / SchematronResult	نتائج مُنظَّمة: ملف التعريف، والنتائج، ودرجات الخطورة.

مثال شيفرة — بداية سريعة

use NextPDF\Enterprise\Invoice\ZugferdEmbedder;
use NextPDF\Enterprise\Invoice\ZugferdProfile;

$pdf = ZugferdEmbedder::basic($pdfAManager, $fileAttachment, $ciiXml)
    ->embed(ZugferdProfile::EN16931);

مثال شيفرة — إنتاج

use NextPDF\Enterprise\Invoice\InvoiceXmlValidator;
use NextPDF\Enterprise\Invoice\InvoiceValidatorMode;

$result = $validator->validate($ciiXml, InvoiceValidatorMode::STRICT);

foreach ($result->findings as $finding) {
    $logger->warning('invoice.finding', [
        'rule'     => $finding->ruleId,
        'severity' => $finding->severity->value,
    ]);
}
// A clean result is one input to your decision, not a compliance verdict.
// The invoice issuer remains responsible for relevant legislation.

الحالات الحدّية والمزالق

• ملف ⁨PDF⁩ سليم البنية لا يحمل حمولة فاتورة قابلة للتمييز يُنتج نتيجة “ليست فاتورة” بدلًا من إثارة استثناء.
• COMPAT هو وضع التحقّق الافتراضي: يُبلَّغ غياب مُعرِّف المواصفة ⁨BT-24⁩ كـتحذير، حتى لا تتراجع مواقع الاستدعاء التي تبوّب على علم صلاحية منطقي. استخدم STRICT لجعل ⁨BT-24⁩ خطأ صارمًا يطابق دلالات ⁨KoSIT / Mustang⁩ الخارجية.
• يزوّد المستدعي ⁨XML⁩ الفاتورة. ولا يُولِّده ⁨NextPDF⁩ ولا يُصحِّحه؛ وقائمة نتائج فارغة لا تجعل حمولة غير مطابقة مطابقةً.
• يتطلّب محرك ⁨Schematron⁩ ‏ext-xsl. وتُجمَّع مجموعات القواعد في وقت البناء؛ ويُنفِّذ وقتُ التشغيل ⁨XSLT⁩ المُجمَّع مُسبقًا فقط.

الأداء

تتدرّج تكلفة التحقّق مع حجم ⁨XML⁩ المُضمَّن وعدد قواعد ⁨Schematron.⁩ وتتدرّج تكلفة التضمين مع حجم الحامل وتُهيمن عليها مُسلسَلة ⁨PDF/A.⁩ تعكس ميزانية أداء الصفحة تصيير الوثائق، لا إنتاجية الفواتير.

ملاحظات أمنية

يمرّ كل تحليل ⁨XML⁩ عبر حارس ⁨XML⁩ المُحصَّن: تُعطَّل تسوية الكيانات الخارجية (آمن ضد ⁨XXE⁩)، ويُرفَض DOCTYPE، ويُحدّ فك الضغط. ويعمل معالج ⁨XSLT⁩ مع تعطيل تحميل موارد الشبكة ونظام الملفات ولا يُسجِّل دوال ⁨PHP⁩ مطلقًا، لذا لا يمكن لـ document() وxsl:include وxsl:import وresult-document بلوغ الشبكة أو القرص. عامِل ⁨XML⁩ الفاتورة من مصادر غير موثوقة على أنه عدائي.

إقامة البيانات وتخفيفات المعلومات الشخصية

قد يحتوي ⁨XML⁩ الفاتورة بيانات شخصية وتجارية ومالية. والمعالجة داخل العملية ومحلية؛ ولا تُجري الوحدة أي اتصال شبكي صادر أثناء التضمين أو التحقّق. طبّق ضوابط الاحتفاظ والتقليل الخاصة بك على ⁨XML⁩ المُستخرَج والنتائج.

القياس الآمن وتنقية السجلات

قد تتضمّن النتائج وسجلات التحقّق مُعرِّفات قواعد وقيم وسوم. وهي لا تتضمّن حمولات الفاتورة الكاملة. نقِّ قيم الحقول أو احجبها قبل إعادة توجيه السجلات إلى مصارف مشتركة إذا كانت تلك القيم حسّاسة.

المطابقة

السلوك	المرجع	الحالة
النموذج الدلالي الأساسي للفاتورة	EN 16931-1:2026 §4	مبني عليه؛ يبقى المُصدِر مسؤولًا عن التشريعات ذات الصلة
مُعرِّف المواصفة (BT-24)	EN 16931-1:2026 BR-1	مفحوص (تحذير في COMPAT، خطأ في STRICT)
ربط بناء UN/CEFACT CII	CEN/TS 16931-3-3:2020	التضمين مدعوم
ربط بناء UBL 2.1	CEN/TS 16931-3-2:2020	التضمين مدعوم
الملف المُرتبط بـ PDF/A-3	ISO 19005-3:2012 §6.7.8	الحامل مدعوم
الملف المُضمَّن بـ PDF/A-4f	ISO 19005-4:2020 Annex A	الحامل مدعوم

يُسجِّل هذا الجدول المواصفات التي بُني عليها ⁨NextPDF Enterprise⁩ وما يفحصه. وهو ليس بيان شهادة، ولا اعتمادًا من سلطة ضريبية، ولا كفاية تنظيمية. مُصدِر الفاتورة مسؤول عن الوفاء بقواعد التشريعات ذات الصلة؛ وهذه ليست أداة تحقّق تابعة لسلطة ضريبية.

سلوك وضع ⁨FIPS⁩

لا تُجري هذه الوحدة أي توقيع تشفيري. توقيع فاتورة مختلطة وحفظ مفاتيح وضع ⁨FIPS⁩ خارج النطاق هنا؛ انظر وحدة التوقيع.

نموذج التهديد

⁨XML⁩ الفاتورة غير الموثوق هو المُدخَل الأساسي. التخفيفات: تحليل آمن ضد ⁨XXE⁩، ورفض DOCTYPE، وفك ضغط محدود، ومعالج ⁨XSLT⁩ مع تعطيل تحميل موارد الشبكة والملفات، وانعدام تركيب الادعاءات — يزوّد المستدعي محتوى الفاتورة ويملكه.

عقد السلوك

• يُرفِق ZugferdEmbedder / PeppolEmbedder ⁨XML⁩ فاتورة يزوّده المستدعي بحامل ⁨PDF/A-4f⁩ أو ⁨PDF/A-3b⁩؛ ولا يُركّب ⁨NextPDF⁩ ⁨XML⁩ الفاتورة مطلقًا.
• يعمل InvoiceXmlValidator بوضع COMPAT (الافتراضي؛ العدد الحدّي وفق ⁨EN 16931⁩ تحذير) أو STRICT (عدد ⁨BT-24⁩ خطأ صارم).
• يُنفِّذ SchematronValidator مجموعات قواعد مُجمَّعة مُسبقًا عبر معالج ⁨XSLT⁩ داخل العملية ويُحلِّل نتائج ⁨SVRL⁩؛ وقائمة نتائج فارغة لا تجعل حمولة غير مطابقة مطابقةً.
• كل تحليل ⁨XML⁩ آمن ضد ⁨XXE⁩: تسوية الكيانات الخارجية مُعطَّلة، وDOCTYPE مرفوض، وفك الضغط محدود.

حدود النشر

توثّق هذه الصفحة السلوك القابل للملاحظة خارجيًا والسطح العام المدعوم من ⁨API⁩ فقط. أما مسارات فضاء الأسماء الداخلية، وأصناف المساعِدة، وجداول الآليات، وأسماء ملفات أدلة التشغيل، وبادئات التذاكر فخارج النطاق.

بديل ⁨Core⁩

لا يُولِّد ⁨NextPDF Core⁩ فواتير مُنظَّمة ولا يتحقّق منها. ويمكن لنشر يقتصر على ⁨Core⁩ أن يُنتج ⁨PDF⁩ لكن لا تضمين ⁨ZUGFeRD / Factur-X / Peppol⁩ لديه، ولا مُتحقِّق ⁨EN 16931⁩، ولا محرك ⁨Schematron.⁩

بديل ⁨Pro⁩

في نشر يقتصر على ⁨Pro⁩، يكون السطح المدعوم هو اكتشاف والتحقّق من الفاتورة الإلكترونية على مستوى ⁨Pro⁩ لحمولات ⁨Factur-X / ZUGFeRD.⁩ ‏⁨Pro⁩ لا يُولِّد حاملات مختلطة بصيغ ⁨ZUGFeRD / Factur-X⁩ أو ⁨Peppol-UBL⁩، ولا يضيف ملف ⁨XRechnung CIUS⁩، ولا يُشغِّل محرك ⁨Schematron⁩ داخل العملية؛ وتهيئة تطلب التوليد أو ملف ⁨XRechnung CIUS⁩ أو ⁨Schematron⁩ في نشر يقتصر على ⁨Pro⁩ لا تملك مكوّن ⁨Enterprise⁩ يُلبّيها. انظر امتثال ⁨Pro⁩ لسطح الاكتشاف والتحقّق في ⁨Pro.⁩

ملاحظة حدود ⁨Enterprise⁩

تبقى تفاصيل الآلية الداخلية في التوثيق الداخلي لمستودع المصدر وهي خارج نطاق هذا الدليل.

حدود التوزيع

يتطلّب محرك ⁨Schematron⁩ امتداد ⁨PHP⁩ ‏ext-xsl؛ وتزويده وتفعيله مسؤولية المُشغِّل. والمعالجة داخل العملية ومحلية؛ ولا تُجري الوحدة أي اتصال شبكي صادر أثناء التضمين أو التحقّق. ونقل الفوترة الإلكترونية الوطني، ومنصّات المقاصّة، وأنظمة الأرشفة خارجة عن هذه الوحدة وهي مسؤولية المُشغِّل.

حدود الامتثال القانوني

يُنتج ⁨NextPDF⁩ فواتير مُنظَّمة مطابقة للنموذج البياني المُعرَّف في ⁨EN 16931⁩ ويُبلِّغ عن نتائج القواعد. وهو لا يُنتج “فواتير مطابقة قانونيًا”، ولا يقدّم ناتجًا “مُعتمَدًا من سلطة ضريبية”، ولا يضمن قبول أي فاتورة لدى سلطة ضريبية أو محكمة أو سجل. مُصدِر الفاتورة مسؤول عن الوفاء بقواعد التشريعات ذات الصلة؛ وهذه ليست أداة تحقّق تابعة لسلطة ضريبية. وتختلف منصّات الفوترة الإلكترونية الوطنية، ونماذج المقاصّة، وتفويضات الأرشفة، ومتطلبات التوقيع الرقمي بحسب الولاية القضائية وهي مسؤولية المُصدِر. استشر مستشاريك الضريبيين والقانونيين.

انظر أيضًا

• مرجع الفاتورة — مرجع على مستوى ⁨API⁩ للمُضمِّنات وأدوات التحقّق ومحرك ⁨Schematron⁩.
• امتثال ⁨Pro⁩ — اكتشاف الفاتورة الإلكترونية والتحقّق منها على مستوى ⁨Pro⁩.
• الإيداع الإلكتروني للمستندات — تحسين التسليم إلى المحاكم/السجلات.
• نظرة عامة على ⁨Enterprise⁩
• مصفوفة ميزات ⁨Core⁩ مقابل ⁨Pro⁩ مقابل ⁨Enterprise⁩