物流服务接口

接口列表

接口名称	接口描述
app.express.getExpressCompany	获取物流公司列表
app.express.getNewExpress	获取最新退换货物流信息
app.express.getRefundExpress	获取退换货物流信息

接口描述

1、获取物流公司列表(app.express.getExpressCompany)

请求参数

Param Name	Param Type	Required	Param Value	Desc
method	String	true	app.express.getExpressCompany	请求方法
status	int	false	1(默认值)	物流公司启用状态 1开启，0关闭 默认开启

响应内容 按公司首字母排序

{
  "code": 200,
  "data": {
    "E": [
      {
        "company_alif": "E",
        "company_code": "ems",
        "company_name": "南京ems",
        "company_name_substr": "南京ems",
        "id": 2,
        "is_first": "Y"
      }
    ],
    "H": [
      {
        "company_alif": "H",
        "company_code": "huitongkuaidi",
        "company_name": "汇通快运",
        "company_name_substr": "汇通快运",
        "id": 37,
        "is_first": "Y"
      }
    ],
    "J": [
      {
        "company_alif": "J",
        "company_code": "jd",
        "company_name": "京东快递",
        "company_name_substr": "京东快递",
        "id": 46,
        "is_first": "Y"
      }
    ],
    "S": [
      {
        "company_alif": "S",
        "company_code": "shunfeng",
        "company_name": "顺丰",
        "company_name_substr": "顺丰",
        "id": 23,
        "is_first": "Y"
      },
      {
        "company_alif": "S",
        "company_code": "shentong",
        "company_name": "申通",
        "company_name_substr": "申通",
        "id": 36,
        "is_first": "N"
      }
    ],
    "T": [
      {
        "company_alif": "T",
        "company_code": "tonghetianxia",
        "company_name": "通和天下",
        "company_name_substr": "通和天下",
        "id": 30,
        "is_first": "Y"
      }
    ],
    "Y": [
      {
        "company_alif": "Y",
        "company_code": "yuantong",
        "company_name": "圆通",
        "company_name_substr": "圆通",
        "id": 29,
        "is_first": "Y"
      },
      {
        "company_alif": "Y",
        "company_code": "youshuwuliu",
        "company_name": "优速快递",
        "company_name_substr": "优速快递",
        "id": 32,
        "is_first": "N"
      },
      {
        "company_alif": "Y",
        "company_code": "yunda",
        "company_name": "韵达",
        "company_name_substr": "韵达",
        "id": 39,
        "is_first": "N"
      }
    ],
    "Z": [
      {
        "company_alif": "Z",
        "company_code": "zhaijisong",
        "company_name": "南京ZJS",
        "company_name_substr": "南京ZJS",
        "id": 5,
        "is_first": "Y"
      }
    ]
  },
  "md5": "c773c50ba3acedff6feacace3f95e468",
  "message": "物流公司"
}

响应内容描述

Param Name	Param Type	Desc
company_alif	String	物流公司首字母
company_code	String	物流公司编码
company_name	String	物流公司名称
company_name_substr	String	物流公司子字符串
id	int	物流公司ID
is_first	String	是否首次

2、获取最新退换货物流信息(app.express.getNewExpress)

请求参数

Param Name	Param Type	Required	Param Value	Desc
method	String	true	app.express.getNewExpress	请求方法
id	int	true	428106	退换货申请ID
uid	int	true	362719	用户ID
type	String	true	refund	类型 （退货：refund,换货：change）

响应内容 按公司首字母排序

{
    "code": 200,
    "message": "成功获取物流信息",
    "data": {
        "url": "http://www.ems.com.cn/",
        "logo": "http://img12.static.yhbimg.com/taobaocms/2015/08/17/07/02fa410769cbbc3c4b59d6a804a3b8d98e.png",
        "caption": "南京ems",
        "is_support": "3",
        "express_number": "44323566",
        "express_detail": []
    },
    "md5": "3fc5f5f1ea744d14ad4c4ae54e7cf143"
}

响应内容描述

Param Name	Param Type	Desc
url	String	物流公司网址
logo	String	物流公司logo
caption	String	物流公司名称
is_support	String	返回状态(1:查询到物流信息 2:不支持物流公司 3:没有找到物流信息)
express_number	String	快递单号
express_detail	json数组	物流详情

3、获取退换货物流信息(app.express.getRefundExpress)

请求参数

Param Name	Param Type	Required	Param Value	Desc
method	String	true	app.express.getRefundExpress	请求方法
express_id	int	true	23	快递公司ID
express_number	String	true	800481228670	快递单号

响应内容 按公司首字母排序

{
  "code": 200,
  "data": [
    {
      "acceptTime": "2014-12-06 12:38:24",
      "accept_address": "客户 签收人: 林汐 已签收",
      "express_id": 3,
      "express_number": "800481228670",
      "order_code": 412506421
    },
    {
      "acceptTime": "2014-12-06 08:58:31",
      "accept_address": "北京市通州区城区公司 派件人: 徐宏博 派件中 派件员电话18911353205",
      "express_id": 3,
      "express_number": "800481228670",
      "order_code": 412506421
    },
    {
      "acceptTime": "2014-12-06 07:51:43",
      "accept_address": "快件到达 北京市通州区城区公司",
      "express_id": 3,
      "express_number": "800481228670",
      "order_code": 412506421
    },
    {
      "acceptTime": "2014-12-05 18:28:25",
      "accept_address": "北京转运中心公司 已发出,下一站 北京市通州区城区",
      "express_id": 3,
      "express_number": "800481228670",
      "order_code": 412506421
    },
    {
      "acceptTime": "2014-12-05 18:26:21",
      "accept_address": "快件到达 北京转运中心公司",
      "express_id": 3,
      "express_number": "800481228670",
      "order_code": 412506421
    },
    {
      "acceptTime": "2014-12-04 19:44:16",
      "accept_address": "江苏省南京市雨花区板桥公司 已打包,发往下一站 北京转运中心",
      "express_id": 3,
      "express_number": "800481228670",
      "order_code": 412506421
    },
    {
      "acceptTime": "2014-12-04 18:44:41",
      "accept_address": "快件到达 江苏省南京市雨花区板桥公司",
      "express_id": 3,
      "express_number": "800481228670",
      "order_code": 412506421
    }
  ],
  "md5": "74b36d9c9b9ff658eac1b46c196dbc99",
  "message": "物流信息"

响应内容描述

Param Name	Param Type	Desc
acceptTime	String	运货单创建时间
accept_address	String	运货单接收地址
express_id	int	快递公司ID
express_number	String	快递单号
order_code	long	订单号