دالة تشفير (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
ينطبق على
| فاتورة ضريبية | إشعار مدين | إشعار دائن | مبسطة | مدين مبسط | دائن مبسط |
|---|---|---|---|---|---|
| إلزامي | إلزامي | إلزامي | إلزامي | إلزامي | إلزامي |
القواعد التي تفحصه
حقول ذات صلة
الحقول — الفوترة الإلكترونية في السعودية (فاتورة)
المصادر
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.