ہیش سے پہلے XML کی کینونیکلائزیشن (C14N 1.1)
ہیش بنانے سے پہلے XML متن کو ایک ہی معیاری شکل میں ڈھالنا، تاکہ ایک ہی دستاویز ہر سسٹم پر ایک ہی فنگر پرنٹ دے۔
ایک ہی دستاویز کئی طرح کے متن میں لکھی جا سکتی ہے: ایٹریبیوٹس کی ترتیب، کوٹیشن کا انداز، namespace کے اعلانات، خالی ایلیمنٹس۔ کینونیکلائزیشن (Canonical XML 1.1) ان سب کو ایک متن میں بدل دیتی ہے، اور ہیش اسی پر بنتا ہے۔
ZATCA اسے دستخط کے بلاک میں مقرر کرتی ہے: تین XPath ٹرانسفارمز جو UBLExtensions، cac:Signature اور QR ریفرنس ہٹاتے ہیں، پھر ٹرانسفارم http://www.w3.org/2006/12/xml-c14n11۔ پچھلی انوائس کا ہیش بھی اسی طریقے سے نکالا جاتا ہے۔
عربی انوائسز پر عملی اثرات: متن UTF-8 میں ہوتا ہے، متن کے اندر کوٹیشن مارکس escape نہیں ہوتے جبکہ &، < اور > ہوتے ہیں، اور ہٹائے گئے بلاکس کے گرد لائنوں کی خالی جگہ متن میں باقی رہتی ہے۔
جوداکس میں
دستیابپروگراموں میں کوئی کینونیکلائزر نہیں۔ اس کے بجائے وہ دستاویز شروع ہی سے کینونیکل شکل میں لکھتے ہیں (فیصلہ D-01: صرف &، < اور > کو escape کریں اور کوٹیشن مارکس کو رہنے دیں، ورژن 1.0 کے برعکس)، اس لیے لکھا گیا متن ہی کینونیکل متن ہوتا ہے اور ہیش براہِ راست اسی سے لیا جاتا ہے۔ اس کا انحصار اس پر ہے کہ دستاویز لکھنے والے حصے کا ہر حرف ثابت رہے؛ 400 گولڈن ٹیسٹ کیسز اسے ورژن 1.0 کے مطابق رکھتے ہیں۔
crates/jdx-einvoice-sa/src/xml.rs
متعلقہ صفحات
- KSA-13 پچھلی انوائس کا ہیش (PIH)
- KSA-15 کرپٹوگرافک مہر
- BR-KSA-26 · پچھلی انوائس کا ہیش، معیار کے طریقے سے حساب کیا گیا base64 SHA-256 ہونا چاہیے۔
متعلقہ تصورات
- انوائس ہیش: اس کا حساب کیسے ہوتا ہےمہر اور QR بلاک ہٹانے اور کینونیکلائز کرنے کے بعد دستاویز کا SHA-256 فنگر پرنٹ، جو base64 میں لکھا جاتا ہے؛ مہر اور سلسلہ دونوں اسی پر قائم ہیں۔
- کرپٹوگرافک مہر (ڈیجیٹل دستخط)دستاویز کے ہیش اور دستخط کی خصوصیات پر XAdES شکل میں ECDSA دستخط، جو رجسٹرڈ ڈیوائس کی کلید اور ZATCA کے جاری کردہ سرٹیفکیٹ سے کیا جاتا ہے۔
سعودی عرب میں ای انوائسنگ (فاتورہ)
ماخذ
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
جانچ کی تاریخ: 4 نومبر 2026. جوداکس سے متعلق ہر بات پروگراموں کے اپنے کوڈ سے لی گئی ہے.