1. Before you start
- To issue live invoices you need a Saudi VAT registration and access to the ZATCA Fatoora portal (to generate an OTP). To just try the app, you need nothing — use Test mode.
- 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. Test mode connects in one click to ZATCA's official sandbox — no account needed. For real invoices choose Live mode (Production; Simulation for pre-production testing).
- Log in to the Fatoora portal → Onboard new solution unit/device → generate 1 OTP. It is shown on screen and stays valid for 1 hour. No Fatoora login? Whoever files your VAT returns (often your accountant) has it.
- Enter your VAT number, CRN and business address, paste the OTP, and click Onboard with ZATCA. Orders placed before you connect are not invoiced.
- 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
- On the Thank you and Order status pages: Settings → Checkout → Customize → pick the page → Add app block → ZATCA tax invoice → Save (Shopify requires you to place the block yourself).
- 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 للعملاء
- في صفحتَي الشكر وحالة الطلب: الإعدادات ← الدفع ← تخصيص ← اختر الصفحة ← إضافة كتلة تطبيق ← ZATCA tax invoice ← حفظ (يشترط شوبيفاي أن تضيف الكتلة بنفسك).
- اختياري: أضِفه إلى بريد تأكيد الطلب — بطاقة «إظهار رمز QR للعملاء» في لوحة التحكم توفّر لك المقطع بضغطة واحدة.
٥. إذا لم تُصدَر فاتورة لطلب
تعرض لوحة التحكم تنبيه «يحتاج انتباهك» مع السبب. الحلول الشائعة:
- عملة المتجر ليست ريال ← غيّرها من الإعدادات ← عام.
- الطلب بدون ضريبة ← فعّل ضريبة 15% للسعودية من الإعدادات ← الضرائب.
- الشحن غير خاضع للضريبة ← اجعل الشحن خاضعاً للضريبة (التوصيل يخضع لـ 15% في السعودية).
٦. الباقات
مجانية (25)، قياسية (500)، وغير محدودة شهرياً. الإصدار لا يتوقف أبداً لتبقى ملتزماً — وعند تجاوز الحد ينبّهك التطبيق للترقية فقط.
٧. الدعم
راسلنا على support@progressive-labs.com.