رقم تحقق RUC الإكوادور
الرقم 1710034065001 صحيح: شخص طبيعي من المقاطعة 17، ورقم التحقق 5 في الخانة العاشرة، ورمز المنشأة 001. تختار الأداة القاعدة المناسبة من الرقم الثالث، باقي القسمة على 10 أو 11، وتخبرك بنوع المكلّف. مجانية في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- Ruc
- 1710034065001
- النوع
- natural_person
- تسمية النوع
- Natural person (persona natural)
- الرقم الثالث
- 1
- رمز المقاطعة
- 17
إنّ RUC الإكوادوري (Registro Único de Contribuyentes) هو المعرّف الضريبي المكوّن من ثلاثة عشر رقمًا والذي يصدره Servicio de Rentas Internas للأشخاص الطبيعيين والشركات الخاصة والكيانات العامة. يرمّز الرقمان الأولان المقاطعة، ويختار الرقم الثالث فئة المكلّف، ويقع رقم تحقق مرجّح في الموضع التاسع أو العاشر بحسب تلك الفئة، والكتلة الختامية هي رمز المنشأة أو الفرع. تتحقّق هذه القدرة من RUC نقي من ثلاثة عشر رقمًا بالتوجيه حسب الرقم الثالث: القيم من صفر إلى خمسة تستخدم قاعدة modulo عشرة للشخص الطبيعي المشتركة مع cédula، والستة تستخدم أوزان modulo أحد عشر للكيان العام، والتسعة تستخدم أوزان الشركة الخاصة. يبيّن الردّ ما إذا كان رقم التحقق المخزَّن يطابق القيمة المعاد حسابها، والنوع المكتشف، ورمز المقاطعة، وكتلة المنشأة، ورقم التحقق المتوقع عند وجوده.
كيف تعمل أنواع RUC وأرقام التحقق في الإكوادور
يكون RUC سليم التكوين دائمًا ثلاثة عشر رقمًا عشريًا عند إزالة علامات الترقيم. الموضعان الأول والثاني هما رمز المقاطعة ويجب أن يكونا في النطاق من صفر-واحد إلى أربعة وعشرين للولايات المحلية، أو ثلاثين للمقيمين الأجانب المسجَّلين في الإكوادور. الموضع الثالث هو مميّز النوع الذي يختار الفئة القانونية والحساب معًا: الأرقام من صفر إلى خمسة تشير إلى شخص طبيعي (persona natural)، بما في ذلك أنظمة خاصة ما زالت تتبع جسمًا بأسلوب cédula؛ والستة تشير إلى كيان عام (sector público)؛ والتسعة تشير إلى شركة خاصة (sociedad privada).
الرقمان السابع والثامن محجوزان وليسا رموز نوع صالحة، لذلك ترفضهما هذه الأداة قبل أي مجموع مرجّح. للأشخاص الطبيعيين تطابق الأرقام العشرة الأولى بطاقة الهوية الوطنية (cédula) ويكون رقم التحقق في الموضع العاشر وفق modulo عشرة بمعاملات اثنين-واحد المتكررة: كل حاصل تسعة فأكثر يُخفَّض بتسعة (مجموع الأرقام)، ويُؤخذ المجموع modulo عشرة، والتحقق هو عشرة ناقص ذلك الباقي، أو صفر عندما يكون الباقي صفرًا أصلًا.
للشركات الخاصة يكون رقم التحقق أيضًا في الموضع العاشر، لكن الأوزان هي أربعة وثلاثة واثنين وسبعة وستة وخمسة وأربعة وثلاثة واثنين على الأرقام التسعة الأولى، ويُحوَّل باقي مجموع modulo أحد عشر إلى صفر إذا كان الباقي صفرًا، وإلا أحد عشر ناقص الباقي؛ والقيمة المحوَّلة عشرة تعني أنه لا يوجد رقم تحقق عشري واحد ولا يمكن أن يكون الرقم صالحًا. للكيانات العامة يكون رقم التحقق في الموضع التاسع، والأوزان ثلاثة واثنان وسبعة وستة وخمسة وأربعة وثلاثة واثنان على الأرقام الثمانية الأولى، ويُطبَّق نفس تحويل modulo أحد عشر.
بعد رقم التحقق، تحمل RUC الطبيعية والخاصة رمز منشأة من ثلاثة أرقام بين واحد وتسعمائة وتسعة وتسعين (المصفوفة عادة صفر-صفر-واحد)؛ وتحمل الكيانات العامة كتلة فرع من أربعة أرقام بين واحد وتسعة آلاف وتسعمائة وتسعة وتسعين.
حالات الاستخدام
تدقيق أعمدة RUC في صادرات الفوترة الإلكترونية
تحقّقوا دفعةً من كل RUC في CSV مبيعات أو استقطاع، واعزلوا الصفوف التي لم يعد رقم تحققها يطابق القيمة المعاد حسابها أو التي يكون رقمها الثالث رمزًا محجوزًا.
الأسئلة الشائعة
ما رقم تحقق RUC الإكوادوري؟
هو رقم التحقق داخل RUC من ثلاثة عشر رقمًا، يُحسب من الجسم الأمامي بأوزان تعتمد على الرقم الثالث: modulo عشرة للأشخاص الطبيعيين (المواضع 0–5) وmodulo أحد عشر للكيانات العامة (6) والشركات الخاصة (9).
ماذا يعني الرقم الثالث؟
0–5 تعني شخصًا طبيعيًا (تحقق modulo 10 في الموضع 10)، و6 كيانًا عامًا (modulo 11 في الموضع 9)، و9 شركة خاصة (modulo 11 في الموضع 10).
ماذا يحدث مع الحروف والشرطات والطول الخاطئ أو رموز المقاطعات السيئة؟
مهام التحقق الفاشلة لا تُفوتر. أزيلوا التنسيق في العميل قبل الاستدعاء.
هل يثبت رقم RUC الصحيح أن المكلّف مسجّل فعلًا؟
لا. تتحقق الأداة حسابيًا من البنية ورقم التحقق فقط، ولا تستعلم من سجل مصلحة الضرائب SRI، فلا تستطيع أن تخبرك إن كان الرقم صادرًا أو ما زال فعّالًا.
هل رقم RUC للشخص الطبيعي هو نفسه رقم الهوية؟
تقريبًا. أول عشر خانات من RUC للشخص الطبيعي تطابق رقم الهوية الوطنية مع رقم تحققه، ثم تأتي ثلاث خانات لرمز المنشأة مثل 001، ولذلك يستخدمان قاعدة القسمة على 10 نفسها.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/enc/ruc-ecuador \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"ruc":"1710034065001"}'const res = await fetch("https://api.kit.forhosting.com/enc/ruc-ecuador", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"ruc": "1710034065001"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/ruc-ecuador",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"ruc": "1710034065001"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/ruc-ecuador", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"ruc":"1710034065001"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"ruc":"1710034065001"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/ruc-ecuador", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"ruc": "1710034065001"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.ruc_ecuador",
"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 واضح. شغّلوها مجانًا في المتصفح أو استدعوا KIT API؛ يشترك المساران في الحساب الحسابي نفسه دون ذهاب وإياب شبكي ودون استعلام سجلّ SRI.
كيف تعمل أنواع RUC وأرقام التحقق في الإكوادور
ولأن كل خطوة حساب معياري بأوزان ثابتة، تنتج الأرقام الثلاثة عشر نفسها دائمًا نفس حكم الصلاحية في المتصفح أو Worker أو بيئة اختبار دون اتصال — ولهذا تُنشر القدرة كمحرك parse من المستوى A لا كاستدعاء نموذج أو استعلام SRI مباشر.
كيف تتحقّقون من RUC عبر هذه API
أرسلوا حقل ruc يحتوي فقط على الأحرف من صفر إلى تسعة ويبلغ طوله ثلاثة عشر رقمًا بالضبط. تفشل السلاسل الفارغة وruc المفقود والأطوال غير ثلاثة عشر ورموز المقاطعات خارج صفر-واحد إلى أربعة وعشرين وثلاثين والأرقام الثالثة سبعة أو ثمانية قبل أي مجموع مرجّح ولا تُفوتر. فضّلوا هذه القدرة عندما تحتاجون تقرير النوع الخاص بالإكوادور والتوجيه الرسمي المزدوج modulo عشرة / modulo أحد عشر؛ فمدقّق تنسيق معرّف ضريبي عام متعدد الدول لن يطبّق فروع الرقم الثالث لـ SRI ولا قواعد المنشأة. تُرفض المسافات والنقاط والشرطات والحروف والنقاط العشرية كمدخل غير رقمي مع invalid_input حتى لا يقبل نموذج قيمة منظَّفة بصمت — أزيلوا أي قناع تنسيق في العميل قبل الاستدعاء. عند النجاح يعيد المحرك ruc كسلسلة أرقام مطبَّعة، وvalid كقيمة منطقية، وtype كواحد من natural_person أو public_entity أو private_company، وtype_label وصفًا قصيرًا، وthird_digit وprovince_code وalgorithm كـ modulo_10 أو modulo_11، وcheck_position (تسعة أو عشرة)، وcheck_digit كما أُرسل، وexpected_check_digit عند إمكانية حساب رقم عشري، وestablishment ككتلة الفرع الختامية، وlength ثلاثة عشر، وalgorithm_id ruc_ecuador. تكون valid صحيحة فقط عندما يطابق رقم التحقق وتكون كتلة المنشأة ضمن النطاق غير الصفري المسموح لذلك النوع؛ وما زال رقم التحقق الخاطئ يعيد حمولة منظمة مع valid false حتى تعرضوا «المتوقع X، المستلم Y» دون طلب ثانٍ. ولأن المسار parse خالص بلا ساعة ولا مصدر عشوائي ولا شبكة، ينتج المدخل نفسه دائمًا JSON نفسه في أداة المتصفح المجانية وعلى API. بسعر $0.002 لكل طلب ناجح يمكنكم حماية استيراد CRM بالجملة وبوابات الفوترة الإلكترونية وتدقيق ملفات الشركاء دون التفاوض على شريحة مخصَّصة.
أين تناسب عملية التحقق من RUC مسارات المنتج الحقيقية
تطلب مسارات الانضمام في التقنيات المالية والأسواق الإلكترونية الإكوادورية RUC مبكرًا؛ والتحقق من أرقام التحقق والنوع عند فقدان التركيز يقلّل الإرسال الفاشل وتذاكر الدعم دون استدعاء SRI عند كل ضغطة مفتاح. يجب على أنظمة المحاسبة والفوترة الإلكترونية التي تُصدر comprobantes electrónicos عزل الصفوف التي لم يعد رقم تحققها مطابقًا أو التي تكون كتلة منشأتها أصفارًا كلها قبل أن يصل المستند إلى التفويض. لا تعاملوا رقم تحقق ناجحًا كدليل على أن المكلّف موجود في أنظمة SRI أو أن RUC نشط أو أن المنشأة مخوَّلة بإصدار فواتير — فهو يثبت فقط أن السلسلة ذات الثلاثة عشر رقمًا سليمة حسابيًا وفق القواعد الرسمية المعتمدة على النوع، وهو نفس معيار الصدق الذي تطبّقونه على أي أداة مجموع تحقق ضريبي. يمكن لاستيراد الرواتب والموارد البشرية للمتعاقدين المستقلين أن يقيّد التخزين على valid true ويعرض type_label حتى يرى المشغّل ما إذا كان الرقم شخصًا طبيعيًا أو شركة خاصة أو كيانًا عامًا. تعيد مهام جودة البيانات حساب expected_check_digit لكل عمود RUC في تصدير ERP وتُعلّم عدم التطابق قبل أن يصل إلى التقارير الضريبية أو ملفات الاستقطاع. تخزّن فرق ضمان الجودة التي تحتاج تجهيزات حتمية أرقام RUC معروفة من ثلاثة عشر رقمًا لكل فئة نوع وتؤكّد شكل JSON الذهبي بما في ذلك algorithm وcheck_position حتى يفشل أي تغيير مستقبلي في المعاملات بصوت عالٍ. في كل مسار العقد واحد: أرقام فقط، ثلاثة عشر بالضبط، JSON منظم يمكن اختباره ذهبيًا، سلوك متطابق مجانًا في المتصفح أو برصيد KIT مدفوع مسبقًا، وفشل صادق عندما لا يكون المدخل سلسلة RUC سليمة التكوين.
حالات التكامل
تقييد التسجيل ونماذج KYC على RUC صالح
عندما يكتب عميل RUC من ثلاثة عشر رقمًا، تحقّقوا عند فقدان التركيز، واعرضوا type_label وexpected_check_digit إذا كانت valid خاطئة، وامنعوا المتابعة حتى يجتاز رقم التحقق وكتلة المنشأة.
تصنيف نوع المكلّف قبل توجيه المسارات
استخدموا حقل type المُعاد (natural_person وprivate_company وpublic_entity) لاختيار قوالب المستندات أو معدلات الاستقطاع أو مسارات الموافقة دون استدعاء سجلّ منفصل.
أسئلة تقنية
كيف نتحقّق من RUC بهذه API؟
أرسلوا POST مع ruc مضبوطًا على ثلاثة عشر رقمًا بالضبط (0-9 فقط). يتضمن الرد valid وtype وtype_label وcheck_digit وexpected_check_digit عند التوفر وprovince_code وestablishment وalgorithm.
هل أداة رقم تحقق RUC الإكوادور مجانية؟
أداة المتصفح مجانية وتعمل محليًا. تستدعي مكالمات API رصيد KIT المدفوع مسبقًا بالسعر الأساسي المنشور $0.002؛ والمدخل غير الصالح لا يُحاسب أبدًا.