هاش الفاتورة (Invoice Hash)
هاش الفاتورة في زاتكا هو SHA-256 بترميز base64 لملف XML بعد حذف التوقيع والـ QR وتوحيد صيغته (C14N11)، ويصير PIH للفاتورة اللي بعدها.
هاش الفاتورة بصمة رقمية للمستند: SHA-256 لنص الـ XML بترميز base64. أي تغيير ولو مسافة بعد الحساب يعطي هاش مختلف تماماً.
الطريقة الرسمية (من نص BR-KSA-26): احذف ext:UBLExtensions، واحذف cac:AdditionalDocumentReference اللي cbc:ID فيه QR، واحذف cac:Signature، بعدين وحّد صيغة المستند بمعيار C14N11، واحسب SHA-256، ورمّز الناتج base64. يطلع نص طوله 44 حرف مثل z5F9qsS6…JgQ=.
نفس القيمة تظهر في أربع أماكن: DigestValue للمرجع invoiceSignedData داخل التوقيع، والوسم 6 في الـ QR، والحقل invoiceHash في الطلب للهيئة، وPIH في الفاتورة اللي بعدها. الهيئة تعيد حساب الهاش من المستند وترفض لو ما تطابق، فالغلط الشائع إنك تعدّل الـ XML (تنسيق، ترتيب، مسافات) بعد ما حسبت الهاش ووقّعت.
ماثل يحسب الهاش بنفس تحويلات الهيئة، ومطابق حرف بحرف لعيّنات الـ SDK في اختباراتنا، ويرجعه لك في invoice_hash عشان ترسله PIH للفاتورة اللي بعدها.
مثال
<ds:Reference Id="invoiceSignedData" URI="">
...
<ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
<ds:DigestValue>z5F9qsS6oWyDhehD8u8S0DaxV+2CUiUz9Y+UsR61JgQ=</ds:DigestValue>
</ds:Reference>
أسئلة شائعة
ليش هاش أول PIH أطول من هاش الفاتورة؟
لأن القيمة الرسمية لأول PIH هي base64 للنص الست عشري للهاش (88 حرف)، أما هاش الفاتورة فهو base64 للبايتات الخام (44 حرف).
هل أحسب الهاش قبل التوقيع أو بعده؟
النتيجة وحدة، لأن الحساب يحذف التوقيع والـ QR أصلاً. المهم ما تغيّر باقي المستند بعد الحساب.
قواعد الهيئة المرتبطة
مصطلحات قريبة
خلّ ماثل يتعامل مع هذا عنك
ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.
جرّب ماثل بدون تسجيل توثيق ماثل API