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

كيف يعمل؟

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

قبل أن تبدأ

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

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

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

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

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

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

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

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

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

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

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

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

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

تفاصيل تهمك

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

أسئلة شائعة