开发者文档
查询ISP订单

1.接口说明

卖家或第三方通过该接口可查询ISP订单。

2.使用场景

卖家或第三方通过该接口可查询ISP订单。

 

3.请求说明

URL

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

接口测试

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

请求方法

action:isp.order.query

验证方式

Token,md5

格式

json

字符编码UTF-8

http请求方式

http,post

请求数限制

默认每分钟300,有需要可以申请加大

4.请求入参

名称

类型

必填

说明

示例

 orderNo

 String(60)

Y

 ISP 订单号


5.返回出参

名称

类型

说明

示例

refNo

String(60)

卖家订单号


winitProductCode

String(50)

winit产品编码


expressNo

String(50)

跟踪号


winitProductName

String(50)

winit产品名称


orderDate

String(YYYY-MM-DD   HH:MI:SS)(20)

下单时间


status

String(50)

订单状态


dispatchType

String(10)

发货方式

C:中邮揽收  P:winit揽收  S:自发快递


warehouseName

String(20)

验货仓


warehouseCode

String(10)

仓库Code


shipperAddrId

String(50)

寄件人地址ID


shipperPostCode

String(50)

寄件人邮编


shipperCountryCode

String(20)

寄件人国家code


shipperCountry

String(100)

寄件人国家


shipperState

String(100)

寄件人州


shipperCity

String(10)

寄件人城市


shipperDistrict

String

寄件人区(县)


shipperAddress1

String(50)

寄件人地址1


shipperAddress2

String(20)

寄件人地址2


shipperEmail

String(30)

寄件人邮箱


buyerName

String(10)

收件人姓名


buyerContactNo

String(50)

收件人电话


buyerEmail

String(50)

收件人邮箱


buyerCountry

String(20)

收件人国家


buyerState

String(20)

收件人州


buyerCity

String(50)

收件人城市


buyerAddress1

String(100)

收件人地址1


buyerAddress2

String()

收件人地址2


buyerZipCode

String()

收件人邮编


buyerHouseNo

String()

收件人门牌号


ebaySellerId

String(60)

ebay卖家ID


packageList

以下字段为packageList子节点

包裹列表


--| weight

Numeric(10,2)

重量(kg)


--| length

Numeric(10,2)

(cm)


--| width

Numeric(10,2)

(cm)


--| height

Numeric(10,2)

(cm)


--|weightActual

Numeric(10,2)

重量(实际)(kg)


--|lengthActual

Numeric(10,2)

长(实际)


--|widthActual

Numeric(10,2)

宽(实际)(cm)


--|heightActual

Numeric(10,2)

高(实际)(cm)


--| merchandiseList

以下字段为merchandiseList子节点

商品列表


--| --|declaredNameCn

String(100)

申报品名(中文)


--| --|declaredNameEn

String(100)

申报品名(英文)


--| --| declaredValue

Numeric(10,2)

申报价值


--| --| itemID

String(30)

产品号


--| --| transactionID

String(30)

交易号



6.请求示例

{
    "action":"isp.order.query",
    "app_key":"rebecca",
    "data":{
        "orderNo":"ID15051107911757CN"
    }
,
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"00000000000000000000000000000000",
    "sign_method":"md5",
    "timestamp":"2015-06-16 00:19:26",
    "version":"1.0"
}

返回结果示例

{
    "code":"0",
    "data":{
        "buyerAddress1":"aaaa",
        "buyerAddress2":"s",
        "buyerCity":"深圳",
        "buyerContactNo":"11",
        "buyerCountry":"US",
        "buyerEmail":"",
        "buyerName":"aa",
        "buyerState":"广东",
        "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":"苹果6",
                        "declaredNameEn":"iphone6",
                        "declaredValue":1,
                        "itemID":"1",
                        "transactionID":"1"
                    }

                ]
,
                "weight":1,
                "weightActual":0,
                "width":1,
                "widthActual":0
            }

        ]
,
        "refNo":"",
        "shipperAddrId":266,
        "shipperAddress1":"深圳市南山区高新南一道创维大厦",
        "shipperAddress2":"深圳市南山区高新南一道创维大厦",
        "shipperCity":"深圳",
        "shipperCountry":"China",
        "shipperCountryCode":"CN",
        "shipperEmail":"",
        "shipperPostCode":"518000",
        "shipperState":"Guang Dong",
        "status":"PD",
        "warehouseCode":"SZ0001",
        "warehouseName":"ShenZhen Warehouse",
        "winitProductCode":"PPTestProduct",
        "winitProductName":"测试产品勿动1"
    }
,
    "msg":"操作成功"
}

 

返回参数说明

 

正确的返回结果:isp订单信息。

错误的返回结果:错误码,错误信息


错误代码错误信息(中文)错误信息(英文)解决方案
2010250001字段[orderNo]不能为空The field[orderNo] can not null填写相应字段值后重新请求
1010250001系统错误System error联系客服或Winit IT处理
1010250002服务访问异常Service access exception稍后重新发起请求,如长时间出现此问题请联系Winit IT
1030240001系统异常,请您稍后重试或联系客服处理System is abnormal, Please try   again later or contact customer service processing稍后重新发起请求,如长时间出现此问题请联系Winit IT