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

التغطية

  • التغطية: ~ 100%
  • الدولة: البرازيل
  • معرّف الخدمة: bra_cpf
  • نطاق البيانات: الهوية
  • الفئة: السجل الضريبي

المدخلات

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

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

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

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

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

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

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

تعتمد الحقول الدقيقة التي تظهر في source_data على ما يُرجعه السجل. يوثّق المثال المُولَّد لـbra_cpf حاليًا هذا الشكل الموحّد:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • lgpd_minor
  • minor_under_16
  • minor_under_18
  • registration_date

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

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

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

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