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

التغطية

  • التغطية: ~ 100%
  • الدولة: البرازيل
  • معرّف الخدمة: bra_company_registry
  • نطاق البيانات: حكومي
  • الفئة: 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_registry"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصرًا على قاعدة البيانات المحددة هذه.مثال: bra_company_registry
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_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؛ ويختلف توفر المصدر التابع حسب الدولة ومجموعة البيانات.

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

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