商城订单物流详情¶
功能说明¶
- 查询商城订单物流详情
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/tenant/commerce/logistics/detail
- 生产环境: https://openapi.guanaitong.com/tenant/commerce/logistics/detail
HTTP请求方式¶
- Method: POST
- Content-Type: application/x-www-form-urlencoded
参数说明¶
-
公有参数
发送请求是必须传入公共参数,详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| seller_order_code | 是 | string | 商家订单号 |
请求示例(HTTP)¶
POST /tenant/commerce/logistics/detail?access_token=3c1e5462cc2ed066ca0dada4e9c204f5&appid=25001707&seller_order_code=S202211042517356198954289×tamp=1667888736&version=1.0.0&sign=b4ae8bb91dcd07ec2cfb29a29c8a3d0e4cdcd2e3 HTTP/1.1
Host: https://openapi.guanaitong.tech
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误代码。 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回商城商家订单物流信息,集合 |
| data.seller_order_code | String类型,商家订单号 |
| data.logistic_bill_code | String类型,物流单号 |
| data.logistic_phone | String类型,物流公司电话 |
| data.logistic_company_name | String类型,物流公司名称 |
| data.logistic_status | 快递状态 0:在途,即货物处于运输过程中; 1:揽件,货物已由快递公司揽收并且产生了第一条跟踪信息; 2:疑难,货物寄送过程出了问题; 3:签收,收件人已签收; 4:退签,即货物由于用户拒签、超区等原因退回,而且发件人已经签收; 5:派件,即快递正在进行同城派件; 6:退回,货物正处于退回发件人的途中 |
| data.last_logistic_detail | 对象类型,最新一条物流信息 |
| data.all_logistic_detail_list | List集合,全部物流流转信息 |
| data.product_list | 订单商品列表,List集合 |
物流流转信息(logistic_detail)¶
| 参数名称 | 描述 |
|---|---|
| time_tracked | String类型,跟踪信息的时间,格式yyyy-MM-dd HH:mm:ss |
| content_tracked | String类型,跟踪信息的内容 |
订单商品列表(product_list)¶
| 参数名称 | 描述 |
|---|---|
| spu_code | String类型,商品code |
| spu_name | String类型,商品名称 |
| sku_code | String类型,sku_code |
| sku_name | String类型,sku_name |
| sku_pic_url | String类型,单规格商品的图片,默认取商品的第一张头图 |
| current_price | BigDecimal类型,现价 |
| purchase_num | Integer类型,购买数量 |
正确返回示例¶
{
"code": 0,
"msg": "OK",
"data": [
{
"logistic_bill_code": "433322333",
"logistic_company_name": "安达信",
"seller_order_code": "S202211042517356198954289",
"product_list": [
{
"purchase_num": 1,
"sku_pic_url": "https://img1.guanaitong.com/grus-gfs/test/gmall-seller-mgr/by-days/2022-04-16/e363cb4d7fe7fbed6333dc6921c1018d.jpg",
"spu_name": "固定时间测测试",
"spu_code": "PC22041600000002",
"sku_name": "颜色:红色",
"current_price": 60.0,
"sku_code": "KC22041600000002"
},
{
"purchase_num": 3,
"sku_pic_url": "https://img1.guanaitong.com/grus-gfs/test/gmall-seller-mgr/by-days/2022-04-18/e363cb4d7fe7fbed6333dc6921c1018d.jpg",
"spu_name": "自发货测试商品0418xiugai111222",
"spu_code": "PC22041800000001",
"sku_name": "颜色:红色",
"current_price": 1.0,
"sku_code": "KC22041800000001"
}
],
"logistic_phone": ""
}
]
}
错误返回示例¶
常见错误码¶
| 错误码 | 错误信息 |
|---|---|
| 1000240002 | 参数校验失败 |
| 其他公共错误码 | 其他公共错误码 |