PIH (هاش الفاتورة السابقة)
PIH هو هاش الفاتورة السابقة لنفس الجهاز، يُكتب في الفاتورة اللي بعدها عشان تتسلسل الفواتير. تشترط وجوده القاعدة BR-KSA-61.
PIH اختصار Previous Invoice Hash، يعني هاش الفاتورة السابقة. كل مستند يصدره الجهاز يحمل هاش المستند اللي قبله من نفس الجهاز، وبكذا تصير فواتير الجهاز سلسلة مترابطة مع عدّاد ICV.
مكانه في الـ XML (الحقل KSA-13): عنصر cac:AdditionalDocumentReference قيمة cbc:ID فيه PIH، والهاش داخل cac:Attachment/cbc:EmbeddedDocumentBinaryObject بـ mimeCode="text/plain". أول فاتورة للجهاز ما قبلها شي، فالنص الرسمي يحدد لها قيمة ثابتة: NWZlY2Vi…OQ==، وهي base64 للنص الست عشري لـ SHA-256 للحرف "0".
وش يغلط في الواقع؟ BR-KSA-61 تطلع لو غاب العنصر أو كان فاضي أو ما عليه text/plain. وBR-KSA-26 تشرح طريقة حساب الهاش، لكن جرّبناها على SDK 3.4.8 وطلع الفحص يكتفي بأن القيمة موجودة: قيمة base64 مخترعة تعدّي. يعني نجاح المدقق ما يثبت إن سلسلتك صحيحة. الأخطاء الشائعة: حفظ الهاش قبل ما تنقبل الفاتورة، أو جهازين يتشاركون سلسلة وحدة.
في ماثل، الرد يرجع invoice_hash وهو اللي ترسله previous_invoice_hash في الفاتورة اللي بعدها. ومع device_token ماثل يحفظ الـ PIH داخل التوكن ويحطه بنفسه، ولو ما أرسلته في أول فاتورة يعبّيه ماثل.
مثال
<cac:AdditionalDocumentReference>
<cbc:ID>PIH</cbc:ID>
<cac:Attachment>
<cbc:EmbeddedDocumentBinaryObject mimeCode="text/plain">NWZlY2ViNjZmZmM4NmYzOGQ5NTI3ODZjNmQ2OTZjNzljMmRiYzIzOWRkNGU5MWI0NjcyOWQ3M2EyN2ZiNTdlOQ==</cbc:EmbeddedDocumentBinaryObject>
</cac:Attachment>
</cac:AdditionalDocumentReference>
أسئلة شائعة
وش قيمة PIH لأول فاتورة؟
النص الرسمي لـ BR-KSA-26 يحددها: NWZlY2ViNjZmZmM4NmYzOGQ5NTI3ODZjNmQ2OTZjNzljMmRiYzIzOWRkNGU5MWI0NjcyOWQ3M2EyN2ZiNTdlOQ== وهي ترميز base64 لهاش SHA-256 للحرف "0" بصيغته الست عشرية.
المدقق قبل الـ PIH، يعني هو صحيح؟
مو شرط. قواعد SDK 3.4.8 تتحقق من وجود القيمة بس، فأي نص base64 يعدّي. لازم تاخذ الهاش من آخر فاتورة مقبولة فعلاً.
هل السلسلة وحدة للمنشأة كلها؟
لا، لكل جهاز (EGS) سلسلة خاصة: عدّاده وهاش آخر فاتورة مقبولة منه.
قواعد الهيئة المرتبطة
مصطلحات قريبة
خلّ ماثل يتعامل مع هذا عنك
ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.
جرّب ماثل بدون تسجيل توثيق ماثل API