API
查询ISP订单详情
更新时间: 2021-08-22 17:52:55 访问次数:9170
Document
接口说明

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

请求说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
接口名isp.order.query
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
orderNo String(60) N
winit订单号
refNo

String(60)

N
卖家订单号
若唯一则返回订单信息
若不唯一则返回最新创建的非作废的订单信息)

请求示例
{
    "action":"isp.order.query",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
   "client_sign":"D066D8C800E3D22E803E06EC8C4C65BB",
    "data":{
        "orderNo":"ID15270000001060ZZ",
        "refNo":""
    },
    "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 订单状态
ISP订单状态列表
dispatchType String(1) Y 发货方式
P:Winit揽收
S:自发快递
T:卖家自送
C:中邮揽收
D:DHL揽收
warehouseName String(20) Y 验货仓
warehouseCode String(10) Y 仓库Code
shipperAddrId String(50) Y 寄件人地址ID
shipperPostCode String(50) Y 寄件人邮编
shipperCountryCode String(20) Y 寄件人国家编码
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 收件人邮箱
iossNo String(128) N IOSS
buyerCompany String(100) 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
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)
packageList.merchandiseList
transactionID String(30) N 电商平台交易ID
itemID String(30) N ebayItemID
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,
 "iossNo": "",
    "buyerCompany":"",
    "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"
  }
}

                        
若唯一,则返回订单信息 若不唯一,则返回最新创建的非作废订单