التسعيرات
التسعيرة عرض سعر ملزم من ناقل محدد لخدمة محددة، صالح لمدة قصيرة، وهي الخطوة الأولى قبل إنشاء أي شحنة.
دورة حياة التسعيرة
- أرسل مسار الشحنة وطرودها إلى POST /api/v1/rates.
- يعيد منفذ تسعيرة لكل خدمة مؤهلة، لكل منها quote_id فريد.
- مرّر quote_id المختار إلى POST /api/v1/shipments لإنشاء الشحنة بالسعر نفسه.
- بعد 15 دقيقة تنتهي صلاحية التسعيرة ولا يمكن استخدامها.
صلاحية 15 دقيقة
كل تسعيرة تحمل حقل expires_at بموعد انتهاء صلاحيتها بعد 15 دقيقة من الإصدار. أسعار الشحن تتحرك — الوقود والسعة وأسعار الصرف — لذلك لا يثبّت الناقل سعره إلا لفترة قصيرة.
محاولة إنشاء شحنة بتسعيرة منتهية تعيد 409 برمز E_QUOTE_EXPIRED — والحل ببساطة طلب تسعيرة جديدة.
نصيحة
اطلب التسعيرة عند تأكيد الطلب لا عند عرض سلة المشتريات، كي لا تنتهي صلاحيتها قبل الإنشاء.
الوزن الحجمي
الطرود الخفيفة كبيرة الحجم تشغل مساحة أكثر مما يوحي وزنها، لذلك يفوتر الناقلون على الوزن الأكبر بين الفعلي والحجمي. الصيغة:
المعامل يحدده الناقل حسب وسيلة النقل: 5000 للخدمات الجوية والإكسبريس، و6000 للبري والبحري. ثم:
الوزن القابل للفوترة = الأعلى بين الفعلي والحجمي، مقرّبًا لأعلى إلى 0.5 كغ.
مثال: طرد 30×40×50 سم وزنه الفعلي 3 كغ على خدمة إكسبريس: الحجمي = 60000 ÷ 5000 = 12 كغ، فيُفوتر على 12 كغ لا على 3.
بنود تفصيل السعر
مصفوفة breakdown تفصّل كيف تكوّن الإجمالي. كل بند يحمل رمزًا آليًا وتسمية بالعربية والإنجليزية والمبلغ بالريال. البنود التي قد تظهر في التسعيرة:
| الرمز | التسمية | الوصف |
|---|---|---|
base | الرسم الأساسي | رسم ثابت لكل شحنة حسب الخدمة والمنطقة. |
weight_charge | رسم الوزن | يُحسب على الوزن القابل للفوترة وفق شرائح الوزن. |
oversize | رسم تجاوز الأبعاد | يُضاف عندما يتجاوز أطول بُعد حدّ الخدمة. |
fuel_surcharge | رسم الوقود | نسبة من رسوم الشحن تتبع مؤشر الوقود. |
cod_fee | رسم الدفع عند الاستلام | يُضاف عند تحديد cod_amount أكبر من صفر. |
customs_clearance | رسم التخليص الجمركي | للشحنات الدولية العابرة للحدود. |
insurance | التأمين | نسبة من القيمة المصرّح بها عند توفرها. |
vat | ضريبة القيمة المضافة 15% | تُحسب على مجموع البنود الخاضعة. |