ای انوائس کا QR کوڈ
انوائس پر پرنٹ ہونے والا ایک مربع کوڈ جس میں انوائس کا اہم ڈیٹا اور مہر base64 میں انکوڈ شدہ TLV کی صورت میں ہوتی ہے، تاکہ خریدار فون سے اسے جانچ سکے۔
پہلے مرحلے (4 دسمبر 2021) سے سادہ انوائس پر پانچ ٹیگ والا QR کوڈ لازمی ہے: فروخت کنندہ کا نام، VAT نمبر، ٹائم اسٹیمپ، VAT سمیت کل رقم اور VAT کا کل۔ دوسرے مرحلے نے کوڈ کو ہر دستاویز پر لازمی کر دیا اور چار ٹیگ مزید شامل کیے: دستاویز کا ہیش، اس کا دستخط، پبلک کلید، اور سادہ دستاویزات پر ڈیوائس کے سرٹیفکیٹ پر ZATCA کا دستخط۔
ہر ٹیگ تین ساتھ ساتھ حصوں پر مشتمل ہوتا ہے: ٹیگ نمبر کے لیے ایک بائٹ، ویلیو کی لمبائی کے لیے ایک بائٹ، پھر UTF-8 میں ویلیو۔ ٹیگز کو جوڑ کر ایک بائٹ سیکوئنس بنایا جاتا ہے، اسے base64 میں انکوڈ کیا جاتا ہے، اور اسی متن سے تصویر بنتی ہے۔ سیکیورٹی کا معیار اس متن کی حد 700 حروف رکھتا ہے۔
سادہ دستاویز پر پورا کوڈ فروخت کنندہ کی ڈیوائس بناتی ہے، کیونکہ مہر بھی وہی لگاتی ہے۔ معیاری دستاویز پر کلیئرنس کے وقت فاتورہ (FATOORA) پلیٹ فارم کوڈ شامل یا اپ ڈیٹ کرتا ہے۔ XML میں QR بلاک ہیش سے خارج ہوتا ہے، کیونکہ اس میں خود ہیش ہوتا ہے۔
ZATCA کی دستاویزات میں ایک نکتے پر فرق ہے جو جاننا مفید ہے: سیکیورٹی کا معیار ٹیگ 6 کو 32 بائٹ (بائنری ہیش) بتاتا ہے، جبکہ تکنیکی رہنما اصولوں کی حل شدہ مثال ٹیگ 6 اور 7 میں base64 متن رکھتی ہے (ہیش کے لیے 44 حروف)۔ ZATCA کی مثالوں میں ٹائم اسٹیمپ بھی Z پر ختم ہوتا ہے، حالانکہ معیار اس کے بغیر مقامی وقت کی اجازت دیتا ہے۔
جوداکس میں
دستیابپوائنٹ آف سیل ہر سادہ دستاویز پر نو ٹیگ والا کوڈ پرنٹ کرتا ہے، جس میں ٹیگ 6 اور 7 تکنیکی رہنما اصولوں کی مثال کی طرح base64 متن ہوتے ہیں۔ حسابات کے پروگرام (Books) کی A4 انوائسز پر پہلے مرحلے کا پانچ ٹیگ والا کوڈ پرنٹ ہوتا ہے، بغیر دستخط کے۔ پروگرام 255 بائٹ سے بڑا کوئی ٹیگ قبول نہیں کرتے، لیکن 700 حروف کی حد نہیں جانچتے۔
crates/jdx-einvoice-sa/src/xml.rs
مراحل
- ویلیوز جمع کریں: نام، VAT نمبر، ٹائم اسٹیمپ، ٹوٹل، VAT، اور دوسرے مرحلے میں ہیش، دستخط، پبلک کلید اور ZATCA کا دستخط۔
- ہر ویلیو کے لیے ٹیگ کا بائٹ لکھیں، پھر لمبائی کا بائٹ (UTF-8 میں بائٹس کی تعداد)، پھر ویلیو۔
- ٹیگز کو بغیر کسی فاصل کے جوڑیں اور پوری سیکوئنس کو base64 میں انکوڈ کریں۔
- متن کو XML کے QR ایلیمنٹ میں رکھیں اور پرنٹ شدہ کاپی پر اسی سے تصویر بنائیں۔
QR کوڈ کے ٹیگز
| ٹیگ | نام | مرحلہ | مطلب |
|---|---|---|---|
| 1 | فروخت کنندہ کا نام | 1 | فروخت کنندہ کا رجسٹرڈ نام UTF-8 میں، جیسا کہ فروخت کنندہ کے نام کی فیلڈ (BT-27) میں ہے۔ |
| 2 | فروخت کنندہ کا VAT رجسٹریشن نمبر | 1 | فروخت کنندہ کا 15 ہندسوں کا VAT نمبر (BT-31)۔ |
| 3 | انوائس کا ٹائم اسٹیمپ (تاریخ اور وقت) | 1 | ISO 8601 میں تاریخِ اجرا اور وقت؛ سیکیورٹی کے معیار کی مثال 2022-02-21T12:13:57Z ہے۔ دوسرے مرحلے میں پروگرام تاریخ اور وقت کی فیلڈز کے مطابق مقامی وقت Z کے بغیر لکھتے ہیں؛ ان کا پہلے مرحلے کا کوڈ Z کے ساتھ UTC استعمال کرتا ہے۔ |
| 4 | انوائس کا ٹوٹل (VAT سمیت) | 1 | VAT سمیت کل رقم (BT-112) عددی متن کی صورت میں۔ |
| 5 | VAT کا کل | 1 | VAT کا کل؛ سیکیورٹی کے معیار کے ورژن 1.2 نے واضح کیا کہ یہ BT-110 کی ویلیو ہے۔ |
| 6 | XML انوائس کا ہیش | 2 | دستاویز کا ہیش۔ سیکیورٹی کا معیار اس کی لمبائی 32 بائٹ بتاتا ہے، جبکہ تکنیکی رہنما اصولوں کی حل شدہ مثال میں 44 حروف کا base64 متن ہے، اور پروگرام بھی یہی کرتے ہیں۔ |
| 7 | XML ہیش کا ECDSA دستخط | 2 | دستاویز کے ہیش کا ECDSA دستخط: سادہ دستاویزات کے لیے فروخت کنندہ کی ڈیوائس اور معیاری دستاویزات کے لیے ZATCA کا پلیٹ فارم بناتا ہے۔ پروگرام اسے تکنیکی رہنما اصولوں کی مثال کی طرح base64 متن کے طور پر لکھتے ہیں۔ |
| 8 | ECDSA پبلک کلید | 2 | دستخط کی کلید سے مطابقت رکھنے والی پبلک کلید۔ پروگرام تکنیکی رہنما اصولوں کی مثال کی طرح مکمل DER SubjectPublicKeyInfo لکھتے ہیں (secp256k1 کے لیے 88 بائٹ)۔ |
| 9 | کرپٹوگرافک مہر کی پبلک کلید پر ZATCA کی تکنیکی CA کا ECDSA دستخط | 2 | صرف سادہ دستاویزات اور ان کے نوٹ کے لیے: ڈیوائس کے سرٹیفکیٹ پر ZATCA کی سرٹیفکیٹ اتھارٹی کا دستخط، جو سرٹیفکیٹ سے نقل کیا جاتا ہے۔ مقامی ٹیسٹ موڈ میں یہ خود کیا گیا دستخط ہوتا ہے، ZATCA کا نہیں۔ |
سوال و جواب
ZATCA کی ایپ عربی نام کو بگڑا ہوا کیوں دکھاتی ہے؟
عام طور پر اس لیے کہ نام UTF-8 میں انکوڈ نہیں کیا گیا، یا لمبائی میں بائٹس کے بجائے حروف گنے گئے؛ ایک عربی حرف دو بائٹ کا ہوتا ہے۔
کیا دوسرے مرحلے میں شامل ہونے کے بعد پہلے مرحلے کا کوڈ کافی ہے؟
نہیں۔ انٹیگریشن کے بعد دستاویز میں دوسرے مرحلے کے ٹیگ ہونے ضروری ہیں؛ ٹیگ 9 صرف سادہ دستاویزات اور ان کے نوٹ پر لاگو ہوتا ہے۔
متعلقہ صفحات
- KSA-14 QR کوڈ
- BT-27 فروخت کنندہ کا نام
- BT-31 فروخت کنندہ کا VAT رجسٹریشن نمبر
- BT-112 VAT سمیت انوائس کی کل رقم
- BT-110 انوائس میں VAT کی کل رقم
- BR-KSA-27 · دستاویز میں base64Binary کے طور پر انکوڈ شدہ QR کوڈ ہونا چاہیے۔
متعلقہ تصورات
- کرپٹوگرافک مہر (ڈیجیٹل دستخط)دستاویز کے ہیش اور دستخط کی خصوصیات پر XAdES شکل میں ECDSA دستخط، جو رجسٹرڈ ڈیوائس کی کلید اور ZATCA کے جاری کردہ سرٹیفکیٹ سے کیا جاتا ہے۔
- انوائس ہیش: اس کا حساب کیسے ہوتا ہےمہر اور QR بلاک ہٹانے اور کینونیکلائز کرنے کے بعد دستاویز کا SHA-256 فنگر پرنٹ، جو base64 میں لکھا جاتا ہے؛ مہر اور سلسلہ دونوں اسی پر قائم ہیں۔
- پہلا مرحلہ (اجرا) اور دوسرا مرحلہ (انٹیگریشن)پہلا مرحلہ، 4 دسمبر 2021 سے، انوائسز کو الیکٹرانک طور پر جاری کرنا اور محفوظ رکھنا لازمی قرار دیتا ہے؛ دوسرا مرحلہ، 1 جنوری 2023 سے ویوز (waves) کی صورت میں، XML، مہر اور فاتورہ (FATOORA) کے ساتھ انٹیگریشن کا اضافہ کرتا ہے۔
سعودی عرب میں ای انوائسنگ (فاتورہ)
ماخذ
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
جانچ کی تاریخ: 4 نومبر 2026. جوداکس سے متعلق ہر بات پروگراموں کے اپنے کوڈ سے لی گئی ہے.