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

hash الفاتورة: كيف يُحسب

بصمة SHA-256 للمستند بعد حذف كتل الختم والرمز وتوحيد صيغته، تُكتب بـ base64، وعليها يقوم الختم والسلسلة.

الـ hash هو ما يُوقَّع فعلاً: ختم التشفير توقيع على الـ hash لا على الملف. وهو أيضاً ما يحمله المستند التالي في حقل hash الفاتورة السابقة، وما يُرسل إلى منصة فاتورة مع كل طلب، وما يظهر في الوسم 6.

قبل الحساب تُزال ثلاث كتل لأنها لا تكون جاهزة وقت الحساب أو لأنها تحمل الـ hash نفسه: UBLExtensions (الختم)، ومرجع رمز الاستجابة السريعة، وcac:Signature. ثم يُحذف سطر إعلان XML ويُوحَّد النص بمعيار C14N 1.1، ثم يُحسب SHA-256 وتُرمّز البايتات الـ 32 بـ base64.

لأن الـ hash يُحسب على نص المستند، فأي فرق في مسافة أو ترتيب خصائص أو ترميز حرف ينتج hash مختلفاً. لهذا يوحَّد النص قبل الحساب، ولهذا لا تغيّر المنصة الـ hash حين تختم الفاتورة الضريبية: ختمها يقع في كتل مستثناة.

في جوداكس

مبني

لا يستخدم البرنامج محرك C14N: يكتب المستند بالشكل الموحّد أصلاً (القرار D-01: تهريب &وو<وو> فقط وترك علامات الاقتباس)، ثم يقطع الكتل الثلاث من النص ويحذف الإعلان ويحسب SHA-256. يُحسب الـ hash من مسودة المستند النهائي بقيم مؤقتة في الكتل المستثناة، وقبلت أداة التحقق من الهيئة النتيجة، وتتحقق 400 حالة ذهبية من تطابقه مع الإصدار 1.0.

crates/jdx-einvoice-sa/src/xml.rs

الخطوات

  1. احذف كتلة ext:UBLExtensions.
  2. احذف AdditionalDocumentReference الذي معرّفه QR.
  3. احذف cac:Signature.
  4. احذف سطر إعلان XML ووحّد النص بـ C14N 1.1.
  5. احسب SHA-256 ورمّز البايتات الـ 32 بـ base64.

أسئلة وأجوبة

هل أنتظر اعتماد الفاتورة قبل حساب hash الفاتورة التالية؟

لا. تذكر الإرشادات الفنية أن ختم الهيئة لا يغير الـ hash، فيمكن إصدار المستندات دون انتظار.

صفحات ذات صلة

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

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

المصادر

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

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