انوائس ہیش: اس کا حساب کیسے ہوتا ہے
مہر اور QR بلاک ہٹانے اور کینونیکلائز کرنے کے بعد دستاویز کا SHA-256 فنگر پرنٹ، جو base64 میں لکھا جاتا ہے؛ مہر اور سلسلہ دونوں اسی پر قائم ہیں۔
اصل میں دستخط ہیش پر ہوتا ہے: کرپٹوگرافک مہر ہیش پر دستخط ہے، فائل پر نہیں۔ یہی ہیش اگلی دستاویز میں پچھلی انوائس کے ہیش کے طور پر جاتا ہے، ہر درخواست کے ساتھ فاتورہ (FATOORA) کو بھیجا جاتا ہے، اور QR کے ٹیگ 6 میں آتا ہے۔
ہیش بنانے سے پہلے تین بلاک ہٹائے جاتے ہیں، کیونکہ یا تو وہ ابھی تیار نہیں ہوتے یا ان میں خود ہیش ہوتا ہے: UBLExtensions (مہر)، QR ریفرنس اور cac:Signature۔ XML ڈیکلریشن ہٹا دیا جاتا ہے، متن کو C14N 1.1 سے کینونیکلائز کیا جاتا ہے، SHA-256 نکالا جاتا ہے اور 32 بائٹس کو base64 میں انکوڈ کیا جاتا ہے۔
چونکہ ہیش دستاویز کے متن پر بنتا ہے، اس لیے ایک اسپیس، ایٹریبیوٹس کی ترتیب یا حروف کی انکوڈنگ میں فرق سے ہیش بدل جاتا ہے۔ اسی لیے پہلے متن کو کینونیکلائز کیا جاتا ہے، اور اسی لیے ZATCA کی مہر کلیئر شدہ انوائس کا ہیش نہیں بدلتی: مہر خارج شدہ بلاکس میں ہوتی ہے۔
جوداکس میں
دستیابپروگرام کوئی C14N انجن استعمال نہیں کرتے: وہ دستاویز شروع ہی سے کینونیکل شکل میں لکھتے ہیں (فیصلہ D-01: صرف &، < اور > کو escape کریں، کوٹیشن مارکس کو رہنے دیں)، پھر متن سے تینوں بلاک کاٹتے ہیں، ڈیکلریشن ہٹاتے ہیں اور SHA-256 نکالتے ہیں۔ ہیش حتمی دستاویز کے ایک مسودے سے لیا جاتا ہے جس کے خارج شدہ بلاکس میں عارضی ویلیوز ہوتی ہیں؛ ZATCA کے ویلیڈیٹر نے نتیجہ قبول کیا، اور 400 گولڈن ٹیسٹ کیسز اسے ورژن 1.0 کے مطابق رکھتے ہیں۔
crates/jdx-einvoice-sa/src/xml.rs
مراحل
- ext:UBLExtensions بلاک ہٹائیں۔
- وہ AdditionalDocumentReference ہٹائیں جس کی ID، QR ہو۔
- cac:Signature ہٹائیں۔
- XML ڈیکلریشن ہٹائیں اور C14N 1.1 سے کینونیکلائز کریں۔
- SHA-256 نکالیں اور 32 بائٹس کو base64 میں انکوڈ کریں۔
سوال و جواب
کیا اگلی انوائس کا ہیش بنانے سے پہلے مجھے کلیئرنس کا انتظار کرنا ہوگا؟
نہیں۔ تکنیکی رہنما اصولوں کے مطابق ZATCA کی مہر ہیش کو تبدیل نہیں کرتی، اس لیے دستاویزات انتظار کیے بغیر جاری کی جا سکتی ہیں۔
متعلقہ صفحات
- KSA-13 پچھلی انوائس کا ہیش (PIH)
- KSA-15 کرپٹوگرافک مہر
- KSA-14 QR کوڈ
- BR-KSA-26 · پچھلی انوائس کا ہیش، معیار کے طریقے سے حساب کیا گیا base64 SHA-256 ہونا چاہیے۔
- BR-KSA-61 · ہر دستاویز میں پچھلی انوائس کا ہیش ہونا چاہیے۔
متعلقہ تصورات
- ہیش سے پہلے XML کی کینونیکلائزیشن (C14N 1.1)ہیش بنانے سے پہلے XML متن کو ایک ہی معیاری شکل میں ڈھالنا، تاکہ ایک ہی دستاویز ہر سسٹم پر ایک ہی فنگر پرنٹ دے۔
- پچھلی انوائس کا ہیش (PIH) اور دستاویزات کا سلسلہہر دستاویز میں اسی ڈیوائس کی پچھلی دستاویز کا ہیش ہوتا ہے، اس لیے دستاویزات ایک سلسلہ بناتی ہیں جس میں کوئی بھی حذف یا تبدیلی ظاہر ہو جاتی ہے۔
- کرپٹوگرافک مہر (ڈیجیٹل دستخط)دستاویز کے ہیش اور دستخط کی خصوصیات پر XAdES شکل میں ECDSA دستخط، جو رجسٹرڈ ڈیوائس کی کلید اور ZATCA کے جاری کردہ سرٹیفکیٹ سے کیا جاتا ہے۔
سعودی عرب میں ای انوائسنگ (فاتورہ)
ماخذ
- 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. جوداکس سے متعلق ہر بات پروگراموں کے اپنے کوڈ سے لی گئی ہے.