التحقق من ضريبة القيمة المضافة الأوروبية API
تحقّق من أي رقم ضريبة قيمة مضافة أوروبي عبر VIES، السجل الرسمي للمفوضية الأوروبية. تأكيد فوري، إضافة إلى الاسم والعنوان المسجَّلين عندما تفصح عنهما الدولة العضو.
لا تملك مفتاح API؟
سجّل الدخول إلى حسابك لإنشاء وإدارة مفاتيح API.
دليل التكامل
انسخ المقتطف، استبدل مفتاح API الخاص بك، ثم شغّله. يعمل مع أي عميل HTTP — أمثلة أدناه بـ cURL وJavaScript وPython.
/api/validate-vathttps://www.apipick.comValidate an EU VAT number against the official VIES registry
vat_numberstringمطلوبFull VAT number with its two-letter member-state prefix. Spaces, dots, and hyphens are stripped. IE6388047V
countrystringاختياريMember-state code, if the number is supplied without its prefix. Greece is EL, not GR. IE
curl -X GET "https://www.apipick.com/api/validate-vat" \
-H "x-api-key: YOUR_API_KEY"{
"vat_number": "IE6388047V",
"country_code": "IE",
"number": "6388047V",
"valid": true,
"name": "GOOGLE IRELAND LIMITED",
"address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
"name_disclosed": true,
"request_date": "2026-09-01T11:52:22.440Z",
"consultation_number": null,
"source": "European Commission VIES",
"credits_used": 3,
"remaining_credits": 97
}مبني لحالات استخدام واقعية
فوترة الاحتساب العكسي
أكِّد تسجيل المشتري لضريبة القيمة المضافة قبل تطبيق نسبة صفرية على فاتورة أعمال عابرة للحدود، واحتفظ بسجل التحقق.
تسجيل عملاء الأعمال
تحقّق عند التسجيل واملأ الاسم القانوني والعنوان تلقائيًا من السجل بدل مطالبة العميل بكتابتهما.
منع الاحتيال
التقط الأرقام الضريبية المختلَقة أو المنتهية قبل أن تصل إلى نظام الفوترة أو إلى إقرار ضريبي.
سير عمل الوكلاء
امنح وكيلًا ماليًا أداة بمعامل واحد يستدعيها أثناء معالجة فاتورة، وتعيد إجابة منطقية لا لبس فيها.
حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
| valid | boolean | ما إذا كان الرقم مسجَّلًا حاليًا للتجارة العابرة للحدود |
| country_code | string | رمز الدولة العضو كما يُقدَّم (EL لليونان، وXI لأيرلندا الشمالية) |
| number | string | الرقم الضريبي دون بادئة الدولة |
| name | string | null | اسم المنشأة المسجَّل، حين تفصح عنه الدولة العضو |
| address | string | null | العنوان المسجَّل، حين تفصح عنه الدولة العضو |
| name_disclosed | boolean | يكون false عندما تحجب الدولة العضو حقول الهوية بحكم السياسة (ألمانيا وإسبانيا) |
| request_date | string | null | الطابع الزمني الذي سجّله VIES لهذا التحقق |
| consultation_number | string | null | مُعرِّف طلب VIES، ويصلح دليلًا على إجراء التحقق |
| credits_used | integer | الأرصدة المخصومة عن هذا الطلب |
| remaining_credits | integer | الأرصدة المتبقية في حسابك |
حدود المعدل
يُطبَّق التقييد لكل مفتاح API، بنافذة منزلقة مدتها 60 ثانية. عند بلوغ الحد تحصل على رمز 429 نظيف مع ترويسة Retry-After.
20req/min
لكل مفتاح API ولكل نقطة نهاية. نافذة منزلقة مدتها 60 ثانية.
3concurrent
الحد الأقصى للطلبات الجارية المتزامنة لكل مفتاح API.
X-RateLimit-Limitالحد الأقصى للطلبات المسموح بها في الدقيقةX-RateLimit-Remainingالطلبات المتبقية في النافذة الحاليةX-RateLimit-Resetعدد الثواني حتى إعادة ضبط النافذة الحاليةRetry-Afterعدد الثواني التي يجب انتظارها قبل إعادة المحاولة (عند 429 فقط)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 20 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}مصدر البيانات والترخيص
تُجرى عمليات التحقق عبر VIES، نظام تبادل معلومات ضريبة القيمة المضافة التابع للمفوضية الأوروبية، الذي يمرّر كل استعلام فورًا إلى قاعدة البيانات الضريبية للدولة العضو نفسها. ولا نحتفظ بأي نسخة من السجل — فالإجابة تعود إلى الهيئة الضريبية، ونحن نقدّمها بصيغة JSON نظيفة مع بيان واضح لحالات الانقطاع وعدم الإفصاح.
الأسئلة الشائعة
س: هل هذا هو التحقق الرسمي للاتحاد الأوروبي؟
ج: نعم. يُوجَّه الطلب إلى VIES، نظام تبادل معلومات ضريبة القيمة المضافة التابع للمفوضية الأوروبية، الذي يستعلم فورًا من قاعدة البيانات الضريبية للدولة العضو نفسها. ولا توجد قاعدة بيانات وسيطة، فالإجابة هنا مطابقة لما تحصل عليه من نموذج المفوضية على الويب.
س: لماذا يكون اسم المنشأة فارغًا في الأرقام الألمانية؟
ج: لا تفصح ألمانيا وإسبانيا عن اسم المنشأة وعنوانها عبر VIES بحكم السياسة. ويبقى تأكيد تسجيل الرقم من عدمه واضحًا — وإنما تُحجب حقول الهوية وحدها. وتضبط الاستجابة name_disclosed: false كي تميّز بين الحجب النظامي والحقل الفارغ فعلًا.
س: ماذا يحدث حين يتعطل نظام إحدى الدول الأعضاء؟
ج: يوجّه VIES الطلبات إلى قاعدة بيانات كل دولة عضو، وهذه القواعد تتوقف أحيانًا للصيانة. وعندئذٍ تحصل على HTTP 503 برسالة واضحة، ولا تُخصم أي أرصدة. أعد المحاولة بعد دقائق — فالعطل لدى الهيئة الضريبية لا لدينا.
س: ما رموز الدول المدعومة؟
ج: الدول الأعضاء السبع والعشرون جميعها، إضافة إلى XI لأيرلندا الشمالية بموجب إطار وندسور. ولاحظ أن اليونان تقدّم ضريبة القيمة المضافة برمز EL لا برمزها ISO المعروف GR. أما بريطانيا العظمى (GB) فقد خرجت من VIES بعد بريكست وليست مشمولة.
س: هل يمكنني الحصول على رقم استشارة لسجل التدقيق لديّ؟
ج: يحمل حقل consultation_number مُعرِّف طلب VIES عند إصداره. وهذا المُعرِّف هو ما تقبله الهيئة الضريبية دليلًا على أنك تحققت من وضع الطرف المقابل الضريبي في تاريخ محدد، وهو أمر مهم في فوترة الاحتساب العكسي.