Skip to main content

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

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

لغو سفارش​

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

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

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

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-
info

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

{
"detail": "This transition is not possible on this occupancy.",
"code": "495"
}
tip

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