文档
测试

维修单列表查询

POST
https://gw.kuaimai.com/router

接口描述

维修单列表查询

系统相关界面

【售后】---【维修单管理】

请求地址

|环境|服务地址(HTTP/HTTPS)| |-|-| |V2正式环境(推荐)| https://gw.superboss.cc/router| **2022年4月1日**以后申请的APP Key,统一使用V2正式环境的请求地址:**https://gw.superboss.cc/router**

公共参数

调用任何一个API都必须传入的参数,目前支持的公共参数有: | 参数名称 | 参数类型 | 是否必须 | 参数描述 | | --- | --- | --- | --- | | method | string | 是 | API接口名称 | | appKey | string | 是 | 分配给应用的AppKey | | timestamp | string | 是 | 时间戳,时区为GMT+8,例如:2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 | | format | string | 否 | 响应格式。默认为json格式,可选值:json | | version | string | 是 | API协议版本 可选值:1.0 | | sign\_method | string | 否 | 签名的摘要算法(默认 hmac),可选值为:hmac,md5,hmac-sha256。 | | sign | string | 是 | 签名 | | session | string | 是 | 授权会话信息 (即access_token,由系统分配) |

请求头

参数名
类型
描述
必填
Content-Type
string
application/x-www-form-urlencoded;charset=UTF-8
必填

API接口名

参数名
类型
描述
必填
method
string
erp.aftersale.repair.list.query
必填

请求参数

参数名
类型
描述
必填
repairStatus
string
维修状态 0待审核1待收货2待维修3待寄出4已完成-1已作废
可选
pageSize
integer
每页数量
可选
pageNo
integer
页码
可选
timeType
string
createTime :创建时间, returnTime:退回时间, modified:更新时间
可选
timeStart
string
起始时间 格式:yyyy-MM-dd HH:mm:ss
可选
timeEnd
string
结束时间 格式:yyyy-MM-dd HH:mm:ss
可选
queryType
string
查询类型 (repairOrderNum-维修单号,contactInfo-联系方式,returnLogisticsCode-退回快递单号,sendLogisticsCode-寄出快递单号,identificationCodes-识别码,receiverName-收件人姓名)
可选
queryText
string
查询请求值(对应queryType的具体查询参数)
可选

响应参数

参数名
类型
描述
必填
traceId
string
traceId
必填
total
long
总条数
必填
success
string
true/false
必填
list
array
数据列表
必填
id
Long
维修单ID
必填
repairOrderNum
string
维修单号
必填
createTime
String
生成时间 格式:yyyy-MM-dd HH:mm:ss
必填
userNick
string
用户昵称
必填
sid
Long
系统订单号
必填
tid
String
平台订单号
必填
userId
Long
店铺编码
必填
shopName
String
店铺名称
必填
companyId
Long
企业ID
必填
wangwangNum
String
买家旺旺号
必填
contactInfo
string
联系方式
必填
repairStatus
Integer
维修状态 :0待审核1待收货2待维修3待寄出4已完成-1已作废
必填
hasFee
Integer
是否需要付费 0不需要 1需要
必填
payedStatus
Integer
支付状态 0未付款 1部分付款 2已付款
必填
repairMoney
Double
维修费用
必填
payedMoney
Double
已付金额
必填
repairWarehouseId
Long
维修仓库ID
必填
repairWarehouseName
String
维修仓库名称
必填
identificationCodes
String
商品识别码 (多个,分隔)
必填
problemDescription
String
问题描述
必填
failureCause
String
故障原因
必填
remark
String
备注
必填
repairRemark
String
维修备注
必填
fullyOutlook
Integer
外观是否完好 0 是 1 否
必填
fullyEquipped
Integer
设备是否齐全 0 是 1 否
必填
fullyProtected
Integer
是否过保 0 是,1否
必填
createUser
String
维修单创建人
必填
returnTime
String
退回时间,格式:yyyy-MM-dd
必填
returnWarehouseId
Long
退回仓库ID
必填
returnWarehouseName
String
退回仓库名称
必填
returnLogisticsName
String
退回快递名称
必填
returnLogisticsCode
String
退回快递单号
必填
sendTime
String
寄出时间
必填
sendLogisticsCode
String
寄出快递单号
必填
sendLogisticsName
String
寄出快递名称
必填
sendRemark
String
寄出备注
必填
receiverName
String
收件人姓名
必填
receiverPhone
String
收件人电话
必填
province
String
必填
city
String
必填
area
String
必填
receiverAddress
String
收件人地址
必填
receiverDescription
String
收件人备注
必填
accessoryUrl
String
维修附件
必填
repairItemInfos
String
商品明细 (多个,分割)
必填
itemInfos
String[]
商品信息
必填
tradeReceiveName
String
订单收货人
必填
tradeReceiveMobile
String
订单收货联系人
必填
source
String
店铺来源
必填
flag
String
店铺标记
必填
finishTime
String
完成时间
必填
photoPathStr
String
图片
必填
workOrderId
Long
售后工单号
必填
sendExpressCompanyId
Long
寄出快递公司id
必填
shortId
Long
售后工单短号
必填

返回示例

``` { "traceId": "2451667440669289674", "list": [ { "contactInfo": "13777366666", "hasFee": 0, "source": "tm", "tid": "518816123781632", "receiverPhone": "13777366666", "fullyProtected": 1, "province": "浙江省", "id": 111383, "fullyOutlook": 0, "area": "滨江区", "repairStatus": 1, "payedStatus": 0, "returnTime": "2023-02-02", "returnLogisticsName": "ZxZx", "receiverAddress": "江南大道588号恒鑫大厦10F光云科技", "companyId": 28591, "flag": "2", "city": "杭州市", "repairMoney": 0.0, "shopName": "懒洋洋睡觉店铺", "returnWarehouseName": "yyh专属", "wangwangNum": "AAHk5d-EAAeGwJedwSFu0XXX", "sid": 4150517578391252, "payedMoney": 0.0, "userNick": "刘明剑s3aRA", "repairItemInfos": "|||sky海台开启批次001|||3|||", "repairOrderNum": "4150850984280576", "fullyEquipped": 0, "receiverName": "刘明剑s3aRA", "problemDescription": "41324134", "repairWarehouseName": "yyh专属", "returnLogisticsCode": "314141324", "userId": 85127, "returnWarehouseId": 41531, "createTime": "2023-02-02 16:00:06", "repairWarehouseId": 41531 }, { "contactInfo": "13777366666", "hasFee": 0, "source": "tm", "tid": "518816123781632", "receiverPhone": "13777366666", "fullyProtected": 1, "province": "浙江省", "id": 111738, "fullyOutlook": 0, "area": "滨江区", "repairStatus": 2, "payedStatus": 0, "returnTime": "2023-02-06", "returnLogisticsName": "天天快递", "receiverAddress": "江南大道588号恒鑫大厦10F光云科技", "companyId": 28591, "flag": "2", "city": "杭州市", "repairMoney": 0.0, "shopName": "懒洋洋睡觉店铺", "returnWarehouseName": "yyh专属", "wangwangNum": "AAHk5d-EAAeGwJedwSFu0XXX", "sid": 4150517578391252, "payedMoney": 0.0, "userNick": "刘明剑s3aRA", "repairItemInfos": "|||sky海台开启批次001|||2|||", "repairOrderNum": "4156624732881408", "fullyEquipped": 0, "receiverName": "刘明剑s3aRA", "problemDescription": "41341324", "repairWarehouseName": "yyh专属", "failureCause": "test", "returnLogisticsCode": "431431241", "userId": 85127, "returnWarehouseId": 41531, "createTime": "2023-02-06 17:53:28", "repairWarehouseId": 41531 }, { "contactInfo": "13777366666", "hasFee": 0, "source": "tm", "tid": "521102154717696", "receiverPhone": "13777366666", "fullyProtected": 1, "province": "浙江省", "id": 113266, "fullyOutlook": 0, "area": "滨江区", "repairStatus": 1, "tradeReceiveName": "13777366666", "payedStatus": 0, "returnTime": "2023-02-13", "returnLogisticsName": "天天快递", "receiverAddress": "江南大道588号恒鑫大厦10F光云科技", "companyId": 28591, "flag": "2", "city": "杭州市", "repairMoney": 1.0, "shopName": "懒洋洋睡觉店铺", "returnWarehouseName": "test-2021/4/30", "wangwangNum": "AAHk5d-EAAeGwJedwSFu0XXX", "sid": 4167913574918882, "payedMoney": 0.0, "userNick": "刘明剑YAtFJ", "repairItemInfos": "https://img.alicdn.com/bao/uploaded/i3/65343260/TB20GORzhxmpuFjSZFNXXXrRXXa_!!65343260.jpg|||毛线衣|||1|||", "repairOrderNum": "4180230195511808", "fullyEquipped": 0, "receiverName": "刘明剑YAtFJ", "problemDescription": "141324", "repairWarehouseName": "test-2021/4/30", "returnLogisticsCode": "41341324132", "userId": 85127, "returnWarehouseId": 39528, "tradeReceiveMobile": "13777366666", "createTime": "2023-02-23 10:06:11", "repairWarehouseId": 39528 }, { "contactInfo": "13777366666", "hasFee": 0, "source": "tm", "tid": "521102154717696", "receiverPhone": "13777366666", "fullyProtected": 1, "province": "浙江省", "repairRemark": "434", "id": 113270, "fullyOutlook": 0, "area": "滨江区", "repairStatus": 3, "tradeReceiveName": "13777366666", "payedStatus": 0, "returnTime": "2023-02-16", "returnLogisticsName": "ZxZx", "receiverAddress": "江南大道588号恒鑫大厦10F光云科技", "companyId": 28591, "flag": "2", "city": "杭州市", "repairMoney": 0.0, "shopName": "懒洋洋睡觉店铺", "returnWarehouseName": "test-2021/4/30", "wangwangNum": "AAHk5d-EAAeGwJedwSFu0XXX", "sid": 4167913574918882, "payedMoney": 0.0, "userNick": "刘明剑YAtFJ", "repairItemInfos": "https://img.alicdn.com/bao/uploaded/i3/65343260/TB20GORzhxmpuFjSZFNXXXrRXXa_!!65343260.jpg|||毛线衣|||1|||", "repairOrderNum": "4180243413008896", "fullyEquipped": 0, "receiverName": "刘明剑YAtFJ", "problemDescription": "411324", "repairWarehouseName": "test-2021/4/30", "failureCause": "故障", "returnLogisticsCode": "412413241324", "userId": 85127, "returnWarehouseId": 39528, "tradeReceiveMobile": "13777366666", "createTime": "2023-02-23 10:19:37", "repairWarehouseId": 39528 } ], "total": 4, "success": true } ```