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

كيف يعمل؟

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

قبل أن تبدأ

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

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

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

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

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

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

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

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

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

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

تفاصيل تهمك

• نوع الفاتورة:مبسطة (B2C) افتراضيًا — وهي الصحيحة لطلبات المتاجر. تُبلَّغ للهيئة خلال المهلة النظامية.
• حقل الرقم الضريبي في الدفع:يظهر للعميل خيار«الشراء باسم منشأة»ليدخل رقم منشأته الضريبي (والسجل التجاري) — ويبرز تلقائيًا عند الطلبات1,000 ريال وأكثر.
• فواتير الشركات (B2B) وقاعدة الألف:نظام الضريبة السعودي يوجب فاتورة ضريبية كاملة للتوريدبـ1,000 ريال أو أكثرلمشترٍ مسجّل ضريبيًا — فنصدرهاStandard باعتماد فوريعند اكتمال العنوان الوطني (شارع + رقم مبنى + مدينة + رمز بريدي). وتحت الألف تبقى مبسطةمع طباعة رقم المشتري الضريبيعليها.
• تحديد نوع المشتري بنفسك:على أي طلب، لوحة«ZATCA e-invoice»فيها اختيارمنشأة (B2B)أوفرد (B2C)، معالرقم الضريبيوالعنوان الوطنيوالسجل التجاري— وتخبرك اللوحةقبل الإصداربنوع الفاتورة التي ستصدر. واذا اخترت «منشأة» يتحوّل المطلوب منها أحمر، وما عداه مكتوب عنده «اختياري».
• عنوان واحد فقط: العنوان الوطني.الفاتورة الضريبية تحتاج الشارع ورقم المبنى والمدينة والرمز البريدي — ونحننستخرجها كلهامن العنوان الوطني المختصر (4 أحرف + 4 أرقام مثلRRRD2929) عندنا في الخدمة. فلا تُسأل عن «رقم مبنى» ولا تجمع العنوان يدويًا.
• المبلغ هو من يحدد الشكل — لا نوقف الإصدار أبدًا:تعليم الطلب كمنشأة يعني «اهدف للفاتورة الضريبية وأخبرني إن لم تستطع». فإذا كان الإجماليتحت 1,000 ريالتصدرمبسطة(المادة 53 تجيز المبسطة تحت الألف لأي مشترٍ) مع طباعة رقم المشتري الضريبي، وإذا كان1,000 وأكثروينقص بيان مطلوب تصدرمبسطة مع تحذير يسمّي البيان الناقصعلى الطلب وفي ملاحظاته وفي لوحتنا. المبسطة يجب أن تُبلَّغ خلال24 ساعة— فحجب المستند أسوأ من إصداره مبسطًا.
• عميل شركة يتكرر:تحفظ نوعه ورقمه الضريبي فيملف العميلنفسه (المستخدمون ← تعديل العميل) فتُطبَّق على كل طلباته القادمة تلقائيًا دون إعادة كتابة، ويبقى بإمكانك تجاوزها على طلب واحد.
• الفاتورة تصل عميلك:رقم الفاتورة الضريبية ورابط تحميلها يظهران فيإيميلات الطلبوصفحةشكرًاوصفحةحسابي ← الطلبات— فالمستند المعتمد هو ما يستلمه العميل فعلًا.
• لوحة داخل WordPress:صفحةZATCA Toolsفي قائمة لوحتك تعرض حالة الربط،فحص إعداد الضريبة، عدد الفواتير، وآخر الطلبات مع حالة كل فاتورة وزرإعادة محاولة.
• لا نلفّق ضريبة:أي طلب لم يُحصَّل بضريبة 15% فعليًا (الضريبة معطّلة، أو بنود معفاة، أو نسبة مختلفة)لا تُصدر له فاتورة— ويظهر السبب على الطلب لتصدرها يدويًا من منصتنا.
• الاسترجاع:أي استرداد للطلب يصدرإشعار دائن تلقائيًامرتبطًا بفاتورة الطلب.
• إلغاء الطلب:إذا صارت حالة الطلبCancelledأوRefundedبعد إصدار فاتورته، نصدرإشعار دائن كامليعكسها — لأن الفاتورة المُبلَّغة للهيئة لا تُحذف. يظهر رقم الإشعار على الطلب وفي جدول لوحتنا مع زر لعرضه وطباعته داخل الصفحة. والطلبلا يختفيمن الجدول بعد الإلغاء. وإذا أُلغي الطلبقبلإصدار فاتورته، لا نصدر شيئًا أصلًا.
• وإذا رجّعت الطلب مكتملًا بعد الإلغاء:نصدرإشعار مدينبنفس المبلغ فتصير الفاتورة مستحقة من جديد. إشعار الدائنلا يُحذف— كل مستند بُلِّغ للهيئة نهائي، والاثنان معًا هما سجل التدقيق. وإن ألغيته مرة أخرى يصدر إشعار دائنجديد، وهكذا.
• تعديل الطلب بعد الفوترة:الفاتورة الصادرة لا تُعدَّل — فإذا عدّلت الطلب بعد إصدارها (أضفت بندًا أو غيّرت سعرًا) نصدرالفرقتلقائيًا:إشعار مدينإذا زاد الإجمالي وإشعار دائنإذا نقص. وإذا صار الطلب بضريبة غير موحّدة 15% لا نلفّق شيئًا — يظهر لك تنبيه لتصدر التصحيح يدويًا.
• تاريخ الفاتورة وتاريخ التوريد:كل مستند يُؤرَّخبالتوقيت السعودي(لا UTC) — فبيع الساعة 1 فجرًا لا يُؤرَّخ لليوم السابق ولا يُرحَّل لإقرار الشهر الماضي. وتاريخ التوريد هوتاريخ دفع الطلبلا تاريخ إصدار الفاتورة، لأنهما يختلفان إذا تأخر الإصدار.
• الإشعارات تصل عميلك:إشعار الدائن حق للمشتري — هو إثبات رد الضريبة له. فيظهر مع رقمه ورابطه فيإيميلات الطلبوصفحةحسابي، لا الفاتورة الأصلية وحدها.
• الخصومات والشحن:خصومات الطلب تنعكس على الفاتورة (صافية)، ورسوم الشحن تظهر بندًا مستقلًا — وإجمالي الفاتورة يطابق المبلغ المدفوع دائمًا.
• لا يبطئ متجرك:الفوترة تعمل في الخلفية بعد الدفع — تجربة الشراء لا تتأثر إطلاقًا.
• كل فاتورة تستهلك من رصيد باقتك— تابع المتبقي من لوحة التحكم.

أسئلة شائعة