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

ڈیوائس کی آن بورڈنگ اور اس کا CSID

انوائسنگ ڈیوائس ZATCA سے اپنا مہر کا سرٹیفکیٹ کیسے حاصل کرتی ہے: کلید، سرٹیفکیٹ کی درخواست، OTP، کمپلائنس کی جانچ، پھر پروڈکشن سرٹیفکیٹ۔

سرٹیفکیٹ (CSID؛ ضوابط اسے کرپٹوگرافک مہر کا شناخت کنندہ کہتے ہیں) انوائسنگ ڈیوائس کو ٹیکس دہندہ کے VAT نمبر سے جوڑتا ہے۔ عمل فاتورہ (FATOORA) پورٹل سے شروع ہوتا ہے، جہاں ٹیکس دہندہ OTP بناتا ہے (ایک درخواست میں 100 تک، ہر ایک ایک گھنٹے کے لیے کارآمد؛ OTP کے لیے کوئی API نہیں)۔

ڈیوائس ایک کلیدی جوڑا (key pair) اور PKCS#10 درخواست بناتی ہے جس میں یونٹ کا common name، «1-manufacturer|2-model|3-serial» کی شکل میں سیریل نمبر (یعنی بنانے والا، ماڈل اور سیریل)، VAT نمبر، برانچ کا نام، ٹیکس دہندہ کا نام، ملک، انوائس کی اقسام کا چار ہندسوں کا نقشہ (1100 = معیاری اور سادہ)، مقام اور شعبہ ہوتے ہیں۔ OTP کے ساتھ بھیجنے پر یہ کمپلائنس سرٹیفکیٹ واپس لاتی ہے۔

کمپلائنس سرٹیفکیٹ کے ساتھ ڈیوائس جانچ کے لیے نمونہ دستاویزات بھیجتی ہے؛ تکنیکی رہنما اصول ہر قسم (انوائس، ڈیبٹ نوٹ، کریڈٹ نوٹ) کی تین دستاویزات بتاتے ہیں۔ جب وہ پاس ہو جائیں تو ڈیوائس کمپلائنس درخواست کی ID کے ساتھ پروڈکشن سرٹیفکیٹ کی درخواست کرتی ہے اور اس کے بعد مہر اور رپورٹنگ کے لیے وہی استعمال کرتی ہے۔ سرٹیفکیٹ زیادہ سے زیادہ 60 مہینے کارآمد رہتا ہے؛ تجدید کے لیے نیا OTP اور نئی کلید درکار ہے۔

ضوابط تقاضا کرتے ہیں کہ دستخط کی کلید non-exportable (ناقابلِ برآمد) کے طور پر نشان زد ہو، یا اگر سافٹ ویئر اسے محفوظ کرتا ہو تو ڈسک انکرپٹڈ ہو؛ کلید کو کسی دوسری ڈیوائس پر منتقل کرنا ممنوعہ فعل ہے۔

جوداکس میں

جزوی طور پر

آن بورڈنگ بنائی جا چکی ہے: پروگرام کلید اور CSR خود بناتے ہیں، کمپلائنس سرٹیفکیٹ کی درخواست کرتے ہیں، ایک نمونہ دستاویز (سادہ انوائس) جانچتے ہیں، پھر پروڈکشن سرٹیفکیٹ کی درخواست کرتے ہیں، اور یہ ڈویلپر سینڈ باکس میں کامیاب رہا ہے۔ لیکن وہ انوائس کی قسم 1100 (معیاری اور سادہ) مانگتے ہیں حالانکہ معیاری انوائسز نہیں بنائی گئیں، اور ہر قسم کی تین کے بجائے ایک نمونہ دستاویز جانچتے ہیں؛ اسے سمیولیشن یا پروڈکشن میں نہیں آزمایا گیا، جہاں پلیٹ فارم جانچ مکمل ہونے تک پروڈکشن سرٹیفکیٹ دینے سے انکار کر سکتا ہے۔ CSR کی فیلڈز سیکیورٹی کے معیار کی جدول (organizationIdentifier) کے بجائے ZATCA کی نمونہ کنفیگریشن (متبادل نام میں SN، UID، title) کے مطابق ہیں۔ تجدید نہیں بنائی گئی۔ کلید انکرپٹڈ ڈیٹا فائل کے اندر رکھی جاتی ہے۔

crates/jdx-einvoice-sa/src/unit.rs

مراحل

  1. فاتورہ (FATOORA) پورٹل میں OTP بنائیں۔
  2. ڈیوائس پر مطلوبہ ماحول کے ٹیمپلیٹ کے ساتھ پرائیویٹ کلید اور CSR بنائیں۔
  3. CSR اور OTP کو /compliance پر بھیجیں تاکہ کمپلائنس سرٹیفکیٹ اور اس کا secret مل جائے۔
  4. دستخط شدہ نمونہ دستاویزات /compliance/invoices پر بھیجتے رہیں یہاں تک کہ وہ پاس ہو جائیں۔
  5. پروڈکشن سرٹیفکیٹ لینے کے لیے کمپلائنس درخواست کی ID کو /production/csids پر بھیجیں۔

سوال و جواب

کیا ڈویلپر پورٹل کا سرٹیفکیٹ پروڈکشن میں کام کرتا ہے؟

نہیں۔ ڈویلپر پورٹل کے سرٹیفکیٹ صرف ٹیسٹنگ کے لیے ہیں اور لائیو ماحول میں کام نہیں کرتے۔

VAT گروپ میں شامل ہونے پر ٹیکس دہندہ کے سرٹیفکیٹس کا کیا ہوتا ہے؟

وہ خود بخود منسوخ ہو جاتے ہیں، اور ڈیوائسز کو گروپ نمبر کے تحت دوبارہ آن بورڈ کرنا ہوتا ہے۔

متعلقہ صفحات

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

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

ماخذ

  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. Developer Portal Manual (vVersion 3) — ZATCA
  4. FATOORA Portal User Manual (vVersion 3) — ZATCA
  5. Integration Sandbox API pages (Swagger): reporting, clearance, compliance, production CSID, renewal (ve-Invoicing Sandbox Release 2.1.0 (page lists 2.1.1 as latest)) — ZATCA
  6. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA

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