1. Before you start
- You need a Saudi VAT registration and access to the ZATCA Fatoora portal (to generate an OTP).
- Your Shopify store currency must be SAR (Settings → General), and 15% VAT set up for Saudi Arabia (Settings → Taxes). Selling internationally is fine as long as the base currency is SAR.
2. Connect to ZATCA (one time)
- Open the app and choose the environment (Production for live invoices; Simulation to test).
- In your Fatoora portal, generate an OTP for your device (it expires quickly — use it right away).
- Enter your VAT number, CRN and business address, paste the OTP, and click Onboard with ZATCA.
- You'll see "Connected to ZATCA". Use Test connection to confirm.
3. What happens automatically
- Every paid order → a signed tax invoice with a QR code, reported to ZATCA, attached to the order (a
ZATCA-Invoiced tag + a link).
- A refund → a compliant credit note linked to the original invoice.
4. Show the QR to your customers
- It appears on the customer's Order status page automatically.
- Optional: add it to the order‑confirmation email — the dashboard's "Show the QR to your customers" card gives you a one‑click snippet.
5. If an order isn't invoiced
The dashboard shows a "needs attention" alert with the reason. Common fixes:
- Store currency isn't SAR → change it in Settings → General.
- Order has no VAT → set up 15% VAT for Saudi Arabia in Settings → Taxes.
- Shipping wasn't taxed → make shipping taxable (delivery is subject to 15% VAT in KSA).
6. Plans
Free (25), Standard (500) and Unlimited invoices per month. Invoicing never stops, so you always stay compliant — over the cap the app just nudges an upgrade.
7. Support
Email support@progressive-labs.com.
١. قبل أن تبدأ
- تحتاج إلى تسجيل ضريبة القيمة المضافة في السعودية والدخول إلى بوابة فاتورة (ZATCA) لإنشاء رمز OTP.
- يجب أن تكون عملة متجرك ريال سعودي (SAR) (الإعدادات ← عام) مع تفعيل ضريبة 15% للسعودية (الإعدادات ← الضرائب). البيع دولياً ممكن طالما أن عملة المتجر الأساسية ريال سعودي.
٢. الربط مع الهيئة (مرة واحدة)
- افتح التطبيق واختر البيئة (الإنتاج للفواتير الفعلية، أو المحاكاة للتجربة).
- من بوابة فاتورة، أنشئ رمز OTP لجهازك (ينتهي بسرعة — استخدمه فوراً).
- أدخل الرقم الضريبي والسجل التجاري والعنوان، والصق رمز OTP، ثم اضغط ربط مع الهيئة.
- ستظهر رسالة «متصل بهيئة الزكاة والضريبة». استخدم اختبار الاتصال للتأكد.
٣. ما الذي يحدث تلقائياً
- كل طلب مدفوع ← فاتورة ضريبية موقّعة مع رمز QR، يتم إبلاغها للهيئة وربطها بالطلب (وسم
ZATCA-Invoiced ورابط).
- أي استرجاع ← إشعار دائن متوافق مرتبط بالفاتورة الأصلية.
٤. إظهار رمز QR للعملاء
- يظهر في صفحة حالة الطلب للعميل تلقائياً.
- اختياري: أضِفه إلى بريد تأكيد الطلب — بطاقة «إظهار رمز QR للعملاء» في لوحة التحكم توفّر لك المقطع بضغطة واحدة.
٥. إذا لم تُصدَر فاتورة لطلب
تعرض لوحة التحكم تنبيه «يحتاج انتباهك» مع السبب. الحلول الشائعة:
- عملة المتجر ليست ريال ← غيّرها من الإعدادات ← عام.
- الطلب بدون ضريبة ← فعّل ضريبة 15% للسعودية من الإعدادات ← الضرائب.
- الشحن غير خاضع للضريبة ← اجعل الشحن خاضعاً للضريبة (التوصيل يخضع لـ 15% في السعودية).
٦. الباقات
مجانية (25)، قياسية (500)، وغير محدودة شهرياً. الإصدار لا يتوقف أبداً لتبقى ملتزماً — وعند تجاوز الحد ينبّهك التطبيق للترقية فقط.
٧. الدعم
راسلنا على support@progressive-labs.com.