الانتقال إلى المحتوى الرئيسي
POST
يتحقق من بيانات الإدخال مقابل SUNAT. تعرض Didit هذه الخدمة عبر POST /v3/database-validation/ حتى تتحقق من البيانات المُرسلة مقابل المصدر الرسمي وتحصل على نتائج تطابق موحّدة. صيغة الإدخال: يقبل personal_number رقم DNI البيروفي (8 أرقام بالضبط).

التغطية

  • التغطية: > 90%
  • الدولة: بيرو
  • معرّف الخدمة: per_tax_registration
  • نطاق البيانات: المالية
  • الفئة: السجل الضريبي

المدخلات

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

معلمات الجسم

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

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

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

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

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

تعتمد الحقول الدقيقة المعروضة في source_data على ما يُرجعه السجل. يوثّق المثال المُولَّد لـ per_tax_registration حاليًا هذا الشكل الموحّد:
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score

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

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

للاستمرار في القراءة

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