ربط TaxJar للإبلاغ عن ضريبة المبيعات

يُبقي TaxJar إقرارات ضريبة المبيعات لديك دقيقة باستلام نسخة من كل طلب مكتمل: وجهة المشتري، ومبلغ الطلب، والشحن، والضريبة التي حُصّلت بالفعل. وهو موصل للإبلاغ لا حاسبة ضرائب: فما زالت Stripe Tax هي التي تحسب الضريبة وتحصّلها عند الدفع.

تثبيت الإضافة وقائمة استكشاف الأخطاء العامة مشتركان في كل التكاملات ومشروحان في الدليل المشترك للتكاملات. تبقى هذه المقالة مع إعدادات TaxJar وقواعده.

الخطوة 1 — احصل على رمز API الخاص بـ TaxJar

سجّل الدخول إلى TaxJar، وافتح Account ← SmartCalcs API، وانسخ رمز API.

الخطوة 2 — املأ لوحة TaxJar

افتح «لوحة التحكم ← الإضافات ← TaxJar» والصق رمز API. ثم أدخل عنوان الارتباط الضريبي (nexus) / عنوان الشحن، وهو المكان الذي يعدّه TaxJar منشأ مبيعاتك: عنوان الشارع، والمدينة، والولاية أو المنطقة، والرمز البريدي، ورمز الدولة من حرفين. المطلوب فقط الرمز البريدي والدولة لكي يُرسَل العنوان مع كل طلب. ويمكنك أيضًا ضبط رمز ضريبة افتراضي للمنتج، يُطبَّق على أي بند لا يحمل رمزه الخاص؛ وتجد الرموز في TaxJar ضمن Product Tax Codes.

وأخيرًا فعّل «تفعيل TaxJar» واضغط «حفظ الإعدادات». يبدأ المفتاح مُعطَّلًا، وما دام معطّلًا لا يُرسَل أي طلب. و«اختبار الاتصال» يفحص الإعدادات التي حفظتها آخر مرة، فاحفظ أولًا. وهو يطلب من TaxJar تقدير ضريبة بمبلغ صفر بين عنوانك وعنوانك نفسه؛ ولا يُقدَّم أي شيء للإقرار.

تعامل مع رمز API الخاص بـ TaxJar كما تتعامل مع كلمة المرور. يخزّنه VeloCMS مشفّرًا، ولا يعرضه لك كاملًا مرة أخرى، ولا يسجّله أبدًا.

ما الذي يُرسَل لكل طلب

رقم الطلب في VeloCMS، ويُستخدم معرّفًا للمعاملة في TaxJar، وتاريخ الطلب.
المبلغ قبل الضريبة، ورسوم الشحن، وضريبة المبيعات التي حُصّلت.
عنوان شحن المشتري بوصفه الوجهة، وعنوانك الضريبي بوصفه المنشأ متى كان رمزه البريدي ودولته مملوءين.
كل بند في الطلب باسمه ورمز SKU وكميته وسعر وحدته، مع رمز الضريبة الافتراضي للمنتج إن ضبطته.

متى لا يُرسَل الطلب

بعض الطلبات تُترك عمدًا بدل أن تُقدَّم بتخمين. الطلب الذي لا يحمل عنوان شحن فيه دولة ورمز بريدي معًا، وهذا شائع في المشتريات الرقمية، ليس له وجهة تُقدَّم، فيُتخطّى بصمت. وإذا كانت Stripe Tax مفعّلة لكن الضريبة التي حصّلتها لم تُسجَّل في طلب بعينه، يُوسَم ذلك الطلب بـ Skipped مع السبب، وتجد الملاحظة على الطلب، لأن تقديم رقم ضريبة مختلق أسوأ من عدم التقديم. وإذا كانت Stripe Tax مُعطَّلة ولم تُسجَّل أي ضريبة، يُقدَّم الطلب بضريبة مبيعات صفر.

إرسال الطلب مرتين غير ضار. فـ TaxJar يعدّ معرّف المعاملة فريدًا ويرفض التكرار، ويفهم VeloCMS هذا الرفض بأنه «مقدَّم من قبل» لا خطأ. أما الإخفاقات الحقيقية، كرفض الرمز، فتظهر في «التكاملات ← نشاط المزامنة».

لا يقرّر TaxJar مقدار الضريبة التي يدفعها المشتري عند الدفع — هذه مهمة Stripe Tax إن كنت فعّلتها. هذا الموصل يُبلّغ فقط عمّا حُصِّل أصلًا، فيطابق سجل معاملات TaxJar مبيعاتك الحقيقية.

إيقافه

أوقف «تفعيل TaxJar» في اللوحة نفسها لإيقاف إرسال الطلبات. لا تُحذف المعاملات التي أُرسلت إلى TaxJar من قبل.