مقدمه

پادرو پلتفرمی هوشمند و مبتنی بر تکنولوژی است. مهمترین چالش برای همه سرویس‌دهندگان و متقاضیان جابجایی کالا پیچیدگی و ناکارآمدی فرآیندهاست و پادرو به‌عنوان یک پلتفرم هوشمند این مشکل را از طریق توسعه ابزارهای آی‌ تی برای متقاضیان و همه شرکت‌های لجستیک حل می‌کند. پادرو از طریق دو محصول مدیریت حمل‌ونقل و مدیریت تقاضا به تعدیل هزینه‌ها و بهینه شدن فرآیند جابه‌جایی بسته‌ها کمک می‌کند. درآمد پادرو مبلغ ثابتی است که به ازای جابجایی هر بسته است از هر تراکنش کسر می‌شود.

عملیات ثبت سفارش پادرو شامل مراحلی می باشد که باید به ترتیب پیاده سازی و اجرا شوند تا یک سفارش نهایی شود:

  1. دریافت لیست استانها
  2. انتخاب استان مبدا
  3. دریافت لیست شهر های استان مبدا
  4. انتخاب شهر مبدا
  5. انتخاب استان مقصد
  6. دریافت لیست شهر های استان مقصد
  7. انتخاب شهر مقصد
  8. دریافت لیست قیمت و پروایدر هایی که میتوانند بسته را حمل کنند
  9. انتخاب پروایدر
  10. ثبت اولیه سفارش
  11. دریافت گزینه های زمان جمع آوری و تحویل بسته برای پروایدر انتخاب شده
  12. انتخاب زمان جمع آوری
  13. انتخاب زمان تحویل
  14. دریافت گزینه های درگاه پرداخت
  15. انتخاب درگاه پرداخت
  16. ثبت کردن زمان جمع آوری و زمان تحویل و درگاه پرداخت که منجر به نهایی شدن سفارش می شود

همچنین سرویسهای جانبی سفارشات نیز در دسترس هستند که پیاده سازی آنها الزامی نیست

  • سرویس دریافت جزییات سفارش بر اساس شماره سفارش
  • سرویس دریافت جزییات سفارش بر اساس شماره همراه گیرنده
  • سرویس دریافت وضعیت فعلی سفارش
  • سرویس لغو سفارش

سرویس دریافت استان ها

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

شناسه سرویس: 225659

پارامترهای ورودی

توضیحات

اجباری

نوع

پارامتر

مقدار ثابت «ایران»

بله

String

country

پارامترهای خروجی

توضیحات

نوع

پارامتر

آرایه ای از گزینه های استان

Array of Json

result

فرمت گزینه استان (result)

توضیحات

نوع

پارامتر

شناسه استان

Integer

Id

نام استان

String

name

نمونه درخواست:

HTTP

 

نمونه پاسخ:

JSON

سرویس دریافت شهرها

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

دقت کنید که نام استان باید از پاسخ سرویس دریافت استانها برداشته شود.

شناسه سرویس: 225674

پارامترهای ورودی

توضیحات

اجباری

نوع مقدار

پارامتر

مقدار ثابت «ایران»

بله

String

country

نام استان

بله

String

state

پارامترهای خروجی

توضیحات

نوع

پارامتر

آرایه ای از گزینه های شهر

Array of Json

result

فرمت گزینه شهر (result)

توضیحات

نوع

پارامتر

شناسه استان

Integer

stateId

نام استان

String

stateName

شناسه شهر

Integer

id

نام شهر

String

name

نمونه درخواست

HTTP

نمونه پاسخ

JSON

سرویس دریافت گزینه‌های شرکت پستی

با استفاده از این وب سرویس می توانید شرکت های پستی مختلف و هزینه حمل را دریافت کنید. شما باید یک کد شرکت پستی از خروجی این سرویس را برای ثبت اولیه سفارش در مرحله بعد، انتخاب کنید.

شناسه سرویس: 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

نمونه درخواست:

JSON

نمونه پاسخ

JSON

خطاها:

کد

پیام

توضیحات

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

برای این مقصد خدمت ارائه نمی شود

نمونه پاسخ خطا:

JSON

نمونه پاسخ خطا:

JSON

سرویس ثبت پیش نویس سفارش

با استفاده از این وب سرویس می توانید سفارش خود را در سیستم پادرو ثبت نمایید.

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

شناسه سرویس: 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

نمونه درخواست:

JSON

نمونه پاسخ:

JSON

 

خطاها:

کد

پیام

توضیحات

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

برای این مقصد خدمت ارائه نمی شود

نمونه پاسخ خطا:

JSON

 

نمونه پاسخ خطا:

JSON

 

سرویس دریافت گزینه‌های زمان تحویل

با استفاده از این سرویس می­توانید گزینه های لازم به منظور نهایی سازی سفارش را دریافت کنید.

زمانهایی که شرکت پستی امکان جمع آوری بسته شما را دارد و همچنین زمانهایی که امکان تحویل بسته شما را دارد دریافت کنید و از میان آنها انتخاب کنید.

شناسه سرویس: 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

نمونه درخواست:

HTTP

 

نمونه پاسخ:

JSON

 

نکته: برخی شرکتهای پستی مثل لینک اکسپرس برای مسیر تهران به تهران تاریخ تحویل مشخص دارند و پاسخ دریافتی مانند نمونه بالا دارای پارامتر deliveries است. اما در اغلب موارد زمان تحویل به گیرنده نهایی مشخص نیست و پارامتر deliveries در پاسخ مشاهده نمی شود؛ مانند نمونه زیر.

نمونه پاسخ:

JSON

 

سرویس دریافت گزینه های درگاه پرداخت

با استفاده از این سرویس می­توانید گزینه های درگاه پرداخت را به منظور نهایی سازی سفارش دریافت کنید.

انواع راههای پرداخت هزینه حمل بسته پستی را دریافت کنید و از میان آنها انتخاب کنید.

شناسه سرویس: 3899304

پارامترهای ورودی

توضیحات

اجباری

نوع مقدار

پارامتر

شماره سفارش مورد نظر

بله

String

orderId

پارامترهای خروجی

توضیحات

نوع

پارامتر

گزینه های در دسترس برای درگاه پرداخت

Array of Json

result.result

فرمت گزینه برای درگاه پرداخت (result)

توضیحات

نوع

پارامتر

درگاه پرداخت

String

method

عنوان درگاه پرداخت

String

title

نمونه درخواست:

HTTP

 

نمونه پاسخ:

JSON

 

سرویس نهایی سازی سفارش

آخرین مرحله ثبت کردن زمان جمع آوری و زمان تحویل (در صورت وجود) و درگاه پرداخت می باشد و با انجام این مرحله سفارش شما با موفقیت نهایی می شود.

دقت کنید که تاریخ جمع آوری و شناسه گزینه جمع آوری و تاریخ تحویل و شناسه گزینه تحویل از پاسخ سرویس گزینه‌های زمان تحویل برداشته شده و به این ترتیب کاربر انتخاب می کند که بسته خود را در چه زمانی به مامور جمع آوری تحویل دهد و چه زمانی این بسته به گیرنده نهایی تحویل شود.

همچنین درگاه پرداخت از پاسخ سرویس دریافت گزینه های درگاه پرداخت برداشته شده و کاربر انتخاب می کند که هزینه حمل به چه صورت پرداخت شود. چنانچه مقدار 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

نمونه درخواست:

JSON

 

نمونه پاسخ:

JSON

 

در ادامه سرویسهای جانبی سفارشات معرفی می شوند که البته پیاده سازی آنها الزامی نیست

سرویس دریافت جزییات سفارش بر اساس شماره سفارش

با استفاده از این وب سرویس می توانید جزئیات سفارش های ثبت شده را دریافت نمایید.

شناسه سرویس: 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

نمونه درخواست:

HTTP

 

نمونه پاسخ:

JSON

 

سرویس دریافت جزئیات سفارش بر اساس شماره همراه گیرنده

با استفاده از این سرویس می توان با ارائه شماره تلفن همراه گیرنده، مشخصات بسته ارسالی به مقصد او و از جمله کد پیگیری ارسال شده به شماره تلفن همراه را دریافت کرد.

دقت کنید چنانچه گیرنده، چند بسته در حال دریافت داشته باشد، فقط مشخصات آخرین بسته جمع آوری شده نمایش داده می شود. همچنین این سرویس پاسخگوی اطلاعات به روز بوده و فقط کد پیگیری سفارشهای نهایی شده از یکماه قبل تا زمان فراخوانی سرویس را ارائه می کند.

شناسه سرویس: 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

result.result.order

(1) در حال حاضر شناسه شهر پادرویی برگردانده می شود که با شناسه شهر پادی وارد شده در سرویس ثبت سفارش متفاوت است. این باگ گزارش شده و در حال رفع است.

فرمت سفارش (order)

توضیحات

نوع

پارامتر

شماره سفارش

String

id

 

String

order_id

 

Integer

shop_id

کد شرکت پستی

String

provider_code

هزینه حمل

Integer

price

درگاه پرداخت

String

payment_approach

وضعیت پرداخت

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

نمونه درخواست:

HTTP

 

نمونه پاسخ:

JSON

 

خطاها:

کد

پیام

توضیحات

404

NotFoundException

این شماره همراه سفارش ندارد

404

NotFoundException

بیش از یکماه از نهایی شدن سفارش گذشته است

نمونه پاسخ خطا:

JSON

سرویس دریافت وضعیت فعلی سفارش

با استفاده از این سرویس می توانید وضعیت سفارش خود را در شرکت پستی دریافت کنید.

شناسه سرویس: 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

نمونه درخواست:

HTTP

نمونه پاسخ:

JSON

سرویس لغو سفارش

با استفاده از این وب سرویس می توانید سفارشی که قبلا ثبت شده را لغو کنید.

قبل از فراخوانی این سرویس می توانید با استفاده از سرویس دریافت جزئیات سفارش، پارامتر can_be_canceled را دریافت و بر اساس آن برای فراخوانی سرویس لغو سفارش تصمیم بگیرید. در نتیجه فراخوانی این سرویس در اکثر موارد سفارش لغو می شود، ولی گاهی اوقات امکان دارد لغو سفارش انجام نشود و سفارش در همان وضعیت باقی بماند.

شناسه سرویس: 43776

پارامترهای ورودی

توضیحات

اجباری

نوع مقدار

پارامتر

شماره سفارش مورد نظر

بله

String

orderId

توضیحات لغو سفارش

 

 

note

پارامترهای خروجی

توضیحات

نوع

پارامتر

اطلاعات اضافی

Array of

result.result.payload

شرح موفقیت یا عدم موفقیت

String

result.result.message

نمونه درخواست:

HTTP

 

نمونه پاسخ:

JSON

 

Clasor npm package version 2.1.4
به پادیوم قدرت داده اند:
pasargad
fanap
pod