物流API

1. 物流查询

1.1 接口说明：

1. 接口由宜信提供，合作方调用。
2. 合作方通过此接口获取订单的物流相关信息

1.2 接口地址：

/system/third/queryLogistics

请求参数：

参数名称	类型	是否必须	说明	描述
uid	String	是	用户UID	合作方事先在商城注册一个账号
channelId	String[50]	是	营销渠道码	双方约定好的渠道标识
orderId	String[21]	是	商城子订单号	预占订单商城返回的子订单号

1.3 响应参数：

参数名称	类型	是否必须	说明	备注
status	String	是	返回状态码	1代表成功，其余均为失败，具体参考枚举
msg	String	否	提示信息
data	String	否	成功返回订单物流信息,失败返回null	JSON格式,类型见logisticsInfo
timestamp	String	是	时间戳

== 类型见logisticsInfo ==

参数名称	类型	是否必须	说明	备注
orderId	String[21]	是	商城子订单号
companyName	String[100]	是	快递名称
companyCode	String[50]	是	快递公司编码
logisticCode	String[50]	是	快递单号
state	String	是	快递单当前签收状态,具体值参考枚举logisticsState
traces	List	是	物流轨迹详情,倒序（即时间最新的在最前）,类型参考traceInfo
remark	String	否	商家备注

== 类型见traceInfo ==

参数名称	类型	是否必须	说明	备注
ftime	String	是	物流时间
context	String	是	物流信息

logisticsState枚举

code	desc
0	在途, 快件处于运输过程中
1	揽件, 快件已由快递公司揽收
2	疑难, 快递100无法解析的状态，或者是需要人工介入的状态，比方说收件人电话错误。
3	签收, 正常签收
4	退签, 货物退回发货人并签收
5	派件, 货物正在进行派件
6	退回, 货物正处于返回发货人的途中
-1	未知状态

参数和返回值示例

成功返回

{
  "status": "1",
  "msg": "成功状态",
  "data": {
    "orderId": "12345678",
    "companyName": "京东快递",
    "companyCode": "jd",
    "logisticCode": "jd123db5645",
    "state": "5",
    "traces": [{
      "ftime": "2021-11-09 20:03:42",
      "context": "快件由【安徽芜湖转运中心】发往【北京转运中心】"
    }, {
      "ftime": "2021-11-09 20:00:41",
      "context": "快件已到达【安徽芜湖转运中心】扫描员是【房金生】"
    }, {
      "ftime": "2021-11-09 19:35:07",
      "context": "快件由【安徽芜湖公司】发往【安徽芜湖转运中心】"
    }, {
      "ftime": "2021-11-09 19:18:03",
      "context": "快件由【安徽芜湖公司】发往【安徽芜湖转运中心】"
    }, {
      "ftime": "2021-11-09 14:45:33",
      "context": "【安徽芜湖公司】的收件员【gskh日相月】已收件"
    }],
    "remark": "商家备注"
  },
  "timestamp": 1657791280109
}

失败返回

{
    "msg": "参数异常",
    "status": "1002",
    "data": null,
    "timestamp": 1657260977651
}