رزرو سفارش
برای ثبت سفارش جدید، وبسرویس زیر در نظر گرفته شده است که در ادامه به جزئ یات آن خواهیم پرداخت.
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"
}
],
"pod": "12345",
"ready_time": "2026-06-21 11:00:00"
}
Response Body
{
"occupancy_uuid": "c82de21f-19b0-477e-a489-3705a6e04da9",
"shipment_id": "667788",
"external_id": "GNJ11113370",
"parcels": [
{
"id": 1367,
"submitter_id": "123456",
"weight": 1500,
"value": 1000000,
"temp_size": {
"uuid": "d20e3f63-00df-4138-9a61-46944a5e526d",
"name": null,
"length": 0.4,
"width": 0.2,
"height": 0.3
}
}
],
"status": "reserved",
"logistic_company": {
"pk": 2,
"uuid": "e6733e4d-13ee-4b36-97fc-c167d2b5753b",
"name": "دیجیاکسپرس"
},
"sender": {
"firstname": "علی",
"lastname": "محمدی",
"phone_number": "+989120000000",
"full_name": "علی محمدی"
},
"recipient": {
"firstname": "محمد",
"lastname": "محمدی",
"phone_number": "+989121111111",
"full_name": "محمد محمدی"
},
"destination_location": {
"city": {
"id": 300,
"name": "تهران",
"province": {
"id": 8,
"name": "تهران"
}
},
"address": "آدرس مقصد",
"latitude": 35.70436,
"longitude": 51.40924
}
}
توضیحات فیلدهای درخواست
درخواست شما باید شامل موارد زیر باشد.
-
origin_address(*): اطلاعات آدرس مبدا که باید شامل موارد زیر باشد:city_id(*): آیدی شهر مبدا. برای دریافت لیست شهره ا و آیدی آنها اینجا را مطالعه کنید.full_address(*): آدرس پستی مبدا-
latitude: عرض جغرافیایی -
longitude: طول جغرافیایی
-
destination_address(*): اطلاعات آدرس مقصد که مشابه توضیحات ارائه شده برای آدرس مبدا است.
در صورتی که اطلاعات طول و عرض جغرافیایی برای مبدا یا مقصد سفارش، ارسال نشود، آدرس لفظی ارائه شده، به مختصات جغرافیایی تبدیل میشود اما ارسال این اطلاعات توسط شما به مسیریابی دقیقتر کمک میکند.
-
sender_person(*): اطلاعات شخص فرستنده که برای هماهنگی جهت دریافت مرسوله استفاده خواهد شد. این اطلاعات باید شامل موارد زیر باشد:firstname(*): نامlastname(*): نام خانوادگیphone_number(*): شماره تماس
-
recipient_person(*): اطلاعات شخص گیرنده که برای هماهنگی جهت تحویل مرسوله استفاده خواهد شد. این اطلاعات مشابه اطلاعات شخص فرستنده است. -
logistic_company(*): سرویس پستی که میخواهید از آن برای ارسال مرسوله استفاده کنید. -
pod: کد تحویل مرسوله که گیرنده باید هنگام تحویل گرفتن مرسوله، آن را به مامور ارسال، اعلام کند.
در صورتی که کد تحویل را در درخواست خود قرار ندهید، یک کد تحویل به این مرسوله اختصاص خواهد یافت و به اطلاع گیرنده خواهد رسید.
-
ready_time: زمان آماده بودن مرسوله که نمیتواند در گذشته باشد. جمعآوری مرسوله بعد از این زمان، انجام خواهد شد و در صورتی که این فیلد را ارسال نکنید، جمعآوری مرسوله در نزدیکترین زمان ممکن انجام میشود. -
parcels(*): اطلاعات بستههای مربوط به این مرسوله که باید به صورت آرایهای شامل اطلاعات زیر باشد:dimension(*): ابعاد بسته در این قسمت مشخص میشود که شامل (*)width(عرض)، (*)height(ارتفاع) و (*)length(طول) است. این ابعاد باید بر حسب متر مشخص شود.weight(*): وزن بسته بر حسب گرمvalue(*): ارزش ریالی بسته که مبنای محاسبه هزینه بیمه مرسوله قرار میگیردsubmitter_id: آیدی بسته در سیستم شما که در پاسخ این سرویس و سایر سرویسها به شما برمیگردد.
توضیحات فیلدهای پاسخ
در پاسخ این وبسرویس، درصورت موفقیتآمیز بودن درخواست، اطلاعات زیر را دریافت خواهید کرد:
occupancy_uuid: عبارت است از uuid اختصاص یافته به این سفارش که جهت فراخوانی سایر وبسرویسها مورد استفاده قرار خواهد گرفت.external_id: آیدی مرسوله در سیستم پستیparcels: آرایهای از اطلاعات بستههای مربوط به این سفارش، مطابق با اطلاعات داده شده در درخواست شما.status: وضعیت سفارش که در هنگام ثبت مرسوله reservedخواهد بود.