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

رقم تحقق cédula الإكوادور

أدخل 171003406 لتحصل على رقم التحقق 5، فتكون البطاقة الكاملة 1710034065؛ أو الصق الأرقام العشرة لترى هل يوافق الأخير القاعدة الرسمية بباقي القسمة على 10. مفيد في نماذج التسجيل والرواتب والفوترة الإلكترونية. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

رقم الهوية (سيدولا): 171003406

تحصل على

وضع الحساب: Compute
المُدخَل: 171003406
المتن: 171003406
رقم التحقق: 5

كل بطاقة هوية إكوادورية (cédula de identidad) للشخص الطبيعي رقم من عشرة أرقام لا يُختار آخرها بحرية: إنه رقم تحقق عام يُنتج بطريقة المعاملات modulo-10 لدى Registro Civil. يحتاج من يبني نماذج KYC واستيراد الرواتب وبوابات الفوترة الإلكترونية وأدوات تسجيل المدارس أو العيادات إما إلى حساب ذلك الرقم من المواضع التسعة الأولى أو إلى التأكد من أن cédula كاملة مكتوبة متسقة مع الأوزان الرسمية. تقبل حاسبة رقم التحقق لبطاقة الهوية الإكوادورية تسعة أرقام لإرجاع رقم التحقق والرقم المكتمل، أو cédula من عشرة أرقام لإعادة حساب الرقم المتوقع وتعيين علم valid واضح. تُزال المسافات والشرطات ليبقى اللصق من PDF صالحًا.

كيف يُحسب رقم التحقق لبطاقة الهوية الإكوادورية

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

تشكّل الأرقام من الرابع إلى التاسع جسمًا متسلسلًا يعيّنه السجل المدني. الرقم العاشر محدَّد بالكامل بالتسعة الأولى: لا يختاره المواطن ولا يمكن تخمينه بمعزل عن تلك القيم. تضاعف طريقة المعاملات modulo-10 القياسية كل رقم من أرقام الجسم التسعة بمتجه أوزان ثابت متناوب اثنان، واحد، اثنان، واحد، اثنان، واحد، اثنان، واحد، اثنان من اليسار إلى اليمين.

متى كان الناتج أكبر من أو يساوي عشرة، يُطرح تسعة من ذلك الناتج ليساهم كل موضع بقيمة شبه رقم واحد. تُجمع النواتج التسعة المعدَّلة لتكوين مجموع موزون. رقم التحقق هو عشرة ناقص المجموع modulo عشرة، وإذا كان الفرق عشرة يصبح رقم التحقق صفرًا — أي check = (10 − (sum mod 10)) mod 10.

ولأن كل خطوة حساب صحيح على جدول أوزان ثابت، يتلقى عميلان يرسلان نفس التسعة أرقام دائمًا نفس رقم التحقق ونفس المجموع الموزون ونفس تفصيل النواتج. ليست الطريقة Luhn لبطاقات الدفع في كل تفاصيل العرض، وإن اشتركت العائلتان في فكرة modulo-10: هنا المعاملات ثابتة من اليسار إلى اليمين لهيكل cédula، وقواعد المقاطعة والرقم الثالث تضيّق الأجسام الصالحة. لا تعيدوا استخدام مدقق Luhn عام على حقول cédula الإكوادورية إن احتجتم إلى فرض المقاطعة والرقم الثالث وقائمة products الموثقة في الاستجابة.

أين تثبت جدوى واجهة رقم التحقق لبطاقة الهوية الإكوادورية

غالبًا ما تطلب نماذج الإدماج وKYC للعملاء الإكوادوريين كتابة cédula وتحتاج فحصًا فوريًا من جهة العميل قبل مراجعة أبطأ مقابل الأنظمة الرسمية. تحتاج المواقع التعليمية التي تستهدف عبارات مثل حاسبة رقم التحقق cédula الإكوادور إلى أداة مجانية حية يطابق مسار متصفحها الأتمتة حتى تبقى لقطات الشروح دقيقة. قد تملك العيادات والمدارس والبلديات التي تستعيد بطاقة بلاستيكية بالية تسعة أرقام موثوقة فقط وتحتاج العاشر لإكمال مواعيد عبر الإنترنت أو ملفات تأمين أو تسجيل.

ولأن التنفيذ parse نقي من المستوى A، يبقى كل استدعاء ناجح داخل نموذج التكلفة التحليلي بلا رموز نموذج ولا شبكة صادرة. لا تعاملوا رقم تحقق ناجحًا كدليل على أن الشخص معرّف بشكل صحيح أو حي أو مقيم أو موجود في Registro Civil: يثبت فقط أن سلسلة الأرقام متسقة مع طريقة المعاملات modulo-10 المنشورة لبطاقات cédula للأشخاص الطبيعيين.

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

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

تحققوا من cédula إكوادورية من عشرة أرقام مكتوبة قبل الإرسال حتى يصحح المستخدم رقم تحقق خاطئ دون ذهاب وإياب إلى السجل المدني.

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

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

استيراد جماعي للرواتب وCRM

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

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

كيف يُحسب رقم التحقق لبطاقة الهوية الإكوادورية؟

اضربوا الأرقام التسعة الأولى في المعاملات 2,1,2,1,2,1,2,1,2. إذا كان الناتج 10 أو أكثر فاطرحوا 9. اجمعوا النواتج المعدَّلة ثم خذوا (10 − sum mod 10) mod 10 كرقم تحقق. مثال: الجسم 171003406 يعطي الرقم 5.

ما قواعد المقاطعة والرقم الثالث؟

تستخدم cédula الشخص الطبيعي رموز مقاطعات من 01 إلى 24 ورقمًا ثالثًا من 0 إلى 5. الأرقام الثالثة الأخرى تنتمي إلى أنظمة ضريبية مختلفة وترفضها هذه الحاسبة.

هل يمكن التحقق من cédula كاملة من عشرة أرقام؟

نعم. أرسلوا عشرة أرقام (المسافات أو الشرطات مسموحة).

هل يمكنني لصق رقم البطاقة مع مسافات أو شرطات؟

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

هل تصلح الأداة أيضًا لرقم RUC الخاص بالشركات؟

لا. فهي تغطي بطاقات الأشخاص الطبيعيين التي يتراوح رقمها الثالث بين 0 و5. أما الأرقام الثالثة الأكبر فتخص فئات أخرى من المكلفين بقواعد مختلفة، وتقع خارج هذا الفحص.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/enc/ci-ecuador

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

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

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

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

import os, requests

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

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

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

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

{
  "cedula": "171003406"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.ci_ecuador",
  "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 المدفوعة مسبقًا في دالة نقية واحدة، فلا تختلف مساعدات الدراسة وسكربتات الإدماج ومدققات النماذج على المجموع الموزون.

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

قد يكون mode الاختياري auto أو compute أو validate؛ والافتراضي auto ويستنتج compute عندما يتبقى تسعة أرقام تمامًا بعد إزالة المسافات والشرطات والنقاط والشرطات السفلية، أو validate عندما يتبقى عشرة. فضّلوا compute عند تجميع cédula من جسم تسعة أرقام مستعاد من وثائق جزئية؛ وفضّلوا validate عندما يقدّم مستخدم أو ملف شريك أو مسار OCR رقمًا كاملًا من عشرة أرقام وتحتاجون بوابة منطقية قبل استعلام السجل المدني أو البيانات الرئيسية. أرسلوا جسم JSON بحقل سلسلة إلزامي اسمه cedula. تُقبل الأسماء المستعارة text وinput وnumber وdigits وvalue وci وn حتى يعيد العملاء الخفيفون ومربعات النص العامة استخدام نفس نقطة النهاية دون إعادة تسمية الحقول. يعيد وضع compute الحقل check_digit كسلسلة من حرف واحد، وfull كـ cédula مكتملة من عشرة أرقام، وbody كحمولة تسعة أرقام، وprovince وthird_digit للعرض، وweighted_sum وproducts للشفافية، وcoefficients كمتجه الأوزان الثابت، وalgorithm بقيمة modulo10_coefficients، وmode بقيمة compute، وvalid true لأنه لم يُقدَّم رقم متعارض. يتوقع وضع validate سلسلة من عشرة أرقام تشمل رقم التحقق الختامي؛ يعيد المحرك حساب الرقم المتوقع ويقارنه بآخر رقم مقدَّم ويضبط valid إلى true أو false ويعيد provided_check_digit حتى تبرز الواجهات حرفًا مكتوبًا خطأ دون تخمين. السلاسل الفارغة والأحرف غير الرقمية بعد إزالة الفواصل والأطوال الخاطئة للوضع المختار ورموز المقاطعات خارج صفر واحد–أربعة وعشرين والأرقام الثالثة خارج صفر–خمسة ترفع invalid_input برسالة تسمي المشكلة؛ ولا تُفوتر تلك الإخفاقات. عند النجاح يتضمن الجسم دائمًا نفس المفاتيح المنظمة حتى يختبر العملاء JSON مستقرًا حرفًا حرفًا. تكلف استدعاءات API الناجحة السعر الأساسي المنشور $0.002 لكل عنصر؛ وتبقى الأداة في المتصفح مجانية للفحوصات التفاعلية.

أين تثبت جدوى واجهة رقم التحقق لبطاقة الهوية الإكوادورية

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

أسئلة تقنية

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

في وضع validate تظل الاستجابة تتضمن check_digit المتوقع وسلسلة full، ويكون valid false إذا لم يطابق الرقم الأخير. الإدخال المشوه تمامًا يفشل بـ invalid_input.

كم تكلفة حاسبة رقم التحقق لبطاقة الهوية الإكوادورية؟

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

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

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

مثال محلول

كيف يُحسب رقم التحقق لبطاقة الهوية الإكوادورية

أين تثبت جدوى واجهة رقم التحقق لبطاقة الهوية الإكوادورية

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

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

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

استيراد جماعي للرواتب وCRM

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

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

أين تثبت جدوى واجهة رقم التحقق لبطاقة الهوية الإكوادورية

أسئلة تقنية

شكرًا