حرف التحكم NIE
للرقم X1234567 يكون حرف التحكم L، فيصبح رقم NIE الكامل X1234567L. أدخل البادئة والأرقام السبعة لتكمل رقم المقيم الأجنبي، أو الصق رقمًا كاملًا لتراجع حرفه قبل عقد أو ملف رواتب. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- العدد
- X1234567
- وضع الحساب
- Compute
- المُدخَل
- X1234567
- البادئة
- X
- رقم البادئة
- 0
رقم NIE الإسباني (Número de Identidad de Extranjero) هو رقم هوية الأجنبي المستخدم في مسارات الضرائب والمصارف والتوظيف والإقامة في إسبانيا. وعلى خلاف سلسلة أرقام خالصة، يبدأ كل NIE بالحرف X أو Y أو Z، ويتابع بسبعة أرقام، وينتهي بحرف تحكم واحد يثبت أن الجسم كُتب أو خُزّن دون خطأ شائع. تنفّذ هذه القدرة التعيين الرسمي وقاعدة mod-23 المشتركة مع حروف التحكم في DNI: استبدلوا 0 بالحرف X، و1 بالحرف Y، أو 2 بالحرف Z، وعاملوا الناتج كعدد صحيح من ثمانية أرقام، ثم خذوا ذلك العدد modulo 23 وابحثوا عن الحرف في الجدول الثابت TRWAGMYFPDXBNJZSQVHLCKE. استخدموا وضع compute عندما تملكون البادئة والسبعة أرقام فقط وتحتاجون الحرف الختامي الصحيح لنموذج أو استيراد بيانات رئيسية؛ واستخدموا وضع validate عندما يرسل شريك أو CRM أو مستخدم NIE كاملًا وتحتاجون مؤشر valid واضحًا مع حرف التحكم المتوقع لرسائل الخطأ.
كيف يُحسب حرف التحكم لرقم NIE الإسباني
يتألف NIE الإسباني دائمًا من تسعة محارف عند كتابته بلا مسافات ولا شرطات: حرف بادئ من المجموعة X وY وZ؛ وسبعة أرقام عشرية؛ وحرف تحكم ختامي من A إلى Z (لا تظهر كل الحروف — الجدول فيه ثلاث وعشرون موضعًا). الحرف البادئ ليس للزينة. تاريخيًا تميّز X وY وZ نطاقات متتالية من الأرقام المخصصة للمقيمين الأجانب؛ ولصيغة حرف التحكم تُعاد كتابتها كأرقام لإعادة استخدام جدول DNI نفسه.
عيّنوا X إلى صفر وY إلى واحد وZ إلى اثنين، ثم اربطوا ذلك الرقم بالسبعة محارف الرقمية لتكوين سلسلة من ثمانية أرقام مثل 01234567 للجسم الكلاسيكي X1234567. فسّروا تلك السلسلة كعدد صحيح (الأصفار البادئة لا تغيّر القيمة المعيارية) واحسبوا الباقي عند القسمة على ثلاثة وعشرين. فهرسوا التسلسل الرسمي T, R, W, A, G, M, Y, F, P, D, X, B, N, J, Z, S, Q, V, H, L, C, K, E باستخدام ذلك الباقي كفهرس يبدأ من الصفر.
الحرف في ذلك الموضع هو حرف التحكم الوحيد الصالح لذلك الجسم. مثال: X1234567 يُعيَّن إلى 01234567، الباقي تسعة عشر، حرف التحكم L، وNIE الكامل X1234567L. الخوارزمية حتمية ومحلية: بلا استدعاء شبكة إلى الحكومة الإسبانية، وبلا استعلام سجل، وبلا ساعة.
لا تؤكد هذه الأداة أن الشخص يحمل بطاقة إقامة سارية، ولا توسّع رموز المقاطعات، ولا تدّعي أن مجموع تحقق صالحًا يعني تفويض NIE لنظام ضريبي معيّن — بل تثبت فقط أن الحرف الختامي متسق مع قاعدة mod-23 الرسمية.
أين تناسب فحوصات حرف NIE مسارات العمل الحقيقية
تُدخل فرق الموارد البشرية والرواتب موظفين غير إسبان ويجب أن تُلحق حرف التحكم الصحيح لـ NIE قبل كتابة المعرّف على العقود أو إيداعات الضمان الاجتماعي أو ملفات الدفع المصرفي التي ترفض معرّفات ضريبية غير صالحة. نماذج التسجيل العقارية والمصرفية والاتصالات تتحقق من NIE كامل من تسعة محارف عند إنشاء الحساب حتى لا يُنشئ حرف واحد مكتوب خطأ عميلًا وهميًا وخلل امتثال.
تمرّ مهام جودة البيانات على كل عمود NIE في تصدير CRM أو ERP، وتستدعي وضع validate، وتعزل الصفوف حيث valid يساوي false — فتلتقط التعديلات البشرية وأخطاء المولّدات التي تخلط أجسام DNI الرقمية فقط بقواعد بادئة NIE. لا تعاملوا فحص حرف NIE الناجح كإثبات إقامة سارية لدى السلطات الإسبانية ولا كتصريح عمل معيّن؛ فهو يثبت فقط أن حرف التحكم متسق مع الجسم ذي الثمانية أرقام بعد التعيين وفق جدول mod-23 القياسي.
حالات الاستخدام
تدقيق أعمدة NIE في تصديرات CRM وERP
تحققوا دفعةً واحدة من كل NIE إسباني في ملف عملاء أو موظفين، واعزلوا الصفوف التي لم يعد حرف التحكم فيها يطابق القيمة المتوقعة المعاد حسابها.
الأسئلة الشائعة
ما حرف التحكم في NIE الإسباني؟
هو المحرف الأخير في NIE من تسعة محارف. بعد تعيين X أو Y أو Z البادئة إلى 0 أو 1 أو 2، يفهرس العدد ذو الثمانية أرقام modulo 23 الجدول الرسمي TRWAGMYFPDXBNJZSQVHLCKE لإنتاج ذلك الحرف.
ماذا يحدث عند طول خاطئ أو بادئة خاطئة أو ترقيم؟
NIE سليم الشكل بحرف خاطئ يعيد valid false في وضع validate. مهام التحقق الفاشلة لا تُفوتر.
كيف يُحسب حرف التحكم في NIE؟
يُستبدل X بالرقم 0 وY بالرقم 1 وZ بالرقم 2، ثم يُقسم العدد المكوّن من ثمانية أرقام على 23، ويدل الباقي على الحرف في الجدول TRWAGMYFPDXBNJZSQVHLCKE. للرقم X1234567 يكون الباقي 19 والحرف L.
هل يُحسب حرف NIE بطريقة حرف DNI نفسها؟
نعم، بالجدول نفسه المكوّن من 23 حرفًا وبالقسمة نفسها المستخدمة في DNI الإسباني. والفرق الوحيد أن الحرف الأول X أو Y أو Z يُحوَّل أولًا إلى 0 أو 1 أو 2.
هل يثبت الحرف الصحيح أن رقم NIE قد صدر؟
لا. يبيّن الفحص فقط أن الحرف يطابق البادئة والأرقام. لا تتصل الأداة بأي جهة حكومية إسبانية ولا تبحث في أي سجل، لذا لا يمكنها تأكيد صاحب الرقم.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/enc/nie-spain \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"X1234567"}'const res = await fetch("https://api.kit.forhosting.com/enc/nie-spain", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": "X1234567"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/nie-spain",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": "X1234567"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/nie-spain", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":"X1234567"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":"X1234567"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/nie-spain", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"number": "X1234567"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.nie_spain",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
تفشل المدخلات المشوّهة بـ invalid_input بدل التنظيف الصامت، فلا تخزّنون أبدًا معرّف أجنبي نصف منظّف. تعمل الحسابات النقية نفسها مجانًا في المتصفح وبالسعر المنشور لواجهة API.
عقد المدخلات والأوضاع وسلوك الأخطاء
أرسلوا حقل number بجسم NIE. الطول الخاطئ خطأ صريح يسمّي الوضع والطول الذي أرسلتموه — ثمانية لـ compute وتسعة لـ validate — حتى تعرض نماذج العميل رسالة دقيقة دون تخمين. السلاسل الفارغة وnumber المفقود وقيم mode غير الصالحة والبادئات غير X Y Z والأوساط غير الرقمية والنهايات غير الحرفية تفشل قبل الوثوق بأي ناتج معياري للتخزين ولا تُفوتر. فضّلوا compute عند إكمال معرّفات الأجانب للنماذج؛ وفضّلوا validate عند تقييد بحث أو استيراد بـ NIE كامل من مستخدم أو ملف شريك. تُزال المسافات والشرطات حتى تُحلّل أشكال العرض الشائعة مثل X-1234567-L؛ أما النقاط والخطوط المائلة وعلامات الترقيم الأخرى فتُرفض كمدخل مشوّه بـ invalid_input حتى لا يصل قيمة نُظّفت بصمت إلى التخزين. وضع compute هو الافتراضي: يطلب المحرك ثمانية محارف بالضبط بعد التطبيع — البادئة X أو Y أو Z مع سبعة أرقام — ويعيد control_letter وسلسلة nie الكاملة مع الحرف المُلحق وprefix_digit (0 أو 1 أو 2) وmapped_number وremainder. وضع validate يطلب تسعة محارف بالضبط بما فيها حرف التحكم الختامي؛ وتُبلغ الاستجابة valid true عندما يطابق ذلك الحرف expected_control_letter المعاد حسابه، وvalid false عندما يكون الجسم سليم الشكل لكن الحرف خاطئ. يعيد validate دائمًا control_letter المُعطى وexpected_control_letter وprefix وdigits وmapped_number وremainder وnie المصحّح المبني بالحرف المتوقع. تُقبل مفاتيح بديلة مثل nie وtext وvalue وcode وid وn لنفس حقل الحمولة حتى لا تحتاج التكاملات التي تتكلم أصلًا بـ nie إلى إعادة تسمية. ولأن المسار parse خالص بلا ساعة ولا مصدر عشوائي ولا شبكة، ينتج نفس جسم JSON دائمًا نفس نتيجة JSON على أداة المتصفح المجانية وعلى API بسعر $0.002 لكل طلب ناجح.
أين تناسب فحوصات حرف NIE مسارات العمل الحقيقية
تعيد منصات الهجرة وإعادة التوطين حساب expected_control_letter وتعرض تصحيحًا ودّيًا عندما يلصق مقدّم الطلب رقمًا بحرف ختامي خاطئ. تثبّت اختبارات التكامل nie على عيّنات معروفة مثل X1234567L حتى لا تنحرف مكتبات الفوترة وهذه API.
حالات التكامل
إكمال جسم NIE للرواتب والعقود
استدعوا وضع compute بـ X/Y/Z مع سبعة أرقام، واحفظوا nie المُعاد مع control_letter، ومرّروا المعرّف الكامل إلى أنظمة الموارد البشرية أو الضرائب أو المصارف.
التحقق من أرقام NIE الكاملة عند الإدخال أو الاستيراد
عندما يرسل نموذج أو CSV تسعة محارف، استدعوا وضع validate وامنعوا الحفظ إذا كان valid يساوي false، مع عرض expected_control_letter للمساعدة على تصحيح خطأ طباعة واحد.
أسئلة تقنية
كيف أحسب حرف التحكم لـ NIE الإسباني بهذه API؟
أرسلوا POST مع number يساوي البادئة زائد سبعة أرقام (مثل X1234567) وmode compute (أو احذفوا mode). تتضمن الاستجابة control_letter وnie (تسعة محارف كاملة) وprefix_digit وmapped_number وremainder.
كيف أتحقق من NIE إسباني كامل؟
أرسلوا POST مع NIE ذي التسعة محارف وmode validate. تتضمن الاستجابة valid وcontrol_letter (المعطى) وexpected_control_letter وprefix وdigits وmapped_number وremainder وnie المبني بالحرف المتوقع.
هل أداة حرف التحكم لـ NIE الإسباني مجانية؟
أداة المتصفح مجانية وتعمل محليًا. تستعمل استدعاءات API رصيد KIT المدفوع مسبقًا بالسعر الأساسي المنشور $0.002؛ والمدخل غير الصالح لا يُحاسب أبدًا.