API
查询订单(详情)
更新时间: 2019-11-06 14:33:30 访问次数:2986
接口说明

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

接口英文名称

isp.order.query

使用场景

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

备注
状态中文名订单状态编码(status)
未提交PD
已提交WFD
确认发货WFR
已揽收CFS
已打包PC
已出库AO
作废VO
货物未收到PUF
订单异常EX

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
orderNo String(60) Y ISP 订单号
请求示例
{
    "action":"isp.order.query",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
   "client_sign":"D066D8C800E3D22E803E06EC8C4C65BB",
    "data":{
        "orderNo":"ID15270000001060ZZ"
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"OWNERERP",
    "sign":"88C82AFB6196BDF25B5710A8BAAAB7BF",
    "sign_method":"md5",
    "timestamp":"2015-06-16 00:19:26",
    "version":"1.0"
}

                        
返回出参
名称 类型 必填 说明 示例
refNo String(60) Y 卖家订单号
winitProductCode String(50) Y winit产品编码,即物流产品代码
winitProductName String(50) Y winit产品名称
expressNo String(50) Y 跟踪号
orderDate String(YYYY-MM-DD HH:MI:SS)(20) Y 下单时间
status String(50) Y 订单状态
dispatchType String(1) Y 发货方式【P:Winit揽收、S:自发快递、T:卖家自送、C:中邮揽收、D:DHL揽收】,不同物流渠道要求与提交的“寄件/提货地址“的审核情况而定,审核通过选择【Winit揽收】,审核不通过使用【自发快递、卖家自送】,其它2个是特殊渠道的揽收方式
warehouseName String(20) Y 验货仓
warehouseCode String(10) Y 仓库Code
shipperAddrId String(50) Y 寄件人地址ID
shipperPostCode String(50) Y 寄件人邮编
shipperCountryCode String(20) Y 寄件人国家code
shipperCountry String(100) Y 寄件人国家
shipperState String(100) Y 寄件人州
shipperCity String(10) Y 寄件人城市
shipperDistrict String(50) Y 寄件人区(县)
shipperAddress1 String(50) Y 寄件人地址1
shipperAddress2 String(20) Y 寄件人地址2
shipperEmail String(30) Y 寄件人邮箱
buyerName String(50) Y 收件人名字
buyerContactNo String(20) Y 收件人电话
buyerEmail String(30) N 收件人邮箱
buyerCountry String(50) Y 收件人国家
buyerState String(20) Y 收件人州
buyerCity String(50) Y 收件人城市
buyerAddress1 String(100) Y 收件人地址1
buyerAddress2 String(100) N 收件人地址2
buyerZipCode String(10) Y 收件人邮编
buyerHouseNo String(10) N 收件人门牌号
ebaySellerId String(60) N ebay卖家ID(eBay订单必填)
packageList Array 包裹列表,以下字段为packageList子节点
--|weight Numeric(6,2) Y 重量(KG)
--|length Numeric(6,2) Y 长(CM)
--|width Numeric(6,2) Y 宽(CM)
--|height Numeric(6,2) Y 高(CM)
--|weightActual Numeric(6,2) Y 实际重量(KG)
--|lengthActual Numeric(6,2) Y 实际长(CM)
--|widthActual Numeric(6,2) Y 实际宽(CM)
--|heightActual Numeric(6,2) Y 实际高(CM)
-|merchandiseList Y 商品列表,以下字段为merchandiseList子节点
--|--|transactionID String(30) N 交易ID(eBay订单必填)
--|--|itemID String(30) N 条目ID(eBay订单必填)
--|--|declaredValue Numeric(10,2) Y 单个商品申报价格(USD)
--|--|declaredNameCn String(100) Y 申报品名(中文)
--|--|declaredNameEn String(100) Y 申报品名(英文)

正确的返回结果:isp订单信息。 错误的返回结果:错误码,错误信息

返回示例
{
  "code": "0",
  "msg": "操作成功",
  "data": {
    "refNo": "ugreen3",
    "dispatchType": "S",
    "expressNo": "AT060318453312CN",
    "buyerEmail": "abc@winit.com.cn",
    "winitProductName": "优邑专线-英国达(可跟踪)内部渠道LMA",
    "occurTime": null,
    "buyerAddress1": "abcTest",
    "buyerAddress2": "",
    "shipperCountry": "China",
    "source": "OWNERERP",
    "shipperCity": "SHENZHEN",
    "warehouseName": "深圳ISP仓",
    "warehouseCode": "YW10000008",
    "buyerZipCode": "BL51BT",
    "shipperCountryCode": "CN",
    "buyerContactNo": "13800001111",
    "rmk": null,
    "buyerCity": "Bolton",
    "buyerHouseNo": "1",
    "shipperEmail": "45678@outluk.com",
    "shipperState": "GUANGDONG",
    "storeType": null,
    "orderNo": "ID15270000001060ZZ",
    "shipperAddress1": "pingan build 5005",
    "isValid": "Y",
    "shipperAddress2": null,
    "buyerState": "NorthWest",
    "buyerName": "COCO",
    "packageList": [
      {
        "declaredTotalValue": 10.23,
        "merchandiseList": [
          {
            "itemID": "110",
            "hsCode": null,
            "goodsLocation": "",
            "declaredNameEn": "test1",
            "declaredNameCn": "测试1",
            "merchandiseCode": "2222",
            "merchandiseQuantity": 1,
            "transactionID": "1234567890",
            "declaredValue": 10.23,
            "ebayItemPrice": 0.00
          }
        ],
        "trackingNo": "AT060318453312CN",
        "length": 2.00,
        "width": 1.23,
        "weight": 1.2300,
        "widthActual": 0.00,
        "heightActual": 0.00,
        "lengthActual": 0.00,
        "weightActual": 0.0000,
        "height": 1.23
      }
    ],
    "buyerCountry": "UK",
    "trackingNo": "AT060318453312CN",
    "shipperAddrCode": "20190036",
    "winitProductCode": "ISP041450",
    "shipperDistrict": "FUTIANQU",
    "orderDate": "2019-09-11 18:46:03",
    "shipperPostCode": "518000",
    "ebaySellerId": "bessky_cn",
    "status": "WFD"
  }
}