أنواع المستندات التي يعيدها القارئ
documents[].doc_type هو أحد هذه الرموز، أو سلسلة أخرى بأحرف صغيرة، أو null.
يحصل كل مستند أيضًا على الفحوص التي لا تعتمد على نوعه: بوابة
doctype: عندما تفرض الخطوة أو التلميح بوابة (أدناه)، وexpiry: عند قراءة id_expiry، وفحص MRZ عند قراءة أسطر MRZ، وفحوص الملف provenance: وفحص authenticity:specimen:. يشرح دليل التحقق كلًا منها.
يُطلب من القارئ الإجابة بـ other عند الشك، لأن تصنيفًا خاطئًا واثقًا يؤدي إلى رفض مستند العميل. وتقبل الخطوات التي تتوقعها المستندات القانونية الحرة (المجموعة الأخيرة) إلى جانب other. ويُحوَّل النص الحر من القارئ إلى هذه الرموز بحسب جذر الكلمة، فتصل “Driver License” و”PR Card” و”Void Cheque” على أنها drivers_license وpr_card وvoid_cheque.
يُقبل مستندان للعنوان كإثبات عنوان: utility_bill وbank_statement. أما الشيك فلا يكون إثباتًا أبدًا.
مفاتيح الحقول
كل مفتاح يجوز للقارئ إعادته، مجمّعًا. المفتاح غير المدرج هنا يُسقط.id_type هو أحد Passport أو Driver License أو National ID أو Residence Permit (بطاقة الإقامة الدائمة PR والبطاقة الخضراء الأمريكية هما Residence Permit).
يُبلَّغ القارئ بأي جهة في المستند هي العميل. في الفاتورة أو كشف الاستهلاك أو كشف الحساب، العميل هو المستلم (الجهة “المفوترة”)، لا المُصدِر أبدًا. وdocument_holder_name وlegal_name ومفاتيح العنوان والاتصال تصف المستلم.
الحقول بحسب نوع المستند
ما يُطلب من القارئ البحث عنه في كل نوع، وما تحتاجه الفحوص. لا يعيد القارئ إلا ما هو مطبوع ومقروء. لا شيء مما يلي مضمون العودة.
إذا غابت جميع الحقول المتوقعة لنوع ما، يكون
legible: بدرجة critical. وإذا غاب بعضها فقط فهو تحذير يسمّيها (could not read: id_number).
لا تُقرأ المبالغ المالية إلا من مستند يذكرها. تُظهر قسيمة الراتب أجر فترة معينة. ويُطلب من القارئ ألا يقدّر أبدًا، فيغيب
annual_income ما لم يكن مطبوعًا. لا تعتمدوا على قسيمة راتب وحدها لتحديد الدخل السنوي. انظر الدليل التطبيقي.الحقول التي تصل إلى fields
البوابة: step_key وdoc_type
يجعل step_key الاستدعاء يتحقق من أن المستند من النوع الذي تتوقعه الخطوة. فحص doctype: من درجة critical: إذا قال القارئ “فاتورة مرافق” وكانت الخطوة تأخذ هوية بصورة، تقول الإجابة this is a utility bill; this step takes a passport, a national ID card, a driver's licence... ويفشل العنصر.
إذا لم ترسلوا step_key، يُستخدم نص doc_type كبوابة أيضًا عندما يحتوي إحدى هذه العبارات (بأحرف صغيرة، والمسافات مهمة): photo id وpassport وpr card وproof of address وbank وarticles of incorporation وbusiness registration. مثلًا doc_type=passport يقبل جواز سفر أو هوية وطنية أو رخصة قيادة أو تصريح إقامة. وdoc_type=bank_statement يحتوي bank ويقبل كشف حساب أو فاتورة مرافق أو شيكًا ملغى. وdoc_type=payslip لا يطابق شيئًا ولا يُفرض عليه بوابة. استخدموا step_key عندما تريدون بوابة دقيقة.
الخطوة المعروفة التي ليس لها بوابة نوع (banking وrib وخطوات قليلة أخرى) تقبل أي مستند.
مفاتيح الخطوات
الخطوة المصنّفة
address هي خطوة إثبات عنوان. فإذا قُرئ فيها utility_bill أو proof_of_address أو bank_statement كان عليه فحص حداثة مانع (critical، 90 يومًا افتراضيًا). ويكون utility_bill أو proof_of_address من درجة critical في أي خطوة. أما bank_statement في أي خطوة أخرى فهو تحذير.