销退入库单查询
系统相关界面
【售后】---【销退入库】
请求地址
环境 | 服务地址(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.refund.warehouse.query
必填
请求参数
参数名
类型
描述
必填
userIds
string
店铺ID
warehouseIds
string
仓库ID
ids
string
销退入库工单号
workOrderIds
string
售后工单号工单号
status
integer
状态 1:等待收货,2:上架完成,3:等待上架,4:已作废
pageSize
integer
每页数量
pageNo
integer
页码
timeType
string
createTime :创建时间, modifyTime:修改时间,endTime:完成时间,receiveGoodsTime:收货时间,disposeSuc:工单完成时间
必填
startTime
string
起始时间 格式:yyyy-MM-dd HH:mm:ss
endTime
string
结束时间 格式:yyyy-MM-dd HH:mm:ss
buyerName
string
买家姓名
wangwangNum
string
买家旺旺
响应参数
参数名
类型
描述
必填
msg
string
msg
必填
expiresIn
long
到期时间
必填
companyId
long
关联的企业ID
必填
userId
long
关联的用户ID
必填
accessToken
string
会话Token
必填
refreshToken
string
用来刷新会话的Token
必填
traceId
string
traceId
必填
total
long
总条数
必填
code
string
code
必填
solution
string
solution
必填
subCode
string
subCode
必填
subMsg
string
subMsg
必填
body
string
body
必填
forbiddenField
string
forbiddenField
必填
list
array
数据列表
必填
sid
Long
系统订单编号
必填
tid
string
平台订单号
必填
created
string
生成时间(时间戳)
必填
version
integer
版本号
必填
receiveUser
string
收货人
必填
receiveGoodsTime
string
收货时间(时间戳)
必填
expressName
string
退回快递的快递名称 (数据库不持久化)同ReissueOrRefund的expressName
必填
remarkInfo
string
留言信息
必填
isExtra
integer
是否是扩展的
必填
reissueOrRefundId
long
退货或补发的id 这里特指退货id(只有退货才会生成销退入库单)
必填
modified
string
修改时间(时间戳)
必填
id
long
入库单号
必填
workOrderId
long
售后工单号
必填
wareHouseName
string
收货仓库名称
必填
endTime
string
收货完成时间(时间戳) , 即status为2时,将该时间记录到数据库中
必填
items
array
退货商品信息
必填
goodItemCount
integer
良品数(销退入库时使用)
必填
badItemCount
integer
次品数 (销退入库时使用)
必填
type
integer
售后类型(商品级别) 1:退货商品 2:补发商品
必填
outerId
string
商家编码
必填
title
string
商品名称
必填
picPath
string
商品图片
必填
isMatch
integer
商品状态(匹配/未匹配) 0:匹配 1:未匹配
必填
itemRealQty
integer
实退数量
必填
price
double
销售价(元)
必填
rawRefundMoney
BigDecimal
平台实退金额(元)
必填
refundMoney
BigDecimal
商品系统实退金额(元)
必填
itemSnapshotId
Long
原售后工单商品id
必填
batchProductDates
array
批次效期信息
必填
productDate
string
生产日期
必填
batchNo
string
批次
必填
qualityType
Integer
质量类型:1.良品 2.次品
必填
count
Integer
数量
必填
itemUniqueCodes
array
商品唯一码信息
必填
isPda
integer
是否曾用pda入库过,0 没有 1 有 默认为0 (已经被pda入库过就不能在pc端入库)
必填
status
integer
1:等待收货,2:上架完成,3:等待上架,4:已作废
必填
expressId
string
退回快递的快递编号 (数据库不持久化)同ReissueOrRefund的expressId
必填
wareHouseId
Long
发货或退货仓库编号
必填
wareHouseName
String
售后仓库名称
必填
wareHouseCode
String
发货仓编码
必填
disposeSuc
Long
工单完成时间(时间戳)
必填
afterSaleType
integer
售后类型 0:其他,1:已发货仅退款,2:退货,3:补发,4:换货,5:未发货仅退款,6:补款,7:拒收退货,8:档口退货,9:维修,10:仅退款
必填
afterSaleTypeName
String
售后类型名称
必填
sourceId
Long
分销商id
必填
sourceName
String
分销商名称
必填
remark
String
售后工单备注
必填
tradeRemark
String
原订单平台备注
必填
tradeSysMemo
String
原订单系统备注
必填
buyerName
String
买家姓名
必填
wangwangNum
String
买家旺旺
必填
返回示例
{
"traceId": "42142313213",
"list": [
{
"tid": "12321324",
"sid": 2142424321,
"modified": 1659502709000,
"wareHouseOutCode": "XXX",
"wareHouseId": 8010,
"wareHouseName": "XX仓",
"id": 3212421324123213,
"isPda": 0,
"wareHouseCode": "XXX",
"created": 1659502709000,
"userId": 321321,
"receiveUser": "小五",
"receiveGoodsTime": 1659502709000,
"isExtra": 0,
"reissueOrRefundId": 382130238219423,
"workOrderId": 382412389204812,
"endTime": 946656000000,
"items": [
{
"goodItemCount": 3,
"badItemCount": 2,
"title": "巧克力",
"type": 1,
"isMatch": 0,
"picPath": "https://xxx.jpg",
"itemRealQty": 3,
"price": 0.0,
"outerId": "010-2131"
}
],
"status": 3
}
],
"total": 1,
"success": true
}