تخطَّ إلى المحتوى
KSA-13

دالة تشفير (Hash) الفاتورة أو الإشعار السابق

الـ hash المحسوب للمستند السابق من الجهاز نفسه، مكتوباً بـ base64، فتتسلسل المستندات كحلقات.

كل مستند يحمل بصمة المستند الذي سبقه، فإذا حُذف مستند أو عُدّل انقطعت السلسلة. القاعدة BR-KSA-61 تشترط وجود الحقل، والقاعدة BR-KSA-26 تحدد طريقة حسابه: إزالة كتلة UBLExtensions وكتلة رمز الاستجابة السريعة وكتلة cac:Signature، ثم توحيد الصيغة بمعيار C14N11، ثم SHA-256، ثم base64.

المستند الأول في سلسلة الجهاز ليس له سابق، فيحمل قيمة ثابتة حددها المعيار: NWZlY2ViNjZmZmM4NmYzOGQ5NTI3ODZjNmQ2OTZjNzljMmRiYzIzOWRkNGU5MWI0NjcyOWQ3M2EyN2ZiNTdlOQ==، وهي base64 لنص الـ hash الست عشري للرقم «0».

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

المعرّفKSA-13
المسار في المستند/Invoice/cac:AdditionalDocumentReference[cbc:ID='PIH']/cac:Attachment/cbc:EmbeddedDocumentBinaryObject
التكرار0..1
نوع البياناتBinary (base64)
ينطبق علىالفاتورة الضريبية (القياسية) والفاتورة الضريبية المبسطة

في جوداكس

مبني

كل وحدة تحفظ hash آخر مستند أصدرته وتضعه في المستند التالي، وتبدأ بالقيمة الثابتة نفسها التي في المعيار. اختبارات الوحدة تتحقق من أن كل مستند يحمل hash سابقه.

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

ينطبق على

فاتورة ضريبيةإشعار مدينإشعار دائنمبسطةمدين مبسطدائن مبسط
إلزاميإلزاميإلزاميإلزاميإلزاميإلزامي

القواعد التي تفحصه

  • BR-KSA-26 · hash الفاتورة السابقة يجب أن يكون SHA-256 بترميز base64 محسوباً بطريقة المعيار.
  • BR-KSA-61 · يجب أن يحمل كل مستند hash الفاتورة السابقة.

حقول ذات صلة

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

المصادر

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

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