پرش به مطلب اصلی

باز کردن درب سفارش

برای باز کردن درب گنجه لازم است وب‌سرویس زیر را فراخوانی کنید.

POST/v1.1/hub-management/open-door-for-drop-off/

Request Body

{
"location_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjo5LCJzdGF0aW9uIjoiMDVkZGZmYTEtNTRlYy00YTBmLWE5N2EtYWMxODc5MmNmYTAzIiwidGltZXN0YW1wIjoiMjAyNC0xMS0wOSAxMTo1MDoyMiJ9.N77WBVFc3WbYMDzZT01nEBs7eCC1qpvr9z038OKDxJc",
"external_id": "Test1000",
"user_external_id": "111111"
}

Successful Response Body

{
"detail": "Door Opened"
}

Successful Response Codes

Status Code Description
200Door Opened

Unsuccessful Response Body

{
"detail": "location_token is not valid",
"code": "8001"
}

Unsuccessful Response Codes

code detail Description
8001location_token is not validاسترینگ داده شده به عنوان location_token، معتبر نیست.
8002user in location_token is not validدر location_token، کاربری معرفی شده است که برابر با کاربر احراز شده در این ریکوئست نیست.
8003station does not match with shipmentاستیشن مرسوله درخواستی، با استیشن موجود در location_token یکی نیست. به عبارت دیگر مرسولۀ درخواستی برای جای دیگری است.
8004shipment external_id does not existمرسولۀ رزروشده‌ای با این بارکد موجود نیست.
8005location_token time limit has been exceededاز مدت زمان اعتبار location_token گذشته است.
8006station is not given in location_tokenدر location_token استیشن معرفی نشده است.
8007user is not given in location_tokenدر location_token کاربر معرفی نشده است.
8008station does not existدر location_token استیشنی معرفی شده است که وجود ندارد.
8009cannot open doorامکان باز شدن در نیست. به یکی از دلایل زیر: 1- از آخرین تلاش برای باز شدن این در مدت زمان مشخصی گذشته است. 2- استاتوس مرسوله reserved نیست.

در ادامه توضیحات مربوط به هر یک از فیلدهای درخواست را می‌توانید مشاهده کنید:

  • location_token: باید همان توکنی باشد که از وب‌سرویس بررسی لوکیشن دریافت کرده‌اید.

  • external_id: باید شماره سفارشی (همان بارکد روی بسته) باشد که از قبل با استفاده از وب‌سرویس رزرو، رزرو انجام داده‌اید.

  • user_external_id: باید ID پیک در سیستم تامین‌کننده باشد. این فیلد الزامی نیست.