مواد پر جائیں
فاتوراز

ZATCA ای انوائسنگ API انٹیگریشن: فیز 2 قدم بہ قدم کیسے کام کرتا ہے

فیز 2 میں ZATCA ای انوائسنگ API انٹیگریشن کیسے کام کرتی ہے: آن بورڈنگ، ہر انوائس میں کیا ہوتا ہے، کلیئرنس اور رپورٹنگ کا فرق، اور خود بنانے یا خریدنے کے سوالات۔

تاریخ اشاعت 6 اکتوبر، 2026 · آخری اپ ڈیٹ 6 اکتوبر، 2026 · 5 منٹ کا مطالعہ

فیز 2 میں ZATCA ای انوائسنگ API انٹیگریشن سے کیا مراد ہے

فیز 2 میں ZATCA ای انوائسنگ API انٹیگریشن آپ کے انوائسنگ سسٹم اور زکوٰۃ، ٹیکس اور کسٹمز اتھارٹی کے Fatoora پلیٹ فارم کے درمیان لائیو کنکشن ہے۔ آپ کا سسٹم ہر انوائس ایک مقررہ فارمیٹ میں اسی پلیٹ فارم کو بھیجتا ہے۔ اسٹینڈرڈ ٹیکس انوائسز پہلے کلیئر کی جاتی ہیں، اور خریدار کو اس کے بعد ملتی ہیں۔ سادہ ٹیکس انوائسز فوراً جاری کی جاتی ہیں اور 24 گھنٹوں کے اندر رپورٹ کی جاتی ہیں۔ اگر آپ کا سافٹ ویئر یہ کام پہلے سے کرتا ہے تو آپ کی ٹیم میں کسی کو کوڈ لکھنے کی ضرورت نہیں۔

لفظ API سن کر لگتا ہے کہ یہ پروگرامرز کا کام ہے، لیکن یہ صرف اس طریقے کا نام ہے جس سے دو سسٹم آپس میں بات کرتے ہیں۔ اس بات چیت کا طریقہ ZATCA طے کرتی ہے، اس لیے فیز 2 کے سسٹم ایک جیسے قواعد پر عمل کرتے ہیں۔ اس گائیڈ میں ان اجزا کو آسان الفاظ میں سمجھایا گیا ہے، تاکہ کوئی کاروباری مالک یا آئی ٹی کا ذمہ دار یہ فیصلہ کر سکے کہ کنکشن خود بنائے یا تیار سافٹ ویئر پر انحصار کرے۔

آن بورڈنگ: پہلی اصل انوائس سے پہلے ایک بار کا سیٹ اپ

اصل انوائسز بھیجنے سے پہلے کسی بھی سسٹم کو ZATCA کے ساتھ رجسٹر کرنا ضروری ہے۔ اسی کو آن بورڈنگ کہتے ہیں، اور یہ کام Fatoora پورٹل پر ٹیکس دہندہ کرتا ہے، سافٹ ویئر فراہم کنندہ نہیں۔ پہلے آپ پورٹل سے ایک بار استعمال ہونے والا پاس ورڈ (OTP) حاصل کرتے ہیں۔ پھر آپ سرٹیفکیٹ سائننگ ریکویسٹ (CSR) بناتے ہیں، جس کے ذریعے ZATCA سے درخواست کی جاتی ہے کہ وہ آپ کے سسٹم کے لیے ایک ڈیجیٹل شناخت جاری کرے۔

جواب میں ZATCA تعمیل کا CSID جاری کرتی ہے، جو صرف ٹیسٹنگ کے لیے استعمال ہوتا ہے۔ پھر آپ کا سسٹم نمونے کی انوائسز تعمیل کی جانچ کے لیے بھیجتا ہے۔ جب یہ انوائسز جانچ میں کامیاب ہو جائیں تو ZATCA پروڈکشن کا CSID جاری کرتی ہے اور اصل انوائسنگ شروع ہو سکتی ہے۔ سافٹ ویئر ان مراحل میں آپ کی رہنمائی کر سکتا ہے، لیکن یہ مراحل آپ کے کاروبار کے ذمے ہیں، سافٹ ویئر فراہم کنندہ کے نہیں، اس لیے ریکارڈ رکھیں کہ یہ کس نے اور کب مکمل کیے۔

ہر انوائس کے لیے سسٹم کو کیا کچھ تیار کرنا لازمی ہے

ہر انوائس کے لیے سسٹم XML میں ایک ڈیٹا فائل بناتا ہے، جس میں UBL 2.1 نامی ایک معیاری فارمیٹ استعمال ہوتا ہے۔ اسے ایک ایسے فارم کی طرح سمجھیں جس کے ہر فیلڈ کا ایک مقررہ نام ہو، تاکہ ZATCA کے کمپیوٹر اسے کسی اندازے کے بغیر پڑھ سکیں۔ اس فائل کے ساتھ سسٹم نیچے دیے گئے اجزا شامل کرتا ہے، اور ہر جز کا کام سیدھا سادہ ہے۔ فہرست میں ان کی وضاحت کی گئی ہے، تاکہ آپ جان سکیں کہ آپ کے سسٹم کو کیا درکار ہے۔

یہ اجزا کوئی ہاتھ سے نہیں لکھتا۔ جب بھی کوئی ملازم جاری کرنے کا بٹن دبائے، سافٹ ویئر کو یہ خود بنانے چاہییں، اور چونکہ کاؤنٹر اور ہیش مل کر ایک زنجیر بناتے ہیں، اس لیے سسٹم کو اپنی بھیجی ہوئی آخری انوائس بھی یاد رکھنی ہوتی ہے۔ اگر کنکشن آپ خود بنائیں تو یہ یادداشت ان حصوں میں سے ہے جن میں سب سے زیادہ احتیاط درکار ہوتی ہے، اس لیے اسے نظر انداز نہ کریں۔

  • UUID: ایسا شناختی کوڈ جو کسی دوسری انوائس کا نہیں ہوتا
  • کاؤنٹر ویلیو: جاری کی گئی انوائسز کی مسلسل گنتی
  • پچھلی انوائس کا ہیش: آخری انوائس کا فنگر پرنٹ، جو انوائسز کو ایک زنجیر میں جوڑتا ہے
  • کرپٹوگرافک اسٹیمپ: ایک ڈیجیٹل مہر جو انوائس کو آپ کے سسٹم سے جوڑتی ہے
  • QR کوڈ: اسکین ہونے والا کوڈ جس میں انوائس کی اہم تفصیلات ہوتی ہیں
  • اختیاری PDF/A-3 کاپی: پڑھنے کے قابل فائل جس کے اندر XML رکھی جا سکتی ہے

کلیئرنس یا رپورٹنگ: خریدار کے لحاظ سے دو راستے

ایک چھوٹے کیفے کی مثال لیں۔ گاہک کاؤنٹر پر ادائیگی کرتا ہے، اس لیے انوائس سادہ ٹیکس انوائس ہوتی ہے۔ کیش رجسٹر اسے فوراً پرنٹ کرتا ہے اور سسٹم 24 گھنٹوں کے اندر اسے ZATCA کو رپورٹ کر دیتا ہے۔ چونکہ انوائس پہلے جاری ہوتی ہے، اس لیے انٹرنیٹ تھوڑی دیر کے لیے بند ہو جائے تو بھی قطار نہیں رکتی، بشرطیکہ انوائس اسی مدت کے اندر بھیج دی جائے۔

اب ایک ہول سیلر کی مثال لیں جو کسی دکان کو انوائس بھیج رہا ہے۔ یہ اسٹینڈرڈ ٹیکس انوائس ہے، اس لیے اسے کلیئر کیا جاتا ہے: پہلے ZATCA اسے وصول کرتی ہے، اور دکان کو یہ صرف اس وقت ملتی ہے جب ZATCA اسے قبول کر لے۔ اگر ZATCA اسے قبول نہ کرے تو انوائس درست کر کے دوبارہ بھیجنی ہوتی ہے۔ ایسا سسٹم منتخب کریں جو مسترد ہونے والی انوائسز واضح طور پر دکھائے، اور کسی ایک شخص کو مقرر کریں جو بلا تاخیر روزانہ انہیں چیک کرے۔

خود بنائیں یا تیار سافٹ ویئر لیں: ایک دیانت دارانہ موازنہ

خود بنانا ایسی کمپنی کے لیے موزوں ہے جس کے اپنے ڈویلپر ہوں اور جس کی انوائسنگ کی ضروریات عام نوعیت کی نہ ہوں۔ پہلا ورژن بنانا آسان حصہ ہے۔ اس کے بعد کا مسلسل کام یہ ہے کہ جب ZATCA اپنے قواعد بدلے تو کنکشن درست رکھا جائے، ہر تبدیلی سمیولیشن ماحول میں ٹیسٹ کی جائے، اور سب سے مصروف وقت میں آنے والی خرابیاں ٹھیک کی جائیں۔ جب تک آپ انوائسز جاری کرتے ہیں، کسی نہ کسی کو اس کام کی ذمہ داری لینی ہوگی۔

تیار سافٹ ویئر میں اس دیکھ بھال کا بڑا حصہ فراہم کنندہ کے ذمے چلا جاتا ہے، اور کوئی خرابی ہو تو جواب بھی وہی دیتا ہے۔ اس صورت میں آپ اس فراہم کنندہ پر انحصار کرتے ہیں، اس لیے پوچھیں کہ اپ ڈیٹس کیسے آتی ہیں اور سپورٹ ٹیم کتنی جلدی جواب دیتی ہے۔ دونوں صورتوں میں آن بورڈنگ آپ کا کاروبار خود ہی کرتا ہے۔ فیصلہ کرنے سے پہلے یہ سوالات کسی ڈویلپر یا فراہم کنندہ سے پوچھیں۔

  • فیز 2 کے کون سے مراحل آپ کا سسٹم سنبھالتا ہے، اور کون سے ہمارے ذمے ہیں؟
  • ZATCA کے قواعد میں تبدیلیاں ہم تک کیسے پہنچتی ہیں، اور انہیں کون ٹیسٹ کرتا ہے؟
  • کیا ہم پہلے سمیولیشن ماحول میں مشق کر سکتے ہیں؟
  • انٹرنیٹ یا پلیٹ فارم بند ہو تو انوائسز کا کیا ہوتا ہے؟
  • مسترد یا نہ بھیجی گئی انوائسز ہمیں کہاں نظر آتی ہیں؟

انٹیگریشن کب لاگو ہوتی ہے؟ ویوز، آخری تاریخیں اور فاتوراز کا کردار

ZATCA فیز 2 کو نمبر وار ویوز میں نافذ کرتی ہے، اور ہر ویو کا انتخاب مقررہ سالوں میں VAT کے تابع آمدنی کی بنیاد پر ہوتا ہے۔ ZATCA کسی ویو میں شامل ٹیکس دہندگان کو ان کی انٹیگریشن کی تاریخ سے کم از کم چھ ماہ پہلے براہِ راست مطلع کرتی ہے، اور اب تک 25 ویوز کا اعلان کر چکی ہے۔ کوئی بھی فیصلہ کرنے سے پہلے اپنی ویو اور تاریخ ZATCA سے چیک کریں۔

ZATCA نے اعلان کیا ہے کہ ویو 24 میں وہ ٹیکس دہندگان شامل تھے جن کی VAT کے تابع آمدنی 2022، 2023 یا 2024 میں 375,000 ریال سے تجاوز کر گئی، اور اس کی آخری تاریخ زیادہ سے زیادہ 30 جون 2026 تھی، جو گزر چکی ہے۔ ویو 25 میں وہ ٹیکس دہندگان شامل ہیں جن کی VAT کے تابع آمدنی 2022، 2023، 2024 یا 2025 میں 187,500 ریال سے تجاوز کر گئی، اور اس کی آخری تاریخ زیادہ سے زیادہ 1 فروری 2027 ہے۔

فاتوراز دونوں فیز، یعنی فیز 1 اور فیز 2، میں ZATCA کی ای انوائسنگ کے تقاضوں کو سپورٹ کرتا ہے۔ آن بورڈنگ ٹیکس دہندہ Fatoora پورٹل پر کرتا ہے، اور فاتوراز آپ کے ورک اسپیس کے اندر قدم بہ قدم اس میں آپ کی رہنمائی کرتا ہے۔ مفت آزمائش ZATCA کے سمیولیشن ماحول میں چلتی ہے، اس لیے ایک بھی اصل انوائس جاری کرنے سے پہلے آپ اپنے حقیقی معاملات کے ساتھ مشق کر سکتے ہیں۔

یہ گائیڈ عمومی معلومات پر مبنی ہے، قانونی یا ٹیکس مشورہ نہیں۔ ZATCA کے تازہ ترین اعلانات دیکھیں اور اپنی صورتحال کے لیے اپنے اکاؤنٹنٹ سے بات کریں۔

اکثر پوچھے جانے والے سوالات

کیا ZATCA کے Fatoora پلیٹ فارم سے منسلک ہونے کے لیے ڈویلپر کی ضرورت ہے؟

اگر آپ کا انوائسنگ سافٹ ویئر یہ کنکشن پہلے سے سنبھالتا ہے تو نہیں۔ البتہ آن بورڈنگ پھر بھی کاروبار کو Fatoora پورٹل پر مکمل کرنی ہوتی ہے: ایک بار استعمال ہونے والا پاس ورڈ، سرٹیفکیٹ سائننگ ریکویسٹ، تعمیل کا CSID، نمونے کی انوائسز کے ساتھ تعمیل کی جانچ، اور پروڈکشن کا CSID۔ ڈویلپر کی ضرورت زیادہ تر اسی وقت پڑتی ہے جب آپ کنکشن خود بنائیں۔

انوائس کی کلیئرنس اور رپورٹنگ میں کیا فرق ہے؟

کلیئرنس کاروباروں اور سرکاری اداروں کے لیے جاری ہونے والی اسٹینڈرڈ ٹیکس انوائسز پر لاگو ہوتی ہے۔ پہلے ZATCA انوائس وصول کرتی ہے، اور خریدار کو یہ قبول ہونے کے بعد ہی ملتی ہے۔ رپورٹنگ عام گاہکوں کے لیے سادہ ٹیکس انوائسز پر لاگو ہوتی ہے۔ یہ فوراً جاری کی جاتی ہیں اور پھر 24 گھنٹوں کے اندر ZATCA کو رپورٹ کی جاتی ہیں۔

کیا کنکشن کو اصل میں استعمال کرنے سے پہلے آزمایا جا سکتا ہے؟

جی ہاں۔ ZATCA اصل انوائسنگ سے پہلے مشق کے لیے سمیولیشن ماحول فراہم کرتی ہے۔ کریڈٹ نوٹس سمیت، ہر اس قسم کی نمونے کی انوائسز بھیجیں جو آپ استعمال کرتے ہیں، اور دیکھیں کہ کوئی انوائس مسترد ہونے پر آپ کا سسٹم کیا کرتا ہے۔ فاتوراز کی مفت آزمائش اسی ماحول میں چلتی ہے۔ اپنی ویو کی تصدیق ZATCA سے کریں۔

اپنے ذاتی ورک اسپیس سے آغاز کریں

90 دن تک انوائسنگ، ای انوائسنگ اور پوائنٹ آف سیل آزمائیں۔ نہ کریڈٹ کارڈ، نہ کوئی پابندی۔