> ## Documentation Index
> Fetch the complete documentation index at: https://help.kwentra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kwentra وLogicsWare - ماسح جوازات السفر

> امسح هويات النزلاء وجوازاتهم بماسح LogicsWare. تُملأ بيانات ملف النزيل في Kwentra تلقائياً.

امسح هويات النزلاء وجوازاتهم بماسح LogicsWare. تُملأ بيانات ملف النزيل في Kwentra تلقائياً.

**LogicsWare** شركة تقدّم حلولاً وخدمات إلكترونية للأعمال. مع ماسح الجوازات الخاص بها، لا يكتب الموظفون حقول الملف يدوياً.

### **حالات الاستخدام**

* موظف الاستقبال يمسح مستندات النزيل عند تسجيل الوصول لينتهي أسرع.
* مدير المكاتب الأمامية يحافظ على اكتمال ملفات النزلاء ببيانات من مستندات رسمية.
* الفندق يتحقق من هوية النزيل كما يطلب القانون، بالهوية الوطنية أو الجواز أو الإقامة.
* يقضي الاستقبال وقتاً أقل مع كل نزيل، وينتظر النزلاء أقل.

### **كيف يعمل**

| **Where:** Front Office → Settings Gear Sign → Integrations → Passport Scanners |
| - |

#### **ربط LogicsWare**

1. أضف **API URL endpoint** من واجهة LogicsWare.
2. فعّل الاتصال.

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-logicsware-passport-scanner/9ad721030b.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=277ffa519d882dea283e111056050629" alt="إعدادات اتصال LogicsWare في Passport Scanners" width="1866" height="889" data-path="images/compliance-integrations/kwentra-logicsware-passport-scanner/9ad721030b.png" />

#### **كيف يعمل المسح**

* **الوجه والظهر:** امسح وجه المستند أو ظهره أو كليهما، حسب القواعد المحلية.
* **ضغطة واحدة:** في ملف النزيل، اضغط **Capture ID** لبدء المسح.
  * يقرأ الماسح المستند ويرسل البيانات.
* **حفظ تلقائي:** تُملأ حقول الملف وحدها. لا تضغط **Save**.
  * تُحفظ البيانات فوراً وتتحدث الشاشة.

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-logicsware-passport-scanner/8e68978baa.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=955fdd238a5c0141417f2cccf80d2508" alt="زر Capture ID في ملف النزيل" width="1779" height="731" data-path="images/compliance-integrations/kwentra-logicsware-passport-scanner/8e68978baa.png" />

#### **البيانات الملتقطة والحقول**

| API Parameter | حقل Kwentra | القاعدة |
| - | - | - |
| `firstName` | Guest Profile → First Name | يُنسخ كما هو |
| `lastName` | Guest Profile → Last Name | يُنسخ كما هو |
| `City` | Guest Profile → Address → City | يُنسخ كما هو |
| `nationalNumber` | Guest Profile → ID Number | يُملأ دائماً، مع أي نوع مستند |
| `docNumber` | Guest Profile → Passport ID | يُملأ دائماً، مع أي نوع مستند |
| `versionNumber` | Guest Profile → Identity Version No. | يُنسخ كما هو |

#### **نوع المستند**

يحدد النظام نوع الهوية من قيمة LogicsWare:

| قيمة API | نوع الهوية في Kwentra |
| - | - |
| Face National ID Card | Identity Card |
| Back National ID Card | Identity Card |
| Passport | Passport |
| Visa | Passport |
| Driver License | Driver License |
| Residency ID | Residency ID (Iqama) |
| Visitor ID | Visitor ID |
| Family ID | Family ID |
| GCC ID | GCC ID |
| أي قيمة أخرى / فارغ | Other |

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-logicsware-passport-scanner/fb7734afec.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=5a5d1a66cc3ad5c83407bde3edd78a88" alt="نوع الهوية في ملف النزيل بعد المسح" width="1484" height="696" data-path="images/compliance-integrations/kwentra-logicsware-passport-scanner/fb7734afec.png" />

#### **ملاحظات**

* **الحفظ التلقائي:** كل مسح يُحفظ في ملف النزيل. لا تضغط **Save**.
* **العنوان:** إذا أرسل الماسح عنواناً، فإنه يحل محل العنوان الذي نوع اتصاله **Main**.
* إذا لم يوجد نوع اتصال **Main**، يُضاف العنوان بأول نوع اتصال في النظام.
* **رقم الهوية ورقم الجواز:** يذهب `nationalNumber` دائماً إلى **ID Number**. يذهب `docNumber` دائماً إلى **Passport ID**.
* **نوع مستند غير معروف أو فارغ:** إذا كان `documentName` فارغاً أو غير معروف، يصبح نوع المستند **Other**.

#### **أمثلة**

* **مسح هوية وطنية:** يحفظ النظام فوراً الاسم الأول والأخير والمدينة ورقم الهوية والعنوان. يصبح نوع الهوية Identity Card.
* **مسح جواز سفر:** يُحفظ تلقائياً الاسم الأول والأخير ورقم الجواز والعنوان ونوع الهوية (Passport).
* **مسح نوع مستند غير معروف:** تُحفظ كل الحقول. يصبح نوع الهوية **Other**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.