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

پیش از رزرو سفارش، با استفاده از این وب‌سرویس بازه‌های زمانی قابل انتخاب برای جمع‌آوری و تحویل مرسوله را دریافت کنید. اطلاعات سفارش در این مرحله ثبت موقت می‌شود و هر بازه زمانی یک candidate_token اختصاصی دارد. پس از انتخاب بازه موردنظر، توکن آن را به وب‌سرویس رزرو سفارش ارسال کنید تا رزرو نهایی شود.

POST/v1.1/p2p-delivery/occupancy/candidate-shipping-windows

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

Request Body

{
  "origin_address": {
    "city_id": 300,
    "full_address": "آدرس مبدا",
    "latitude": 35.60436,
    "longitude": 51.30924
  },
  "sender_person": {
    "firstname": "علی",
    "lastname": "محمدی",
    "phone_number": "+989120000000"
  },
  "recipient_person": {
    "firstname": "محمد",
    "lastname": "محمدی",
    "phone_number": "+989121111111"
  },
  "destination_address": {
    "city_id": 300,
    "full_address": "آدرس مقصد",
    "latitude": 35.70436,
    "longitude": 51.40924
  },
  "logistic_company": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "parcels": [
    {
      "dimension": {
        "width": 0.2,
        "height": 0.3,
        "length": 0.4
      },
      "weight": 1500,
      "value": 1000000,
      "submitter_id": "123456",
      "packaging_type": "box",
      "characteristics": "normal"
    }
  ],
  "pod": "12345",
  "ready_time": "2026-08-23 11:00:00",
  "off_day_dates": [
    "2026-08-27",
    "2026-08-28"
  ]
}

Response Body

{
  "options": [
    {
      "candidate_token": "candidate-token-1",
      "promised_datetime_start": "2026-08-25 09:00:00",
      "promised_datetime_end": "2026-08-25 12:00:00",
      "pick_up_datetime_start": "2026-08-23 14:00:00",
      "pick_up_datetime_end": "2026-08-23 18:00:00",
      "token_expires_at": "2026-08-23 13:30:00"
    },
    {
      "candidate_token": "candidate-token-2",
      "promised_datetime_start": "2026-08-26 09:00:00",
      "promised_datetime_end": "2026-08-26 12:00:00",
      "pick_up_datetime_start": "2026-08-24 09:00:00",
      "pick_up_datetime_end": "2026-08-24 12:00:00",
      "token_expires_at": "2026-08-23 13:30:00"
    }
  ]
}

توضیحات فیلدهای درخواست

ساختار بدنه درخواست این وب‌سرویس با بدنه درخواست وب‌سرویس رزرو سفارش یکسان است و فقط فیلد اختیاری زیر به آن اضافه شده است:

• off_day_dates: فهرست روزهایی که امکان جمع‌آوری مرسوله وجود ندارد، با قالب YYYY-MM-DD. ارسال این فیلد اختیاری است.

توضیحات فیلدهای پاسخ

• options: آرایه بازه‌های زمانی قابل انتخاب. اگر هیچ بازه معتبری وجود نداشته باشد، این آرایه خالی خواهد بود و سفارش قابل رزرو نیست.
• candidate_token: توکن اختصاصی بازه زمانی. برای نهایی کردن همان بازه، این مقدار را در فیلد candidate_shipping_window_token وب‌سرویس رزرو ارسال کنید.
• promised_datetime_start: ابتدای بازه زمانی وعده‌داده‌شده برای تحویل مرسوله به گیرنده.
• promised_datetime_end: انتهای بازه زمانی وعده‌داده‌شده برای تحویل مرسوله به گیرنده.
• pick_up_datetime_start: ابتدای بازه زمانی جمع‌آوری مرسوله از مبدا.
• pick_up_datetime_end: انتهای بازه زمانی جمع‌آوری مرسوله از مبدا.
• token_expires_at: زمان انقضای توکن. درخواست رزرو باید پیش از این زمان ارسال شود.

هشدار

توکن منقضی‌شده قابل استفاده نیست. همچنین پس از رزرو موفق سفارش، هیچ‌یک از توکن‌های بازه زمانی مربوط به آن سفارش دوباره قابل استفاده نخواهند بود.