51 售后单服务单列表
1. 接口
/mtop/aftersale/openapi/aftersaleorders
2. 接口参数
公共参数
请求参数
data: {
"ids": ["JS1908013500000001", "JS1908013500000002"], // 服务单号;
"orderIds": [4190729713107499, 4190731793206121], // 订单号;
"refundType": 1, // 售后类型:1:售后,2:售中,3:拒收, 4:首款退款(预售订单)
"type": "TK", // 服务单类型 [TK-退款, TH-退货, HH-换货, WX-维修, JS-拒收, ZP-直赔]
"createTimeBegin": 1563532232, // 创建开始时间, unix timestamp 秒
"createTimeEnd": 1563532232, // 创建结束时间, unix timestamp 秒
"updateTimeBegin": 1563532232, // 更新开始时间, unix timestamp 秒
"updateTimeEnd": 1563532232, // 更新结束时间, unix timestamp 秒
"pageNo": 1 // 当前页号
"pageSize": 50 //页大小,默认50, pageSize <= 100
}
查询说明:
有如下四种查询条件的组合方式 :
1)按服务单号:ids, refundType(非必需), type(非必需)
2)按订单号:orderIds, refundType(非必需), type(非必需)
3)按创建时间范围:createTimeBegin, createTimeEnd, refundType(非必需), type(非必需), 时间跨度< 7天
4)按更新时间范围:updateTimeBegin, updateTimeEnd, refundType(非必需), type(非必需), 时间跨度< 7天
以上组合优先级为1)>2)>3)>4), 即在ids不为空的条件下,按照1)来执行查询; 如果ids为空, order_ids不为空,则按照2)来执行查询, 以此类推。
3. 返回示例
返回字段 参考 有品售后中心数据字典
{
"code": 0,
"message": "ok",
"data": {
"pageNo": 1,
"pageSize": 50,
"total": 2000,
"data": [// 售后单服务单列表
{
"id": "YP1905154200000002", // 服务单号
"refundType": 1, // 售后类型:1:售后,2:售中(未发货退款),3:拒收
"orderId": "4190515215607422", // 有品订单号
"pid": 22865, // 商品ID,服务单类型为售中时,该值为空,代表整单申请
"ugId": "4200309201900540001", // ugId 订单商品行唯一标识,服务单类型为售中时,该值为空,代表整单申请
"count": 1, // 商品个数
"state": "READY_CHECK", // 服务单状态(服务单操作前的状态)
"opCode": "CHECK_PASS", // 服务单操作
"targetState": "READY_PROCESS", // 服务单流转状态(当前服务单状态),只有售后/拒收类型服务单具有此字段,售中/预售退款无审核流程,因此此字段为空
"opTime": 1557916643, // 操作时间
"selfSupporting": 0, // 有品自营标识 [0-非自营,1-自营]
"type": "TH", // 服务单类型 [TK-退款, TH-退货, HH-换货, WX-维修, ZP-直赔]
"auditType": "TH", // 服务单类型(商家审核)[TK-退款, JS-拒收, TH-退货, HH-换货, WX-维修]
"serviceWay": "YHJS", // 服务方式 [NA-未知, YHJS-用户寄送, SMQJ- 上门取件, DJFW-到家服务, DDFW-到店服务]
"orgId": "197", // 机构ID
"orgName": "有品测试商户", // 机构名称
"applyReason": "LACK_ACCESSORIES", // 申请原因
"arbitrable": 0, // 仲裁状态:[0-不允许仲裁, 1-允许仲裁, 2-已仲裁]
"evaluable": 0, // 评价状态:[0-未评价,1-已评价]
"createTime": 1557916444, // 创建时间
"createPerson": 10000, // 创建人uid
"updateTime": 1557916547, // 更新时间
"updatePerson": 3150045599, // 操作人uid
"createFrom": "YOUPIN_ONLINE", // 建单来源
"userExpressName": "", // 用户寄回商家(仓库)的快递公司
"userExpressSn": "", // 用户寄回商家(仓库)的快递单号,
"exchangeNewOid": 4226821000149205, // 当前服务单为售后换新的,返回换新订单号,无则为0(仅2022-09-01日后的售后单)
"refundList": [ // 退款列表,真实退款完成才有值,否则为空
{
"refundFee": 100, // 退款金额(分)
"refundStatus": "SUCCESS", // 退款状态[''SUCCESS''-退款成功,''FAIL''-退款失败]
"notifyTime": 1552043893, // 通知时间
"state": "READY_PROCESS", // 售后服务单状态
"pid": 22865, // pid
"count": 1, // 数量
"payType": 1 // 支付类型:[1-普通订单,5-预售首款,6-预售尾款]
}
]
}
]
}
}