تخطَّ إلى المحتوى
الفوترة الإلكترونية في السعودية (فاتورة)

توحيد صيغة 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

صفحات ذات صلة

مفاهيم ذات صلة

الفوترة الإلكترونية في السعودية (فاتورة)

المصادر

  1. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  3. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA

تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.