Developer Documentation
Create Shipping Notice(China Import)

1.Description

You can create shipping notification using this interface. For each request, only one shipping notification associated with multiple ISP orders can be created.

2.Scenario

You can create shipping notification using this interface. For each request, only one shipping notification associated with multiple ISP orders can be created.

3.Request Information

URL

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

UAT
Action 
action:isp.dispatchNoticeOrder.create

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

Number

110

Y

ISP Order Number, which is associated with shipping notice

Data Type: Array



inspWarehouseID

Integer


Y

Inspection Warehouse ID


shippingType

String

16

Y

Shipping Type


dateExpectFrom

Date(YYYY-MM-DD HH24:mi:ss)


N

Pickup Date From (Required When ShippingType Is Pickup)


dateExpectTo

Date(YYYY-MM-DD HH24:mi:ss)


N

Pickup Expire Date (Required When ShippingType Is Pickup)


express

String

32

N

Carrier Name (Required When ShippingType Is Logistic)


trackingNo

String

32

N

Package Tracking Number (Required When ShippingType Is Logistic)


email

String

32

N

Contact Email


contact

String

32

N

Contact Person (Required When ShippingType Is Pickup)


phoneNo

String

32

N

Contact Person Phone Number (Required When ShippingType Is Pickup)


countryNameString32NCountry Name
provinceNameString32NProvince Name
cityNameString32NCity Name

pickupAddress

String

128

N

Pickup Address


pickupAddressIDInteger
N

Pickup AddressID (When ShippingType Is Picup, Country, Province and

 City Couldn't Be All Empty)


zipCode

String

32

N

Zipcode


5、Response Parameter

Name

Type

Length

Description

Example

dispatchNoticeOrderNo

String32Shipping Notice Order Number


6、Request Example

{

    "action": "isp.dispatchNoticeOrder.create",

    "app_key": "rebecca",

    "data": {

        "orderNo":[

            {

                "documentNo": "ID15000000034385CN"

            }

        ],

      "inspWarehouseID": "1000003",

        "shippingType": "P",

        "dateExpectFrom": "2015-03-22 23:22:03",

        "dateExpectTo": "2015-03-23 23:22:03",

        "express":"sf",

        "trackingNo": "rerer",

        "email": "gjeo@rd.gfw",

        "contact": "mingbao",

        "phoneNo": "df",

        "countryName": "China",

        "provinceName": "GuangDong",

        "cityName": "ShenZhen", 

        "pickupAddress": "aaa",

        "pickupAddress":"12333",

        "zipCode": '1000001'

    },

    "format": "json",

    "language": "zh_CN",

    "platform": "I65",

    "sign": "00000000000000000000000000000000",

    "sign_method": "md5",

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

    "version": "1.0"

}



Response Example


{

   "code": "0",

   "msg": "OPERATION SUCCESS",

   "data": {"dispatchNoticeOrderNo": "IF15000000000163CN"}

}




Response Description


Success response:Shipping Notice Order Number.

Error response:Error code, Error message