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
الخطوات
- احذف كتلة ext:UBLExtensions.
- احذف AdditionalDocumentReference الذي معرّفه QR.
- احذف cac:Signature.
- احذف سطر إعلان XML ووحّد النص بـ C14N 1.1.
- احسب SHA-256 ورمّز البايتات الـ 32 بـ base64.
أسئلة وأجوبة
هل أنتظر اعتماد الفاتورة قبل حساب hash الفاتورة التالية؟
لا. تذكر الإرشادات الفنية أن ختم الهيئة لا يغير الـ hash، فيمكن إصدار المستندات دون انتظار.
صفحات ذات صلة
- KSA-13 دالة تشفير (Hash) الفاتورة أو الإشعار السابق
- KSA-15 ختم التشفير
- KSA-14 رمز الاستجابة السريعة (QR Code)
- BR-KSA-26 · hash الفاتورة السابقة يجب أن يكون SHA-256 بترميز base64 محسوباً بطريقة المعيار.
- BR-KSA-61 · يجب أن يحمل كل مستند hash الفاتورة السابقة.
مفاهيم ذات صلة
- توحيد صيغة XML (C14N 1.1) قبل الـ hashتحويل نص XML إلى شكل وحيد قياسي قبل حساب الـ hash، حتى ينتج المستند نفسه البصمة نفسها في كل نظام.
- hash الفاتورة السابقة (PIH) وسلسلة المستنداتكل مستند يحمل hash المستند الذي سبقه من الجهاز نفسه، فتصير المستندات سلسلة يكشف فيها أي حذف أو تعديل.
- ختم التشفير (التوقيع الرقمي) في الفاتورةتوقيع ECDSA بصيغة XAdES على hash المستند وخصائص التوقيع، بمفتاح جهاز مسجل وشهادة من الهيئة.
الفوترة الإلكترونية في السعودية (فاتورة)
المصادر
- Electronic Invoice XML Implementation Standard 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. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.