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

رقم تحقق RUC الإكوادور

إنّ RUC الإكوادوري (Registro Único de Contribuyentes) هو المعرّف الضريبي المكوّن من ثلاثة عشر رقمًا والذي يصدره Servicio de Rentas Internas للأشخاص الطبيعيين والشركات الخاصة والكيانات العامة.

● Betaمجاني · داخل متصفحك

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

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

يرمّز الرقمان الأولان المقاطعة، ويختار الرقم الثالث فئة المكلّف، ويقع رقم تحقق مرجّح في الموضع التاسع أو العاشر بحسب تلك الفئة، والكتلة الختامية هي رمز المنشأة أو الفرع. تتحقّق هذه القدرة من RUC نقي من ثلاثة عشر رقمًا بالتوجيه حسب الرقم الثالث: القيم من صفر إلى خمسة تستخدم قاعدة modulo عشرة للشخص الطبيعي المشتركة مع cédula، والستة تستخدم أوزان modulo أحد عشر للكيان العام، والتسعة تستخدم أوزان الشركة الخاصة. يبيّن الردّ ما إذا كان رقم التحقق المخزَّن يطابق القيمة المعاد حسابها، والنوع المكتشف، ورمز المقاطعة، وكتلة المنشأة، ورقم التحقق المتوقع عند وجوده. تُرفض الأحرف غير الرقمية والأطوال الخاطئة ورموز المقاطعات غير الصالحة والأرقام الثالثة المحجوزة بخطأ invalid_input واضح. شغّلوها مجانًا في المتصفح أو استدعوا KIT API؛ يشترك المساران في الحساب الحسابي نفسه دون ذهاب وإياب شبكي ودون استعلام سجلّ SRI.

طريقة الاستخدام

أدخل القيم في النموذج أعلاه. تتحقق الأداة منها قبل الحساب ثم تعرض النتيجة في الصفحة نفسها.

راجع بياناتك

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

أعد الحساب أو نفّذه آليًا

استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.

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

احصل على النتيجة الآن

أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.

قارن السيناريوهات

غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.

أتمت العمل المتكرر

استخدم الواجهة البرمجية عندما تحتاج إلى تشغيل الحساب نفسه داخل منتجك أو سير عملك.

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

ما رقم تحقق RUC الإكوادوري؟

هو رقم التحقق داخل RUC من ثلاثة عشر رقمًا، يُحسب من الجسم الأمامي بأوزان تعتمد على الرقم الثالث: modulo عشرة للأشخاص الطبيعيين (المواضع 0–5) وmodulo أحد عشر للكيانات العامة (6) والشركات الخاصة (9).

كيف نتحقّق من RUC بهذه API؟

أرسلوا POST مع ruc مضبوطًا على ثلاثة عشر رقمًا بالضبط (0-9 فقط). يتضمن الرد valid وtype وtype_label وcheck_digit وexpected_check_digit عند التوفر وprovince_code وestablishment وalgorithm.

ماذا يعني الرقم الثالث؟

0–5 تعني شخصًا طبيعيًا (تحقق modulo 10 في الموضع 10)، و6 كيانًا عامًا (modulo 11 في الموضع 9)، و9 شركة خاصة (modulo 11 في الموضع 10). الرقمان 7 و8 محجوزان ويُرفضان كـ invalid_input.

ماذا يحدث مع الحروف والشرطات والطول الخاطئ أو رموز المقاطعات السيئة؟

المدخل غير الرقمي والأطوال غير ثلاثة عشر ورموز المقاطعات خارج 01–24 و30 والأرقام الثالثة المحجوزة تُرفض بـ invalid_input. مهام التحقق الفاشلة لا تُفوتر. أزيلوا التنسيق في العميل قبل الاستدعاء.

هل أداة رقم تحقق RUC الإكوادور مجانية؟

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

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

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

الـEndpoint

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

صادِق على طلبك بترويسة 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 فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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