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

تغییر دادن وضعیت سفارش

برای تغییر دادن وضعیت سفارش در حالت‌های خاص، وب‌سرویس‌هایی در نظر گرفته شده که در ادامه به معرفی آن‌ها می‌پردازیم.

لغو سفارش

تا زمانی که سفارش هنوز به گنجدار تحویل داده نشده باشد، می‌توانید آن را لغو کنید. در این صورت سفارش در لیست مرسوله‌های پیک، نمایش داده نمی‌شود و در محاسبات مالی نیز در نظر گرفته نخواهد شد.

به عنوان مثال در صورتی که سفارش توسط مشتری لغو شده باشد و یا سفارش در زمان تعیین شده، آماده‌ی تحویل به گنجدار نباشد، می‌توانید آن را لغو کنید.

برای این منظور از وب‌سرویس زیر استفاده کنید:

PATCH/v1.1/manual-lastmile/occupancy/transit-by-supplier/{uuid}/cancel/

Response Body

{
"uuid": "19719a2b-4ede-4b4a-9f1e-63e3ce946226",
"status": "canceled"
}

Response Codes

Status Code detail
400This transition is not possible on this occupancy
404Not found
401Authentication credentials were not provided
403You do not have permission to perform this action
200-
اطلاع

تنها در صورتی که سفارش در وضعیت reserved باشد، می‌توانید از این وب‌سرویس استفاده کنید. در غیر این صورت با ارور 400 و کد 495 مواجه خواهید شد.

{
"detail": "This transition is not possible on this occupancy.",
"code": "495"
}
نکته

در وب‌سرویس فوق، در قسمت url باید uuid سفارش را که از وب‌سرویس رزرو دریافت کرده‌اید، قراردهید. در صورتی که uuid اشتباه باشد، با ارور 404 مواجه خواهید شد.