اربط متجر Shopify بالفوترة الإلكترونية

كيف يعمل؟

عند اكتمال دفع أي طلب في متجرك، يرسل Shopify إشعارًا فوريًا لمنصتنا. نحوّل الطلب (المنتجات، الكميات، الخصومات، الشحن) إلى فاتورة ضريبية مبسطة متوافقة مع المرحلة الثانية، نوقّعها بشهادة منشأتك، ونبلّغها للهيئة — كل ذلك خلال ثوانٍ من الدفع. تجد الفاتورة في صفحة الفواتير بمنصتنا مع رمز QR جاهز للمشاركة أو الطباعة.

قبل أن تبدأ

• حساب في ZATCA Tools مرتبط بمنصة فاتورة — أكمل الربط من صفحة الإعدادات أولًا.
• صلاحية مالك المتجر (أو Manage apps) في لوحة Shopify.
• عملة المتجر ريال سعودي (SAR) — الطلبات بعملات أخرى تُتجاهل.

الخطوة ١ · أنشئ تطبيقًا مخصصًا في متجرك

1. من لوحة تحكم Shopify افتح Settings ← Apps and sales channels.
2. اضغط Develop apps ثم Allow custom app development (إن طُلب منك).
3. اضغط Create an app وسمّه مثلًا ZATCA Tools.

الخطوة ٢ · امنح صلاحية قراءة الطلبات

1. داخل التطبيق افتح تبويب Configuration ثم Admin API integration ← Configure.
2. ابحث عن read_orders وفعّلها — هذه الصلاحية الوحيدة المطلوبة.
3. احفظ بـ Save.

الخطوة ٣ · ثبّت التطبيق وانسخ المفاتيح

1. افتح تبويب API credentials واضغط Install app.
2. انسخ Admin API access token — يبدأ بـ shpat_ ويظهر مرة واحدة فقط.
3. من نفس الصفحة انسخ API secret key — نستخدمه للتحقق من أن الإشعارات قادمة فعلًا من متجرك.

الخطوة ٤ · اربط المتجر في ZATCA Tools

افتح الإعدادات ← ربط المتاجر واضغط ربط المتجر، ثم أدخل:

• عنوان المتجر — بصيغة my-store.myshopify.com (وليس النطاق المخصص).
• Admin API access token وAPI secret key من الخطوة السابقة.

عند الضغط على «ربط المتجر» نتحقق من صحة المفاتيح ونفعّل إشعارات الطلبات تلقائيًا — لا حاجة لأي إعداد Webhook يدوي.

الخطوة ٥ · جرّب بطلب حقيقي

أنشئ طلبًا مدفوعًا في متجرك (أو علّم طلبًا قائمًا كمدفوع من لوحة Shopify)، ثم افتح صفحة الفواتير في منصتنا — ستجد فاتورته صدرت وبُلّغت خلال ثوانٍ. عدّاد الفواتير الصادرة يظهر أيضًا في بطاقة المتجر بصفحة الإعدادات.

تفاصيل تهمك

• نوع الفاتورة: مبسطة (B2C) — وهي الصحيحة لطلبات المتاجر الإلكترونية. تُبلَّغ للهيئة خلال المهلة النظامية (24 ساعة).
• ضريبة القيمة المضافة: إن كان متجرك مضبوطًا على «الأسعار تشمل الضريبة» نفصل الضريبة من السعر، وإلا نضيف 15٪ — وفي الحالتين إجمالي الفاتورة يطابق ما دفعه العميل فعلًا.
• الخصومات والشحن: خصومات السلة تنعكس كخصم على الفاتورة، ورسوم الشحن تظهر بندًا مستقلًا.
• كل فاتورة تستهلك من رصيد باقتك — تابع المتبقي من لوحة التحكم.
• الاسترجاع: أي Refund في متجرك يصدر إشعار دائن تلقائيًا مرتبطًا بفاتورة الطلب، بمبلغ الاسترداد الفعلي.
• فواتير الشركات (B2B): ثلاث طرق لالتقاط الرقم الضريبي للمشتري — (1) بلوك جاهز باسم «الرقم الضريبي (ZATCA)» تضيفه لصفحة السلة بالسحب والإفلات من المتجر الإلكتروني ← تخصيص ← إضافة بلوك؛ (2) الأفضل لعملائك الدائمين: احفظ الرقم مرة واحدة في ملف العميل (خانة Note أو كوسم Tag) وكل طلباته تصير فواتير ضريبية تلقائيًا؛ (3) عند إنشاء طلب يدويًا من لوحة التحكم اكتب الرقم في حقل Notes. متى ما وُجد رقم صالح وعنوان فوترة مكتمل (شارع ومدينة ورمز بريدي ورقم مبنى من 4 أرقام ضمن العنوان) نصدر فاتورة ضريبية Standard باعتماد فوري — وإلا مبسطة تلقائيًا وتقدر تصدر الضريبية يدويًا من المنصة.
• الإيقاف المؤقت: من بطاقة المتجر في الإعدادات توقف الفوترة التلقائية وتستأنفها متى شئت، دون فقدان الربط.

أسئلة شائعة