يُعد PEPPOL-EN16931-R004 خطأً فادحًا في عملية التحقق من صحة ملف تعريف المورد ( BIS Billing ) وفقًا لمعايير Peppol. وهذا يعني أن معرّف المواصفات في BT-24، المتمثّل في cbc:CustomizationID، لا يتوافق مع تنسيق المعرّف المطلوب لفاتورة أو إشعار ائتمان وفقًا لمعيار Peppol BIS Billing 3.0. هذه الوثيقة غير متوافقة ولا ينبغي إرسالها عبر شبكة Peppol حتى يتم تصحيح القيمة.
| الميدان | القيمة |
| القاعدة | PEPPOL-EN16931-R004 |
| الخطورة | مميت |
| طبقة التحقق من الصحة | Peppol BIS |
| المجال المتأثر | cbc:CustomizationID (BT-24) |
| ينطبق على | فاتورة UBL وإشعار الائتمان |
| Release الموصوف | Peppol BIS Billing 3.0.21 |
ماذا يعني هذا الخطأ؟
CustomizationID يُحدد للمُحقق ونظام الاستلام المواصفات وقواعد العمل التي يدعي المستند أنه يتبعها. بالنسبة لمستند Peppol القياسي BIS Billing 3.0، تُحدد هذه القيمة كلًّا من الامتثال لمعيار EN 16931 ومواصفات الاستخدام الخاصة بـ Peppol Billing.
هذا ليس معرّف مشارك في Peppol، ولا يُحدد هوية المرسل أو المستلم. كما أنه يختلف عن ProfileID، والذي يحدد العملية التجارية التي يتم في إطارها تبادل المستند.
ما الذي يتحقق منه المعيار PEPPOL-EN16931-R004
تتحقق قاعدة OpenPeppol الحالية من أن القيمة المعيارية CustomizationID:
- يبدأ بالمعرّف المطلوب وفقًا لمعيار Peppol BIS Billing 3.0؛ و
- لا تحتوي على لاحقة الإصدار المكونة من نقطتين، والتي تُكتب على النحو التالي:
::.
بالنسبة للفاتورة أو إشعار الائتمان القياسي وفقًا لمعيار Peppol BIS Billing 3.0، استخدم القيمة القياسية الواردة أدناه تمامًا كما هي موضحة:
urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0احتفظ بها كسلسلة واحدة متصلة. على الرغم من أن اختبار التحقق من الصحة يقوم بتوحيد المسافات البيضاء قبل فحص القيمة، فإن استخدام القيمة القياسية دون إضافة مسافات أو فواصل أسطر أو لواحق يساعد على تجنب الغموض وأخطاء التعيين.
لماذا تفشل لاحقات الإصدارات؟
قامت OpenPeppol بتحديث القاعدة R004 ذات الأثر الفادح في Peppol BIS Billing 3.0.21 لتوضيح الشرط بشكل صريح: CustomizationID يجب ألا تتضمن معلومات الإصدار. تم نشر « release » في مايو 2026 وأصبح إلزاميًا في 17 أغسطس 2026. ولذلك، قد تفشل القيمة المنسوخة من إصدار قديم في اجتياز عملية التحقق الحالية إذا كانت تنتهي بلاحقة إصدار مثل ::2.1 أو ::3.0.
الأسباب الشائعة
- مواصفات خاطئة: يقوم نظام تخطيط موارد المؤسسة (ERP) أو المحول بإدراج معرّف خاص بنظام CIUS آخر أو تنسيق آخر أو شبكة أخرى.
- معرّف غير مكتمل: تشير القيمة إلى المعيار EN 16931، لكنها تغفل الجزء المتعلق بـ Peppol BIS Billing .
- تم إرفاق معلومات الإصدار: تنتهي القيمة بلاحقة مكونة من نقطتين متتاليتين، وهو ما ترفضه القاعدة الحالية.
- عنصر مفقود أو فارغ:
cbc:CustomizationIDغير موجود، أو فارغ، أو مكتوب في مساحة اسم XML خاطئة. وقد يؤدي ذلك أيضًا إلى ظهور الخطأ BR-01. - تعيين المصدر غير الصحيح: يؤدي أحد القوالب أو تعيين البرمجيات الوسيطة أو إعدادات التصدير إلى إنشاء قيمة خاطئة لكل مستند.
كيفية إصلاح PEPPOL-EN16931-R004
- افتح ملف XML الذي تم إنشاؤه. تحديد الموقع
cbc:CustomizationIDبالقرب من بداية الجذرInvoiceأوCreditNoteعنصر. - تحقق من القيمة الكاملة. ابحث عن معرّف مختصر، أو قيمة من تنسيق آخر، أو خطأً إملائياً، أو إضافةً
::لاحقة الإصدار. - قم بتعيين المعرّف القياسي. بالنسبة لمعيار Peppol BIS Billing 3.0، استبدل القيمة بالمعرّف الموضح أعلاه.
- قم بتصحيح تكوين المصدر. قم بتحديث عملية التصدير من نظام تخطيط موارد المؤسسة (ERP) أو قالب المستند أو خريطة التحويل التي أنتجت هذه القيمة. فالتعديل الذي يقتصر على ملف XML واحد فقط لا يؤدي إلى إزالة الخطأ الأساسي.
- قم بإنشاء مستند جديد والتحقق من صحته. قم بتشغيل ملف XML الكامل عبر أدوات التحقق من صحة Peppol الحالية BIS Billing قبل محاولة التسليم مرة أخرى.
إذا كانت الوثيقة تستند عمدًا إلى نظام CIUS مختلف أو مواصفة وطنية أو ملف تعريف PINT، فلا تقم باستبدال المعرّف دون تروٍ. تأكد من CustomizationID المطلوبة بموجب تلك المواصفات والتحقق من صحة المستند وفقًا لمجموعة القواعد المقابلة.
أمثلة على لغة XML
متوافق مع معيار Peppol BIS Billing 3.0
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>خطأ: معرّف غير مكتمل
<cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>غير صحيح: تمت إضافة معلومات الإصدار
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::3.0</cbc:CustomizationID>إذا ظهر الطراز BR-01 أيضًا
تتطلب BR-01 أن تحتوي كل فاتورة ومذكرة ائتمان على معرّف المواصفات في BT-24. إذا CustomizationID إذا كان العنصر مفقودًا أو فارغًا أو غير معترف به في مساحة الأسماء المتوقعة، فقد يُبلغ أداة التحقق من الصحة عن الخطأ BR-01 بالإضافة إلى الخطأ R004. قم بتصحيح وجود العنصر ومساحة الأسماء والقيمة الخاصة به، ثم قم بالتحقق من صحة المستند الذي تم إعادة إنشاؤه. لا تعامل هاتين الرسالتين على أنهما خطأان غير مرتبطين ببعضهما.
لا يمكن استبدال «CustomizationID» بـ «ProfileID» والعكس صحيح
| العنصر | الغرض |
cbc:CustomizationID | يحدد المواصفات ومجموعة القواعد التي يتبعها المستند. |
cbc:ProfileID | يحدد العملية التجارية التي يتم في إطارها تبادل المستند. |
التغيير ProfileID لن يؤدي ذلك إلى حل المشكلة المتعلقة بـ PEPPOL-EN16931-R004. يتعلق الخطأ بـ CustomizationID.
إرشادات ذات صلة
المصدر المعياري
تنشر منظمة OpenPeppol متطلبات التحقق من الصحة واختبار القواعد. تقدم هذه المقالة شرحًا عمليًّا وإرشادات تنفيذية من Qvalia. يجب دائمًا استخدام عناصر التحقق من الصحة التي تنطبق على المستند وإصدار Peppol الحالي release.