POST AI agent ready /v1/validate/vat

واجهة برمجة تطبيقات التحقق من رقم ضريبة القيمة المضافة - فحص مجاني لضريبة القيمة المضافة في الاتحاد الأوروبي

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

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/validate/vat \
  -H "Content-Type: application/json" \
  -d '{"vat_number":"DE123456789"}'

When to use this API

تحقق من معرفات ضريبة القيمة المضافة للعملاء أثناء الخروج من B2B

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

تعبئة البلد والقواعد الضريبية تلقائيًا من رقم ضريبة القيمة المضافة

قم باستخراج رمز البلد من معرف ضريبة القيمة المضافة لتطبيق معدل ضريبة القيمة المضافة الصحيح ولغة الفاتورة ومتطلبات إعداد التقارير تلقائيًا لكل دولة عضو في الاتحاد الأوروبي.

التحقق من صحة أرقام ضريبة القيمة المضافة في نظام إدارة علاقات العملاء (CRM) الخاص بك

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

Frequently asked questions

ما هي الدول المدعومة؟

جميع الدول الأعضاء الـ 27 في الاتحاد الأوروبي. لكل بلد تنسيق رقم ضريبة القيمة المضافة الخاص به (على سبيل المثال، DE + 9 أرقام لألمانيا، FR + 11 حرفًا لفرنسا). تتحقق واجهة برمجة التطبيقات (API) من صحة النمط الصحيح للبلد المكتشف.

هل تتحقق واجهة برمجة التطبيقات هذه من رقم ضريبة القيمة المضافة مقابل قاعدة بيانات VIES؟

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

هل يتم تخزين رقم ضريبة القيمة المضافة بعد التحقق من صحته؟

لا، تتم معالجة الرقم في الذاكرة ويتم التخلص منه بعد الاستجابة. لا تتم كتابة أي بيانات على القرص أو أي نظام خارجي.

هل يمكنني التحقق من صحة أرقام ضريبة القيمة المضافة في المملكة المتحدة؟

تتبع أرقام ضريبة القيمة المضافة في المملكة المتحدة (بادئة GB) تنسيقًا معروفًا ويمكن التحقق من صحتها هيكليًا. منذ أن غادرت المملكة المتحدة الاتحاد الأوروبي، لم تعد جزءًا من VIES، لكن التحقق من التنسيق لا يزال يعمل.

ماذا يحدث إذا قمت بإرسال رقم بدون بادئة الدولة؟

تتطلب واجهة برمجة التطبيقات بادئة البلد المكونة من حرفين (على سبيل المثال، "DE"، "FR"، "NL"). وبدون ذلك، تعود الاستجابة صالحة: خطأ مع سبب يوضح أن رمز البلد مفقود.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.