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

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

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

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

  • شناسه‌ی بسته‌ها
  • ابعاد بسته‌ها
  • شماره تلفن سفیر
هشدار

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

  • هر کدام از ابعاد بسته‌های جدید، بزرگتر از ابعاد قبلی باشد.
  • حجم هر کدام از بسته‌های جدید، بزرگتر از حجم قبلی باشد.
  • مجموع حجم بسته‌های جدید، بزرگتر از مجموع حجم بسته‌های قبلی باشد.
POST/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‍ در پاسخ این وب‌سرویس دریافت می‌کنید، قطعی نیست و پس از ثبت نهایی سفارش‌های هر گنجه، می‌تواند تغییر کند.