文档
测试

维修单列表查询

websocket测试
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 } ```
上一篇 登记补款查询
nextDoc 维修单详情查询
本文档使用易文档编写, 更新时间: 2023-12-18 10:49