BITEX التوثيق English

التكامل Taxjar

يتيح تكامل TaxJar لمستخدمي BITEX حساب الضرائب تلقائيًا بناءً على عناوين العملاء والشركات ومواقع التسليم.

كيفية إعداد TaxJar؟

حساب TaxJar ورموز API:

ستحتاج إلى الرموز المميزة API من حسابك لإعداد Taxjar.

  1. Create a Taxjar account first as per your requirements.
  2. قم بتسجيل الدخول إلى لوحة معلومات حسابك وانقر على زر الحساب وانقر على TaxJar API في قائمة الخيارات المنسدلة.
  3. سترى الآن رموز API الخاصة بك، وستكون هذه الرموز المميزة ضرورية لتكوين تكامل BITEX TaxJar الخاص بك.

إضافة Nexus والدول في TaxJar:

ما هو النكسس؟

لا تحتاج إلى التسجيل لتحصيل ضرائب المبيعات من العملاء في كل ولاية. ستقوم فقط بتحصيل ضرائب المبيعات من العملاء الذين يعيشون في الولايات التي توجد بها رابطة!

"Nexus" هو نوع محدد من الاتصال بولاية يكون مهمًا بدرجة كافية بحيث يُطلب منك الالتزام بقوانين ضريبة المبيعات في تلك الولاية.

كيف أعرف مكان وجود جهاز Nexus الخاص بي؟

سيكون لديك دائمًا رابطة في موطنك حيث تتواجد.

For more details, please read up on the official TaxJar page about Nexus without fail!

إضافة الولايات:

Please follow detailed instructions given on the official TaxJar page here regarding adding/removing states to your dashboard, please follow their instructions from top to bottom as it will help you set up everything perfectly.

إعداد TaxJar على BITEX:

من سطح المكتب، انقر على أيقونة "TaskJar". سيؤدي هذا إلى إعادة توجيهك إلى مساحة عمل TaxJar.

انقر فوق "** إعدادات TaxJar **". هذا هو المكان الذي تقوم فيه بتكوين تكامل TaxJar الخاص بك في BITEX.

ملء

وضع الحماية:

يوفر TaxJar بيئة رملية للاختبار والتطوير الآلي. بعد إنشاء الرمز المميز لصندوق الحماية API، قم بتوجيه عميل API الخاص بك إلى بيئة وضع الحماية: https://api.sandbox.taxjar.com]. لاحظ أن معاملات وضع الحماية لن تنعكس في لوحة معلومات TaxJar الخاصة بك. لاستكشاف الأخطاء وإصلاحها أثناء التطوير، استخدم سجل TaxJar API.

** التسجيل: **

  • عند تحديد تمكين تسجيل TaxJar في إعدادات TaxJar، تتم كتابة طلبات/استجابات/تخطي/أخطاء TaxJar إلى سجل TaxJar API وسجلات الملفات.
  • عند إلغاء تحديد تمكين تسجيل TaxJar، يستمر تشغيل المنطق الضريبي، ولكن لا تتم كتابة إدخالات سجل TaxJar جديدة.

الحمولة والاستجابة المخزنة في السجل،

إعداد الرموز المميزة ورؤساء الحسابات:

  1. تمكين حساب الضرائب، وإنشاء معاملة TaxJar:
  2. تحتاج إلى تمكين هذه الخيارات لحسابات الضرائب التلقائية وستظهر هذه المعاملات على صفحة معاملات حساب TaxJar الخاصة بك حيث يمكنك تتبعها وتحليل تفاصيل الضرائب.
  3. بمجرد إجراء بعض المعاملات، ستظهر تلقائيًا على صفحة المعاملات الخاصة بـ TaxJar:
  4. يمكنك الاطلاع على جميع المعاملات التي تمت والتفاصيل الضريبية.
  5. انسخ الرموز المميزة API من حساب TaxJar الخاص بك وفقًا للتوجيهات أعلاه وألصقها في مفتاح API المباشر وحقل مفتاح Sandbox API.
  6. سيتعين عليك تعيين رأسي حسابين للضرائب والشحن، وتحديد الحسابات كما هو مطلوب وبمجرد تكوين كل شيء، انقر فوق "حفظ" وستكون جاهزًا للبدء!

تحديد العناوين الصحيحة

لكي يعمل التكامل بسلاسة، يرجى التأكد من إنشاء العناوين الصحيحة لشركتك وعملائك ومورديك وما إلى ذلك.

ملاحظة:

  1. أثناء إنشاء عنوان، تأكد من إدخال الحالة الصحيحة في حقل الولاية/المقاطعة. يتطلب TaxJar التنسيق المكون من حرفين للولايات على سبيل المثال. تعتبر مدينة نيويورك بمثابة مدينة نيويورك، ولكن ليس من الضروري إدخالها بشكل إلزامي بهذه الطريقة، حيث يقوم النظام بتحويلها إلى رمز الولاية المكون من حرفين تلقائيًا. عرض نموذج العنوان
  2. يمكنك تحديد مربعي الاختيار عنوان إرسال الفواتير المفضل وعنوان الشحن المفضل لملء هذه الحقول تلقائيًا في فواتير مختلفة وتجنب المتاعب.
  3. تأكد من ملء حقول المدينة/البلدة، الولاية/المقاطعة، البلد، الرمز البريدي بشكل صحيح.
  4. قد ترغب في تعطيل الضرائب، إن وجدت، والتي يتم تعيينها افتراضيًا.

TaxJar في العمل!

في هذه الحالة، لدينا شركة يقع مقرها في نيويورك ونقوم بإصدار فاتورة مبيعات إلى عميل مقيم في نفس الولاية.

كما ترون، يتم تطبيق الضرائب والرسوم بناءً على الولاية والرمز السري تلقائيًا عند الحفظ.