Developer Documentation
Create ISP Order New

1.Description

This interface is used for seller or third-party create ISP order, each time only can create one ISP order. .

2.Scenario

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

3.Request Information

URL

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

UAT
Action 
action:isp.order.createOrder

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

refNo

String

60

N

Seller's order number


winitProductCode

String

60

Y

Winit Product Code


warehouseCode

String

10

Y

Warehouse Code

If [Shipping Mode] is "By Express", the [Warehouse Code] is required; Otherwise, it is optional.

If [Shipping Mode] is "Other", the default warehouse bound with [Shipper Address Code] will be automatically used for [Warehouse Code].


dispatchType

String


Y

Delivery Method

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


(Pick-up by China Post can only be used for China Post products)



shipperAddrCode

String

8

Y

Shipper Address Code


buyerName

String

50

Y

Buyer Name


buyerContactNoString20Y

Buyer Phone

 Number


buyerEmail

String

30

N

Buyer Email


buyerZipCode

String

10

Y

Buyer Email


buyerCountry

String

50

Y

Buyer Country


buyerStateString20YBuyer State

buyerCity

String

50

Y

Buyer City


buyerAddress1

String

100

Y

Buyer Address1


buyerAddress2

String

100

N

Buyer Address2


ebaySellerIdString
60N

Ebay Seller IdChina Post Product is required


buyerHouseNo
String
10
N

Buyer House

 Number


          packageList

The following parameters are packageList

child node


Y

Package List


-|packageDesc

String

60

Y

Package Description


-|weight

Numeric(10,2)


Y

Weight(KG)


-|length

Numeric(10,2)


Y

Length(CM)


-|width

Numeric(10,2)


Y

Width(CM)


-|height

Numeric(10,2)


N

Height(CM)


-|merchandiseList

The following parameters are merchandiseListchild node


Y

merchandise List


-|-|transactionID

String

30

N

Transaction ID(China Post Product is required)


-|-|itemID

String

30

N

Item ID(China Post Product is required)


-|-|declaredValue

Numeric(10,2)


Y

Declared Value/Price(USD)


-|-|declaredNameCn

String

100

Y

Declared Name(Chinese)


-|-|declaredNameEn

String

100

Y

Declared Name(English)




 

 

5、Response Parameter

Name

Type

Length

Description

Example

 orderNo String 60 ISP Order Number
 trackingNo String 60 Tracking number

6、Request Example

{
   "action": "isp.order.createOrder", 
   "app_key": "qiongjierui@163.com", 
   "data": {
       "buyerAddress1": "abc", 
       "buyerAddress2": "", 
       "buyerCity": "CA", 
       "buyerContactNo": "13800001111", 
       "buyerCountry": "US", 
       "buyerEmail": "abc@winit.com.cn", 
       "buyerHouseNo": "1", 
       "buyerName": "abc", 
       "buyerState": "LA", 
       "buyerZipCode": "123", 
       "dispatchType": "C", 
       "packageList": [
           {
               "height": "1.23", 
               "length": "1.23", 
               "merchandiseList": [
                   {
                       "declaredNameCn": "苹果手机", 
                       "declaredNameEn": "ihpone", 
                       "declaredValue": "10.23", 
                       "itemID": "I000000001", 
                       "transactionID": "T00000001"
                   }
               ], 
               "weight": "1.23", 
               "width": "1.23"
           }
       ], 
       "refNo": "a1001", 
       "shipperAddrCode": "WK0001", 
       "warehouseCode": "SZ0001", 
       "winitProductCode": "WP-CNP002"
   }, 
   "format": "json", 
   "language": "zh_CN", 
   "platform": "", 
   "sign": "5FA151D5105408AE36AFE2E768959402", 
   "sign_method": "md5", 
   "timestamp": "", 
   "version": "1.0"
}


Response Example

{

   "code": "0",

OPERATION SUCCESS

   "data": {"orderNo": "ID15000000007938CN","trackingNo":"0000001"}

}

Response Description


Success response:Outbound order number,trackingNo.

Error response:Error code, Error message