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

التغطية

  • التغطية: ~ 100%
  • الدولة: البرازيل
  • معرّف الخدمة: bra_company_directors
  • نطاق البيانات: الجهات الحكومية
  • الفئة: CompanyRegister

المدخلات

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

معاملات جسم الطلب

string
افتراضي:"BRA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: BRA
string
افتراضي:"bra_company_directors"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات هذه بالتحديد.مثال: bra_company_directors
string
افتراضي:"11222333000181"
مطلوب
القيمة company_registration_number التي تتطلبها خدمة قاعدة البيانات هذه.مثال: 11222333000181
string
افتراضي:"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}.

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

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

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

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

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

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

آخر تعديل في ٧ نوفمبر ٢٠٢٦