ZATCA ای انوائس QR (سعودی FATOORA)
سعودی عرب کی ZATCA (زکوٰۃ، ٹیکس اور کسٹمز اتھارٹی) مملکت میں جاری ہر ٹیکس انوائس پر QR لازمی قرار دیتی ہے۔ فیز 1 آسان TLV ہے؛ فیز 2 FATOORA پلیٹ فارم کے ذریعے کرپٹوگرافک سیلنگ شامل کرتا ہے۔ غیر تعمیل کنندہ انوائسز خریدار کا اکاؤنٹنگ سافٹ ویئر مسترد کرتا ہے اور VAT واپسی کے لیے باطل ہیں۔
کیننکل سپیسیفکیشن:ZATCA ای-انوائسنگ ریزولوشن اور نفاذی ضوابط, 2026 تک موجودہ۔
فیز 1 (جنریشن): 4 دسمبر 2021 سے نافذ۔ تمام VAT رجسٹرڈ کاروبار QR کے ساتھ ڈیجیٹل انوائسز جاری کرنے کے پابند ہیں۔
فیز 2 (انٹیگریشن): یکم جنوری 2023 سے کاروبار کے حجم کے مطابق مرحلہ وار نافذ۔ معیاری انوائسز کے لیے ڈیجیٹل دستخط + ZATCA کلیئرنس اور آسان انوائسز کے لیے ریئل ٹائم رپورٹنگ شامل کرتا ہے۔
فیز 1 (جنریشن): 4 دسمبر 2021 سے نافذ۔ تمام VAT رجسٹرڈ کاروبار QR کے ساتھ ڈیجیٹل انوائسز جاری کرنے کے پابند ہیں۔
فیز 2 (انٹیگریشن): یکم جنوری 2023 سے کاروبار کے حجم کے مطابق مرحلہ وار نافذ۔ معیاری انوائسز کے لیے ڈیجیٹل دستخط + ZATCA کلیئرنس اور آسان انوائسز کے لیے ریئل ٹائم رپورٹنگ شامل کرتا ہے۔
یہ کیا ہے
QR ایک Base64 سٹرنگ انکوڈ کرتا ہے۔ مقررہ ترتیب میں 5 لازمی فیلڈز کے ساتھ بائنری TLV سیکوئنس حاصل کرنے کے لیے Base64 ڈی کوڈ کریں:
| ٹیگ | فیلڈ | قسم | نوٹس |
|---|---|---|---|
01 | بیچنے والے کا نام | UTF-8 سٹرنگ | بیچنے والے کا تجارتی نام۔ عربی اور لاطینی دونوں قابل قبول۔ |
02 | VAT رجسٹریشن نمبر | 15 ہندسے | سعودی اداروں کے لیے 3 سے شروع ہوتا ہے۔ فارمیٹ: 3XXXXXXXXXXXXX3۔ |
03 | انوائس ٹائم اسٹیمپ | ISO 8601 | مثلاً 2026-04-18T10:30:00Z۔ ٹائم زون شامل ہونا چاہیے۔ |
04 | انوائس کُل (VAT سمیت) | اعشاریہ سٹرنگ | مثلاً 115.00۔ کرنسی ضمنی طور پر SAR ہے۔ |
05 | VAT رقم | اعشاریہ سٹرنگ | مثلاً 15.00۔ موجودہ معیاری شرح 15%۔ |
06 | انوائس ہیش (فیز 2) | Base64 SHA-256 | کیننکل انوائس XML کا SHA-256۔ |
07 | ڈیجیٹل دستخط (فیز 2) | Base64 | بیچنے والے کے CSID سرٹیفکیٹ سے انوائس ہیش پر ECDSA۔ |
08 | پبلک کلید (فیز 2) | Base64 X.509 | بیچنے والے کی ECDSA پبلک کلید (CSID سے)۔ |
09 | ZATCA اسٹیمپ (فیز 2) | Base64 | ZATCA کا کاؤنٹر سائن۔ صرف ZATCA کلیئرنس کے بعد موجود۔ |
ہر TLV ریکارڈ 1 ٹیگ بائٹ + 1 لمبائی بائٹ + <لمبائی> قدر بائٹس ہے۔ پھر پورے سیکوئنس کو QR پے لوڈ بننے کے لیے Base64 انکوڈ کیا جاتا ہے۔
فیز 1 (آسان) بمقابلہ فیز 2 (انٹیگریشن)
| پہلو | فیز 1 | فیز 2 |
|---|---|---|
| QR مواد | صرف ٹیگز 01–05 | ٹیگز 01–05 کے ساتھ 06، 07، 08، اختیاری طور پر 09 |
| ZATCA انٹیگریشن | کچھ نہیں, آف لائن | آسان انوائسز کے لیے ریئل ٹائم API، معیاری انوائسز کے لیے کلیئرنس فلو |
| ضروری سرٹیفکیٹس | نہیں | ہاں, ZATCA کی طرف سے جاری CSID (کرپٹوگرافک اسٹیمپ آئیڈنٹیفائر) |
| نافذ ہونے کی تاریخ | 2021-12-04 (تمام کاروبار) | 2023-01-01 (آمدنی کے مطابق مرحلہ وار لہریں) |
| انوائس کا دائرہ | B2C (آسان) + B2B (معیاری) | B2C آسان: ریئل ٹائم رپورٹ۔ B2B معیاری: جاری کرنے سے پہلے کلیئرنس (پری ویلیڈیشن)۔ |
کیننکل ٹیسٹ ویکٹرز
TLV مثال (Base64 سے پہلے):
01 0A "Acme Saudi" 02 0F "300000000000003" 03 14 "2026-04-18T10:30:00Z" 04 06 "115.00" 05 05 "15.00"Base64 انکوڈنگ کے بعد:
AQpBY21lIFNhdWRpAg8zMDAwMDAwMDAwMDAwMDMDFDIwMjYtMDQtMThUMTA6MzA6MDBaBAYxMTUuMDAFBTE1LjAw| کیس | ان پٹ | Base64 پریفکس |
|---|---|---|
| فیز 1، کم سے کم آسان | seller=Acme Saudi | AQpBY21lIFNhdWRp... |
| عربی بیچنے والے کا نام | seller=شركة أكمي | بیچنے والے کا نام Base64 سے پہلے TLV کے اندر UTF-8 انکوڈ کیا گیا۔ |
| فیز 2 معیاری انوائس | اوپر کے تمام کے ساتھ hash=<SHA-256 Base64> | بہت لمبا Base64۔ ڈیکوڈرز کو 05 کے بعد اضافی ٹیگز برداشت کرنے چاہئیں۔ |
عام نقصانات
- VAT نمبر کی لمبائی۔ ZATCA VAT نمبرز بالکل 15 ہندسوں کے ہیں،
3سے شروع اور ختم ہوتے ہیں۔ کچھ بھی اور انوائس انجیسشن سائیڈ پر ویلیڈیشن ناکام ہوتی ہے۔ - ٹائم زون کے بغیر ٹائم اسٹیمپ۔ سپیسیفکیشن واضح زون (
Zیا+03:00) کے ساتھ ISO 8601 کی ضرورت ہے۔ سادہ لوکل ٹائم اسٹیمپس مسترد کیے جاتے ہیں۔ - انکوڈنگ ترتیب۔ TLV فیلڈز ٹیگ نمبر ترتیب (01، 02، 03، 04، 05، …) میں ہونی چاہئیں۔ دوبارہ ترتیب دینے سے QR کامیابی سے ڈی کوڈ ہوتا ہے لیکن کچھ ویلیڈیٹرز اسے غیر معیاری نشان زد کرتے ہیں۔
- اعشاریہ فارمیٹنگ۔ انوائس کُل اور VAT رقم ڈاٹ اعشاریہ (
115.00) استعمال کرتے ہیں، کامہ اعشاریہ (115,00) نہیں۔ ہزار کے جداگر بھی نہیں۔ - کرنسی ضمنی طور پر SAR۔ غیر ملکی کرنسی کے انوائسز بھی QR فیلڈ کے لیے SAR میں تبدیل ہوتے ہیں۔ بنیادی XML اصل کرنسی رکھ سکتا ہے؛ QR نہیں۔
- فیز 2 کلیئرنس ناکامیاں۔ ZATCA کے کلیئرنس API کو جمع کردہ معیاری انوائس مسترد ہو سکتی ہے (خراب CSID، ناقص XML، غلط ٹیکس حساب)۔ کلیئرنس تک انوائس قانوناً باطل ہے۔ ایکسپونینشل بیک آف کے ساتھ ری ٹرائی لوپ رکھیں؛ کلیئرنس کامیاب ہونے تک انوائس جاری نہ کریں۔
- CSID سرٹیفکیٹ روٹیشن۔ فیز 2 CSIDs ختم ہوتے ہیں (عام طور پر 1 سال)۔ اپنے ای انوائسنگ اسٹیک میں تجدید جانچ بنائیں ورنہ اچانک انوائسز جاری کرنے سے قاصر ہو جائیں گے۔
اسکینر مطابقت
| ریڈر | سپورٹ | نوٹس |
|---|---|---|
| ZATCA FATOORA ایپ | نیٹو | سرکاری وزارت ایپ؛ ZATCA PKI کے خلاف فیز 2 دستخطوں کی تصدیق کرتی ہے۔ |
| سعودی اکاؤنٹنگ سافٹ ویئر (SAP B1, Oracle, Microsoft Dynamics) | نیٹو (2023 کے بعد) | مقامی سعودی بلڈز میں AP پائپ لائن میں ZATCA پارسنگ موجود ہے۔ |
| iOS کیمرہ | خام Base64 | ٹیکس انوائس کے طور پر نہیں پہچانا۔ صارف کو FATOORA ایپ کھولنی ہوگی۔ |
| Android کیمرہ / Google Lens | خام Base64 | وہی, کوئی نیٹو پارسنگ نہیں۔ |
| تھرڈ پارٹی آڈٹ ٹولز (PwC, KPMG, Deloitte Saudi یونٹس) | نیٹو | آڈٹ ٹیکنالوجی سوٹس فیز 2 دستخط پارس + تصدیق کرتے ہیں۔ |
مزید دیکھیں
- /zatca-saudi-einvoice-qr-code/, جنریٹر۔
- /standards/, معیارات کے اشاریے پر واپس جائیں۔
- ZATCA ڈویلپرز پورٹل, مستند وسائل اور FATOORA سینڈ باکس۔