كيف أربط TaxJar للإبلاغ عن ضريبة المبيعات على الطلبات المكتملة؟
أرسل ضريبة كل طلب مكتمل إلى TaxJar لتقديم الإقرارات الضريبية. يُبلّغ TaxJar عمّا جمعه Stripe Tax بالفعل — ولا يحسب الضريبة عند الدفع.
يبقي TaxJar إقراراتك الضريبية دقيقة عبر استلام نسخة من كل طلب مكتمل — وجهة المشتري، إجمالي الطلب، الشحن، والضريبة التي سبق جمعها. إنه موصل إبلاغ لا حاسبة ضريبة: فـ Stripe Tax لا يزال يحسب الضريبة ويجمعها عند الدفع.
الخطوة 1 — احصل على مفتاح TaxJar API الخاص بك
سجّل الدخول إلى حساب TaxJar الخاص بك، افتح Account → TaxJar API، وانسخ مفتاح الـ API.
الخطوة 2 — ثبّت الإضافة واضبط إعداداتها
اذهب إلى Admin → Plugins → Marketplace، ابحث عن TaxJar، واضغط Install. افتح Admin → Plugins → TaxJar والصق مفتاح الـ API الخاص بك. ستُدخل أيضًا عنوان النِّطاق الضريبي (nexus) / عنوان الشحن — الموقع الذي يستخدمه TaxJar لتحديد أين تدين بالضريبة — ويمكنك اختياريًا ضبط رمز ضريبة منتج افتراضي للعناصر التي لا تحدد واحدًا.
اضغط Test Connection للتأكد من صحة المفتاح قبل الحفظ. بعد الحفظ، فعّل الموصل.
تعامل مع مفتاح TaxJar API كما تتعامل مع كلمة مرور. يخزّنه VeloCMS مشفّرًا، ولا يعرضه لك كاملًا مطلقًا، ولا يسجّله في أي سجلّات.
ما الذي يُرسَل، ومتى
كل طلب يصل إلى حالة الاكتمال يُرسَل إلى قائمة معاملات TaxJar فور اكتماله — يستلمه TaxJar كبيعة منتهية جاهزة للظهور في إقرارك التالي. لا يُرسَل شيء إلى TaxJar حتى يكتمل الطلب فعليًا.
لا يقرر TaxJar مقدار الضريبة التي يدفعها المشتري عند الدفع — تلك مهمة Stripe Tax، إن كانت مفعّلة. يُبلغ هذا الموصل فقط عمّا جُمع بالفعل، بحيث يطابق سجل معاملات TaxJar لديك مبيعاتك الحقيقية.
إيقاف التشغيل
بدّل الموصل إلى إيقاف في نفس اللوحة لوقف إرسال الطلبات. المعاملات المُرسَلة مسبقًا إلى TaxJar لا تُحذف.