الانتقال إلى المحتوى الرئيسي
POST
يتحقق من البيانات في قاعدة CPF/CNPJ. تتيح لك Didit هذه الخدمة عبر POST /v3/database-validation/ للتحقق من البيانات المُرسَلة مقابل المصدر الموثوق، واستلام نتائج مطابقة موحَّدة. صيغة الإدخال: يقبل tax_number رقم CPF البرازيلي (11 رقمًا بالضبط).

التغطية

  • التغطية: ~ 100%
  • الدولة: البرازيل
  • معرّف الخدمة: bra_tax_registration
  • نطاق البيانات: مالي
  • الفئة: TaxRegistry

المدخلات

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

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

string
افتراضي:"BRA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: BRA
string
افتراضي:"bra_tax_registration"
مطلوب
مصفوفة تحتوي على معرّف الخدمة هذا. تثبيت الخدمة يُبقي الطلب مقتصرًا على قاعدة البيانات هذه بالتحديد.مثال: bra_tax_registration
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"11111111111"
مطلوب
الرقم الضريبي أو رقم التعريف المالي.مثال: 11111111111
string
افتراضي:"user-1234"
مرجعك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، مما يقلل الضوضاء في اكتشاف التكرار.مثال: user-1234

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

  • رقم CPF البرازيلي (11 رقمًا بالضبط)
  • يجب أن يحتوي tax_number على أرقام فقط؛ أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يبلغ طول tax_number 11 حرفًا بالضبط.

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

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

تعتمد الحقول الدقيقة الظاهرة في source_data على ما يعيده السجل. يوثّق المثال المُولَّد للخدمة bra_tax_registration حاليًا البنية الموحّدة التالية:
  • date_of_birth
  • identification_number
  • name_match_score

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

تُحتسب استعلامات التسجيل الضريبي في البرازيل (CPF/CNPJ) فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $0.15 USD
  • الفوترة: لكل استعلام ناجح. لا تُحتسب أي رسوم عندما يكون السجل غير قابل للوصول، أو عند غياب الحقول المطلوبة، أو عند رفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: المعتاد عند المئين 95 (p95) أقل من ثانيتين.
  • التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصدر اللاحق بحسب الدولة ومجموعة البيانات.

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

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