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

ای انوائس کا 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

مراحل

  1. ویلیوز جمع کریں: نام، VAT نمبر، ٹائم اسٹیمپ، ٹوٹل، VAT، اور دوسرے مرحلے میں ہیش، دستخط، پبلک کلید اور ZATCA کا دستخط۔
  2. ہر ویلیو کے لیے ٹیگ کا بائٹ لکھیں، پھر لمبائی کا بائٹ (UTF-8 میں بائٹس کی تعداد)، پھر ویلیو۔
  3. ٹیگز کو بغیر کسی فاصل کے جوڑیں اور پوری سیکوئنس کو base64 میں انکوڈ کریں۔
  4. متن کو XML کے QR ایلیمنٹ میں رکھیں اور پرنٹ شدہ کاپی پر اسی سے تصویر بنائیں۔

QR کوڈ کے ٹیگز

ٹیگناممرحلہمطلب
1فروخت کنندہ کا نام1فروخت کنندہ کا رجسٹرڈ نام UTF-8 میں، جیسا کہ فروخت کنندہ کے نام کی فیلڈ (BT-27) میں ہے۔
2فروخت کنندہ کا VAT رجسٹریشن نمبر1فروخت کنندہ کا 15 ہندسوں کا VAT نمبر (BT-31)۔
3انوائس کا ٹائم اسٹیمپ (تاریخ اور وقت)1ISO 8601 میں تاریخِ اجرا اور وقت؛ سیکیورٹی کے معیار کی مثال 2022-02-21T12:13:57Z ہے۔ دوسرے مرحلے میں پروگرام تاریخ اور وقت کی فیلڈز کے مطابق مقامی وقت Z کے بغیر لکھتے ہیں؛ ان کا پہلے مرحلے کا کوڈ Z کے ساتھ UTC استعمال کرتا ہے۔
4انوائس کا ٹوٹل (VAT سمیت)1VAT سمیت کل رقم (BT-112) عددی متن کی صورت میں۔
5VAT کا کل1VAT کا کل؛ سیکیورٹی کے معیار کے ورژن 1.2 نے واضح کیا کہ یہ BT-110 کی ویلیو ہے۔
6XML انوائس کا ہیش2دستاویز کا ہیش۔ سیکیورٹی کا معیار اس کی لمبائی 32 بائٹ بتاتا ہے، جبکہ تکنیکی رہنما اصولوں کی حل شدہ مثال میں 44 حروف کا base64 متن ہے، اور پروگرام بھی یہی کرتے ہیں۔
7XML ہیش کا ECDSA دستخط2دستاویز کے ہیش کا ECDSA دستخط: سادہ دستاویزات کے لیے فروخت کنندہ کی ڈیوائس اور معیاری دستاویزات کے لیے ZATCA کا پلیٹ فارم بناتا ہے۔ پروگرام اسے تکنیکی رہنما اصولوں کی مثال کی طرح base64 متن کے طور پر لکھتے ہیں۔
8ECDSA پبلک کلید2دستخط کی کلید سے مطابقت رکھنے والی پبلک کلید۔ پروگرام تکنیکی رہنما اصولوں کی مثال کی طرح مکمل DER SubjectPublicKeyInfo لکھتے ہیں (secp256k1 کے لیے 88 بائٹ)۔
9کرپٹوگرافک مہر کی پبلک کلید پر ZATCA کی تکنیکی CA کا ECDSA دستخط2صرف سادہ دستاویزات اور ان کے نوٹ کے لیے: ڈیوائس کے سرٹیفکیٹ پر ZATCA کی سرٹیفکیٹ اتھارٹی کا دستخط، جو سرٹیفکیٹ سے نقل کیا جاتا ہے۔ مقامی ٹیسٹ موڈ میں یہ خود کیا گیا دستخط ہوتا ہے، ZATCA کا نہیں۔

سوال و جواب

ZATCA کی ایپ عربی نام کو بگڑا ہوا کیوں دکھاتی ہے؟

عام طور پر اس لیے کہ نام UTF-8 میں انکوڈ نہیں کیا گیا، یا لمبائی میں بائٹس کے بجائے حروف گنے گئے؛ ایک عربی حرف دو بائٹ کا ہوتا ہے۔

کیا دوسرے مرحلے میں شامل ہونے کے بعد پہلے مرحلے کا کوڈ کافی ہے؟

نہیں۔ انٹیگریشن کے بعد دستاویز میں دوسرے مرحلے کے ٹیگ ہونے ضروری ہیں؛ ٹیگ 9 صرف سادہ دستاویزات اور ان کے نوٹ پر لاگو ہوتا ہے۔

متعلقہ صفحات

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

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

ماخذ

  1. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
  3. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
  4. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA

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