تغییر دادن وضعیت سفارش
برای تغییر دادن وضعیت سفارش در حالت‌های خاص، وب‌سرویس‌هایی در نظر گرفته شده که در ادامه به معرفی آن‌ها می‌پردازیم.
لغو سفارش
تا زمانی که سفارش هنوز در گنجه جایگذاری نشده باشد، می‌توانید آن را لغو کنید. در این صورت سفارش در لیست مرسوله‌های پیک، نمایش داده نمی‌شود و در محاسبات مالی نیز در نظر گرفته نخواهد شد.
به عنوان مثال در صورتی که سفارش توسط مشتری لغو شده باشد و یا سفارش در زمان تعیین شده، آماده‌ی جایگذاری در گنجه نباشد، می‌توانید آن را لغو کنید.
برای این منظور از وب‌سرویس زیر استفاده کنید:
Response Body
{
"uuid": "19719a2b-4ede-4b4a-9f1e-63e3ce946226",
"status": "canceled"
}
Response Codes
| Status Code | detail |
|---|---|
400 | This transition is not possible on this occupancy |
404 | Not found |
200 | - |
تنها در صورتی که سفارش در وضعیت reserved باشد، می‌توانید از این وب‌سرویس استفاده کنید. در غیر این صورت با ارور 400 مواجه خواهید شد.
جلوگیری از برداشتن سفارش توسط مشتری
در صورتی که سفارش در گنجه جایگذاری شده باشد اما به هر دلیلی، می‌خواهید اجازه‌ی برداشتن آن را به مشتری ندهید، می‌توانید آن را بلاک کنید. در این صورت این سفارش توسط مشتری قابل برداشت نخواهد بود و پیک می‌تواند در مراجعه ی بعدی به گنجه، آن را مرجوع کند.
به عنوان مثال در صورتی که سفارش پس از جایگذاری در گنجه، توسط مشتری لغو شده باشد، می‌توانید آن را بلاک کنید.
برای این منظور از وب‌سرویس زیر استفاده کنید:
Response Body
{
"uuid": "19719a2b-4ede-4b4a-9f1e-63e3ce946226",
"status": "blocked"
}
Response Codes
| Status Code | detail |
|---|---|
400 | This transition is not possible on this occupancy |
404 | Not found |
200 | - |
تنها در صورتی که سفارش در وضعیت occupied باشد، می‌توانید از این وب‌سرویس استفاده کنید. در غیر این صورت با ارور 400 مواجه خواهید شد.
همچنین در صورتی که می‌خواهید مجددا اجازه‌ی برداشتن بسته را به مشتری بدهید، می‌توانید با استفاده از وب‌سرویس زیر، سفارش را از وضعیت blocked به وضعیت occupied برگردانید.
Response Body
{
"uuid": "19719a2b-4ede-4b4a-9f1e-63e3ce946226",
"status": "occupied"
}
Response Codes
| Status Code | detail |
|---|---|
400 | This transition is not possible on this occupancy |
404 | Not found |
200 | - |
تنها در صورتی که سفارش در وضعیت blocked باشد، می‌توانید از این وب‌سرویس استفاده کنید. در غیر این صورت با ارور 400 مواجه خواهید شد.
در وب‌سرویس‌های فوق، در قسمت url باید uuid سفارش را که از وب‌سرویس رزرو دریافت کرده‌اید، قراردهید. در صورتی که uuid اشتباه باشد، با ارور 404 مواجه خواهید شد.