توحيد صيغة XML (C14N 1.1) قبل الـ hash
تحويل نص XML إلى شكل وحيد قياسي قبل حساب الـ hash، حتى ينتج المستند نفسه البصمة نفسها في كل نظام.
المستند الواحد يمكن كتابته بأكثر من نص: ترتيب الخصائص، وعلامات الاقتباس، وتعريفات النطاقات، والعناصر الفارغة. التوحيد (Canonical XML 1.1) يحوّل كل هذه الصيغ إلى نص واحد، ثم يُحسب الـ hash عليه.
تحدد الهيئة في كتلة التوقيع: ثلاثة تحويلات XPath تحذف UBLExtensions وcac:Signature ومرجع QR، ثم التحويل http://www.w3.org/2006/12/xml-c14n11. والطريقة نفسها تُستخدم لحساب hash الفاتورة السابقة.
من أهم أثر للتوحيد في الفواتير العربية: النص يُرمَّز UTF-8، وعلامات الاقتباس داخل النص لا تُهرَّب، و&و<و> تُهرَّب. ومسافات الأسطر حول الكتل المحذوفة تبقى في النص.
في جوداكس
مبنيلا يحمل البرنامج محرك توحيد. بدلاً من ذلك يكتب المستند بالشكل الموحّد من البداية (القرار D-01: يهرّب & و< و> فقط ويترك علامات الاقتباس، بخلاف الإصدار 1.0)، فيكون النص المكتوب هو النص الموحّد، ويُحسب الـ hash منه مباشرة. هذا يعتمد على أن كل حرف في الكاتب ثابت؛ وتتحقق 400 حالة ذهبية من تطابقه مع الإصدار 1.0.
crates/jdx-einvoice-sa/src/xml.rs
صفحات ذات صلة
- KSA-13 دالة تشفير (Hash) الفاتورة أو الإشعار السابق
- KSA-15 ختم التشفير
- BR-KSA-26 · hash الفاتورة السابقة يجب أن يكون SHA-256 بترميز base64 محسوباً بطريقة المعيار.
مفاهيم ذات صلة
الفوترة الإلكترونية في السعودية (فاتورة)
المصادر
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.