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

# Checkout API لأسعار الشحن الفورية

> اعرض خيارات شركات الشحن الفعلية وأسعارها ومواعيد التوصيل المتوقعة في صفحة الدفع عبر Checkout API من OTO: ما الذي تطلبه، وما الذي يعود، وكيف تعرضه.

> [!NOTE]
>
> **مكانه في المنصة:** الإعدادات ← Developers ‏← API Documentation — [افتح في OTO ↖](https://app.tryoto.com/api-integrations)

معظم صفحات الدفع تخمّن في ما يخص الشحن: سعر ثابت، أو جدول بالرموز البريدية، أو وعد بـ«3–5 أيام عمل» لم يراجعه أحد مع أي شركة شحن منذ كُتب.

## ما الغاية من هذه الواجهة؟

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

وهي الآلية نفسها التي يستخدمها [اختيار شركة الشحن](https://docs.tryoto.com/ar/modules/shipping-management/carrier-integration.md) داخليًا، والفرق الوحيد هو من يطرح السؤال.

## طلب الخيارات

`POST /rest/v2/checkOTODeliveryFee`

| الحقل | إلزامي | ما هو؟ |
| - | - | - |
| `originCity` | نعم | مدينة الاستلام، أي المركز الذي سيُشحن منه الطلب. |
| `destinationCity` | نعم | مدينة العميل. |
| `weight` | نعم | الوزن التقريبي للطرد بالكيلوغرام. |
| `originCountry` · `destinationCountry` | لا | رموز ISO 3166-2 للشحنات الدولية. |
| `length` · `width` · `height` · `packageCount` | لا | الأبعاد وعدد الطرود، حين ينطبق الوزن الحجمي أو تسعير الشحنات متعددة الصناديق. |
| `totalDue` · `currency` | لا | قيمة الطلب، لتطبيق رسوم الدفع عند الاستلام وحدود القيمة. |
| `serviceType` | لا | يضيّق نطاق النتائج: **express** أو **sameDay** أو **fastDelivery** أو **coldDelivery** أو **heavyAndBulky** أو **electronicAndHeavy**. |

## ما الذي يعود؟

قائمة بخيارات التوصيل، خيار واحد لكل خدمة شحن تقبل الشحنة.

| الحقل | ما الذي يحمله؟ |
| - | - |
| `deliveryOptionName` · `deliveryCompanyName` | الخدمة، وشركة الشحن التي تقدمها. |
| `price` | تكلفة التوصيل. |
| `avgDeliveryTime` | تقدير مقروء للبشر، مثل *«1 to 2 Working Days»*. |
| `pickupCutOffTime` | آخر وقت يمكن فيه تسليم الطلب لشركة الشحن ليُشحن في اليوم نفسه، مثل *17:00*. |
| `codCharge` · `maxCODValue` | رسوم الدفع عند الاستلام، والحد الأعلى للقيمة التي تقبل شركة الشحن تحصيلها. |
| `returnFee` · `insurancePolicy` | تكلفة الإرجاع في هذه الخدمة، وما يغطيه التأمين إذا فُقدت الشحنة. |
| `trackingType` · `pickupDropoff` | طريقة تتبع الطرد، وطريقة تسليمه لشركة الشحن: **freePickup** أو **dropoffOnly** أو **freePickupDropoff**. |

## المدة المتوقعة للتوصيل وآخر موعد للاستلام

يجيب حقلا الوقت عن سؤالين مختلفين، ومكان كليهما صفحة الدفع.

**متوسط مدة التوصيل** مدة زمنية: الوقت الذي تستغرقه هذه الخدمة عادةً على هذا المسار. أما **آخر موعد للاستلام** (pickup cut-off) فهو مهلة نهائية: إذا طلب العميل بعده بدأ العدّ من الغد.

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

## إضافتها إلى صفحة الدفع

1. يدخل العميل عنوان التوصيل.
2. يستدعي متجرك `checkOTODeliveryFee` بالمدينة، ووزن السلة، والمركز الذي ستشحن منه.
3. تعرض الخيارات التي تريد تقديمها، وعادةً ما تكون الأرخص والأسرع لا كلها، مع المدة المتوقعة، ومع آخر موعد للاستلام إذا كان قريبًا.
4. يصبح اختيار العميل خيار التوصيل في الطلب، فيُشحن الطلب بالخدمة التي بيعت فعلًا.

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

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

* [ربط شركات الشحن](https://docs.tryoto.com/ar/modules/shipping-management/carrier-integration.md): شركات الشحن التي تأتي منها هذه الخيارات.
* [أتمتة الشحن](https://docs.tryoto.com/ar/modules/shipping-management/shipping-automation.md): كيف تُختار شركة الشحن حين لا يُسأل أحد.
* [إدارة المراكز](https://docs.tryoto.com/ar/modules/hubs-management/overview.md): نقطة الانطلاق التي يُحسب منها التقدير.


## Related topics

- [خدمات الويب هوك للتحديثات الفورية](https://docs.tryoto.com/ar/integrations/webhooks.md)
- [الربط مع شركات الشحن](https://docs.tryoto.com/ar/integrations/carriers.md)
- [نظرة عامة على OTO API](https://docs.tryoto.com/ar/developers/overview.md)


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