يتعامل AvaTax مع معدلات الضرائب حسب المواقع لكل ولاية، مقاطعة، ومدينة. يساعد ذلك في تحسين دقة الإيداعات من خلال مراعاة القوانين، القواعد، الحدود القضائية، والظروف الخاصة (مثل، الإجازات الضريبية، والإعفاءات الضريبية للمنتجات). يمكن للشركات التي تتكامل مع AvaTax الحفاظ على السيطرة على حساب الضرائب داخليًا باستخدام هذا التكامل البسيط للواجهة البرمجية API .

إعداد AvaTax

لاستخدام AvaTax ، يلزم وجود حساب مع Avalara للإعداد. إذا لم يتم إعداد حساب بعد، تواصل مع Avalara لشراء ترخيص: Avalara: دعنا نتحدث .

بعد ذلك، قم بإنشاء ملف تعريف شركة أساسي .

إنشاء ملف تعريف شركة أساسي

اجمع التفاصيل الأساسية للشركة للخطوة التالية: المواقع التي يتم فيها جمع الضرائب، المنتجات/الخدمات التي يتم بيعها (ومواقع بيعها)، وإعفاءات العملاء من الضرائب، إذا كانت تنطبق. اتبع وثائق Avalara لإنشاء ملف تعريف شركة أساسي:

1. إضافة معلومات الشركة .

2. أخبرنا أين تجمع الشركة وتدفع الضرائب .

3. تحقق من الاختصاصات وقم بتفعيل الشركة .

4. أضف مواقع أخرى للشركة لإعداد الضرائب حسب المواقع .

5. أضف سوقًا إلى ملف تعريف الشركة .

الاتصال بـ AvaTax

بعد إنشاء ملف تعريف الشركة الأساسي في Avalara، قم بالاتصال بـ AvaTax . هذه الخطوة تربط iroom و AvaTax بشكل ثنائي الاتجاه.

انتقل إلى بيئة sandbox أو الإنتاج في Avalara، بناءً على نوع الحساب الذي ترغب الشركة في التكامل معه.

قم بتسجيل الدخول لإنشاء مفتاح الترخيص . انتقل إلى الإعدادات ‣ الترخيص ومفاتيح API . انقر على إنشاء مفتاح ترخيص .

إذا كانت هذه هي المرة الأولى التي يتم فيها إنشاء تكامل API مع AvaTax وiroom، فانقر على إنشاء مفتاح ترخيص .

إذا كان هذا مفتاح ترخيص إضافي، تأكد من إمكانية قطع الاتصال السابق. يوجد مفتاح ترخيص واحد فقط مرتبط بكل من حسابات Avalara sandbox والإنتاج.

إعدادات iroom

قبل استخدام AvaTax ، يجب إجراء بعض الإعدادات الإضافية في iroom لضمان حساب الضرائب بدقة.

تحقق من أن قاعدة بيانات iroom تحتوي على البيانات اللازمة. الدولة التي يتم إعدادها في البداية في قاعدة البيانات تحدد الموقع المالي، وتساعد AvaTax في حساب معدلات الضرائب بدقة.

الدولة الضريبية

لتعيين الدولة الضريبية ، انتقل إلى تطبيق المحاسبة ‣ الإعدادات ‣ التكوين .

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

إعدادات الشركة

يجب على جميع الشركات التي تعمل ضمن قاعدة بيانات iroom إدراج عنوان كامل وصحيح في الإعدادات. انتقل إلى تطبيق الإعدادات ، وتحت قسم الشركات ، تأكد من وجود شركة واحدة فقط تعمل ضمن قاعدة البيانات. انقر على تحديث المعلومات لفتح صفحة منفصلة لتحديث تفاصيل الشركة.

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

يجب على مديري قاعدة البيانات التأكد من تحديث المعلومات التالية لكل شركة: الشارع… ، الشارع 2… ، المدينة ، الولاية ، الرمز البريدي ، و الدولة .

هذا يضمن دقة حساب الضرائب وسلاسة عمليات المحاسبة في نهاية العام.

تثبيت الوحدة

بعد ذلك، تأكد من تثبيت وحدة AvaTax الخاصة بـ iroom. للقيام بذلك، انتقل إلى تطبيق التطبيقات . في شريط بحث… ، اكتب avatax ، واضغط على Enter . ستظهر النتائج التالية:

الاسم	الاسم التقني	الوصف
AvaTax	account_avatax	وحدة AvaTax الأساسية. تضيف ميزات الحسابات الضريبية الأساسية.
AvaTax for geo localization	account_avatax_geolocalize	تتضمن الميزات المطلوبة للتكامل مع تحديد المواقع الجغرافية في iroom.
AvaTax for SO	account_avatax_sale	تتضمن المعلومات اللازمة لحساب الضرائب على أوامر المبيعات.
AvaTax for Inventory	account_avatax_stock	تتضمن حساب الضرائب في إدارة المخزون بـ iroom.
Amazon/AvaTax Bridge	sale_amazon_avatax	تتضمن ميزات حساب الضرائب بين iroom ووحدة Amazon Connector.
AvaTax Brazil	l10n_br_avatax	تتضمن المعلومات لحساب الضرائب في توطين البرازيل.

انقر على زر تثبيت للوحدة المسمّاة AvaTax : account_avatax . عند التثبيت، ستضاف الوحدات التالية:

• AvaTax : account_avatax
• AvaTax for SO : account_avatax_sale
• AvaTax for Inventory : account_avatax_stock

إذا كانت هناك حاجة لـ AvaTax لتحديد المواقع الجغرافية أو مع وحدة Amazon Connector، فقم بتثبيت تلك الوحدات بشكل فردي بالنقر على زر تثبيت .

إعدادات iroom AvaTax

لدمج AvaTax API مع iroom، انتقل إلى قسم تطبيق المحاسبة ‣ التكوين ‣ الإعدادات . في قسم الضرائب ، يمكنك إدخال إعدادات AvaTax وتكوين الاعتمادات اللازمة.

أولاً، ضع علامة في مربع الاختيار بجانب إعدادات AvaTax لتفعيل AvaTax في قاعدة البيانات. هذه الطريقة سريعة وسهلة لتفعيل أو إلغاء تفعيل حساب الضرائب باستخدام AvaTax على قاعدة بيانات iroom.

المتطلبات المبدئية

أولاً، اختر البيئة التي ترغب الشركة في استخدامها مع AvaTax . يمكن أن تكون إما بيئة اختبارية أو بيئة الإنتاج .

بيانات الاعتماد

الآن، يمكن إدخال بيانات الاعتماد. يجب إدخال AvaTax معرف الحساب في حقل معرف API ، ويجب إدخال مفتاح الترخيص في حقل مفتاح API .

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

أولاً، قم بتسجيل الدخول إلى بوابة AvaTax ( بيئة الاختبار أو بيئة الإنتاج ). ثم، انتقل إلى الإعدادات ‣ إدارة الشركات . ستجد قيمة رمز الشركة في صف الشركة في عمود رمز الشركة .

خيارات المعاملات

هناك إعدادان للمعاملات في إعدادات AvaTax في iroom يمكن تكوينهما: استخدام UPC و تثبيت المعاملات .

إذا تم تحديد مربع الاختيار بجانب استخدام UPC ، ستستخدم المعاملات أكواد المنتجات العالمية (UPC)، بدلاً من الأكواد المعرفة مخصصًا في Avalara. استشر محاسبًا معتمدًا للحصول على إرشادات محددة.

إذا تم تحديد مربع الاختيار بجانب تثبيت المعاملات ، فسيتم تثبيت المعاملات في قاعدة بيانات iroom للإبلاغ عنها في AvaTax .

التحقق من العناوين

تضمن ميزة التحقق من العنوان أنه يتم تعيين العنوان الأكثر تحديثًا وفقًا للمعايير البريدية على جهة اتصال في iroom. هذا مهم لضمان حسابات الضرائب الدقيقة للعملاء.

بالإضافة إلى ذلك، حدد مربع الاختيار بجانب حقل التحقق من العنوان .

حفظ الإعدادات لتطبيق التكوين.

اختبار الاتصال

بعد إدخال جميع المعلومات السابقة في إعداد AvaTax في iroom، انقر على اختبار الاتصال . هذا يضمن أن معرف API و مفتاح API صحيحان، ويتم إنشاء اتصال بين iroom وواجهة برمجة التطبيقات (API) الخاصة بـ AvaTax .

معلمات التزامن

بعد الانتهاء من إعدادات وتكوين قسم AvaTax ، اضغط على زر تزامن المعلمات . ستقوم هذه العملية بمزامنة رموز الاستثناء من AvaTax .

الموقف الضريبي

بعد ذلك، انتقل إلى تطبيق المحاسبة ‣ التكوين ‣ المحاسبة: المواقف الضريبية . يتم سرد موقف ضريبي باسم، التخطيط التلقائي للضرائب (AvaTax) . اضغط عليه لفتح صفحة تكوين الموقف الضريبي لـ AvaTax .

هنا، تأكد من أن مربع الاختيار استخدام واجهة برمجة التطبيقات لـ AvaTax مفعل.

اختياريًا، قم بتفعيل مربع الاختيار بجانب الحقل المسمى: الاكتشاف التلقائي . إذا تم تحديد هذا الخيار، سيقوم iroom بتطبيق هذا الموقف الضريبي تلقائيًا للمعاملات في iroom.

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

حسابات AvaTax

بعد تحديد خيار مربع الاختيار لـ استخدام واجهة برمجة التطبيقات لـ AvaTax ، يظهر تبويب جديد باسم AvaTax . اضغط على هذا التبويب لعرض إعدادين مختلفين.

الإعداد الأول هو حساب فاتورة AvaTax ، بينما الثاني هو حساب استرداد AvaTax . تأكد من تعيين كلا الحسابين لضمان دقة السجلات في نهاية السنة. استشر محاسبًا معتمدًا (CPA) للحصول على توجيهات محددة حول تعيين كلا الحسابين.

اضغط على حفظ لتنفيذ التغييرات.

تخطيط الضرائب

تتوفر تكامل AvaTax على طلبات البيع والفواتير مع الموقف الضريبي المدمج لـ AvaTax .

تخطيط فئات المنتجات

قبل استخدام التكامل، حدد فئة AvaTax في فئات المنتجات. انتقل إلى تطبيق المخزون ‣ التكوين ‣ فئات المنتجات . اختر فئة المنتج لإضافة فئة AvaTax لها. في حقل فئة AvaTax ، اختر فئة من القائمة المنسدلة، أو ابحث أكثر… لفتح القائمة الكاملة للخيارات.

تخطيط المنتجات

AvaTax يمكن تحديد فئاتها على المنتجات الفردية أيضًا. لتحديد فئة AvaTax ، انتقل إلى تطبيق المخزون ‣ المنتجات ‣ المنتجات . اختر المنتج لإضافة فئة AvaTax له. تحت تبويب المعلومات العامة ، على اليمين، يوجد حقل اختيار بعنوان: فئة AvaTax . أخيرًا، اضغط على القائمة المنسدلة، واختر فئة، أو ابحث أكثر… للعثور على فئة غير مدرجة.