برای ثبت سفارش، داشتن city_id الزامی است. شما باید این لیست را دریافت و با دیتابیس خود مپ کنید.
https://api-demo.digiexpress.ir/api/citiesساختار پاسخ دریافت لیست شهرها (Response Body - HTTP 200) :
{
"status_code": 200,
"data": {
"cities": [
{
"id": 0,
"name": "string",
"state_id": 0,
"state_name": "string",
"latitude": 0,
"longitude": 0
}
]
}
}محدودیت پوشش جمع‌آوری در محیط Production
در محیط Production، امکان ثبت موفق سفارش به معنی امکان جمع‌آوری از تمام شهرها نیست. سرویس جمع‌آوری دیجی‌اکسپرس بر اساس شهر مبدأ، وزن مرسوله و پوشش عملیاتی فعال در هر بازه زمانی کنترل می‌شود.
بنابراین کانساینر باید قبل از ثبت سفارش، شهر مبدأ را با لیست شهرهای تحت پوشش جمع‌آوری تطبیق دهد.
جمع‌آوری مرسوله‌های ۱۵ کیلوگرم و کمتر
برای مرسوله‌هایی که وزن آن‌ها ۱۵ کیلوگرم یا کمتر است، جمع‌آوری فقط از شهرهای اعلام‌شده در لیست Pickup Coverage مجاز است. کانساینر باید city_id مبدأ را مطابق خروجی سرویس GET /api/cities ارسال کند.
جمع‌آوری مرسوله‌های بالای ۱۵ کیلوگرم
برای مرسوله‌های بالای ۱۵ کیلوگرم، پوشش جمع‌آوری محدودتر است و فقط در شهرهایی انجام می‌شود که جمع‌آوری بالای ۱۵ کیلوگرم برای آن‌ها فعال شده باشد.
در صورتی که شهر مبدأ در لیست پوشش عملیاتی مربوط به وزن مرسوله قرار نداشته باشد، ممکن است سفارش Route نشود یا در مرحله مسیریابی با وضعیت‌هایی مانند عدم یافتن مسیر / نبود ظرفیت مواجه شود.
نکته مهم
لیست شهرهای تحت پوشش جمع‌آوری ثابت نیست و ممکن است توسط تیم عملیات دیجی‌اکسپرس به‌روزرسانی شود. به همین دلیل، قبل از شروع تست Production، آخرین نسخه لیست پوشش جمع‌آوری باید از تیم عملیات دریافت شود و شهر مبدأ سفارش‌های تستی بر اساس همان نسخه بررسی گردد.