واجهة برمجة التطبيقات للتحقق من رقم ضريبة القيمة المضافة: التحقق من معرفات ضريبة الاتحاد الأوروبي في منشور واحد

أنت تبيع البرامج للشركات في أوروبا. يتطلب قانون الضرائب في الاتحاد الأوروبي منك التحقق من صحة ضريبة القيمة المضافة للمشتري معرف قبل تطبيق الرسوم العكسية (0٪ ضريبة القيمة المضافة). تتمتع خدمة VIES الرسمية بوقت تشغيل غير موثوق به وإرجاع SOAP XML. أنت بحاجة إلى بديل أسرع وأكثر راحة.

البوتوي /v1/validate/vat تقوم نقطة النهاية بالتحقق من صحة أرقام ضريبة القيمة المضافة لجميع أعضاء الاتحاد الأوروبي الـ 27 الدول والمملكة المتحدة. أرسل منشورًا واحصل على رد JSON يتضمن الصلاحية ورمز البلد و رقم منسق. لا يوجد تحليل XML. لا توجد ملفات WSDL. لا مهلة من الحكومة المثقلة الخوادم.

استدعاء API

أرسل رقم ضريبة القيمة المضافة مع بادئة الدولة المكونة من حرفين:

إجابة:

ال valid المجال هو true عندما يتطابق الرقم مع التنسيق المتوقع لبلدها. ال country_code و country تخبرك الحقول الولاية القضائية التي ينتمي إليها الرقم.

عندما يفشل الرقم في التحقق من صحته

إذا كان الرقم لا يتطابق مع النمط المتوقع، valid يعود false. لا تزال الاستجابة تتضمن البلد المكتشف:

تتطلب أرقام ضريبة القيمة المضافة الألمانية 9 أرقام بالضبط بعد DE بادئة. هذا واحد لديه 5. يمكن للواجهة الأمامية الخاصة بك عرض اسم البلد والتنسيق المتوقع لمساعدة المستخدم على تصحيح معلوماته إدخال.

تكامل الخروج الشريطي

قبل إنشاء جلسة دفع Stripe، قم بالتحقق من صحة معرف ضريبة القيمة المضافة الخاص بالمشتري. إذا كان صحيحا، تعيين العميل ل tax_exempt: "reverse" لذا فإن Stripe يتقاضى ضريبة القيمة المضافة بنسبة 0٪. إذا كان غير صالح، ارفض النموذج واطلب من المشتري تصحيحه.

وهذا يمنع مشكلتين شائعتين: فرض ضريبة القيمة المضافة على الشركات التي ينبغي إعفاؤها (خلق مشكلة استرداد الأموال)، ومنح إعفاء ضريبي لشخص لديه رقم ضريبة القيمة المضافة المزيف (خلق مشكلة التدقيق).

إنشاء فاتورة مع ضريبة القيمة المضافة المشروطة

عند إنشاء فاتورة، يتعين عليك تحديد معدل ضريبة القيمة المضافة. القواعد:

• البيع بين الشركات في نفس البلد: افرض معدل ضريبة القيمة المضافة المحلي لديك.
• البيع بين الشركات عبر الحدود باستخدام معرف ضريبة القيمة المضافة صالح: تطبيق رسوم عكسية (0%).
• معرف ضريبة القيمة المضافة غير صالح أو مفقود: قم بتحصيل السعر المحلي للمشتري.

ال country_code من استجابة API يقود هذا المنطق:

التحقق من صحة نموذج الاشتراك SaaS B2B

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

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

تنسيق ضريبة القيمة المضافة حسب البلد

لدى كل دولة من دول الاتحاد الأوروبي تنسيق مختلف لأرقام تعريف ضريبة القيمة المضافة. يتم التحقق من صحة API ضد كل هذه الأنماط:

تغطي القائمة الكاملة جميع الدول الأعضاء في الاتحاد الأوروبي البالغ عددها 27 دولة بالإضافة إلى المملكة المتحدة. تتراوح التنسيقات من 8 أرقام (الدنمارك، لوكسمبورغ) إلى 12 رقمًا (السويد). تتضمن بعض الدول حروفًا في نص الملف رقم (فرنسا، إسبانيا، أيرلندا).

التحقق من صحة التنسيق مقابل بحث VIES

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

بالنسبة لمعظم عمليات الدفع، يعد التحقق من صحة التنسيق هو الخطوة الأولى الصحيحة. فإنه يمسك الأخطاء المطبعية، في عداد المفقودين البادئات والأرقام المختلقة بشكل فوري، دون الاعتماد على خدمة خارجية في كثير من الأحيان إلى أسفل. إذا كنت بحاجة أيضًا إلى حالة التسجيل، فاتصل بـ VIES بعد اجتياز فحص التنسيق. يعمل هذا النهج المكون من خطوتين على تقليل مكالمات VIES بنسبة 15-30% (جميع التنسيقات غير الصالحة لا تصل مطلقًا إلى خدمة بطيئة).

النقاط الرئيسية

يغطي المستوى المجاني التطوير واستخدام الإنتاج منخفض الحجم. للخروج من حركة المرور العالية التدفقات، قم بإضافة مفتاح API الخاص بك في ملف Authorization: Bearer header. تحقق من مستندات API للحصول على مرجع نقطة النهاية الكامل و ملعب تفاعلي لاختبار أرقام ضريبة القيمة المضافة في متصفحك.