API
获取运单号V3.0(lma.shipment.get)
更新时间: 2019-10-25 18:09:21 访问次数:826
接口说明

卖家或第三方通过该接口获取订单跟踪号

接口英文名称

lma.shipment.get

使用场景

卖家或第三方通过该接口获取订单跟踪号

不支持有“抓取中”的物流渠道,如果下单以下渠道,只能使用lma.shipment.print获取跟踪号

若非自画面单的物流渠道,建议全部使用lma.shipment.print获取跟踪号

物流渠道编码 物流渠道名称
OSF711003533 USPS First Class Package-LMA917
OSF711003548 USPS First Class Package-LMA917
备注

  • 1.支持批量查询
    部分失败:返回部分成功,部分失败,失败list并提示每一单失败的原因
  • 2.本接口只获取跟踪号,需要同时获取跟踪号和面单,请使用获取面单(单个)V3.0或者获取面单(批量)V3.0
  • 3.若订单取消发货,此前已经获得跟踪号,也可以查询到跟踪号

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
接口名lma.shipment.get
版本3.0
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
winitOrderNos Array Y winit 订单号

请求示例
1.单个查询
									{
    "action":"lma.shipment.get",
    "app_key":"rebecca",
"client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "data":{
        "winitOrderNOs":[
            "LMA010000001124CN"
        ]
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"OWNERERP",
    "sign":"65828C74EB396261730E06BFFB123C89",
"client_sign":"2D161F37A776755DDDD338938CE90F5E",
    "sign_method":"md5",
    "timestamp":"2016-07-10 23:04:52",
    "version":"3.0"
}
2.批量查询
{
    "action":"lma.shipment.get",
    "app_key":"rebecca",
"client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "data":{
        "winitOrderNOs":[
            "LMA010000001124CN","LMA010000001197CN"
        ]
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"OWNERERP",
    "sign":"1CC79FB4C19723D15A15D13DF7F2E5E1",
"client_sign":"998D5FDC5BAD9802801A9BFFD12DA357",
    "sign_method":"md5",
    "timestamp":"2016-07-10 23:04:52",
    "version":"3.0"
}

                            
返回出参
名称 类型 必填 说明 示例
orderList
Array

结果列表
-|winitOrderNo
String(50)
YWinit订单号
-|packageLabelsArray
包裹列表
-|-|packageNum
StringY包裹编号
-|-|trackingNo
String(50)
Y运单号
-|-|statusString(50)
Y抓取成功(Y),或者失败(N)

-|-|msg
String(50)
Y失败原因

返回示例
1.单个查询结果
	{
   "code": "0",
   "msg": "操作成功",
   "data": {"orderList": [   {
      "packageLabels": [      {
         "msg": "",
         "trackingNo": "1Z68223Y0306821382",
         "packageNum": "test13",
         "status": "Y"
      }],
      "winitOrderNo": "LMA010000001124CN"
   }]}
}
2.批量查询结果
{
   "code": "0",
   "msg": "操作成功",
   "data": {"orderList":    [
            {
         "packageLabels": [         {
            "msg": "",
            "trackingNo": "1Z68223Y0321603197",
            "packageNum": "test20",
            "status": "Y"
         }],
         "winitOrderNo": "LMA010000001197CN"
      },
            {
         "packageLabels": [         {
            "msg": "",
            "trackingNo": "1Z68223Y0306821382",
            "packageNum": "test13",
            "status": "Y"
         }],
         "winitOrderNo": "LMA010000001124CN"
      }
   ]}
}
}