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-预售尾款]
                    }
                ]
            }
        ]
    }
}
©xiaomiyoupin.com 苏B2-20180351 苏ICP备18025642号-1            该文件修订时间: 2023-04-26 01:54:18

results matching ""

    No results matching ""