文档
测试

销退入库单查询

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.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
可选

响应参数

参数名
类型
描述
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
数量
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
原订单系统备注

返回示例

```` { "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 } ````