> ## 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.

هناك ثلاث طرق للبدء مع OTO، ويعتمد اختيارك بينها على دورك وعلى ما تريد تحقيقه. وتنتهي الطرق الثلاث بطلب حقيقي في طريقه إلى العميل.

## من أين تبدأ؟

| إذا كنت… | ابدأ من |
| - | - |
| تبيع عبر متجر إلكتروني وتريد شحن طلباتك | مسار التجار: نحو ساعة واحدة |
| تدير عدة مواقع أو علامات تجارية أو شركات شحن | مسار المواقع المتعددة: يضيف المراكز والقواعد |
| تربط نظامًا آخر مع OTO | مسار المطورين: خمسة طلبات API |

## مسار التجار

أقصر طريق من ربط متجرك إلى أول طرد عليه بوليصة شحن.

| # | الخطوة | المكان |
| - | - | - |
| 1 | **اربط متجرك.** ابحث عن منصتك في الكتالوج واضغط **Explore Channel**. في Shopify وSalla يُثبَّت تطبيق OTO من متجر التطبيقات الخاص بكل منهما، وتكفي معظم المنصات الأخرى رابط المتجر ورمز API. | **عمليات الربط ← قنوات البيع** |
| 2 | **أنشئ المكان الذي ستشحن منه.** يكفي مستودع واحد للبدء. حدّد العنوان على الخريطة بدلًا من كتابته، ليحصل التوجيه على إحداثيات دقيقة. | **الإعدادات ← الإدارة ← المستودعات** |
| 3 | **اضبط الحقلين اللذين تُبنى عليهما وعود التوصيل.** **Serving Radius** (نطاق الخدمة) و**اتفاقية مستوى الخدمة للتحضير** لهذا المركز. القيمة الافتراضية 24 ساعة، فغيّرها إلى المدة الفعلية لديك. | الشاشة نفسها، الخطوة 2 من المعالج |
| 4 | **اربط شركة شحن.** افتح شركة الشحن واربط *الخدمة* التي تحتاجها تحديدًا؛ فلكل شركة شحن عدة خدمات، والقواعد تختار الخدمة لا الشركة. | **عمليات الربط ← Shipping Partners** |
| 5 | **اربط مزود خدمة المراسلة.** اربط حساب الرسائل النصية الخاص بك لتصل رسائل التتبع باسم المرسِل المسجّل لديك. | **الإعدادات ← Customer Notifs ‏← SMS** |
| 6 | **اشحن طلبًا واحدًا.** اختر طلبًا حقيقيًا، وأنشئ الشحنة، واطبع البوليصة. ثم تابعه حتى التسليم، واطّلع على صفحة تتبع الشحنة التي يراها عميلك. | **الشحنات** |

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

## مسار المواقع المتعددة

كل ما سبق، بالإضافة إلى أربعة قرارات لا تصبح مهمة إلا عندما يكون لديك أكثر من واحد من الشيء نفسه.

| القرار | لماذا الآن؟ |
| - | - |
| **رموز المراكز** | اتفق عليها مع المسؤول عن نظام ERP أو POS لديك *قبل* إنشاء المراكز. فهي حلقة الوصل بين الأنظمة، وتحديدها سهل بينما تغييرها لاحقًا مكلف. راجع [أنظمة ERP](https://docs.tryoto.com/ar/integrations/erp-systems.md). |
| **أي مركز يشحن ماذا وإلى أين؟** | نطاق الخدمة واتفاقية مستوى الخدمة للتحضير لكل مركز، ثم قواعد [توجيه الطلبات](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). |

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

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

## مسار المطورين

خمسة طلبات بالترتيب. تجد كل نقاط النهاية في [فهرس نقاط النهاية](https://docs.tryoto.com/ar/developers/rest-api-reference.md)، وهذه هي الخطوات الأساسية.

| # | الطلب | النتيجة |
| - | - | - |
| 1 | `POST /rest/v2/refreshToken` | رمز وصول (access token) صالح لمدة ساعة. احفظه مؤقتًا، ولا تطلب رمزًا جديدًا مع كل طلب. |
| 2 | `GET /rest/v2/healthCheck` | تأكيد أن الرمز وعنوان الخادم صحيحان قبل البحث عن أي مشكلة أخرى. |
| 3 | `POST /rest/v2/createOrder` | يُنشأ الطلب في OTO ويخضع لقواعد التوجيه. يمكنك إرسال رقم طلبك أو ترك OTO تُنشئه. |
| 4 | `POST /rest/v2/createShipment` | تُحجز الشحنة لدى شركة الشحن وتصدر البوليصة (AWB). |
| 5 | `POST /rest/v2/webhook` | يُسجَّل مرة واحدة لا مع كل طلب، وبعدها يصلك كل شيء تلقائيًا. |

احصل على `refresh_token` من **الإعدادات ← API Integrations ← ربط**، وابنِ تكاملك على `https://staging-api.tryoto.com` قبل الانتقال إلى الإنتاج. راجع [التوثيق Authentication](https://docs.tryoto.com/ar/developers/authentication.md).

> [!TIP]
>
> **أضف الخطوة 5 من اليوم الأول، لا عندما يصبح الاستعلام المتكرر مشكلة**
>
> الاستعلام المتكرر عن `orderStatus` يعمل فورًا ولا يحتاج إلى نقطة نهاية من جهتك، ولهذا بالضبط تُبنى التكاملات بهذه الطريقة وتبقى عليها.
>
> إعداد الويب هوك عمل صباح واحد. أما إضافته لاحقًا إلى نظام اعتمد على الاستعلام المتكرر لمدة عام فليس كذلك.

## قبل الإطلاق

| | |
| - | - |
| **راجع اتفاقيات مستوى الخدمة للتحضير** | لكل مركز، واضبطها وفق المدة الفعلية لا القيمة الافتراضية البالغة 24 ساعة. |
| **راجع ساعات العمل** | بما في ذلك ما إذا كانت للفروع ساعات عمل محددة، فوعد التوصيل يُحسب على أساسها. |
| **أرسل لنفسك كل الرسائل** | رسائل التتبع والتوصيل والإرجاع، بكل لغة تدعمها، على جهاز جوال حقيقي. |
| **حدّد حد تنبيه الرصيد** | بقيمة كافية تمنحك وقتًا لملاحظة انخفاض الرصيد والدفع. فعند نفاد الرصيد يتوقف إنشاء الشحنات. |
| **فعّل التحقق متعدد العوامل (MFA)** | للجميع، وابدأ بالمشرفين. راجع [الأمان والامتثال](https://docs.tryoto.com/ar/platform/security-and-compliance.md). |
| **اشترك في تنبيهات الأعطال الصامتة** | **Shipment Creation Attempt Failed** و**SLA Breach**. لن يخبرك عنها أي شيء آخر. راجع [الإشعارات](https://docs.tryoto.com/ar/platform/collaboration-and-notifications.md). |

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

> **[المفاهيم الأساسية](https://docs.tryoto.com/ar/get-started/core-concepts.md)**
>
> المصطلحات التي يستخدمها بقية التوثيق.

> **[OMS متعدد القنوات](https://docs.tryoto.com/ar/modules/omnichannel-oms/overview.md)**
>
> النظام الذي يُنصح بقراءته أولًا.

> **[المطورون](https://docs.tryoto.com/ar/developers/overview.md)**
>
> واجهة API كاملة.


## Related topics

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


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