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

# مزامنة الطلبات: كيف تصل الطلبات إلى OTO

> الطرق الأربع لوصول الطلبات إلى OTO، من المزامنة التلقائية مع قنوات البيع إلى الإدخال اليدوي والرفع الجماعي، وكيفية إعادة مزامنة طلب واحد.

> [!NOTE]
>
> **مكانه في المنصة:** Main ← عمليات الربط ← قنوات البيع — [افتح في OTO ↖](https://app.tryoto.com/sales-channels)

تدخل الطلبات إلى OTO عبر مزامنة الطلبات. معظمها يصل تلقائيًا من قناة بيع مربوطة، والباقي تُنشئه يدويًا أو ترفعه بشكل جماعي. ومن هنا تبدأ كل الخطوات التالية من توجيه وتجهيز وشحن، لذلك فهذا أيضًا هو المكان الذي تسبب فيه البيانات الخاطئة أكبر ضرر.

## أربع طرق لوصول الطلب

| الطريقة | متى تستخدمها؟ |
| - | - |
| **قناة بيع مربوطة** | الحالة المعتادة، إذ تصل الطلبات تلقائيًا من متجرك أو من السوق الإلكتروني. |
| **الإدخال اليدوي** | طلب هاتفي، أو عميل حضر إلى المتجر، أو استبدال لمرة واحدة. |
| **الرفع الجماعي** | نقل الطلبات السابقة، أو قناة لا يتوفر لها ربط مع OTO بعد. |
| **API** | متجر إلكتروني مخصّص أو نظام ERP يتولى إنشاء الطلبات. راجع [REST API](https://docs.tryoto.com/ar/developers/rest-api-reference.md). |

## الميزات

تضم هذه الوظيفة 7 ميزات.

### مزامنة الطلبات من قنوات البيع

يمكنك ربط القناة بنفسك دون الحاجة إلى الدعم الفني. تفتح **Main ← عمليات الربط ← قنوات البيع** كتالوجًا قابلًا للبحث يضم كل المنصات المربوطة مع OTO؛ اختر منصتك واضغط **Explore Channel** لبدء الربط.

![كتالوج All Channels في صفحة قنوات البيع](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/ordersync-1-all-channels.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=43e84f1b06936eba738b93a33a683c47)

الشكل 1 — يضم الكتالوج منصات المتاجر العالمية ومنصات إنشاء المتاجر الإقليمية والأسواق الإلكترونية جنبًا إلى جنب: من Shopify وSalla وWooCommerce وZid وAdobe Commerce وOpenCart وBigCommerce وSylius وIkas، إلى Makane وShahbandr و3S Cart وMatjrah وT-Soft وKMK، إضافة إلى Noon وJumia وJahez وFooder.

بعد الربط تظهر القناة ضمن **Connected Channels** باسم المتجر، وشارة **Active** أو **Inactive**، ومفتاح لتشغيلها أو إيقافها دون فصل الربط. وتُدار كل إعدادات الربط من قائمة **⋯** الخاصة بكل قناة.

![تبويب Connected Channels مع قائمة إجراءات القناة](https://mintcdn.com/oto/YkJay8Y-1RDv8ciw/images/ordersync-2-connected-channels.png?fit=max\&auto=format\&n=YkJay8Y-1RDv8ciw\&q=85\&s=dde45a46c5f20af8d771118ff256c343)

الشكل 2 — لكل قناة: Edit Credentials وMatch Pickup Locations وInventory Sync Settings وSync Orders وSynchronize Products وStatus Mapping وRemove. ويوقف مفتاح Active/Inactive القناة مؤقتًا دون فقدان إعداداتها.

| الإجراء | الغرض منه |
| - | - |
| **Edit Credentials** | إعادة التحقق من الهوية عند انتهاء صلاحية الرمز أو تغيير كلمة المرور. |
| **Match Pickup Locations** | ربط مواقع القناة بالمستودعات والفروع في OTO، ليعرف التوجيه من أين يجب أن يُشحن طلب القناة. |
| **Inventory Sync Settings** | التحكم في طريقة إرسال كميات المخزون إلى القناة. راجع [مزامنة المخزون](https://docs.tryoto.com/ar/modules/inventory-management/inventory-sync.md). |
| **Sync Orders** | سحب الطلبات من القناة عند الطلب، للقناة كاملة. |
| **Synchronize Products** | إعادة استيراد الكتالوج لتتطابق رموز SKU وأسماء المنتجات. |
| **Status Mapping** | تحديد الحالة التي تُبلَّغ بها القناة مع تقدم الطلب في OTO. |

> [!NOTE]
>
> **نوعان مختلفان من المزامنة**
>
> يسحب **Sync Orders** هنا طلبات القناة كاملة. أما **Synchronize Order** المشروح لاحقًا في هذه الصفحة فيعيد مزامنة طلب واحد محدد. وهما إجراءان مختلفان في مكانين مختلفين.

### مزامنة طلبات الأسواق الإلكترونية

تعمل الأسواق الإلكترونية بطريقة مختلفة عن متجرك الخاص: فهي التي تملك العلاقة مع العميل، وتفرض مواعيدها الخاصة (SLA)، وتتوقع أن تصلها حالات الطلبات وفق شروطها. وتتعامل OTO معها كبقية القنوات في الكتالوج نفسه، لا كنوع منفصل من الربط: فـ **Noon** و**Jumia** و**Jahez** موجودة إلى جانب منصات المتاجر، كما يتوفر الربط مع Amazon وTrendyol.

وتعمل Jahez بطريقة مختلفة: تُسحب الطلبات إلى OTO، وتُجهَّز فيها، ثم تُسلَّم لمندوبي Jahez لتوصيلها. أي أن OTO تتولى التجهيز بينما يتولى السوق الإلكتروني التوصيل النهائي.

### ربط الحالات المخصّص

لكل منصة أسماء مختلفة لحالات الطلب، ولا تتطابق أي منها مع حالات OTO. **Status Mapping** هو جدول الترجمة بينهما، ويُضبط لكل قناة مربوطة على حدة.

يجيب كل صف عن أربعة أسئلة: أي **OTO Status** يُطلق التحديث، وأي **Update Type** يُرسَل، وأي **Ecom Status** تُضبط عليها القناة، وما **Ecom Comment** الذي يُكتب معها. يضيف **Add New Row** صفًا جديدًا، وتحذف أيقونة سلة المهملات الصف.

![نافذة Status Mapping لقناة مربوطة](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/ordersync-3-status-mapping.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=1c2313a320798e124e7aa2566ec3e593)

الشكل 3 — جدول ربط حقيقي: تضبط Shipment Processing حالة القناة على executed، وCollected على shipped، وOut for Delivery على delivery، وحالتا الإرجاع على restoring وrestored. والتعليقات قوالب جاهزة، إذ تُستبدَل :deliveryCompany ورقم التتبع لحظة الإرسال.

> [!TIP]
>
> **التعليق هو الجزء الأكثر فائدة**
>
> يقبل حقل Ecom Comment المتغيرات، لذلك يمكن أن تتضمن الرسالة التي يراها العميل في المتجر اسم شركة الشحن ورقم التتبع: *«Shipped with :deliveryCompany»*. وكثيرًا ما يكون هذا أهم من الحالة نفسها، لأن خيارات الحالات في المتاجر محدودة.

### تحديثات الحالة المشروطة

**Update Type** هو ما يجعل الربط مشروطًا بدلًا من أن يكون نسخة مطابقة. فالحالة نفسها في OTO يمكن أن ترسل نوعًا مختلفًا من التحديثات، مثل تعليق على الطلب أو سجل شحنة، أما الحالة التي لا تربطها فلا تُرسَل إلى القناة أبدًا.

وهذا مهم، لأن إرسال كل خطوة داخلية إلى المتجر يجعل سجل الطلب صعب القراءة، وقد يدفع المنصة إلى إرسال رسائل بريد مكررة إلى العميل. اربط فقط الخطوات التي يستفيد العميل من رؤيتها، واترك الخطوات التشغيلية داخل OTO.

وانتبه إلى أن الحالة الواحدة في OTO قد تظهر في أكثر من صف بأنواع تحديث مختلفة؛ ففي المثال أعلاه ترسل `Shipment Processing` تعليقًا وسجل Order Shipment معًا.

### إعادة المحاولة تلقائيًا عند فشل التحديث

قد تفشل واجهات API للقنوات أحيانًا بسبب حدود الطلبات أو انتهاء المهلة أو انقطاع مؤقت. وإذا لم يصل تحديث إلى قناة البيع، تعيد OTO المحاولة بدلًا من تجاهله، حتى لا يبقى الطلب ظاهرًا بحالة خاطئة في المتجر بسبب عطل عابر.

تظهر حالات الفشل وإعادة المحاولة في **الإعدادات ← Logs ‏← Integration Logs**، وهو أول مكان تبحث فيه عندما تختلف حالات القناة عن حالات OTO.

### إدخال الطلبات يدويًا

من **Main ‏← Shipping ← الشحنات** اضغط **Add Order**. يتكون النموذج من خطوتين.

**الخطوة 1: Receiver Details (بيانات المستلم).** الاسم الأول ورقم الجوال والدولة حقول إلزامية، أما اسم العائلة والبريد الإلكتروني فاختياريان. ويمكن إدخال العنوان بثلاث طرق: كتابة **Short Address Code** (العنوان المختصر بصيغة العنوان الوطني السعودي، أربعة أحرف وأربعة أرقام مثل `RRRD2929`)، أو تعبئة **Full Address Line** وحقوله التفصيلية يدويًا، أو استخدام **Fill from Map** لتحديد الموقع على الخريطة.

![الخطوة 1 من Add Order: Receiver Details](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/ordersync-4-add-order-receiver.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=6c91241a252899a02551f182ea2ea5ee)

الشكل 4 — تحمل الحقول الإلزامية علامة نجمة حمراء. لاحظ قسم العنوان: Short Address Code وFull Address Line وBuilding No وStreet Name وSecondary Address Number وCity وDistrict وZIP Code، وهي بنية العنوان الوطني السعودي بدلًا من حقل نصي واحد.

**الخطوة 2: Order Details and Products (بيانات الطلب والمنتجات).** اترك **Order Number** فارغًا لتُنشئ OTO رقمًا تلقائيًا. حقلا **Order Date** و**Order Value** إلزاميان، وتنبّه ملاحظة حقل Order Value إلى أن هذه القيمة تحدد مبلغ التعويض إذا احتجت إلى تقديم مطالبة، لذلك من الأفضل ألا تكون تقريبية. يحدد **المستودع** أو **الفرع** مكان الشحن، وتساعد حقول **العلامات التجارية** و**Invoice Number** و**Ref No** على مطابقة الطلب مع أنظمتك. ثم يضم قسم المنتجات حقل **Package Size** وحقل **Item Description** الإلزامي.

![الخطوة 2 من Add Order: Order Details](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/ordersync-5-add-order-details.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=36f3fa853edecd83c138f52912998260)

الشكل 5 — تحدد Order Value القيمة المصرّح بها التي يُحتسب على أساسها التعويض. ويظهر موقعك الافتراضي في حقل المستودع. يعيدك Previous إلى خطوة المستلم، ويُنشئ Add الطلب الذي يدخل بعدها مرحلة التوجيه مثل أي طلب آخر.

> [!TIP]
>
> **استخدم العنوان المختصر**
>
> إذا كان العميل يعرفه، فكتابة العنوان المختصر أسرع وأدق بكثير من كتابة عنوان الشارع، فهو يُترجم إلى إحداثيات دقيقة، وهي ما يحتاجه [توجيه الطلبات](https://docs.tryoto.com/ar/modules/omnichannel-oms/order-routing.md) لاختيار أقرب موقع. راجع [تصحيح العناوين والبيانات](https://docs.tryoto.com/ar/modules/omnichannel-oms/order-data-correction.md).

### استيراد الطلبات بشكل جماعي

يفتح **Upload Multiple Orders** في صفحة الشحنات نافذة **Upload Orders**. حمّل القالب واملأه ثم ارفعه. يُفحص الملف قبل إنشاء أي طلب، وتُعرض الصفوف التي تحتوي على مشكلات لتصحيحها بينما تُعالَج الصفوف السليمة. وهذا مهم عند نقل كميات كبيرة من البيانات، إذ لا يُفشل صفٌّ واحد خاطئ الملف بأكمله.

![نافذة Upload Orders](https://mintcdn.com/oto/YkJay8Y-1RDv8ciw/images/ordersync-6-upload-orders.png?fit=max\&auto=format\&n=YkJay8Y-1RDv8ciw\&q=85\&s=d4f5e037a694126f1e9597a8546539d2)

الشكل 6 — اضغط Download Template، ثم اسحب الملف وأفلته أو اختره عبر Browse. ملف واحد في كل مرة بصيغة XLSX أو XLS وبحجم أقصاه 100 ميغابايت. وحقل Description الاختياري ملاحظة لفريقك، وهو مفيد عندما يرفع عدة أشخاص ملفات.

| المتطلب | التفاصيل |
| - | - |
| **الصيغة** | XLSX أو XLS، ملف واحد في كل مرة |
| **حجم الملف** | حتى 100 ميغابايت |
| **الأعمدة الإلزامية** | Customer Name ‏· Phone Number (مع رمز الدولة) · Address ‏· City ‏· Country ‏· Order Number ‏· Order Date ‏· Payment Method (`Paid` أو `Cash on Delivery`) · Grand Total ‏· Currency |
| **الأعمدة الاختيارية** | Zip code · وصف المنتجات · رموز SKU · التعليقات · صور المنتجات · الوزن · المستودع |
| **أرقام الطلبات** | يجب أن تكون فريدة، وتُرفض الأرقام المكررة. |
| **القالب** | لا تغيّر أسماء الأعمدة أو تنسيقها، لأن الفحص يعتمد عليها. |

## إعادة مزامنة طلب واحد

عندما يفوت تحديث من القناة أو يصل متأخرًا، قد تتأخر حالة الطلب عن المنصة. لتحديثه، افتح **الشحنات ← Pending Orders**، واختر الطلب، وافتح قائمة **Orders** ثم اضغط **Synchronize Order**.

![قائمة Orders في صفحة الشحنات](https://mintcdn.com/oto/YkJay8Y-1RDv8ciw/images/ordersync-7-orders-menu.png?fit=max\&auto=format\&n=YkJay8Y-1RDv8ciw\&q=85\&s=ee5c0c54d29238831ed321fc642198e2)

الشكل 7 — يظهر Synchronize Order بين إجراءات الطلب. وبعض الإجراءات الأخرى مشروحة في وظائف أخرى: Update Sender Location وSplit Order في توجيه الطلبات، وPut on hold في فحوصات ما قبل التجهيز، وInter Depot Transfer في تجهيز الطلبات.

> [!NOTE]
>
> **نطاق هذا الإجراء**
>
> يسحب هذا الإجراء الحالة الحالية من المنصة ويطبّقها. ولا يغيّر بقية بيانات الطلب، ولا يُرسل إشعارات للعميل، ويعمل فقط على الطلبات الموجودة في **Pending Orders**، وعلى طلب واحد في كل مرة. ولتحديث القناة كاملة استخدم **Sync Orders** من قائمة تلك القناة.

## الحدود والمتطلبات المسبقة

| المتطلب | التفاصيل |
| - | - |
| **قناة مربوطة** | تحتاج المزامنة التلقائية إلى أن تكون القناة مربوطة وبحالة **Active**. أما الإدخال اليدوي والرفع الجماعي فيعملان دون قناة. |
| **ربط نقاط استلام الطلب** | إلى أن يُضبط **Match Pickup Locations** لا يكون لطلبات القناة مكان يُشحن منه. |
| **مستودع أو فرع** | يجب أن يوجد موقع واحد على الأقل قبل إسناد أي طلب. |
| **صيغة رقم الجوال** | رمز الدولة إلزامي في الإدخال اليدوي والرفع الجماعي. |
| **حجم الرفع** | 100 ميغابايت لكل ملف، وملف واحد في كل مرة. |
| **إعادة المزامنة يدويًا** | طلب واحد في كل مرة، وفقط ما دام الطلب معلّقًا. |

## صفحات ذات صلة

* [قنوات البيع](https://docs.tryoto.com/ar/modules/sales-channels/overview.md): النظام الذي يشرح الربط والتحديثات وcheckout API بالتفصيل.
* [تصحيح العناوين والبيانات](https://docs.tryoto.com/ar/modules/omnichannel-oms/order-data-correction.md): ينظّف البيانات الواردة من المزامنة قبل أن يستخدمها التوجيه.
* [توجيه الطلبات](https://docs.tryoto.com/ar/modules/omnichannel-oms/order-routing.md): الخطوة التالية لكل طلب يصل إلى هنا.
* [مزامنة المخزون](https://docs.tryoto.com/ar/modules/inventory-management/inventory-sync.md): النصف الآخر من ربط القناة، إذ يرسل المخزون إليها.
* [REST API](https://docs.tryoto.com/ar/developers/rest-api-reference.md): الطريقة الرابعة لإدخال الطلبات، للمتاجر المخصّصة وأنظمة ERP.


## Related topics

- [قنوات البيع](https://docs.tryoto.com/ar/modules/sales-channels/overview.md)
- [تصحيح العناوين والبيانات](https://docs.tryoto.com/ar/modules/omnichannel-oms/order-data-correction.md)
- [توجيه الطلبات بين المستودعات والمتاجر](https://docs.tryoto.com/ar/modules/omnichannel-oms/order-routing.md)


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