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

تغییر دادن اطلاعات مرسوله

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

مواردی که قابل تغییر هستند، عبارت‌اند از:

  • شناسه‌ی بسته‌ها
  • ابعاد بسته‌ها
  • شماره تلفن سفیر
PATCH/v1.1/hub-management/occupancy/{uuid}/update-shipment/
نیاز به احراز هویت

Request Body​

{
  "package": {
    "parcels": [
      {
        "external_id": "Example1_1",
        "dimension": {
          "width": 0.1,
          "height": 0.25,
          "length": 0.15
        }
      },
      {
        "external_id": "Example1_2",
        "dimension": {
          "width": 0.2,
          "height": 0.15,
          "length": 0.35
        }
      }
    ]
  },
  "dropper": "+989120000000"
}

Response Body​

{
  "pk": 10000,
  "uuid": "c82de21f-19b0-477e-a489-3705a6e04da9",
  "verbose_id": null,
  "status": "Reserved",
  "process": "lastmile",
  "station": {
    "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "address": "آدرس گنجه",
    "location": null,
    "nickname": "نام گنجه",
    "postal_code": null,
    "images": [],
    "districts": []
  },
  "dates": {
    "time_scope": {
      "expected_check_in": "2024-10-31 08:00:00",
      "expected_duration": "10:00:00"
    },
    "order_date": "2024-10-31 09:35:24",
    "check_in": null,
    "check_out": null,
    "cancel_date": null,
    "extend_date": null
  }
}

Response Codes​

Status Code detail
400Update shipment info is not possible for this occupancy
404Not found
200-
نکته

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

هشدار

وضعیت سفارش که در فیلد status‍ در پاسخ این وب‌سرویس دریافت می‌کنید، قطعی نیست و پس از ثبت نهایی سفارش‌های هر گنجه، می‌تواند تغییر کند.