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

[saeedkh 10]

با سلام

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

راهنمای استفاده از وب سرویس خرید ایران مارکت سنتر

این مستند بعنوان راهنمای استفاده از سرویس وب خرید اینترنتی ایران مارکت سنتر می باشد و مخاطب آن برنامه نویسانی هستند که آشنا به مفاهیم تکنولوژی SOAP بوده و نحوه ایجاد یک SOAP Client را با زبانی که مسلط به آن هستند بدانند. البته مثالهای کاربردی با زبان PHP و Asp.net در ادامه ارائه شده است. ایران مارکت سنتر خود را موظف به ارائه صحیح سرویس وب می داند و هیچ تعهدی برای نصب، پیکربندی و راه اندازی SOAP Client بر روی سرویس دهنده های دیگر ندارد و در صورت نیاز مشتری، طبق قرارداد جداگانه قابل انجام است.

برای مشاهده تغییراتی که با اضافه شدن استان البرز باید در تنظیمات خود اعمال نمایید روی اینجا کلیک کنید

آدرس سرویس وب

آدرس WSDL سرویس وب خرید ایران مارکت سنتر : http://www.imcbasket.com/Webservice/wsdl.php

عملیاتها و پارامترها

متد GetSendPrice

جهت دریافت هزینه پستی از این متد استفاده می شود. در جدول زیر پارامترهای ورودی این متد آورده شده است. مقدار بازگشتی این متد "هزینه ارسال" می باشد.

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

نام پارامتر نوع پارامتر توضیح

ProductSumPrice* String این پارامتر حاوی مجموع قیمت کالا ها می باشد

ProductSumWeight* String این پارامتر حاوی مجموع وزن کالا ها می باشد

OstanId Int این پارامتر حاوی شناسه استان مقصد می باشد(مطابق دستورالعمل)

ShahrId Int این پارامتر حاوی شناسه شهر مقصد می باشد(مطابق دستورالعمل)

SendType* Int عددی که نوع ارسال را مشخص می کند

0 : پیشتاز

1 : سفارشی

2 : پیک موتوری

خروجی

نوع توضیح

String هزینه ارسال

متد RegisterOrder

جهت ثبت سفارش از این متد استفاده می شود. در جدول زیر پارامترهای ورودی این متد آورده شده است. مقدار بازگشتی این متد "کد رهگیری سفارش" می باشد.

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

نام پارامتر نوع پارامتر توضیح

Name* String نام خریدار

LastName * String نام خانوادگی خریدار

Company String نام شرکت خریدار

JobTel * String تلفن محل کار خریدار

HomeTel * String تلفن خانه خریدار

Mobile * String تلفن همراه خریدار

Email String ایمیل خریدار

ZipCode String کد پستی خریدار

Address * String آدرس خریدار

Comment String توضیحات خریدار

OstanId * Int شناسه استان (طبق دستورالعمل)

ShahrId* Int شناسه شهر (طبق دستور العمل)

Orders* String لیست سفارشات (طبق دستور العمل)

SendType* Int عددی که نوع ارسال را مشخص می کند

0 : پیشتاز

1: سفارشی

2 : پیک موتوری

Discount Int تخفیف

0 : تخفیف اعمال نشود

1: تخفیف اعمال شود

(پیش فرض 0)

(تنظیمات تخفیف داخل پنل)

خروجی

نوع توضیح

String کد رهگیری سفارش

متد GetState

جهت دریافت وضعیت سفارش از این متد استفاده می شود. در جدول زیر پارامترهای ورودی این متد آورده شده است. مقدار بازگشتی این متد "عدد وضعیت سفارش" می باشد.

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

نام پارامتر نوع پارامتر توضیح

FactorKey* String شناسه سفارش مورد نظر

خروجی

نوع توضیح

int وضعیت سفارش

0 - معلق

1 - آماده به ارسال

2 - ارسال شده

3 - توزیع شده

4 - وصول شده

5 - برگشتی

6 - انصرافی

متد GetMultiStates

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

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

نام پارامتر نوع پارامتر توضیح

FactorKeyStr* String شناسه سفارشات مورد نظر

factor1^factor2^factor3^...

خروجی

نوع توضیح

String رشته ای به صورت زیر

factor1,state1^factor2,state2^...

وضعیت سفارش (state)

0 - معلق

1 - آماده به ارسال

2 - ارسال شده

3 - توزیع شده

4 - وصول شده

5 - برگشتی

6 - انصرافی

متد TotalOrders

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

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

نام پارامتر نوع پارامتر توضیح

State* Int عدد وضعیت مورد نظر

وضعیت سفارش (state)

0 - معلق

1 - آماده به ارسال

2 - ارسال شده

3 - توزیع شده

4 - وصول شده

5 - برگشتی

6 - انصرافی

خروجی

نوع توضیح

Int تعداد سفارش

شناسه استان و شناسه شهر

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

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

این کد در آدرس زیر قرار دارد :

(توجه : با توجه به اضافه شدن استان البرز به لیست استانها از این پس از فایل city2.js بجای city.js استفاده کنید و onchange لیست شهر ها را بهonchange='ldMenu(this.value);') تغییر دهید

http://www.imcbasket.com/city2.js

نمونه ای از استفاده از این فایل را در زیر می بینید :

استان : شهر :

لیست سفارشات

لیست سفارشات ، لیست کالاهایی است که توسط مشتری ای که شما مشخصات آن را برای ما ارسال نمودید ، خریداری شده است

• مشخصات هر کالا از دیگری با استفاده از ; (سمی کالن) جدا می گردد

• اطلاعات ارسالی برای هر کالا عبارتند از : شناسه کالا ، نام کالا ، قیمت کالا ، وزن کالا و تعداد کالا که با استفاده از علامت ^ از هم جدا گردیده اند

id^name^price^weight^count;

خطاها

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

کد خطا توضیح خطا

1 نام کاربری یا رمز عبور صحیح نیست

2 اشتباه در ارسال محصولات(استفاده از ; بعد در توضیحات محصول الزامی است)

3 اشتباه در شناسه شهر و استان

4 وارد کردن نام و نام خانوادگی و آدرس الزامی است

5 حداقل یک شماره تلفن قید شود

6 ایمیل بدرستی وارد نشده است

7 مشخصات کالا صحیح نیست

8 نوع ارسال بدرستی انتخاب نشده است

9 شناسه سفارش معتبر نیست

نمونه کد پی اچ پی

PHP Sample Code :

$option=array('login'=> "PanelUsername",'password'=> "WebServicePassword");

$client = new SoapClient("http://www.imcbasket.com/Webservice/wsdl.php",$option);

try{

$response = $client->GetSendPrice(30000,200,51,8,0);

$response = $client->RegisterOrder( "man" , "human" , "05111234567" , "05117654321" , "1234567" , "123456789" , "human@example.com" ,"56789" , "mashhad" , "hello" ,"41" ,"14" ,"49^Windows Vista Home Edition^25000^100^1" , 0 );

echo $response;

}

catch (SoapFault $sf) {

echo $sf->faultcode."\n";

echo $sf->faultstring."\n";

}

نمونه کد ای اس پی دات نت

Asp.Net Sample Code:

Dim irmc As New info.webimc.www.ShoppingService

irmc.Credentials = New System.Net.NetworkCredential("PanelUsername", "WebServicePassword");

Return irmc.GetSendPrice(30000,200,51,8,0);

Return irmc.RegisterOrder( "man" , "human" , "05111234567" , "05117654321" , "1234567" , "123456789" , "human@example.com" , "56789" , "mashhad" , "hello" ,"41" ,"14" ,"49^Windows Vista Home Edition^25000^100^1" , 0 );