接口描述:

  • 获取售后服务单列表。

请求 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… 订单号
account string max:80 carey 账号或昵称
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 结束时间
my_service integer in:0,1 1 我接收的售后单 0=否 1=是
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 账号编号
admin_id integer 0 账号编号
qty integer 0 数量
type integer 0 售后类型,详见附属 A
reason string 不想要了 原因
goods_status integer 1 货物状态,详见附属 B
status integer 0 售后状态,详见附属 C
remark string 备注 客服备注
refund_fee number 0.01 总退款金额
delivery_fee number 0 运费
admin_new integer 0 存在新事件 0=否 1=是
user_new integer 0 存在新事件 0=否 1=是
create_time datetime 2018-06-13 23:02:17 创建时间
update_time datetime 2018-06-13 23:14:28 更新时间
get_user object [] 账号对象
get_admin object [] 账号对象
get_user 类型 是否返回 示例值 描述
username string carey 账号
nickname string carey 昵称
head_pic string //host/head_pic.jpg 头像
get_admin 类型 是否返回 示例值 描述
username string admin 账号
nickname string carey 昵称
head_pic string //host/head_pic.jpg 头像

响应示例:

  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. "admin_id": 1,
  15. "qty": 0,
  16. "type": 1,
  17. "reason": "七天无理由退货",
  18. "goods_status": 2,
  19. "status": 0,
  20. "remark": "",
  21. "refund_fee": 0.01,
  22. "delivery_fee": 1195,
  23. "admin_new": 1,
  24. "user_new": 1,
  25. "create_time": "2018-06-13 23:05:12",
  26. "update_time": "2018-06-13 23:05:12",
  27. "get_user": {
  28. "username": "dnyz520",
  29. "nickname": "careya",
  30. "head_pic": "//host/head_pic.jpg"
  31. },
  32. "get_admin": {
  33. "username": "admin",
  34. "nickname": "carey",
  35. "head_pic": "//host/head_pic.jpg"
  36. }
  37. },
  38. {
  39. "service_no": "SH_I6130213790784100001",
  40. "order_no": "PO_I1049550470892670001",
  41. "order_goods_id": 1,
  42. "goods_image": "",
  43. "key_name": "1_3",
  44. "key_value": "规格B",
  45. "user_id": 1,
  46. "admin_id": 0,
  47. "qty": 0,
  48. "type": 0,
  49. "reason": "不想要了",
  50. "goods_status": 1,
  51. "status": 1,
  52. "remark": "",
  53. "refund_fee": 0.01,
  54. "delivery_fee": 0,
  55. "admin_new": 0,
  56. "user_new": 1,
  57. "create_time": "2018-06-13 23:02:17",
  58. "update_time": "2018-06-14 00:41:01",
  59. "get_user": {
  60. "username": "dnyz520",
  61. "nickname": "careya",
  62. "head_pic": "//host/head_pic.jpg"
  63. },
  64. "get_admin": null
  65. }
  66. ],
  67. "total_result": 2
  68. }
  69. }

备注:

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