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

كيف يعمل؟

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

قبل أن تبدأ

• حساب في ZATCA Tools مرتبط بمنصة فاتورة — أكمل الربط من صفحة الإعدادات أولًا.
• متجر WooCommerce فعّال (ووردبريس 6.0 أو أحدث).
• عملة المتجر ريال سعودي (SAR) — الطلبات بعملات أخرى تُتجاهل.
• ضريبة القيمة المضافة مفعّلة في WooCommerce بنسبة ١٥٪ — هذا شرط أساسي، اضبطه قبل أي شيء (التفاصيل بالأسفل).

الخطوة ١ · ثبّت الإضافة

1. من لوحة ووردبريس افتح الإضافات ← أضف جديدًا.
2. ابحث عن ZATCA Tools — أو افتح صفحتها في مستودع ووردبريس.
3. اضغط التثبيت الآن، ثم تفعيل.

استضافتك تحجب مستودع ووردبريس؟ نزّل الملف (‎.zip) وارفعه من الإضافات ← أضف جديدًا ← رفع إضافة.

الخطوة ٢ · احصل على مفتاح API

1. ادخل إلى منصتنا: الإعدادات ← واجهة API.
2. اضغط توليد مفتاح API وانسخه — يبدأ بـ ztk_live_ ويظهر مرة واحدة فقط.

الخطوة ٣ · اربط المتجر

1. في لوحة ووردبريس افتح WooCommerce ← الإعدادات ← ZATCA Tools.
2. الصق مفتاح API واحفظ.
3. تظهر رسالة «تم الربط باسم منشأتك» — ومن الآن كل طلب مدفوع يُفوتر تلقائيًا.

الخطوة ٤ · جرّب بطلب

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

تفاصيل تهمك

• نوع الفاتورة: مبسطة (B2C) افتراضيًا — وهي الصحيحة لطلبات المتاجر. تُبلَّغ للهيئة خلال المهلة النظامية.
• حقل الرقم الضريبي في الدفع: يظهر للعميل خيار «الشراء باسم منشأة» ليدخل رقم منشأته الضريبي (والسجل التجاري) — ويبرز تلقائيًا عند الطلبات ١٬٠٠٠ ريال وأكثر.
• فواتير الشركات (B2B) وقاعدة الألف: نظام الضريبة السعودي يوجب فاتورة ضريبية كاملة للتوريد بـ١٬٠٠٠ ريال أو أكثر لمشترٍ مسجّل ضريبيًا — فنصدرها Standard باعتماد فوري عند اكتمال العنوان الوطني (شارع + رقم مبنى + مدينة + رمز بريدي). وتحت الألف تبقى مبسطة مع طباعة رقم المشتري الضريبي عليها.
• تحديد نوع المشتري بنفسك: على أي طلب، لوحة «ZATCA e-invoice» فيها اختيار منشأة (B2B) أو فرد (B2C)، مع الرقم الضريبي والعنوان الوطني والسجل التجاري — وتخبرك اللوحة قبل الإصدار بنوع الفاتورة التي ستصدر. واذا اخترت «منشأة» يتحوّل المطلوب منها أحمر، وما عداه مكتوب عنده «اختياري».
• عنوان واحد فقط: العنوان الوطني. الفاتورة الضريبية تحتاج الشارع ورقم المبنى والمدينة والرمز البريدي — ونحن نستخرجها كلها من العنوان الوطني المختصر (٤ أحرف + ٤ أرقام مثل RRRD2929) عندنا في الخدمة. فلا تُسأل عن «رقم مبنى» ولا تجمع العنوان يدويًا.
• المبلغ هو من يحدد الشكل — لا نوقف الإصدار أبدًا: تعليم الطلب كمنشأة يعني «اهدف للفاتورة الضريبية وأخبرني إن لم تستطع». فإذا كان الإجمالي تحت ١٬٠٠٠ ريال تصدر مبسطة (المادة ٥٣ تجيز المبسطة تحت الألف لأي مشترٍ) مع طباعة رقم المشتري الضريبي، وإذا كان ١٬٠٠٠ وأكثر وينقص بيان مطلوب تصدر مبسطة مع تحذير يسمّي البيان الناقص على الطلب وفي ملاحظاته وفي لوحتنا. المبسطة يجب أن تُبلَّغ خلال ٢٤ ساعة — فحجب المستند أسوأ من إصداره مبسطًا.
• عميل شركة يتكرر: تحفظ نوعه ورقمه الضريبي في ملف العميل نفسه (المستخدمون ← تعديل العميل) فتُطبَّق على كل طلباته القادمة تلقائيًا دون إعادة كتابة، ويبقى بإمكانك تجاوزها على طلب واحد.
• الفاتورة تصل عميلك: رقم الفاتورة الضريبية ورابط تحميلها يظهران في إيميلات الطلب وصفحة شكرًا وصفحة حسابي ← الطلبات — فالمستند المعتمد هو ما يستلمه العميل فعلًا.
• لوحة داخل ووردبريس: صفحة ZATCA Tools في قائمة لوحتك تعرض حالة الربط، فحص إعداد الضريبة، عدد الفواتير، وآخر الطلبات مع حالة كل فاتورة وزر إعادة محاولة.
• لا نلفّق ضريبة: أي طلب لم يُحصَّل بضريبة ١٥٪ فعليًا (الضريبة معطّلة، أو بنود معفاة، أو نسبة مختلفة) لا تُصدر له فاتورة — ويظهر السبب على الطلب لتصدرها يدويًا من منصتنا.
• الاسترجاع: أي استرداد للطلب يصدر إشعار دائن تلقائيًا مرتبطًا بفاتورة الطلب.
• إلغاء الطلب: إذا صارت حالة الطلب Cancelled أو Refunded بعد إصدار فاتورته، نصدر إشعار دائن كامل يعكسها — لأن الفاتورة المُبلَّغة للهيئة لا تُحذف. يظهر رقم الإشعار على الطلب وفي جدول لوحتنا مع زر لعرضه وطباعته داخل الصفحة. والطلب لا يختفي من الجدول بعد الإلغاء. وإذا أُلغي الطلب قبل إصدار فاتورته، لا نصدر شيئًا أصلًا.
• وإذا رجّعت الطلب مكتملًا بعد الإلغاء: نصدر إشعار مدين بنفس المبلغ فتصير الفاتورة مستحقة من جديد. إشعار الدائن لا يُحذف — كل مستند بُلِّغ للهيئة نهائي، والاثنان معًا هما سجل التدقيق. وإن ألغيته مرة أخرى يصدر إشعار دائن جديد، وهكذا.
• تعديل الطلب بعد الفوترة: الفاتورة الصادرة لا تُعدَّل — فإذا عدّلت الطلب بعد إصدارها (أضفت بندًا أو غيّرت سعرًا) نصدر الفرق تلقائيًا: إشعار مدين إذا زاد الإجمالي وإشعار دائن إذا نقص. وإذا صار الطلب بضريبة غير موحّدة ١٥٪ لا نلفّق شيئًا — يظهر لك تنبيه لتصدر التصحيح يدويًا.
• تاريخ الفاتورة وتاريخ التوريد: كل مستند يُؤرَّخ بالتوقيت السعودي (لا UTC) — فبيع الساعة ١ فجرًا لا يُؤرَّخ لليوم السابق ولا يُرحَّل لإقرار الشهر الماضي. وتاريخ التوريد هو تاريخ دفع الطلب لا تاريخ إصدار الفاتورة، لأنهما يختلفان إذا تأخر الإصدار.
• الإشعارات تصل عميلك: إشعار الدائن حق للمشتري — هو إثبات رد الضريبة له. فيظهر مع رقمه ورابطه في إيميلات الطلب وصفحة حسابي، لا الفاتورة الأصلية وحدها.
• الخصومات والشحن: خصومات الطلب تنعكس على الفاتورة (صافية)، ورسوم الشحن تظهر بندًا مستقلًا — وإجمالي الفاتورة يطابق المبلغ المدفوع دائمًا.
• لا يبطئ متجرك: الفوترة تعمل في الخلفية بعد الدفع — تجربة الشراء لا تتأثر إطلاقًا.
• كل فاتورة تستهلك من رصيد باقتك — تابع المتبقي من لوحة التحكم.

أسئلة شائعة