سرویس حمل کالای پادرو
خدمتدهنده
پادرو
مقدمه
پادرو پلتفرمی هوشمند و مبتنی بر تکنولوژی است. مهمترین چالش برای همه سرویسدهندگان و متقاضیان جابجایی کالا پیچیدگی و ناکارآمدی فرآیندهاست و پادرو بهعنوان یک پلتفرم هوشمند این مشکل را از طریق توسعه ابزارهای آی تی برای متقاضیان و همه شرکتهای لجستیک حل میکند. پادرو از طریق دو محصول مدیریت حملونقل و مدیریت تقاضا به تعدیل هزینهها و بهینه شدن فرآیند جابهجایی بستهها کمک میکند. درآمد پادرو مبلغ ثابتی است که به ازای جابجایی هر بسته است از هر تراکنش کسر میشود.
عملیات ثبت سفارش پادرو شامل مراحلی می باشد که باید به ترتیب پیاده سازی و اجرا شوند تا یک سفارش نهایی شود:
- دریافت لیست استانها
- انتخاب استان مبدا
- دریافت لیست شهر های استان مبدا
- انتخاب شهر مبدا
- انتخاب استان مقصد
- دریافت لیست شهر های استان مقصد
- انتخاب شهر مقصد
- دریافت لیست قیمت و پروایدر هایی که میتوانند بسته را حمل کنند
- انتخاب پروایدر
- ثبت اولیه سفارش
- دریافت گزینه های زمان جمع آوری و تحویل بسته برای پروایدر انتخاب شده
- انتخاب زمان جمع آوری
- انتخاب زمان تحویل
- دریافت گزینه های درگاه پرداخت
- انتخاب درگاه پرداخت
- ثبت کردن زمان جمع آوری و زمان تحویل و درگاه پرداخت که منجر به نهایی شدن سفارش می شود
همچنین سرویسهای جانبی سفارشات نیز در دسترس هستند که پیاده سازی آنها الزامی نیست
- سرویس دریافت جزییات سفارش بر اساس شماره سفارش
- سرویس دریافت جزییات سفارش بر اساس شماره همراه گیرنده
- سرویس دریافت وضعیت فعلی سفارش
- سرویس لغو سفارش
سرویس دریافت استان ها
با استفاده از این سرویس می توان لیست استان های کشور را دریافت کرد.
شناسه سرویس: 225659
پارامترهای ورودی
توضیحات | اجباری | نوع | پارامتر |
مقدار ثابت «ایران» | بله | String | country |
پارامترهای خروجی
توضیحات | نوع | پارامتر |
آرایه ای از گزینه های استان | Array of Json | result |
فرمت گزینه استان (result)
توضیحات | نوع | پارامتر |
شناسه استان | Integer | Id |
نام استان | String | name |
نمونه درخواست:
نمونه پاسخ:
سرویس دریافت شهرها
با استفاده از این سرویس می توان لیست شهرهای یک استان را استخراج کرد.
دقت کنید که نام استان باید از پاسخ سرویس دریافت استانها برداشته شود.
شناسه سرویس: 225674
پارامترهای ورودی
توضیحات | اجباری | نوع مقدار | پارامتر |
مقدار ثابت «ایران» | بله | String | country |
نام استان | بله | String | state |
پارامترهای خروجی
توضیحات | نوع | پارامتر |
آرایه ای از گزینه های شهر | Array of Json | result |
فرمت گزینه شهر (result)
توضیحات | نوع | پارامتر |
شناسه استان | Integer | stateId |
نام استان | String | stateName |
شناسه شهر | Integer | id |
نام شهر | String | name |
نمونه درخواست
نمونه پاسخ
سرویس دریافت گزینههای شرکت پستی
با استفاده از این وب سرویس می توانید شرکت های پستی مختلف و هزینه حمل را دریافت کنید. شما باید یک کد شرکت پستی از خروجی این سرویس را برای ثبت اولیه سفارش در مرحله بعد، انتخاب کنید.
شناسه سرویس: 43701
پارامترهای ورودی
توضیحات | اجباری | نوع مقدار | پارامتر |
شیء حاوی پارامترها | بله | Json | body |
فرمت شیء حاوی پارامترها (body)
توضیحات | اجباری | نوع مقدار | پارامتر |
شناسه شهر فرستنده سفارش | بله | String | source_city |
شناسه شهر گیرنده سفارش | بله | String | destination_city |
|
| Json | destination |
|
| Json | source |
یک آرایه از بسته های سفارش | بله | Array of Json | parcels |
فرمت (destination و source)
توضیحات | اجباری | نوع مقدار | پارامتر |
طول جغرافیایی | خیر | Float | latitude |
عرض جغرافیایی | خیر | Float | longitude |
|
| Integer | sequenceNumber |
|
| String | type |
فرمت بسته سفارش (parcel)
توضیحات | اجباری | نوع مقدار | پارامتر |
وزن بسته (گرم) | بله | Integer | weight |
ارزش بسته (ریال) | بله | Integer | value |
ابعاد فیزیکی بسته | بله | Json | dimension |
فرمت ابعاد فیزیکی بسته (dimension)
توضیحات | اجباری | نوع مقدار | پارامتر |
عرض بسته (سانتی متر) | بله | Integer | width |
طول بسته (سانتی متر) | بله | Integer | height |
ارتفاع بسته (سانتی متر) | بله | Integer | depth |
پارامترهای خروجی
توضیحات | نوع | پارامتر |
آرایه ای از گزینه های شرکت های پستی | Array of Json | result.result.quotes |
فرمت گزینه شرکت پستی (quote)
توضیحات | نوع | پارامتر |
نام شرکت پستی | String | provider_name |
کد شرکت پستی | String | provider_code |
لوگوی شرکت پستی | String | provider_logo |
| String | cartItemId |
هزینه حمل (بدون تخفیف) | Integer | price |
هزینه حمل (با اعمال تخفیف) | Integer | sale_price |
| Integer | provider_net_price |
| Integer | pickup_fee |
میزان تخفیف | Integer | discount_value |
حداقل زمان لازم برای رسیدن بسته به مقصد | Integer | from_hours |
حداکثر زمان لازم برای رسیدن بسته به مقصد | Integer | to_hours |
نوع خدمت | String | service_type |
عنوان خدمت | String | service_type_label |
نمونه درخواست:
نمونه پاسخ
خطاها:
کد | پیام | توضیحات |
500 | Server Error | scApiKey اشتباه است |
500 | Server Error | عدد اعشاری برای وزن وارد شده است |
422 | The selected source city is invalid | شناسه شهر اشتباه است |
422 | The selected source city is invalid | scApiKey اشتباه است |
422 | The selected source city is invalid | برای این مبدا خدمت ارائه نمی شود |
422 | The selected destination city is invalid | شناسه شهر اشتباه است |
422 | The selected destination city is invalid | scApiKey اشتباه است |
422 | The selected destination city is invalid | برای این مقصد خدمت ارائه نمی شود |
نمونه پاسخ خطا:
نمونه پاسخ خطا:
سرویس ثبت پیش نویس سفارش
با استفاده از این وب سرویس می توانید سفارش خود را در سیستم پادرو ثبت نمایید.
با وجود ثبت سفارش در این مرحله، سفارش هنوز نهایی نشده و به صورت پیش نویس می باشد. دقت کنید که کد شرکت پستی و نوع خدمت از پاسخ سرویس گزینه های شرکت پستی برداشته شده و به این ترتیب کاربر انتخاب می کند که بسته خود را با کدام شرکت پستی ارسال کند.
شناسه سرویس: 43741
پارامترهای ورودی
توضیحات | اجباری | نوع مقدار | پارامتر |
شیء حاوی پارامترها | بله | Json | body |
فرمت شیء حاوی پارامترها (body)
توضیحات | اجباری | نوع مقدار | پارامتر |
اطلاعات فرستنده | بله | Json | sender |
اطلاعات گیرنده | بله | Json | receiver |
کد شرکت پستی | بله | String | provider_code |
سمت پرداخت هزینه. مقدار «1» برای پرداخت هزینه توسط فرستنده | بله | Integer | payment_type |
نوع خدمت | بله | String | service_type |
توضیحات برای گیرنده |
| String | receiver_comment |
یک آرایه از بسته های سفارش | بله | Array of Json | parcels |
فرمت اطلاعات فرستنده و گیرنده (sender و receiver)
توضیحات | اجباری | نوع مقدار | پارامتر |
نام و نام خانوادگی | بله | String | name |
اطلاعات تماس | بله | Json | contact |
فرمت اطلاعات تماس (contact)
توضیحات | اجباری | نوع مقدار | پارامتر |
کد پستی |
| String | postal_code |
شناسه شهر |
| String | city |
آدرس پستی |
| String | address |
شماره همراه |
| String | phone_number |
کد ملی |
| String | national_code |
طول جغرافیایی |
| Float | latitude |
عرض جغرافیایی |
| Float | longitude |
فرمت بسته سفارش (parcel)
توضیحات | اجباری | نوع مقدار | پارامتر |
شماره بسته. به صورت دلخواه مقداردهی می شود |
| Integer | id |
وزن بسته (گرم) |
| Integer | weight |
ارزش بسته (ریال) |
| Integer | value |
شرح محتویات بسته |
| String | content |
ابعاد فیزیکی بسته |
| Json | dimension |
فرمت ابعاد فیزیکی بسته (dimension)
توضیحات | اجباری | نوع مقدار | پارامتر |
عرض بسته (سانتی متر) | بله | Integer | width |
طول بسته (سانتی متر) | بله | Integer | height |
ارتفاع بسته (سانتی متر) | بله | Integer | depth |
پارامترهای خروجی
توضیحات | نوع | پارامتر |
شماره سفارش | String | result.result. order_id |
نمونه درخواست:
نمونه پاسخ:
خطاها:
کد | پیام | توضیحات |
500 | Server Error | scApiKey اشتباه است |
422 | The selected source city is invalid | شناسه شهر اشتباه است |
422 | The selected source city is invalid | scApiKey اشتباه است |
422 | The selected source city is invalid | برای این مبدا خدمت ارائه نمی شود |
422 | The selected destination city is invalid | شناسه شهر اشتباه است |
422 | The selected destination city is invalid | scApiKey اشتباه است |
422 | The selected destination city is invalid | برای این مقصد خدمت ارائه نمی شود |
نمونه پاسخ خطا:
نمونه پاسخ خطا:
سرویس دریافت گزینههای زمان تحویل
با استفاده از این سرویس میتوانید گزینه های لازم به منظور نهایی سازی سفارش را دریافت کنید.
زمانهایی که شرکت پستی امکان جمع آوری بسته شما را دارد و همچنین زمانهایی که امکان تحویل بسته شما را دارد دریافت کنید و از میان آنها انتخاب کنید.
شناسه سرویس: 43773
پارامترهای ورودی
توضیحات | اجباری | نوع مقدار | پارامتر |
شماره سفارش مورد نظر | بله | String | orderId |
پارامترهای خروجی
توضیحات | نوع | پارامتر |
گزینه های در دسترس برای ساعت جمع آوری بسته | Array of Json | result.result.options |
گزینه های در دسترس برای زمان جمع آوری بسته | Array of Json | result.result.available_options |
فرمت گزینه برای ساعت جمع آوری (option)
توضیحات | نوع | پارامتر |
شناسه گزینه جمع آوری | Integer | option_id |
توضیحات ساعت جمع اوری | String | title |
ساعت شروع بازه جمع اوری | Integer | from |
ساعت پایان بازه جمع آوری | Integer | to |
فرمت گزینه برای زمان جمع آوری (available_option)
توضیحات | نوع | پارامتر |
تاریخ | String | date |
گزینههای در دسترسی برای زمان تحویل بسته | Array of Json | deliveries |
ساعت های جمع آوری بسته در تاریخ مورد نظر بر اساس شناسه گزینه جمع آوری | Array of Integer | option_ids |
فرمت گزینه برای زمان تحویل (delivery)
توضیحات | نوع | پارامتر |
تاریخ | String | date |
شناسه گزینه تحویل | Integer | option_id |
زمان شروع بازه تحویل | timestamp | from |
زمان پایان بازه تحویل | timestamp | to |
نمونه درخواست:
نمونه پاسخ:
نکته: برخی شرکتهای پستی مثل لینک اکسپرس برای مسیر تهران به تهران تاریخ تحویل مشخص دارند و پاسخ دریافتی مانند نمونه بالا دارای پارامتر deliveries است. اما در اغلب موارد زمان تحویل به گیرنده نهایی مشخص نیست و پارامتر deliveries در پاسخ مشاهده نمی شود؛ مانند نمونه زیر.
نمونه پاسخ:
سرویس دریافت گزینه های درگاه پرداخت
با استفاده از این سرویس میتوانید گزینه های درگاه پرداخت را به منظور نهایی سازی سفارش دریافت کنید.
انواع راههای پرداخت هزینه حمل بسته پستی را دریافت کنید و از میان آنها انتخاب کنید.
شناسه سرویس: 3899304
پارامترهای ورودی
توضیحات | اجباری | نوع مقدار | پارامتر |
شماره سفارش مورد نظر | بله | String | orderId |
پارامترهای خروجی
توضیحات | نوع | پارامتر |
گزینه های در دسترس برای درگاه پرداخت | Array of Json | result.result |
فرمت گزینه برای درگاه پرداخت (result)
توضیحات | نوع | پارامتر |
درگاه پرداخت | String | method |
عنوان درگاه پرداخت | String | title |
نمونه درخواست:
نمونه پاسخ:
سرویس نهایی سازی سفارش
آخرین مرحله ثبت کردن زمان جمع آوری و زمان تحویل (در صورت وجود) و درگاه پرداخت می باشد و با انجام این مرحله سفارش شما با موفقیت نهایی می شود.
دقت کنید که تاریخ جمع آوری و شناسه گزینه جمع آوری و تاریخ تحویل و شناسه گزینه تحویل از پاسخ سرویس گزینههای زمان تحویل برداشته شده و به این ترتیب کاربر انتخاب می کند که بسته خود را در چه زمانی به مامور جمع آوری تحویل دهد و چه زمانی این بسته به گیرنده نهایی تحویل شود.
همچنین درگاه پرداخت از پاسخ سرویس دریافت گزینه های درگاه پرداخت برداشته شده و کاربر انتخاب می کند که هزینه حمل به چه صورت پرداخت شود. چنانچه مقدار pasargad در پارامتر درگاه پرداخت ارسال شود، در خروجی لینک پرداخت دریافت خواهد شد.
پس از این مرحله، سفارش داخل پنل کاربری در سایت پادرو قابل مشاهده می شود. انجام این مرحله الزامی می باشد و در صورت عدم انجام آن سفارش به صورت پیش نویس باقی می ماند.
شناسه سرویس: 43774
پارامترهای ورودی
توضیحات | اجباری | نوع مقدار | پارامتر |
شناسه سفارش مورد نظر | بله | String | orderId |
شیء حاوی پارامترها | بله | Json | body |
فرمت شیء حاوی پارامترها (body)
توضیحات | اجباری | نوع مقدار | پارامتر |
بله | String | pickup_date | |
شناسه گزینه جمع آوری | بله | Integer | option_id |
تاریخ تحویل | بله | String | deliver_date |
شناسه گزینه تحویل | بله | Integer | delivery_option_id |
درگاه پرداخت | بله | String | payment_approach |
توضیحات نهایی | بله | String | comment |
پارامترهای خروجی
توضیحات | نوع | پارامتر |
اطلاعات اضافی | Json | result.result.payload |
شرح موفقیت یا عدم موفقیت | String | result.result.message |
فرمت اطلاعات اضافی (payload)
توضیحات | نوع | پارامتر |
لینک پرداخت |
| payment_link |
نمونه درخواست:
نمونه پاسخ:
در ادامه سرویسهای جانبی سفارشات معرفی می شوند که البته پیاده سازی آنها الزامی نیست
سرویس دریافت جزییات سفارش بر اساس شماره سفارش
با استفاده از این وب سرویس می توانید جزئیات سفارش های ثبت شده را دریافت نمایید.
شناسه سرویس: 43775
پارامترهای ورودی
توضیحات | اجباری | نوع مقدار | پارامتر |
شماره سفارش مورد نظر | بله | String | orderId |
پارامترهای خروجی:
توضیحات | نوع | پارامتر |
شماره سفارش | String | result.result.id |
کد شرکت پستی | String | result.result.provider_code |
هزینه حمل (بدون تخفیف) | Integer | result.result.price |
هزینه حمل (با اعمال تخفیف) | Integer | result.result.sale_price |
میزان تخفیف | Integer | result.result.discount |
آرایه ای از اسامی افرادی که بسته را پیکاپ کرده اند | Array of | result.result.order_rider |
زمان شروع جمع آوری | String | result.result.pickup_time |
ساعت پایان جمع اوری | String | result.result.pickup_to_time |
| String | result.result.trackingStatus |
وضعیت سفارش | String | result.result.status |
سمت پرداخت هزینه. مقدار «1» برای پرداخت هزینه توسط فرستنده و مقدار «2» برای پرداخت هزینه توسط گیرنده | Integer | result.result.payment_type |
درگاه پرداخت | String | result.result.payment_approach |
امکان لغو سفارش | Boolean | result.result.can_be_canceled |
| String | result.result.group_id |
وضعیت پرداخت | Integer | result.result.is_paid |
جزئیات سفارش | Json | result.result.order_detail |
تاریخچه وضعیت سفارش |
| result.result.status_history |
فرمت جزئیات سفارش (order_detail)
توضیحات | نوع | پارامتر |
اطلاعات فرستنده | Json | sender |
اطلاعات گیرنده | Json | receiver |
یک آرایه از بسته های سفارش | Array of Json | parcels |
مشخصات کلی بسته های ارسالی | Json | parcel_total |
کد شرکت پستی | String | provider_code |
نوع خدمت | String | service_type |
شماره ارجاع که می تواند توسط شرکت پستی درج شود |
| reference_id |
کد پیگیری | String | tracking_id |
شماره بارنامه | String | waybill_id |
تاریخ تحویل |
| deliveries |
توضیحات سفارش |
| description |
پرداخت توسط گیرنده | Boolean | cod |
فرمت اطلاعات فرستنده (sender)
توضیحات | نوع | پارامتر |
نام و نام خانوادگی | String | name |
| String | type |
اطلاعات تماس | Json | contact |
فرمت اطلاعات گیرنده (receiver)
توضیحات | نوع | پارامتر |
نام و نام خانوادگی | String | name |
توضیحات برای گیرنده | String | comment |
| String | type |
اطلاعات تماس | Json | contact |
فرمت اطلاعات تماس (contact)
توضیحات | نوع | پارامتر |
کد پستی | String | postal_code |
شناسه شهر(1) | String | city |
آدرس پستی | String | address |
شماره همراه | String | phone_number |
طول جغرافیایی | Float | lat |
عرض جغرافیایی | Float | long |
کد ملی | String | national_code |
(1) در حال حاضر شناسه شهر پادرویی برگردانده می شود که با شناسه شهر پادی وارد شده در سرویس ثبت سفارش متفاوت است. این باگ گزارش شده و در حال رفع است.
فرمت بسته سفارش (parcel)
توضیحات | نوع | پارامتر |
وزن بسته (گرم) | Integer | weight |
ارزش بسته (ریال) | Integer | value |
شرح محتویات بسته | String | content |
شماره بسته | Integer | id |
ابعاد فیزیکی بسته | Json | dimension |
| String | boxSizeId |
فرمت ابعاد فیزیکی بسته (dimension)
توضیحات | نوع | پارامتر |
عرض بسته (سانتی متر) | Integer | width |
طول بسته (سانتی متر) | Integer | height |
ارتفاع بسته (سانتی متر) | Integer | depth |
فرمت مشخصات کلی بسته های ارسالی (parcel_total)
توضیحات | نوع | پارامتر |
وزن کل (گرم) | Integer | total_weight |
ارزش کل (ریال) | Integer | total_value |
نمونه درخواست:
نمونه پاسخ:
سرویس دریافت جزئیات سفارش بر اساس شماره همراه گیرنده
با استفاده از این سرویس می توان با ارائه شماره تلفن همراه گیرنده، مشخصات بسته ارسالی به مقصد او و از جمله کد پیگیری ارسال شده به شماره تلفن همراه را دریافت کرد.
دقت کنید چنانچه گیرنده، چند بسته در حال دریافت داشته باشد، فقط مشخصات آخرین بسته جمع آوری شده نمایش داده می شود. همچنین این سرویس پاسخگوی اطلاعات به روز بوده و فقط کد پیگیری سفارشهای نهایی شده از یکماه قبل تا زمان فراخوانی سرویس را ارائه می کند.
شناسه سرویس: 4193432
پارامترهای ورودی
توضیحات | اجباری | نوع مقدار | پارامتر |
شیء حاوی پارامترها | بله | Json | body |
فرمت شیء حاوی پارامترها (body)
توضیحات | اجباری | نوع مقدار | پارامتر |
شماره تلفن همراه گیرنده | بله | String | phone_number |
پارامترهای خروجی
توضیحات | نوع | پارامتر |
| Integer | result.result.id |
شماره سفارش | String | result.result.order_id |
نام و نام خانوادگی گیرنده | String | result.result.name |
شناسه شهر گیرنده سفارش(1) | String | result.result.city_id |
آدرس پستی گیرنده | String | result.result.address |
شماره همراه گیرنده | String | result.result.phone_number |
| String | result.result.type |
|
| result.result.comment |
کد پستی گیرنده | String | result.result.postal_code |
کد ملی گیرنده | String | result.result.national_code |
طول جغرافیایی گیرنده | Float | result.result.lat |
عرض جغرافیایی گیرنده | Float | result.result.long |
| String | result.result.created_at |
| String | result.result.updated_at |
سفارش | Json |
(1) در حال حاضر شناسه شهر پادرویی برگردانده می شود که با شناسه شهر پادی وارد شده در سرویس ثبت سفارش متفاوت است. این باگ گزارش شده و در حال رفع است.
فرمت سفارش (order)
توضیحات | نوع | پارامتر |
شماره سفارش | String | id |
| String | order_id |
| Integer | shop_id |
کد شرکت پستی | String | provider_code |
هزینه حمل | Integer | |
درگاه پرداخت | String | |
وضعیت پرداخت | Integer | is_paid |
| String | created_at |
جزئیات سفارش | Json | detail |
استاتوس سفارش | String | status |
| String | tracking_status |
سمت پرداخت هزینه. مقدار «1» برای پرداخت هزینه توسط فرستنده و مقدار «2» برای پرداخت هزینه توسط گیرنده | Integer | payment_type |
زمان شروع جمع آوری | String | pickup_time |
|
| from_time |
ساعت پایان جمع اوری | String | to_time |
|
| finalize_time |
|
| reference_id |
| String | origin |
نوع خدمت | String | provider_serviceType |
میزان تخفیف | Integer | discount_value |
|
| cancelled_at |
|
| finalized_at |
| Integer | is_return |
|
| channel_id |
| String | group_id |
|
| finance_id |
شناسه شهر فرستنده سفارش(1) | String | sender_city |
شناسه شهر گیرنده سفارش(1) | String | receiver_city |
|
| exclusive_pickup |
(1) در حال حاضر شناسه شهر پادرویی برگردانده می شود که با شناسه شهر پادی وارد شده در سرویس ثبت سفارش متفاوت است. این باگ گزارش شده و در حال رفع است.
فرمت جزئیات سفارش (detail)
توضیحات | نوع | پارامتر |
اطلاعات فرستنده | Json | sender |
اطلاعات گیرنده | Json | receiver |
یک آرایه از بسته های سفارش | Array of Json | parcels |
مشخصات کلی بسته های ارسالی | Json | parcel_total |
کد شرکت پستی | String | provider_code |
نوع خدمت | String | service_type |
شماره ارجاع که می تواند توسط شرکت پستی درج شود |
| reference_id |
کد پیگیری | String | tracking_id |
شماره بارنامه | String | waybill_id |
تاریخ تحویل |
| deliveries |
توضیحات سفارش |
| description |
پرداخت توسط گیرنده | Boolean | cod |
فرمت اطلاعات فرستنده (sender)
توضیحات | نوع | پارامتر |
نام و نام خانوادگی | String | name |
| String | type |
اطلاعات تماس | Json | contact |
فرمت اطلاعات گیرنده (receiver)
توضیحات | نوع | پارامتر |
نام و نام خانوادگی | String | name |
توضیحات برای گیرنده | String | comment |
| String | type |
اطلاعات تماس | Json | contact |
فرمت اطلاعات تماس (contact)
توضیحات | نوع | پارامتر |
کد پستی | String | postal_code |
شناسه شهر(1) | String | city |
آدرس پستی | String | address |
شماره همراه | String | phone_number |
طول جغرافیایی | Float | lat |
عرض جغرافیایی | Float | long |
کد ملی | String | national_code |
(1) در حال حاضر شناسه شهر پادرویی برگردانده می شود که با شناسه شهر پادی وارد شده در سرویس ثبت سفارش متفاوت است. این باگ گزارش شده و در حال رفع است.
فرمت بسته سفارش (parcels)
توضیحات | نوع | پارامتر |
وزن بسته (گرم) | Integer | weight |
ارزش بسته (ریال) | Integer | value |
شرح محتویات بسته | String | content |
شماره بسته | Integer | id |
ابعاد فیزیکی بسته | Json | dimension |
| String | boxSizeId |
فرمت ابعاد فیزیکی بسته (dimension)
توضیحات | نوع | پارامتر |
عرض بسته (سانتی متر) | Integer | width |
طول بسته (سانتی متر) | Integer | height |
ارتفاع بسته (سانتی متر) | Integer | depth |
فرمت مشخصات کلی بسته های ارسالی (parcel_total)
توضیحات | نوع | پارامتر |
وزن کل (گرم) | Integer | total_weight |
ارزش کل (ریال) | Integer | total_value |
نمونه درخواست:
نمونه پاسخ:
خطاها:
کد | پیام | توضیحات |
404 | NotFoundException | این شماره همراه سفارش ندارد |
404 | NotFoundException | بیش از یکماه از نهایی شدن سفارش گذشته است |
نمونه پاسخ خطا:
سرویس دریافت وضعیت فعلی سفارش
با استفاده از این سرویس می توانید وضعیت سفارش خود را در شرکت پستی دریافت کنید.
شناسه سرویس: 44529
پارامترهای ورودی
توضیحات | اجباری | نوع مقدار | پارامتر |
شماره سفارش مورد نظر | بله | String | orderId |
پارامترهای خروجی
توضیحات | پارامتر |
وضعیت سفارش | result.result.order_state |
توضیح وضعیت سفارش | result.result.text |
مقادیر وضعیت سفارش (order_state)
توضیحات | پارامتر |
زمان جمع آوری مشخص شده ولی بر روی api شرکت مورد نظر ثبت نشده | finalized |
سفارش از طرف ادمین پادرو رد شده است | rejected |
توضیحات | پارامتر |
ثبت پیش نویس و غیر نهایی | pending |
در حال پردازش | IN_PROGRESS |
ثبت در وب سرویس شرکت پستی | PROVIDER_SEEN |
جمع آوری از فرستنده | PICKED_UP |
تحویل به شرکت پستی | DELIVERED_TO_PROVIDER |
عدم جمع آوری از فرستنده | NOT_PICKED_UP_FROM_SENDER |
عدم تحویل به شرکت پستی | NOT_DELIVERED_TO_PROVIDER |
در انبار | IN_WAREHOUSE |
در حال ارسال به مقصد | DELIVERING |
تحویل به مشتری | DELIVERED |
لغو شده | cancel / CANCELLED |
ناموفق و مرجوعی | FAILED |
تاخیر در تحویل | DELIVERY_DELAYED |
عدم دریافت توسط مشتری | NOT_RECEIPTED |
تغییر در اطلاعات بارنامه | WAYBILL_INFO_CHANGED |
بروز خسارت در مرسوله | CONSIGNMENT_DAMAGED |
در انتظار لغو دستی توسط پروایدر | PENDING_CANCELLATION |
در حال بررسی تاخیر | CHECKING_DELAY |
جمع آوری ناموفق | PICKUP_IS_REJECTED |
نمونه درخواست:
نمونه پاسخ:
سرویس لغو سفارش
با استفاده از این وب سرویس می توانید سفارشی که قبلا ثبت شده را لغو کنید.
قبل از فراخوانی این سرویس می توانید با استفاده از سرویس دریافت جزئیات سفارش، پارامتر can_be_canceled را دریافت و بر اساس آن برای فراخوانی سرویس لغو سفارش تصمیم بگیرید. در نتیجه فراخوانی این سرویس در اکثر موارد سفارش لغو می شود، ولی گاهی اوقات امکان دارد لغو سفارش انجام نشود و سفارش در همان وضعیت باقی بماند.
شناسه سرویس: 43776
پارامترهای ورودی
توضیحات | اجباری | نوع مقدار | پارامتر |
شماره سفارش مورد نظر | بله | String | orderId |
توضیحات لغو سفارش |
|
| note |
پارامترهای خروجی
توضیحات | نوع | پارامتر |
اطلاعات اضافی | Array of | result.result.payload |
شرح موفقیت یا عدم موفقیت | String | result.result.message |
نمونه درخواست:
نمونه پاسخ: