接口描述:

  • 获取售后服务单列表。

请求 URL:

  • http|https://host/api/v1/order_service/method/get.order.service.list/

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
service_no string max:50 SH_I6130… 售后单号
order_no string max:50 PO_I1049… 订单号
type integer in:0,1,2,3 1 售后类型,详见附属 A
status integer between:0,6 0 售后状态,详见附属 C
begin_time datetime beforeTime:end_time 2018-06-01 00:00:00 开始时间
end_time datetime afterTime:begin_time 2018-06-30 00:00:00 结束时间
page_no integer gt:0 1 1 页码
page_size integer between:1,40 15 15 每页数量
order_type string in:asc,desc desc asc 排序方式
order_field string 见附属 D order_service_id update_time 排序字段

附属 A:
0=仅退款 1=退货退款 2=换货 3=维修

附属 B:
0=未选择 1=未收到货 2=已收到货

附属 C:
0=待处理 1=已同意 2=已拒绝 3=已寄件 4=售后中 5=已撤销 6=已完成

附属 D:
in:order_service_id,create_time,update_time

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 2 合计计数
items 类型 是否返回 示例值 描述
service_no string SH_I6130… 售后单号
order_no string PO_I1049… 订单号
order_goods_id integer 1 订单商品编号
goods_image string //image.jpg 订单商品封面
key_name string 1_3 规格键名
key_value string 规格B 规格值
user_id integer 1 账号编号
qty integer 0 数量
type integer 0 售后类型,详见附属 A
reason string 不想要了 原因
goods_status integer 1 货物状态,详见附属 B
status integer 0 售后状态,详见附属 C
refund_fee number 0.01 总退款金额
delivery_fee number 0 运费
user_new integer 0 存在新事件 0=否 1=是
create_time datetime 2018-06-13 23:02:17 创建时间
update_time datetime 2018-06-13 23:14:28 更新时间

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "service_no": "SH_I6130231224060090001",
  8. "order_no": "PO_I1049550470892670001",
  9. "order_goods_id": 2,
  10. "goods_image": "",
  11. "key_name": "1_2",
  12. "key_value": "规格A",
  13. "user_id": 1,
  14. "qty": 0,
  15. "type": 1,
  16. "reason": "七天无理由退货",
  17. "goods_status": 2,
  18. "status": 0,
  19. "refund_fee": 0.01,
  20. "delivery_fee": 1195,
  21. "user_new": 1,
  22. "create_time": "2018-06-13 23:05:12",
  23. "update_time": "2018-06-13 23:05:12"
  24. },
  25. {
  26. "service_no": "SH_I6130213790784100001",
  27. "order_no": "PO_I1049550470892670001",
  28. "order_goods_id": 1,
  29. "goods_image": "",
  30. "key_name": "1_3",
  31. "key_value": "规格B",
  32. "user_id": 1,
  33. "qty": 0,
  34. "type": 0,
  35. "reason": "不想要了",
  36. "goods_status": 1,
  37. "status": 1,
  38. "refund_fee": 0.01,
  39. "delivery_fee": 0,
  40. "user_new": 1,
  41. "create_time": "2018-06-13 23:02:17",
  42. "update_time": "2018-06-14 00:41:01"
  43. }
  44. ],
  45. "total_result": 2
  46. }
  47. }

备注:

  1. 该接口支持条件搜索,如果不带入业务参数则使用默认值。
文档更新时间: 2018-06-25 10:06