Developer Documentation
Query ISP Order

1.Description

This interface is used for seller or third-party query ISP order.

2.Scenario

This interface is used for seller or third-party query ISP order.

3.Request Information

URL

http://openapi.winit.com.cn/openapi/service

UAT
Action 
action:isp.order.query

Authentication

Token,md5

Format

json

Protocol

http,post

Rate Limitation

Default 300 requests per minute, can request increase on needs


4.Request Parameter

Name

Type

Length

Required

Description

Example

 orderNo String 60Y ISP Order Number

5.Response Parameter

Name

Type

Length

Description

Example

refNo

String

60

Reference Order Number


winitProductCodeString50Winit Product Code
expressNoString50 Tracking Number
winitProductNameString50 Winit Product Name
orderDateString(YYYY-MM-DD HH:MI:SS)20Order Date
statusString50

Order Status


dispatchTypeString10

Delivery Method

C: Pick-up by China Post   P: Pick-up by WINIT   S: By Express


warehouseNameString20Inspection Warehouse
warehouseCodeString10Warehouse Code

shipperAddrId

String

50

Shipper AddressID


shipperPostCodeString50Shipper Zipcode

shipperCountryCode

String

20

Shipper Country Code


shipperCountry

String

100

Shipper Country


shipperState

String

100

Shipper State


shipperCityString10Shipper City
shipperDistrictString
Shipper District

shipperAddress1

String

50

Shipper Address1


shipperAddress2

String

20

Shipper Address2


shipperEmail

String

30

Shipper Email


buyerName

String

10

Buyer Name


buyerContactNo

String

50

Buyer Phone Number


buyerEmail

String50Buyer Email

buyerCountry

String

20

Buyer Country


buyerStateString20Buyer State

buyerCity

String

50

Buyer City


buyerAddress1

String

100

Buyer Address1


buyerAddress2String
Buyer Address2
buyerZipCodeString
Buyer ZipCode
ebaySellerIdString60Ebay Seller Id

packageList

The following parameters are packageList child node


Package List


--| weight

Numeric(10,2)

Weight


--| length

Numeric(10,2)


Length


--| width

Numeric(10,2)


Width


--| height

Numeric(10,2)


Height


--|weightActual

Numeric(10,2)


WeightActual


--|lengthActual

Numeric(10,2)


LengthActual


--|widthActual

Numeric(10,2)


WidthActual


--|heightActualNumeric(10,2)
HeightActual
--| merchandiseListThe following parameters are merchandiseList child node
Merchandise List 
--| --|declaredNameCnString100

Declared Name

(Chinese)


--| --|declaredNameEnString100

Declared Name

(English)


--| --| declaredValueNumeric(10,2)

Declared 

Value/Price


--| --| itemIDString30Item ID
--| --| transactionIDString30Transaction ID



6.Request Example


{

    "action": "isp.order.query", 

    "app_key": "qiongjierui@163.com", 

    "data": {

        "": "", 

        "orderNo": "ID15000000004388CN"

    }, 

    "format": "json", 

    "language": "zh_CN", 

    "platform": "sw", 

    "sign": "EB8FDDFEF686D128DC9ABB127A6B500C", 

    "sign_method": "md5", 

    "timestamp": "2015-06-16 00:19:26", 

    "version": "1.0"

}


Response Example


{

    "code": "0", 

    "data": {

        "buyerAddress1": "aaaa", 

        "buyerAddress2": "s", 

        "buyerCity": "shenzhen", 

        "buyerContactNo": "11", 

        "buyerCountry": "US", 

        "buyerEmail": "", 

        "buyerName": "aa", 

        "buyerState": "gongdong", 

        "buyerZipCode": "122", 

        "ebaySellerId":"1",

        "dispatchType": "S", 

        "expressNo": "", 

        "isValid": "N", 

        "orderDate": "2015-06-11 20:05:24", 

        "orderNo": "ID15000000003683CN", 

        "packageList": [

            {

                "height": 1, 

                "heightActual": 0, 

                "length": 1, 

                "lengthActual": 0, 

                "merchandiseList": [

                    {

                        "declaredNameCn": "iphone6", 

                        "declaredNameEn": "iphone6", 

                        "declaredValue": 1, 

                        "itemID": "1", 

                        "transactionID": "1"

                    }

                ], 

                "weight": 1, 

                "weightActual": 0, 

                "width": 1, 

                "widthActual": 0

            }

        ], 

        "refNo": "", 

        "shipperAddrId": 266, 

        "shipperAddress1": "shen zheng shi gao xin nan", 

        "shipperAddress2": "shen zheng shi gao xin nan", 

        "shipperCity": "shen zheng", 

        "shipperCountry": "China", 

        "shipperCountryCode": "CN", 

        "shipperEmail": "", 

        "shipperPostCode": "518000", 

        "shipperState": "Guang Dong", 

        "status": "PD", 

        "warehouseCode": "SZ0001", 

        "warehouseName": "ShenZhen  Warehouse", 

        "winitProductCode": "PPTestProduct", 

        "winitProductName": "cs chan ping"

    }, 

    "msg": "OPERATION SUCCESS"

}


Response Description


Success response:ISP order information.

Error response:Error code, Error message