واجهة برمجة التحقق من ضريبة القيمة المضافة الأوروبية
غلاف REST مجاني وجاهز للإنتاج حول خدمة VIES الرسمية للاتحاد الأوروبي. تحقق من أي رقم ضريبة قيمة مضافة أوروبي بطلب HTTP واحد — استجابات JSON، تخزين مؤقت على الحافة، حدود سرعة معقولة، وسجلات تدقيق متوافقة مع GDPR.
مصدر VIES الرسمي
مدعوم من ec.europa.eu/taxation_customs/vies — السجل الرسمي للاتحاد الأوروبي. تخزين مؤقت شفاف لمدة 24 ساعة على الحافة يقلل زمن الاستجابة.
JSON بدلاً من SOAP
VIES تعرض SOAP؛ نحن نغلفها بـ REST + JSON نظيف لتتمكن من التكامل في دقائق بدلاً من التعامل مع WSDLs.
حدود سرعة ومجهول
المستوى المجهول: 3 عمليات بحث/IP/يوم. تحقق من بريدك الإلكتروني → 5 عمليات تحقق/IP/يوم. مستويات أعلى متاحة للشركاء.
متوافق مع GDPR
يتم تجزئة عناوين IP (SHA-256) قبل التسجيل. لا توجد بيانات شخصية دائمة في التدفق المجهول.
مُختبَر في الإنتاج
يدعم أداة /tools/eu-business-lookup الموجهة للعملاء في الإنتاج. نفس مسار الكود، نفس ضمانات وقت التشغيل.
لا حاجة للتسجيل للتجربة
استخدم نقطة النهاية العامة مباشرة للتقييم. تحتاج إلى حدود أعلى أو webhooks؟ تواصل معنا للحصول على مستوى الشريك.
نقاط النهاية
جميع نقاط النهاية تقبل JSON وتعيد JSON. تتبع الأخطاء معيار RFC 7807 (problem+json).
https://atlas.apivom.com| الطريقة | المسار | الوصف |
|---|---|---|
| POST | /eu-vat/lookup | يتحقق من رمز البلد + رقم ضريبة القيمة المضافة. يعيد بيانات شركة مقنّعة في المستوى المجهول. |
| POST | /eu-vat/verify | يؤكد رمز البريد الإلكتروني من تدفق التحقق المزدوج. يفتح السجل الكامل غير المقنّع. |
| POST | /eu-vat/resend | يعيد إرسال بريد التأكيد إذا فقده المستخدم. يخضع لنفس الحد اليومي لعنوان IP. |
بداية سريعة
ثلاث خطوات من الصفر إلى أول رقم ضريبة قيمة مضافة موثّق لديك.
1 · افتح مجموعة Postman
تفرّع بنقرة واحدة إلى مساحة عملك. جميع نقاط النهاية والأمثلة والاستجابات النموذجية مضمّنة.
2 · أرسل طلب lookup
أرسل POST إلى /eu-vat/lookup مع country_code + vat_number. ستحصل على نتيجة مقنّعة + معرّف lookup فوراً.
3 · تحقق من البريد لإزالة القناع
تحقق مزدوج اختياري: التقط بريد المستخدم، أرسل تأكيداً، ثم استدعِ /eu-vat/verify بالرمز للكشف عن بيانات الشركة الكاملة.
curl -X POST 'https://atlas.apivom.com/eu-vat/lookup' \
-H 'Content-Type: application/json' \
-d '{ "country_code": "IE", "vat_number": "3515583EH" }'const res = await fetch('https://atlas.apivom.com/eu-vat/lookup', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ country_code: 'IE', vat_number: '3515583EH' }),
});
const data = await res.json();
console.log(data);import requests
resp = requests.post(
'https://atlas.apivom.com/eu-vat/lookup',
json={'country_code': 'IE', 'vat_number': '3515583EH'},
timeout=10,
)
print(resp.json())FAQ
هل هي مجانية فعلاً؟
نعم — المستوى المجهول مجاني للاستخدام العادي (3 عمليات بحث لكل IP يومياً). لأحجام أعلى، تتوفر نقاط نهاية شركاء بمفاتيح API عند الطلب.
ما مدى حداثة البيانات؟
يتم الاستعلام من VIES في الوقت الفعلي؛ يتم تخزين الاستجابات الناجحة مؤقتاً على الحافة لمدة 24 ساعة لحماية تطبيقك والخدمة الأصلية.
هل تخزّنون أرقام ضريبة القيمة المضافة التي أتحقق منها؟
نحفظ عمليات البحث الموثّقة (رمز البلد، رقم الضريبة، الصلاحية، الطابع الزمني) لأغراض التدقيق. يتم تجزئة عناوين IP قبل التسجيل. لا نخزّن بيانات شخصية للمكالمات المجهولة.
لماذا اسم الشركة مقنّع؟
لمنع الكشط الآلي للسجل، يتم تقنيع الاسم والعنوان جزئياً في الاستجابات المجهولة. تحقق من بريدك الإلكتروني لتلقي السجل الكامل.
ماذا يحدث إذا تعطلت VIES؟
تتلقى استجابة 503 برسالة خطأ واضحة. لا نختلق بيانات عندما لا يمكن الوصول إلى الخدمة الأصلية.
هل يمكنني الحصول على مفتاح شريك؟
نعم. تواصل عبر صفحة الاتصال وأخبرنا بالحجم المتوقع وحالة الاستخدام للتكامل.
ابدأ التحقق في 60 ثانية
تفرّع مجموعة Postman وأرسل طلبك الأول — بدون تسجيل، بدون بطاقة ائتمان، بدون مفتاح API.