> ## 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.

# التحقق من الشركاء والمديرين في البرازيل (QSA) API

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

يعيد هذا الاستعلام الشركاء والمديرين الحاليين (QSA) لشركة برازيلية من سجل الهيئة الفيدرالية للإيرادات (Receita Federal)، مع الدور الذي يشغله كل منهم وتاريخ بدايته. تُخفى أرقام CPF للأفراد كما تنشرها الهيئة. تُتيح Didit هذه الخدمة عبر `POST /v3/database-validation/` لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الرسمي، والحصول على نتائج مطابقة موحّدة.

## التغطية

* **التغطية:** \~ 100%
* **الدولة:** البرازيل
* **معرّف الخدمة:** `bra_company_directors`
* **نطاق البيانات:** الجهات الحكومية
* **الفئة:** 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\_directors)

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

مثال: `bra_company_directors`

**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_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=11222333000181"
```

يعيد كل استدعاء ناجح الرمز HTTP ‏`200`. يوضح الحقل **`outcome_code`** ما حدث فعلاً، فيميّز مثلاً بين عدم تطابق بيومتري حقيقي (`BIOMETRIC_NO_MATCH`) وصورة سيلفي تعذّرت قراءتها (`BIOMETRIC_IMAGE_UNUSABLE`). الحالة `status` المعروضة هي الحالة الافتراضية للميزة، ويمكن لـ[إجراءات Partial Match / No Match](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_directors",
      "service_name": "Brazil - Company Partners and Directors (QSA)",
      "source_data": {
        "directors": [
          {
            "document_number": "***.456.789-**",
            "entity_type": "person",
            "name": "MARIA EXEMPLO DA SILVA",
            "role": "SOCIO-ADMINISTRADOR",
            "start_date": "2010-03-15"
          },
          {
            "document_number": "11444777000161",
            "entity_type": "company",
            "name": "HOLDING EXEMPLO S A",
            "role": "SOCIO",
            "start_date": "2018-06-01"
          }
        ],
        "registration_number": "11222333000181"
      },
      "validation": {}
    }
  ]
}
```

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

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

* `directors`
* `registration_number`

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

تُحتسب استعلامات الشركاء والمديرين (QSA) في البرازيل فقط عندما تستلم Didit نتيجة حاسمة من مصدر التحقق.

* **سعر كل استعلام:** \$0.20 بالدولار الأمريكي.
* **الفوترة:** لكل استعلام ناجح. لا تُحتسب عليك أي تكلفة عندما يتعذر الوصول إلى السجل، أو عندما تكون الحقول المطلوبة ناقصة، أو عندما يُرفض الطلب قبل أن يصل إلى المصدر.
* **زمن الاستجابة:** عادةً ما يكون 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.