文档
测试

售后工单查询

POST
请求地址/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.list.query
必填

请求参数

参数名
类型
描述
必填
userIds
string
店铺ID
可选
warehouseIds
string
仓库ID
可选
tid
string
平台订单号
可选
id
long
售后工单号
可选
pageSize
integer
pageSize(不传默认为1,范围是1-200条)
可选
pageNo
integer
页码
可选
asVersion
integer
售后版本 1:旧版, 2:新版(默认)
可选
startModified
string
起始修改时间 格式:yyyy-MM-dd HH:mm:ss
可选
endModified
string
结束修改时间 格式:yyyy-MM-dd HH:mm:ss
可选
afterSaleType
string
售后类型 0:其他;1:已发货仅退款;2:退货;3:补发;4:换货;5:未发货仅退款;7:拒收退货;8:档口退货;9:维修
可选
suiteSingle
integer
是否返回套件信息 0:不返回套件信息,1:返回套件信息,默认0
可选
ids
String
售后工单id批量查询
可选
tids
String
平台订单号批量查询
可选
reissueSid
Long
换货/补发订单号
可选

响应参数

参数名
类型
描述
total
integer
total
list
array
list
id
long
售后工单号
orderType
string
工单来源 1:平台,2:手工
tid
string
平台订单号
sid
long
系统订单编号
created
string
生成时间,时间戳格式:1640966400000
afterSaleType
integer
售后类型 0:其他,1:退款;2:退货;3:补发;4:换货 5:发货前的退款 6:补款 7:拒收退货 8:档口退货 9:维修
buyerName
string
买家姓名
buyerPhone
string
买家手机号
wangwangNum
string
买家旺旺号
goodStatus
integer
货物状态(1:买家未收到货;2:买家已收到货;3:买家已退货;4:卖家已收到退货)
status
integer
工单状态 2:未解决 9:已解决 10:已作废 11:已合并 12:解决中
rawRefundMoney
string
平台实退金额(单位:元)
refundMoney
double
系统实退金额(单位:元)
refundPostFee
string
应退运费
reason
string
售后原因 (1:退运费 2:收到商品破损 3:商品错发/漏发 4:商品需要维修 5:发票问题 6:收到商品与描述不符 7:我不想要了 8:商品质量问题 9:未按约定时间发货)
textReason
string
原订单平台备注
refundWarehouseId
long
退货仓库ID
refundWarehouseName
string
退货仓库名称
refundExpressCompany
string
退回快递公司
refundExpressId
string
退回快递单号
remark
string
工单备注
dealResult
integer
处理结果
platformStatus
integer
平台状态
refundRemindTimeout
string
超时日期
shortId
long
售后工单短号
storageProgress
integer
退货进度
shopName
string
店铺名称
source
string
工单来源具体平台,例如 tb(淘宝或者天猫平台),jd(京东平台),pdd(拼多多)等
finished
string
完成时间
userId
long
店铺ID
reissueSid
long
补发或换货时生成的trade(订单)的sid
items
array
售后工单商品明细集合
goodItemCount
integer
良品数(销退入库时使用)
receiveGoodsOperatorNames
string
入仓操作员名
badItemCount
integer
次品数 (销退入库时使用)
refundMoney
string
商品系统实退金额
remark
string
备注
type
integer
售后类型(商品级别) 1:退货商品 2:补发商品
title
string
商品名称
propertiesName
string
商品规格
receivableCount
integer
申请数量
isMatch
integer
商品状态(匹配/未匹配) 0:匹配 1:未匹配
receiveGoodsTime
string
入仓时间
picPath
string
商品图片
mainOuterId
string
主商家编码
itemRealQty
integer
实退数量
price
double
销售价(单位:元)
outerId
string
商家编码
payment
string
实付金额(单位:元)
suite
integer
是否是套件商品:0=普通商品,1=套件
suiteSingle
integer
是否是套件单品:0=套件本身,1=套件下单品
combineId
long
套件组id,同一套件下套件本身和套件下单品相同
rawRefundMoney
long
平台实退金额(单位:分)
refundableMoney
Long
商品维度系统应退金额(单位:元)
itemSnapshotId
Long
商品id
sysItemId
integer
系统主商品ID
sysSkuId
integer
系统商品规格skuID
isGift
integer
是否为赠品 0:否 1:是
batchProductDates
array
批次效期信息
productDate
string
生产日期
batchNo
string
批次
qualityType
integer
质量类型:1.良品 2.次品
count
integer
数量
numIid
string
平台商品id
skuId
string
平台skuId
suits
array
套件、加工、组合商品的子商品
itemSnapshotId
Long
售后商品记录ID
sysOuterId
string
系统商家编码,如果是商品则为商品的商家编码,如果为SKU则为SKU的商家编码
suiteRatio
integer
套件、组合里的单品的数量分摊比例,需固化。不会因商品组合、套件比例修改改变
explains
string
售后说明
tagList
array
售后标记
string
refundWarehouseCode
string
退货仓库编码
refundableMoney
Long
系统应退金额(单位:元)
modified
Long
修改时间
applyDate
Long
申请时间
sourceId
Long
分销商id
sourceName
string
分销商名称
receiveGoodsTime
long
退货到货时间
advanceStatus
Integer
退款状态 (未申请:-1;平台未申请:0;退款先行垫付申请中:1;垫付完成:2;卖家拒绝收货:3;垫付关闭:4;垫付分账成功:5)
advanceStatusText
String
退款状态名称
platformId
String
外部平台售后单号
tradeSysMemo
String
客服备注
handlerStatus
Integer
自动化售后处理状态(待处理:-1;处理中:0;处理成功:1;处理失败:2)
handlerStatusText
String
自动化售后处理状态文本
tradeWarehouseName
String
原订单发货仓库名称
tradeWarehouseId
Long
原订单发货仓库ID
tradeWarehouseCode
string
原订单发货仓库编码
onlineStatus
Integer
线上状态(空:1;待卖家同意:2;待买家退货:3;待卖家确认收货:4;卖家拒绝退款:5;退款关闭:6;退款成功:7;待发出换货商品:8;待买家收货:9;换货关闭:10;换货成功:11)
onlineStatusText
String
线上状态对应文案

异常示例

```` ````