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

أرقام تحقق CNPJ البرازيل

أدخل الأساس 112223330001 لتحصل على رقمي التحقق 81، فيكون رقم CNPJ الكامل 11222333000181؛ أو الصق 14 رقمًا لتتأكد من الرقمين الأخيرين. مفيد للفواتير وتسجيل الموردين وتنقية البيانات. مجاني في متصفحك.

  • مجاني
  • يعمل في متصفحك
  • دون تسجيل
  • بياناتك لا تغادر جهازك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا
إذا أدخلت
العدد
112223330001
تحصل على
وضع الحساب
Compute
المُدخَل
112223330001
أرقام التحقق
81
رقم التحقق 1
8

ينتهي رقم CNPJ البرازيلي (Cadastro Nacional da Pessoa Jurídica) برقمي تحقق يثبتان أن معرّف الشركة المكوّن من أربعة عشر رقمًا أُدخل أو خُزّن دون تبديل مواضع أو خطأ في رقم واحد. تنفّذ هذه القدرة قاعدة mod-11 الرسمية لـReceita Federal المستخدمة على كل CNPJ: اثنا عشر رقمًا أساسيًا يحدّدان التسجيل الجذري والفرع، ثم يُشتق رقمان ختاميان بتسلسلات أوزان ثابتة وقاعدة باقٍ تحت أحد عشر. استخدم وضع compute عندما تملك القاعدة ذات الاثني عشر رقمًا فقط وتحتاج رقمي التحقق لنموذج أو فاتورة أو استيراد بيانات رئيسية؛ واستخدم وضع validate عندما يرسل شريك أو نظام ERP أو مستخدم CNPJ كاملًا من أربعة عشر رقمًا وتحتاج علم valid واضحًا مع الزوج المتوقع لرسائل الخطأ.

كيف تُحسب أرقام تحقق CNPJ البرازيلي

يتكوّن CNPJ دائمًا من أربعة عشر رقمًا عند كتابته بلا ترقيم. تشكّل الثمانية الأولى رقم التسجيل الجذري الممنوح للشخص الاعتباري؛ وتحدّد الأربعة التالية الفرع (0001 هو فرع المقر المعتاد)؛ والرقمان الأخيران أرقام تحقق ولا يُختاران بحرية أبدًا. لحساب رقم التحقق الأول، اضرب الأرقام الأساسية الاثني عشر بتسلسل الأوزان 5، 4، 3، 2، 9، 8، 7، 6، 5، 4، 3، 2 من اليسار إلى اليمين، واجمع النواتج، وخذ المجموع modulo أحد عشر، ثم اسقط الباقي: إذا كان الباقي أقل من اثنين فالرقم صفر، وإلا فهو أحد عشر ناقص الباقي.

لحساب رقم التحقق الثاني، أَلحق الرقم الأول بالقاعدة ذات الاثني عشر رقمًا وكرّر نفس إسقاط mod-11 بالأوزان الثلاثة عشر 6، 5، 4، 3، 2، 9، 8، 7، 6، 5، 4، 3، 2. يجب أن تحمل السلسلة الكاملة ذات الأربعة عشر رقمًا هذين الرقمين الختاميين تمامًا. الخوارزمية حتمية ومحلية: بلا استدعاء شبكة إلى Receita Federal، وبلا استعلام كتالوج، وبلا ساعة.

لا تبحث هذه الأداة عمّا إذا كانت الشركة نشطة، ولا توسّع العرض المنسّق XX.XXX.XXX/XXXX-XX إلى حالة تسجيل، ولا تدّعي أن مجموع تحقق صالحًا يعني أن CNPJ مُرخَّص لنظام ضريبي معيّن؛ إنها تثبت فقط أن سلسلة الأرقام صحيحة الشكل وفق قاعدة mod-11 الرسمية. مقارنةً بمدققي المعرّفات الضريبية متعددة الدول، نية البحث هنا ضيّقة: من يحتاج حاسبة أرقام تحقق CNPJ البرازيل لقواعد من اثني عشر رقمًا، لا مدقق CPF أو RFC عام.

أين تناسب أرقام تحقق CNPJ سير العمل الحقيقية

تتلقّى فرق المالية والبيانات الرئيسية قواعد شركات داخلية من اثني عشر رقمًا ويجب أن تُلحق أرقام تحقق CNPJ الرسمية قبل كتابة المعرّف على الفواتير أو ملفات الدفع البنكي أو ملفات بائعي الأسواق التي ترفض المعرّفات الضريبية غير الصالحة. تتحقق بوابات الحسابات الدائنة من CNPJ ذي الأربعة عشر رقمًا عند تسجيل المورّدين حتى لا ينشئ تبديل مواضع واحد مورّدًا وهميًا ولا اختلافًا في الدفع.

تمرّ مهام جودة البيانات على كل عمود CNPJ في تصدير CRM أو ERP، وتستدعي وضع validate، وتعزل الصفوف حيث valid يساوي false — فتلتقط تعديلات بشرية وأخطاء مولّدات. لا تعاملوا اجتياز فحص CNPJ كدليل تسجيل نشط لدى Receita Federal أو نظام ضريبي محدّد؛ إنه يثبت فقط أن رقمي mod-11 متسقان مع القاعدة ذات الاثني عشر رقمًا تحت الأوزان القياسية.

تدقيق أعمدة CNPJ في صادرات ERP وCRM

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

ما أرقام تحقق CNPJ البرازيلي؟

هما آخر رقمين في CNPJ من أربعة عشر رقمًا، يُحسبان بمجموعين موزونين متتاليين mod-11 حتى تُلتقط عادة أخطاء الكتابة والاستيراد قبل تخزين المعرّف أو طباعته على فاتورة.

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

تُرفض القواعد المتطابقة كلها في compute؛ وتعيد CNPJ الكاملة المتطابقة كلها valid false في validate. مهام التحقق الفاشلة لا تُفوتر.

ماذا تعني مجموعات الأرقام في رقم CNPJ؟

الأرقام الثمانية الأولى هي جذر تسجيل الشركة، والأربعة التالية تحدد الفرع، وغالبًا ما يكون 0001 للمقر الرئيسي، والرقمان الأخيران رقما تحقق لا يُختاران بحرية.

هل يعني رقم CNPJ الصحيح أن الشركة نشطة؟

لا. اجتياز الفحص يدل فقط على أن الأرقام متسقة مع قاعدة باقي القسمة على 11. ولا تستعلم الأداة من مصلحة الضرائب البرازيلية، فلا تثبت أن التسجيل نشط.

هل يُقبل رقم CNPJ مكوّن من رقم واحد مكرر؟

لا. يُرفض الأساس المكوّن من رقم واحد مكرر عند الحساب، ويُعدّ رقم CNPJ الكامل من هذا النوع غير صالح عند التحقق.

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

POSThttps://api.kit.forhosting.com/enc/cnpj-brazil

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

curl -X POST https://api.kit.forhosting.com/enc/cnpj-brazil \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"112223330001"}'
{
  "number": "112223330001"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.cnpj_brazil",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

لكل طلب$0.002

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

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

المدخلات غير الرقمية والأطوال الخاطئة وسلاسل الأرقام المتطابقة كلها تفشل بـinvalid_input أو valid false بدل التنظيف الصامت، فلا تخزّن أبدًا معرّفًا ضريبيًا نصف منظَّف. وتُنفَّذ الحوسبة الحسابية نفسها مجانًا في المتصفح وبالسعر المنشور لواجهة API.

عقد الإدخال والأوضاع وسلوك الأخطاء

أرسل حقل number يحتوي فقط على الأحرف من صفر إلى تسعة. الطول الخاطئ خطأ صريح يسمّي الوضع والطول المرسل —اثنا عشر لـcompute وأربعة عشر لـvalidate— حتى تعرض نماذج العميل «يلزم اثنا عشر رقمًا» دون تخمين. السلاسل الفارغة وnumber المفقود وقيم mode غير الصالحة والقواعد ذات الاثني عشر رقمًا المتطابقة كلها في compute تفشل قبل الوثوق بأي مجموع موزون للتخزين ولا تُفوتر. فضّلوا compute عند إنشاء أو إكمال معرّفات الشركات؛ وفضّلوا validate عند تقييد بحث أو استيراد بـCNPJ كامل من مستخدم أو ملف شريك. تُرفض المسافات والنقاط والشرطات المائلة والواصلات والحروف والفاصلات العشرية كمدخل غير رقمي بـinvalid_input حتى لا يصل إلى التخزين قيمة نُظّفت بصمت. وضع compute هو الافتراضي: يطلب المحرك اثني عشر رقمًا تمامًا، ويعيد check_digits كسلسلة من حرفين، وcheck_digit_1 وcheck_digit_2 منفصلين، وwith_check كـCNPJ من أربعة عشر رقمًا يمكنكم طباعته أو حفظه. وضع validate يطلب أربعة عشر رقمًا تمامًا؛ وتُبلغ الاستجابة valid true عندما يطابق الرقمان الختاميان expected_check_digits المعاد حسابهما ولم تكن السلسلة تكرارًا متطابقًا مثل أربعة عشر صفرًا. يتضمّن validate دائمًا payload (الاثني عشر الأولى)، وزوجي التحقق المُعطى والمتوقع، وrepeated_digits، وlength أربعة عشر. تُقبل أسماء بديلة مثل digits وcnpj وcode لنفس حقل الحمولة حتى لا تحتاج التكاملات التي تتحدث أصلًا بـ«cnpj» إلى إعادة تسمية. وبما أن المسار parse خالص بلا ساعة ولا مصدر عشوائي ولا شبكة، ينتج نفس جسم JSON دائمًا نفس نتيجة JSON على أداة المتصفح المجانية وعلى API بسعر $0.002 لكل طلب ناجح.

أين تناسب أرقام تحقق CNPJ سير العمل الحقيقية

يمكن لنماذج تسجيل التجارة الإلكترونية وB2B إعادة حساب expected_check_digits وإظهار تصحيح ودّي عندما تلصق شركة برازيلية رقمًا بزوج أخير مكتوب خطأ. تثبّت اختبارات التكامل with_check لتجهيزات معروفة مثل 11222333000181 حتى لا تنحرف مكتبات الفوترة وهذه API.

إكمال قاعدة CNPJ من 12 رقمًا للفواتير

استدعِ وضع compute بالقاعدة ذات الاثني عشر رقمًا، واحفظ with_check، ومرّر CNPJ ذا الأربعة عشر رقمًا إلى NFe أو التحويل البنكي أو ملف بائع السوق.

التحقق من CNPJ كامل مدخل أو مستورد عند الإدخال

عندما يرسل نموذج أو CSV أربعة عشر رقمًا، استدعِ وضع validate وامنع الحفظ إذا كان valid يساوي false، مع عرض expected_check_digits لتصحيح خطأ طباعة واحد.

كيف أحسب أرقام تحقق CNPJ بهذه API؟

أرسل POST مع number من اثني عشر رقمًا تمامًا وmode compute (أو احذف mode). تتضمّن الاستجابة check_digits وcheck_digit_1 وcheck_digit_2 وwith_check (CNPJ الكامل من أربعة عشر رقمًا).

كيف أتحقق من CNPJ كامل من أربعة عشر رقمًا؟

أرسل POST بالسلسلة ذات الأربعة عشر رقمًا وmode validate. تتضمّن الاستجابة valid وcheck_digits وexpected_check_digits وpayload (الأرقام بلا الزوج الأخير) وrepeated_digits.

هل أداة أرقام تحقق CNPJ البرازيل مجانية؟

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

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