> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# فحص سجل الشركات البرازيلي (CNPJ) - واجهة API

> استعلام سجل الشركات البرازيلي (CNPJ) عبر Didit من قاعدة بيانات موثوقة. الدفع لكل استعلام يبدأ من $0.20، بلا عقود ولا حد أدنى.

يبحث هذا عن شركة برازيلية باستخدام CNPJ في سجل Receita Federal: الاسم القانوني والتجاري، وحالة التسجيل، وتاريخ التأسيس، والطبيعة القانونية، والنشاط الرئيسي، وولاية المقر الرئيسي. يوفّر Didit هذه الخدمة عبر `POST /v3/database-validation/` حتى تتمكن من التحقق من البيانات المقدمة مقابل المصدر الرسمي، واستلام نتائج مطابقة موحّدة.

## التغطية

* **التغطية:** \~ 100%
* **الدولة:** البرازيل
* **معرّف الخدمة:** `bra_company_registry`
* **نطاق البيانات:** حكومي
* **الفئة:** CompanyRegister

## المدخلات

| الحقل | مطلوب | مثال |
| - | -: | - |
| `company_registration_number` | نعم | `11222333000181` |
| `vendor_data` | لا | `user-1234` |

* **المدخلات المطلوبة:** `company_registration_number`
* **المدخلات الاختيارية:** `vendor_data`
* **الموافقة:** غير مطلوبة
* **التوفر في سير العمل:** متاح في سير العمل مع ربط الحقول
* **التغطية:** \~ 100%
* **السعر:** \$0.20 لكل استعلام ناجح

في سير العمل، لا يُطبع `company_registration_number` على أي وثيقة هوية، لذلك لا تنتجه أي خطوة من تلقاء نفسها. اجمعه من إجابة في الاستبيان، أو من حقل مستخرج عبر Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه في خطوة التحقق من قواعد البيانات. إلى أن يتم ربطه، يعرض محرر سير العمل هذه الخدمة معطّلة ويذكر المدخل الناقص. وعند التشغيل، يعني المدخل الناقص أن الفحص يُتخطى قبل أي استعلام، فلا تُحتسب عليك تكلفة لقاعدة بيانات لم يكن بالإمكان الاستعلام منها.

## معاملات الجسم

**issuing\_state** `string` *required* (default: BRA)

رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.

مثال: `BRA`

**services** `string` *required* (default: bra\_company\_registry)

مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصرًا على قاعدة البيانات المحددة هذه.

مثال: `bra_company_registry`

**company\_registration\_number** `string` *required* (default: 11222333000181)

القيمة `company_registration_number` المطلوبة من خدمة قاعدة البيانات هذه.

مثال: `11222333000181`

**vendor\_data** `string` (default: user-1234)

مرجع المستخدم الثابت الخاص بهذا الشخص لديك، مثل معرّف المستخدم الداخلي. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل التشويش في اكتشاف التكرارات.

مثال: `user-1234`

## قواعد المدخلات وملاحظات التحقق

* يجب أن تطابق `company_registration_number` النمط `[0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}`.

## كيفية الاستدعاء

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=BRA" \
  -F "services=bra_company_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=11222333000181"
```

تُرجع كل استدعاء ناجح الاستجابة HTTP `200`. يخبرك الحقل **`outcome_code`** بما حدث فعليًا، فيميّز مثلًا بين عدم تطابق بيومتري حقيقي (`BIOMETRIC_NO_MATCH`) وصورة سيلفي تعذّرت قراءتها (`BIOMETRIC_IMAGE_UNUSABLE`). الحالة `status` المعروضة هي حالة الميزة الافتراضية، ويمكن لإجراءاتك المهيأة في [إجراءات التطابق الجزئي / عدم التطابق](https://docs.didit.me/ar/core-technology/database-validation/database-validation-warnings.md) أن تتجاوزها.

**`MATCH`** — أكّد السجل الهوية، وتطابق كل حقل تم فحصه.

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "company_name": "EMPRESA EXEMPLO LTDA",
        "company_status": "ATIVA",
        "company_status_date": "2025-01-10",
        "headquarters_state": "SP",
        "legal_nature": "SOCIEDADE EMPRESARIA LIMITADA",
        "main_activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
        "main_activity_code": "6201501",
        "registration_date": "2010-03-15",
        "registration_number": "11222333000181",
        "trade_name": "EXEMPLO"
      },
      "validation": {}
    }
  ]
}
```

**`DOCUMENT_NOT_FOUND`** — رقم المستند المُقدَّم لا يقابل أي سجل في سجل الشركات.

```json 200 OK — DOCUMENT_NOT_FOUND theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "BRA",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "DOCUMENT_NOT_FOUND",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {}
    }
  ]
}
```

## البيانات المُرجعة

تعتمد الحقول الدقيقة الظاهرة في `source_data` على ما يُرجعه السجل. يوثّق المثال المُولَّد لـ `bra_company_registry` حاليًا البنية الموحّدة التالية:

* `company_name`
* `company_status`
* `company_status_date`
* `headquarters_state`
* `identification_number`
* `legal_nature`
* `main_activity`
* `main_activity_code`
* `registration_date`
* `registration_number`
* `trade_name`

## الأسعار واتفاقيات مستوى الخدمة

تُحتسب استعلامات البرازيل - البحث في سجل الشركات (CNPJ) فقط عندما يتلقى Didit نتيجة حاسمة من مصدر التحقق.

* **السعر لكل استدعاء:** \$0.20 دولار أمريكي.
* **الفوترة:** لكل استعلام ناجح. لا تُحتسب عليك تكلفة عندما يتعذّر الوصول إلى السجل، أو عند غياب الحقول المطلوبة، أو عند رفض الطلب قبل وصوله إلى المصدر.
* **زمن الاستجابة:** عادةً ما يكون زمن الاستجابة عند النسبة المئوية 95 (p95) أقل من ثانيتين.
* **التوفر:** 99.9% لكل ربع سنة من جانب Didit؛ ويختلف توفر المصدر التابع حسب الدولة ومجموعة البيانات.

## متابعة القراءة

* [نظرة عامة على التحقق من قواعد البيانات في البرازيل](https://docs.didit.me/api-reference/database-validation/brazil.md)
* [نظرة عامة على التحقق من قواعد البيانات](https://docs.didit.me/ar/core-technology/database-validation/overview.md)
* [رموز النتائج](https://docs.didit.me/ar/core-technology/database-validation/database-validation-outcome-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.