مواد پر جائیں
سعودی عرب میں ای انوائسنگ (فاتورہ)

انوائس ہیش: اس کا حساب کیسے ہوتا ہے

مہر اور 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

مراحل

  1. ext:UBLExtensions بلاک ہٹائیں۔
  2. وہ AdditionalDocumentReference ہٹائیں جس کی ID، QR ہو۔
  3. cac:Signature ہٹائیں۔
  4. XML ڈیکلریشن ہٹائیں اور C14N 1.1 سے کینونیکلائز کریں۔
  5. SHA-256 نکالیں اور 32 بائٹس کو base64 میں انکوڈ کریں۔

سوال و جواب

کیا اگلی انوائس کا ہیش بنانے سے پہلے مجھے کلیئرنس کا انتظار کرنا ہوگا؟

نہیں۔ تکنیکی رہنما اصولوں کے مطابق ZATCA کی مہر ہیش کو تبدیل نہیں کرتی، اس لیے دستاویزات انتظار کیے بغیر جاری کی جا سکتی ہیں۔

متعلقہ صفحات

متعلقہ تصورات

سعودی عرب میں ای انوائسنگ (فاتورہ)

ماخذ

  1. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  3. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA

جانچ کی تاریخ: 4 نومبر 2026. جوداکس سے متعلق ہر بات پروگراموں کے اپنے کوڈ سے لی گئی ہے.