ForHosting KIT · أدوات المطورين

حاسبة حرف التحكم DNI/NIF الإسباني

أدخل الأرقام الثمانية لبطاقة DNI الإسبانية واحصل على حرف التحكم: يترك 12345678 باقيًا قدره 14 عند قسمته على 23، فيكون الحرف Z والرقم الكامل 12345678Z. الصق رقم DNI أو NIF أو NIE كاملًا للتحقق منه. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

Dni: 12345678

تحصل على

المُدخَل: 12345678
النوع: dni
العدد: 12345678
الحرف: Z

تشترك أرقام الهوية الوطنية الإسبانية (DNI) ومعرّفات الضرائب الشخصية (NIF) في فحص عام واحد: ثمانية أرقام يتبعها حرف تحكم مأخوذ من جدول ثابت من ثلاثة وعشرين حرفًا. يحتاج المقيمون والمغتربون الذين يملؤون النماذج وأدوات الرواتب ومسارات KYC باستمرار إما إلى اكتشاف الحرف الصحيح من الجسم الرقمي أو إلى التأكد من أن المعرّف الكامل المكتوب يطابق القاعدة الرسمية. تقبل حاسبة حرف DNI/NIF الإسباني جسمًا من ثمانية أرقام — أو DNI كاملًا من تسعة أحرف مع الحرف — وتطبّق خريطة modulo ثلاثة وعشرين لهيئة الضرائب وتعيد حرف التحكم والمعرّف المكتمل وعلامة valid واضحة عند تقديم حرف. تستخدم معرّفات NIE التي تبدأ بـ X أو Y أو Z الجدول نفسه بعد الاستبدال الرقمي القياسي. تُزال المسافات والشرطات ليظل اللصق من المستندات صالحًا.

كيف يُحسب حرف التحكم في DNI الإسباني

كل DNI إسباني لشخص طبيعي مكوّن من ثمانية أرقام عشرية بالإضافة إلى حرف أبجدي للتحكم. تشكّل الأرقام عددًا صحيحًا N بين الصفر وتسعة وتسعين مليونًا وتسعمائة وتسعة وتسعين ألفًا وتسعمائة وتسعة وتسعين؛ والأصفار البادئة ذات معنى وتُحفظ في الجسم المعروض، بحيث يبقى المستند المطبوع صفر صفر واحد اثنان ثلاثة أربعة خمسة ستة هو العدد مائة وثلاثة وعشرون ألفًا وأربعمائة وستة وخمسون للحساب. حرف التحكم ليس اختيارًا حرًا للمواطن: فهو محدَّد بالكامل بواسطة N.

احسب باقي قسمة N على ثلاثة وعشرين، ثم ابحث عن ذلك الباقي في الجدول الرسمي المرتّب ذي الثلاثة وعشرين حرفًا: T R W A G M Y F P D X B N J Z S Q V H L C K E. يقابل الباقي صفر الحرف T، وواحد R، وأربعة عشر Z، وهكذا حتى اثنين وعشرين الذي يعطي E. لا تظهر الحروف I وÑ وO وU في هذا الجدول عمدًا لتفادي الالتباس البصري مع الأرقام والإملاء الإسباني.

القاعدة المعيارية نفسها هي فحص NIF الشخصي في النماذج الضريبية: للمقيمين يكون NIF هو DNI مع حرفه. تبدأ أرقام NIE للمقيمين الأجانب بـ X أو Y أو Z متبوعة بسبعة أرقام وحرف؛ وقبل أخذ modulo يُستبدل X بصفر وY بواحد وZ باثنين ليظل المحرك يعمل على عدد من ثمانية أرقام.

أين يفيد التحقق من حرف DNI

غالبًا ما تطلب نماذج الإدماج وKYC للعملاء الإسبان كتابة DNI أو NIF وتحتاج فحصًا فوريًا من جهة العميل قبل مراجعة خلفية أبطأ. تستقبل واردات الرواتب والموارد البشرية معرّفات الموظفين من جداول حيث يرفض حرف خاطئ واحد دفعة كاملة؛ ويتيح وحي حتمي يعيد الحرف المتوقع وvalid تعليم الصفوف دون استدعاء بوابات حكومية. تحتاج المواقع التعليمية التي تستهدف عبارات مثل حاسبة حرف dni الإسباني أو حرف التحكم dni nif أداة مجانية حية يتطابق مسار متصفحها مع الأتمتة حتى تبقى لقطات الدروس دقيقة.

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

حالات الاستخدام

فحوص مسبقة للنماذج وKYC

تحقّق من حرف DNI أو NIF إسباني مكتوب قبل الإرسال حتى يصحّح المستخدم أخطاء الكتابة دون ذهاب وإياب إلى خوادم أنظمة حكومية.

استعادة حرف التحكم من الأرقام

احسب الحرف الرسمي من جسم من ثمانية أرقام عندما يكون المستند مهترئًا أو مقروءًا جزئيًا أو مخزَّنًا بلا حرف.

واردات دفعات الرواتب وCRM

قيّم صفوف المعرّفات الإسبانية في السكربتات: أعد حساب الحرف واضبط valid واعزل الاختلافات قبل أن تصل إلى أنظمة الموارد البشرية.

الأسئلة الشائعة

كيف يُحسب حرف التحكم في DNI الإسباني؟

خذ الجسم ذا الثمانية أرقام كعدد صحيح، واحسب ذلك العدد modulo ثلاثة وعشرين، واختر الحرف عند ذلك الفهرس في الجدول الرسمي TRWAGMYFPDXBNJZSQVHLCKE. مثال: 12345678 modulo 23 يساوي 14 ويقابل Z.

ما الفرق بين DNI وNIF هنا؟

للأشخاص الطبيعيين يكون NIF الشخصي هو DNI شاملًا حرف التحكم. تحسب هذه الأداة ذلك الحرف المشترك وتتحقق منه. أرقام CIF للشركات تستخدم مخططًا مختلفًا وتخرج عن نطاق هذه الحاسبة.

هل تدعم أرقام NIE؟

نعم. أشكال NIE بـ X أو Y أو Z مع سبعة أرقام (حرف اختياري) تستخدم الجدول نفسه بعد تعيين X إلى 0 وY إلى 1 وZ إلى 2.

ماذا يحدث إذا كان الحرف خاطئًا؟

عند إرسال معرّف كامل تتضمن الاستجابة الحرف المتوقع والسلسلة full، وتكون valid بقيمة false إذا لم يطابق الحرف المقدَّم.

لماذا لا ينتهي رقم DNI أبدًا بالحروف I أو Ñ أو O أو U؟

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

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/enc/dni-spain

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/enc/dni-spain \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dni":"12345678"}'

const res = await fetch("https://api.kit.forhosting.com/enc/dni-spain", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "dni": "12345678"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/dni-spain",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "dni": "12345678"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/dni-spain", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"dni":"12345678"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"dni":"12345678"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/dni-spain", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "dni": "12345678"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.dni_spain",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

يفشل الإدخال المشوّه بـ invalid_input بدل اختراع حرف. يتشارك ودجت المتصفح المجاني وواجهة API المدفوعة مسبقًا دالة نقية واحدة، فلا تختلف الواجبات وسكربتات الإدماج ومدقّقات النماذج في الباقي.

عقد الإدخال وشكل الاستجابة وأوضاع التحقق

قد تكون القيمة جسمًا من ثمانية أرقام فقط؛ وعندئذ تعمل القدرة في وضع compute: تعيد حرف التحكم والمعرّف الكامل والباقي المستخدم كفهرس للجدول وkind يساوي dni وmode يساوي compute وvalid يساوي true لأنه لم يُقدَّم حرف متعارض. تتبع أجسام NIE من شكل الحرف X أو Y أو Z مع سبعة أرقام، مع حرف تحكم ختامي أو بدونه، الوضعين نفسيهما مع kind nie. تُزال المسافات والنقاط والشرطات والشرطات السفلية والخطوط المائلة قبل التحليل حتى تظل الأرقام المنسوخة من PDF أو المستندات الإسبانية ذات الفواصل قابلة للتحليل. عند النجاح يتضمن الجسم أيضًا سلسلة الجدول الثابتة حتى يعرض العملاء الخريطة الكاملة بجانب الإجابة دون ترميز نسخة ثانية. أرسل جسم JSON بحقل سلسلة إلزامي اسمه dni. تُقبل الأسماء البديلة text وinput وnumber وnif وvalue وs حتى تعيد العملاء الخفيفة ومربعات النص العامة استخدام نقطة النهاية نفسها دون إعادة تسمية الحقول. وقد تكون القيمة ثمانية أرقام مع حرف مثل واحد اثنان ثلاثة أربعة خمسة ستة سبعة ثمانية Z؛ وهذا مسار وضع validate: يعيد المحرك حساب الحرف المتوقع ويقارنه بالحرف المقدَّم بعد التحويل إلى أحرف كبيرة ويضبط valid إلى true أو false ويعكس provided_letter حتى تبرز الواجهات حرفًا مكتوبًا خطأ دون تخمين. السلاسل الفارغة والكائنات غير السلاسل وأعداد الأرقام الخاطئة والحروف خارج الجدول الرسمي والأنماط التي ليست DNI ولا NIE ترفع invalid_input برسالة تسمّي المشكلة؛ ولا تُفوتر تلك الإخفاقات. تكلف استدعاءات API الناجحة السعر الأساسي المنشور $0.002 لكل عنصر؛ وتظل الأداة في المتصفح مجانية للفحوص التفاعلية.

أين تحقق واجهة API لحرف DNI قيمتها

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

أسئلة تقنية

كم تكلفة حاسبة حرف DNI/NIF الإسباني؟

أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ ولا تُفوتر المدخلات غير الصالحة.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا