لیست سفارش‌ها

برای دریافت لیست سفارش‌ها باید از وب‌سرویس زیر استفاده کنید.

GET/v1.1/manual-lastmile/occupancies/organization/

نیاز به احراز هویت

Response Body

{
  "count": 50,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 60,
      "uuid": "cd8db4f4-3456-4ea3-923d-35eb58e78689",
      "status": "pendingoccupied",
      "manual_station": {
        "uuid": "b83c2f51-2d2b-4195-868c-a45c712df74e"
      },
      "picker": {
        "first_name": "علی",
        "last_name": "محمدی",
        "full_name": "علی محمدی"
      },
      "dates": {
        "time_scope": {
          "expected_check_in": "2024-12-01 14:48:43",
          "expected_duration": "2 00:00:00"
        },
        "order_date": "2024-12-01 11:18:43",
        "check_in": null,
        "check_out": null,
        "cancel_date": null,
        "extend_date": null
      },
      "shipment": {
        "supplier": 11,
        "external_id": "40800666"
      },
      "parcels": [],
      "unix_timestamp": 1734439969.4353259
    },
    ...
  ]
}

در ادامه توضیح برخی از فیلد‌ها آمده است:

• uuid: شناسه یکتای مرسوله در گنجه
• status: آخرین وضعیت مرسوله که می‌تواند مقادیر زیر را داشته باشد:
  • reserved: مرسوله هنوز به گنجدار تحویل داده نشده‌است.
  • pendingoccupied: مرسوله توسط پیک تحویل داده شده است؛ اما هنوز توسط گنجدار تایید نشده‌است.
  • occupied: مرسوله در دست گنجدار است.
  • unoccupied: مرسوله توسط کاربر نهایی از گنجدار تحویل گرفته شده است.
  • expired: مهلت دریافت مرسوله تمام شده است؛ اما مرسوله هنوز در دست گنجدار است.
  • pendingreturned: مرسوله جهت مرجوع شدن توسط گنجدار به پیک تحویل داده شده است
  • returned: مرجوع شده به پیک.
• manual_station: اطلاعات مربوط به گنجدار در این فیلد می‌آید. این اطلاعات شامل موارد زیر است:
  • uuid: شناسه‌ی یکتای گنجه
• picker: اطلاعات مربوط به کاربر نهایی در این فیلد می‌آید. این اطلاعات شامل موارد زیر است:
  • first_name: نام
  • last_name: نام خانوادگی
  • full_name: نام و نام خانوادگی
• dates: تاریخ‌های مهم مربوط به این مرسوله در این فیلد می‌آید. این اطلاعات شامل موارد زیر است:
  • time_scope: تاریخ و زمان بازه‌ی دریافت مرسوله
  • order_date: تاریخ و زمان ثبت مرسوله
  • check_in: تاریخ و زمان لحظه‌ی تحویل مرسوله به گنجدار
  • check_out: تاریخ و زمان لحظه‌ی خروج مرسوله از گنجدار
  • cancel_date: تاریخ و زمان لحظه‌ی لغو مرسوله
  • extend_date: تاریخ و زمان لحظه‌ی تمدید مهلت دریافت مرسوله
• shipment: اطلاعات مربوط به مرسوله در این فیلد می‌آید. این اطلاعات شامل موارد زیر است:
  • supplier: شناسه‌ی تامین‌کننده‌ی مرسوله
  • external_id: شناسه‌ی مرسوله در سرویس تامین‌کننده
• parcels: آرایه‌ای از بسته‌ها (فقره‌ها) ی مربوط به این مرسوله. با توجه به اینکه هر کدام از بسته‌ها می‌توانند شناسه‌ی متفاوتی در سرویس تامین‌کننده داشته باشند، برای هر کدام از بسته‌ها نیز external_id تعریف می‌شود.
• unix_timestamp: زمان ارسال وب‌هوک

tip

برای استفاده‌ی عملی، بهتر است مطابق مثال‌های زیر از فیلتر‌های شعبه، وضعیت و تاریخ به عنوان query parameter استفاده کنید.

manual_station=27866ff0-3d59-41f8-9711-77e08921b25b

status=pendingoccupied

status__in=pendingoccupied,occupied

expected_check_in__gte=2024-12-01 14:00:00

expected_check_in__lte=2024-12-01 14:00:00

موارد بالا را می‌توان با هم ترکیب کرد.