> ## 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 على عدد محدود من المفاهيم الأساسية. بعضها يحمل معنى أدق مما يوحي به اسمه، وبعضها يظهر باسم في الواجهة وباسم آخر في API. هذه الصفحة مرجع للحالتين.

## الطلب والشحنة ليسا الشيء نفسه

هذا هو الفرق الذي يقوم عليه كل شيء آخر، وهو أكثر ما يسبب الالتباس.

| المصطلح | معناه |
| - | - |
| **الطلب** | ما اشتراه العميل. يصل من [قناة البيع](https://docs.tryoto.com/ar/modules/sales-channels/overview.md) أو عبر API، ويكون موجودًا سواء شُحن منه شيء أم لا. |
| **الشحنة** | الحجز لدى شركة الشحن لنقل البضاعة. تُنشأ *من* الطلب، وتحمل رقم التتبع وبوليصة الشحن (AWB). |
| **الصندوق** | طرد فعلي واحد. قد تضم الشحنة عدة صناديق، لكل منها الباركود والوزن الخاصان به. |

> [!TIP]
>
> **الطلب الواحد لا يعني بالضرورة طردًا واحدًا**
>
> يمكن تقسيم الطلب على أكثر من موقع، وشحنه مع أكثر من شركة شحن، وتغليفه في عدة صناديق، وإرجاعه على دفعات. كل واحد من هذه شحنة أو صندوق منفصل مرتبط بالطلب نفسه.
>
> لذلك يجب أن يحدد السؤال عن الحالة ما يقصده. فسؤال «هل تم التوصيل؟» غامض لطلب مقسّم على ثلاثة صناديق، لكنه واضح عندما يتعلق بشحنة واحدة.

## الشيء نفسه باسمين مختلفين

بعض العناصر تُسمّى باسم في الواجهة وباسم آخر في API أو في المواد القديمة. هذه أهمها:

| في لوحة التحكم | في API والقواعد | معناه |
| - | - | - |
| **المستودع** / **الفرع** | **نقطة استلام الطلب** (pickup location): `createPickupLocation` مع قيمة `type` إما `warehouse` أو `branch` | مكان تحتفظ فيه بالمخزون ويمكنك الشحن منه. يسمّي التوثيق كليهما **مركزًا** (hub). راجع [إدارة المراكز](https://docs.tryoto.com/ar/modules/hubs-management/overview.md). |
| **شريك الشحن** / **شركة الشحن** | **Delivery company** واختصارها **DC**: `dcList` و`dcActivation` و`deliveryCompany` | الشركة التي تنقل الطرد. |
| **الخدمة** | **خيار التوصيل** (delivery option): `deliveryOptionName` | خدمة محددة تقدمها شركة شحن، مثل *Aramex Same Day*. قواعد الشحن تختار هذه الخدمة، لا شركة الشحن نفسها. |
| **إشعارات العملاء** | إعدادات الرسائل النصية والبريد الإلكتروني وواتساب | رسائل موجّهة إلى *عملائك*، وتختلف عن [الإشعارات](https://docs.tryoto.com/ar/platform/collaboration-and-notifications.md) الموجّهة إلى *فريقك*. |

## المخزون رقمان لا رقم واحد

يعرض المخزون رقمين: **المتاح** و**الموجود فعليًا**، ويتغير كل منهما في وقت مختلف.

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

> [!NOTE]
>
> **الفرق بين الرقمين هو المخزون المحجوز**
>
> بين تعيين الطلب وإرساله تكون القطعة محجوزة لكنها لم تتحرك بعد، فينخفض المتاح ولا ينخفض الموجود فعليًا. أي أن الطلب الواحد يُنتج حركتين منفصلتين في المخزون، قد يفصل بينهما أيام.
>
> لهذا قد يتطابق الجرد مع الموجود فعليًا ويبدو مع ذلك غير صحيح مقارنةً بالمتاح، ولهذا أيضًا فالسؤال الصحيح ليس «كم لدينا؟» بل «كم يمكننا أن نبيع بعد؟». راجع [تتبع المخزون](https://docs.tryoto.com/ar/modules/inventory-management/inventory-tracking.md).

## المواقع

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

## داخل المستودع

| | |
| - | - |
| **الحاوية (Bin)** | موضع محدد على الرف، له نوع وسعة، وأحيانًا SKU مفضّل. |
| **النطاق (Zone)** | مجموعة من الحاويات، عادةً ممر أو جزء من المستودع، يعمل فيه مجهّز طلبات واحد. |
| **موجة التجهيز** | دفعة من الطلبات تُطلق للتجهيز معًا، ليخدم مسار واحد داخل المستودع عدة طلبات. |
| **التخزين (Putaway)** | نقل البضاعة المستلمة إلى حاوياتها. |
| **وحدة الإرسال** | عربة أو قفص أو منصة نقالة تجمع الطرود المغلّفة لتسليمها إلى شركة شحن واحدة. |

تُدار جميع هذه العناصر في [إدارة المستودعات](https://docs.tryoto.com/ar/modules/warehouse-management/overview.md)، وتُهيّأ لكل مركز على حدة.

## أسطولك الخاص

| | |
| - | - |
| **السائق** | فرد من أسطولك يعمل عبر تطبيق [OTO FLEX](https://docs.tryoto.com/ar/modules/oto-flex/overview.md)، وهو نوع مستخدم مستقل. |
| **المسار** | مجموعة مرتّبة من المحطات مخصصة لسائق واحد. |
| **المهمة** | محطة واحدة في المسار: استلام طلب أو توصيل. |
| **اثبات الاستلام / اثبات التسليم** | ما يجب على السائق توثيقه لإغلاق المهمة: صورة أو رمز أو باركود، أو مزيج منها. |

## المعرّفات

| المعرّف | ما الذي يعرّفه |
| - | - |
| **SKU** | المنتج. وهو حلقة الوصل بين OTO وكل نظام آخر تستخدمه. |
| **رمز المركز** | المكان. وهو حلقة الوصل لكل ما يرتبط بموقع: مواقع ERP ومتاجر POS ومواقع قنوات البيع. |
| **AWB** | بوليصة الشحن: المستند الذي تصدره شركة الشحن ويُلصق على الطرد، ويحمل مرجع التتبع. |
| **رقم التتبع** | المرجع الذي تعطيه شركة الشحن للطرد، وهو يختلف عن رقم طلبك. |

### أرقام الطلبات

لكل طلب **معرّفان**، ويؤدي كل منهما وظيفة مختلفة.

| المعرّف | معناه |
| - | - |
| **رقم طلب أوتو** (`otoId`) | المرجع الداخلي الخاص بـ OTO. فريد على مستوى المنصة ولا يُعاد استخدامه أبدًا. |
| **رقم الطلب** (`incrementId`) | الرقم الذي يستخدمه الناس: فريقك وعميلك وقناة البيع. وهو الرقم الظاهر على البوليصة وفي رسالة التتبع. |

#### من أين يأتي رقم الطلب؟

| طريقة وصول الطلب | رقمه |
| - | - |
| **مزامنة من قناة البيع** | **لا يتغير.** طلب Shopify يحتفظ برقمه في Shopify، وطلب Salla برقمه في Salla. لا تعيد OTO ترقيمه. |
| **إنشاء عبر API** | يُستخدم رقمك إن أرسلته، وإن تركته فارغًا تُنشئ OTO رقمًا. |
| **إنشاء يدوي في OTO** | يُنشأ تلقائيًا بالصيغة `OID-…`. إذا تركت حقل **رقم الطلب** فارغًا في شاشة **إضافة طلب** يُنشأ الرقم تلقائيًا، ويمكنك كتابة رقمك بدلًا من ذلك. |

> [!TIP]
>
> **الأهم أن طلبات القنوات تحتفظ بأرقامها**
>
> عندما يراسلك عميل بشأن الطلب `#1043`، فهذا هو الرقم الموجود في تأكيد الطلب الذي وصله من متجرك. ولأن OTO لم تغيّر الرقم، فهو نفسه الرقم الذي يبحث عنه موظفك، والرقم المطبوع على البوليصة، والرقم المذكور في رسالة التتبع.
>
> أما في نظام يعطي الطلبات أرقامًا خاصة به، فكل محادثة مع عميل تحتاج إلى مطابقة الأرقام، وكل مطابقة مع قناة البيع تحتاج إلى جدول ربط. ولا تظهر البادئة `OID-` إلا حين لا يوجد رقم من القناة يمكن الاحتفاظ به.

#### البادئات واللواحق

لا تحصل السجلات المرتبطة على أرقام مستقلة، بل تُبنى *من* رقم الطلب أيًا كان.

| | |
| - | - |
| `…-R1` | مرتجع لهذا الطلب، و`-R2` لطلب إرجاع ثانٍ على الطلب نفسه. |
| `TR-…` · `IDT-…` | تحويل بين مواقعك. تشير `IDT-` إلى تحويل بين المستودعات مبني على طلب قائم، لذلك يظهر الرقم الأصلي داخله. |

> [!NOTE]
>
> **اللاحقة تحمل معلومة مفيدة**
>
> لأن المرتجع يُرقَّم من طلبه، فإنه يرتبط بعملية البيع الأصلية دون الحاجة إلى البحث عن أي شيء. والطلب الذي يحمل `-R2` أُعيد مرتين، وهذا نمط يستحق الانتباه سواء تعلق بعميل أو بمنتج. راجع [إدارة المرتجعات](https://docs.tryoto.com/ar/modules/return-management/overview.md).
>
> وإذا كانت بادئة في OTO لا تناسب نظامًا آخر لديك، يمكنك عند تسجيل خدمات الويب هوك تحديد **orderPrefix** لحذف البادئة قبل إرسال البيانات. راجع [أحداث الويب هوك](https://docs.tryoto.com/ar/developers/webhook-events.md).

## المدفوعات والرسوم

| | |
| - | - |
| **الدفع عند الاستلام** | تحصّل شركة الشحن المبلغ من العميل عند التسليم ثم تحوّله إليك. وهو في هذه المنطقة وسيلة دفع معتادة لا حالة استثنائية. |
| **الحد الأعلى للدفع عند الاستلام** | أعلى قيمة طلب تقبل شركة شحن معيّنة تحصيلها نقدًا. |
| **الوزن المحتسب** | الوزن الذي تحاسب عليه شركة الشحن فعليًا: الأكبر بين الوزن الفعلي والوزن الحجمي. ويُعرف في تركيا باسم **Desi**. |
| **الرسوم الإضافية** | رسوم تضيفها شركة الشحن لاحقًا، غالبًا عندما يتبيّن أن الطرد أثقل أو أكبر مما صُرّح به. راجع [مطابقة الفواتير](https://docs.tryoto.com/ar/modules/shipping-management/shipping-invoices-reconciliation.md). |

> [!WARNING]
>
> **الوزن الحجمي هو مصدر المفاجآت في فواتير الشحن**
>
> الطرد الكبير الخفيف يُحاسَب على المساحة التي يشغلها لا على وزنه. فإذا صرّحت بوزن وسادة الفعلي، فستحاسبك شركة الشحن على أضعافه.
>
> ويصلك الفرق بعد أسابيع على شكل رسوم إضافية في الفاتورة، بعد تسعير الطلب بوقت طويل. ولهذا وُجدت مطابقة الفواتير، ولهذا أيضًا من المهم إدخال الأبعاد بدقة عند التغليف لا عند الفوترة.

## القواعد والأتمتة

| | |
| - | - |
| **الشرط** | اختبار يُطبَّق على الطلب: قيمته ووزنه ووجهته وعلامته التجارية ووسومه وغير ذلك. |
| **القاعدة** | شروط مع الإجراء المطلوب عند تحققها. وتُقيَّم القواعد بالترتيب. |
| **قابلية التنفيذ** | هل شركة الشحن *مؤهلة* أصلًا لهذا الطلب. يُتحقق منها قبل الاختيار، لذلك قد تنطبق القاعدة على الطلب دون أن تتوفر أي شركة شحن. |
| **أتمتة الطلبات** | قواعد تعمل على الطلبات: التوجيه والتعليق والتقسيم. راجع [توجيه الطلبات](https://docs.tryoto.com/ar/modules/omnichannel-oms/order-routing.md). |
| **أتمتة الشحن** | قواعد تختار شركة الشحن. راجع [أتمتة الشحن](https://docs.tryoto.com/ar/modules/shipping-management/shipping-automation.md). |

## الهوية والصلاحيات

| | |
| - | - |
| **العلامة التجارية** | هوية تجارية داخل الحساب الواحد، لها شعارها واسم المرسِل وقوالب الرسائل الخاصة بها. ويمكن للنشاط التجاري الواحد إدارة أكثر من علامة. |
| **نوع المستخدم** | نوع حساب الشخص: مشرف الشركة، أو مستخدم المستودع، أو مستخدم الفرع، أو السائق، أو مستخدم خدمة العملاء، أو مدير العلامة التجارية. |
| **نموذج الدور** | مجموعة صلاحيات مسمّاة تُطبَّق على المستخدمين. راجع [المستخدمون والأدوار والصلاحيات](https://docs.tryoto.com/ar/platform/users-roles-and-permissions.md). |

## إلى أين بعد ذلك؟

> **[ما هي OTO؟](https://docs.tryoto.com/ar/get-started/what-is-oto.md)**
>
> المنصة في صفحة واحدة.

> **[OMS متعدد القنوات](https://docs.tryoto.com/ar/modules/omnichannel-oms/overview.md)**
>
> حيث تُدار الطلبات.

> **[المطورون](https://docs.tryoto.com/ar/developers/overview.md)**
>
> العناصر نفسها عبر API.


## Related topics

- [منصة لإدارة عمليات التجارة الإلكترونية وبوابة شحن](https://docs.tryoto.com/ar/index.md)
- [ما هي OTO؟](https://docs.tryoto.com/ar/get-started/what-is-oto.md)
- [بنية المنصة](https://docs.tryoto.com/ar/get-started/architecture.md)


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