إنتقل إلى المحتوى الرئيسي

عروض الأسعار

POST /quotes يُرجع عرض سعر للتوصيل باستخدام مسافة التوجيه وبطاقة الأسعار. العروض متزامنة ويُفضل طلبها قبل عرض رسوم التوصيل أو إرسال الطلب.

الطلب

مطلوب: pickup وdropoff مع lat وlng. address اختياري. vehicle_type اختياري (مثل motorcycle، car).

{
"pickup": {"lat": 24.7136, "lng": 46.6753},
"dropoff": {"lat": 24.768, "lng": 46.709},
"vehicle_type": "motorcycle"
}

الاستجابة

الحقلالمعنى
quote_idULID للربط في POST /orders
total_sarالسعر الإجمالي بالريال
distance_km / duration_minutesتقديرات التوجيه
expires_atوقت انتهاء الصلاحية (~15 دقيقة)
breakdownالرسوم الأساسية والكيلومترات الإضافية

ربط العروض بالطلبات

مرّر quote_id عند إنشاء الطلب لتثبيت السعر.

الأخطاء

الحالةمتى
503مزود التسعير غير متاح — أعد المحاولة
422إحداثيات أو حمولة غير صالحة
401 / 403مصادقة أو قائمة IP

Webhook

قد يُرسل quote.created إذا اشتركت في أحداث العروض.

ذات صلة