Developer Documentation
Create ISP Order (China Import)

1.Description

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

2.Scenario

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

3.Request Information


URL

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

UAT
Action 
action:isp.order.createISPImport

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

transactionIDString32Y

Transaction

 ID


paymentTransactionIDString32Y

Payment 

Transaction

 ID


refNo

String

60

N

Reference Order Number

Defined by seller (repetition is not allowed)
winitProductCodeString50Y

Winit

Product 

Code


warehouseIDInteger10Y
SarehouseID

buyerName

String

50

Y

Buyer Name


buyerContactNo

String

20

Y

Buyer Phone Number


buyerEmail

String

60

N

Buyer Email


buyerZipCode

String

10

Y

Buyer ZipCode


buyerCountryCode

String

50

Y

Buyer Country Code

China:CN

 United States:US

buyerState

String

20

Y

Buyer State


buyerCity

String

50

Y

Buyer City


buyerAddress1

String

100

Y

Buyer Address1


buyerAddress2

String

100

N

Buyer Address2


buyerHouseNoString10N

Buyer

House No


buyerCitizenIdNumeber

String32NBuyer Citizen Id Numeber

shipperAddrId

Integer

11


Shipper Address1 

Id

 If shipper address ID is blank, the shipper's name, address, phone number, postcode, country code, country name, state code, state name and city are required.

shipperAddrString100

Shipper 

Address

If shipper address ID is blank, are required.

shipperName

String

50


Shipper Name

If shipper address ID is blank, are required.

shipperContactNo

String

20


Shipper Phone Number

If shipper address ID is blank, are required.

shipperEmail

String

60

N

Shipper Email


shipperZipCode

String

10


Shipper ZipCode

If shipper address ID is blank, are required.

shipperCountry

String

50


Shipper Country

If shipper address ID is blank, are required.

shipperCountryCode

String

50


Shipper CountryCode

If shipper address ID is blank, are required.

shipperState

String

20


Shipper State

If shipper address ID is blank, are required.

shipperStateCode

String

20


Shipper State Code

If shipper address ID is blank, are required.

shipperCity

String

50


Shipper City

If shipper address ID is blank, are required.
currencyString10YCurrency of total transaction cost
totalAmountNumeric(10,2)
YTotal transaction cost (inclusive of freight cost)
expressNoList

The following parameters are expressNoLis

tchild node


N

expressNo

List


-|expressNoString32NExpress No
orderLineList

The following parameters are 

orderLineList

tchild node


YPackage List
-|grossWeightNumeric(10,2)
YPackage Weight
-|merchandiseList

The following parameters are 

merchandiseList

tchild node



YmerchandiseList
-|-|productCodeString32YProduct Code
-|-|specificationString60YProduct Specification
-|-| quantityInteger11YQuantity
-|-| salePriceNumeric(10,2)
YSale Price
-|-| currencyString10YCurrency
-|-| extraGiftString1YIs GiftEither "Y" or "N" shall be input
-|-| brandNameString32YBrand Name


5、Response Parameter

Name

Type

Length

Description

Example

codeString10Response Message Code
msgString100Response Message Description
orderNo String 60 ISP Order NumberReturn order number when success, otherwise will oly return message code.

6、Request Example

{

    "action": "isp.order.createISPImport", 

    "app_key": "rebecca", 

    "data": [

    {

        "transactionID": "T000122222", 

        "paymentTransactionID": "P000sdf1wujiaohua", 

        "refNo":"TID00001",

        "warehouseID": 1000003, 

        "winitProductCode": "IM-USPEK01", 

        "buyerName": "Test.Winit", 

        "buyerContactNo": "13800001111", 

        "buyerEmail": "winit@winit.com",       

        "buyerZipCode": "518000",

        "buyerCountryCode": "CN",

        "buyerState": "Guang Dong", 

        "buyerCity": "Shen Zhen",

        "buyerAddress1": "chuangwei", 

        "buyerAddress2": "chuangwei", 

        "buyerHouseNo": "605",

        "buyerCitizenIdNumeber": "ID00001", 

        "shipperAddrId": "1000000",

        "shipperEmail":"winit@winit.com"

        "expressNoList":[

               {"expressNo":"ex0329932"},

               {"expressNo":"ex0329932"}

        ],

        "orderLineList": [

            {

            "grossWeight": "1.25", 

            "merchandiseList":[

               {

                "productCode": "sku001",  

                "specification": "specification", 

                "quantity": "10", 

                "salePrice": "12.99", 

                "currency": "USD",

                "extraGift": "N",

                "brandName": "NIKE"

               }

                ]

            }

        ]

    } 

    ],

    "format": "json", 

    "language": "zh_CN", 

    "platform": "API", 

    "sign": "00000000000000000000000000000000", 

    "sign_method": "md5", 

    "timestamp": "2014-06-19 18:03:48", 

    "version": "1.0"

}

Note: If shipper address ID is blank, the shipper's name, address, phone number, postcode, country code, country name, state code, state name and city are required.

     Replace "shipperAddrId" with the following string: "1000000":

     "shipperAddr": "chuangwei",

     "shipperName": "Lee.Chen",

     "shipperContactNo": "17777777777",

       "shipperZipCode": "900001",

       "shipperCountry": "United States of America",

       "shipperCountryCode": "US",

       "shipperState": "California",

       "shipperStateCode": "CA",

       "shipperCity": "LA",

    

Response Example

{

   "code": "0",

   "msg": "OPERATION SUCCESS",

   "data": {"orderNo": "ID15000000007938CN"}

}

Response Description


Success response:Outbound order number.

Error response:Error code, Error message