TaxJar

ماذا تفعل

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

لمن يناسب

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

كيف تعمل

1. 01

   في TaxJar، انسخ رمز API الخاص بك من Account ثم SmartCalcs API. وفي VeloCMS، افتح إضافة TaxJar والصق الرمز، وأدخل عنوان الـ nexus، وفعّل «Enable TaxJar» ثم احفظ. يُخزَّن الرمز مشفّرًا.

2. 02

   اضغط «Test Connection». يطلب VeloCMS من TaxJar تقدير ضريبة بقيمة صفر باستخدام عنوانك المحفوظ. ولا يُقدَّم أي إقرار.

3. 03

   حين يُدفع الطلب، يستخرج VeloCMS الضريبة التي حُصّلت فعلًا عليه من سجلات الطلب، لا من تخمين.

4. 04

   يرسل VeloCMS الطلب المكتمل إلى قائمة معاملات TaxJar في الخلفية. والطلب الذي لا تُعرف ضريبته المحصَّلة يُتجاوز ويُعلَّم، ولا يُرسل.

الإعدادات التي تضبطها

تفعيل TaxJar (Enable TaxJar)

يبدأ معطّلًا. وما دام معطّلًا لا يُرسل أي طلب، حتى لو كان الرمز محفوظًا.

رمز API (API Token)

تجده في TaxJar ضمن Account ثم SmartCalcs API. يُخزَّن مشفّرًا ولا يُعرض لك مرة أخرى بعد الحفظ.

عنوان الـ nexus / الشحن (Nexus / ship-from address)

عنوان المنشأ الذي تعدّه TaxJar المكان الذي تبيع منه. لا يلزم إلا الرمز البريدي والدولة حتى يُرسل العنوان مع كل طلب.

رمز الضريبة الافتراضي للمنتج (Default product tax code)

اختياري. يُطبَّق على أي بند ليس له رمز ضريبة خاص به. وتعرض TaxJar الرموز ضمن Product Tax Codes.

اختبار الاتصال (Test Connection)

يتحقق من الإعدادات المحفوظة، فاحفظ أولًا. يطلب تقدير ضريبة بقيمة صفر ولا يقدّم أي إقرار.

ما تستطيع الوصول إليه

بعد كل طلب مدفوع، تقرأ الإضافة معرّف الطلب وتاريخه والإجمالي وتكلفة الشحن والضريبة المحصَّلة على كل بند وعنوان شحن المشتري والمنتجات المشتراة. وترسل هذه البيانات إلى api.taxjar.com وحده، ولا ترسلها إلى أي جهة أخرى. ولا تقرأ تدويناتك ولا أعضاءك. يُخزَّن رمز API الخاص بك في TaxJar مشفّرًا ولا يُعرض نصًا صريحًا أبدًا.

حدود نذكرها بصراحة

• تبلّغ الإضافة ولا تحسب. الضريبة عند الدفع تحسبها وتحصّلها Stripe Tax إن فعّلتها، ولا تضيف هذه الإضافة ضريبة إلى أي عملية بيع ولا تغيّرها.

• إن كانت Stripe Tax مفعّلة ولم تُسجَّل ضريبة محصَّلة لطلب ما، يُعلَّم الطلب «Skipped» مع السبب ولا يُرسل. فالرقم المختلق يفسد الإقرار الضريبي، ولذلك تضيف ذلك الطلب إلى TaxJar يدويًا.

• إن كانت Stripe Tax معطّلة ولم تُسجَّل أي ضريبة، يُرسل الطلب بضريبة مبيعات قدرها صفر.

• الطلب الذي ليس له عنوان شحن فيه دولة ورمز بريدي معًا، وهو الحال المعتاد في المشتريات الرقمية فقط، لا وجهة له ويُتجاوز بصمت.

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

• لا تبلّغ هذه الإضافة TaxJar عن المبالغ المستردة. وإنما تُرسل الطلبات المكتملة فقط.

• الطلبات التي أُجريت قبل الربط لا تُرسل.

الأسئلة الشائعة

إضافات ذات صلة

• Shippo
• ShipStation
• Printful

المواصفات

الفئة

commerce

السعر

مضمَّن

الإصدار

1.1.0

المصدر

من الطرف الأول