跳到主要内容

奇门售后单查询(列表)

查询售后单列表。本文根据《快麦ERP奇门自定义接口V2.6.docx》整理。

接入说明​

调用前请先阅读奇门自定义接口接入说明,配置 target_app_key、customerId 和 warehouseCode。

请求地址​

环境服务地址
正式环境http://z29932hpkn.api.taobao.com/router/qm

API接口地址​

参数名值说明
methodkuaimai.refund.list.query查询售后单列表

请求参数​

以下为接口业务参数;false 表示非必填。奇门系统参数和路由参数见接入说明。

名称类型是否必须描述
pageNoIntegerfalse页码
pageSizeIntegerfalse页面大小(每页数据条数)
refundTypeIntegerfalse类型
1:退款;
2:退货;
3:补发;
4:换货;
5: 发货前的退款
asVersionIntegerfalse售后版本
1:旧版
2:新版(默认)
startTimeStringfalse开始时间(yyyy-MM-dd HH:mm:ss)
(默认更新时间)
endTimeStringfalse结束时间(yyyy-MM-dd HH:mm:ss)(默认更新时间)
userIdLongfalse店铺编号
warehouseIdLongfalse订单分仓id
tidstringfalse平台订单号
idlongfalse售后工单号
suiteSingleintegerfalse是否返回套件信息 0:不返回套件信息,1:返回套件信息,默认0

响应参数​

以下按原文的字段层级展示,各子表标题表示字段所属的对象路径。

顶层字段​

名称类型描述
totalLong总数
pageNoInteger页码
hasNextPageBoolean是否有下一页,默认否
workOrdersList售后工单明细

workOrders(售后工单明细)​

名称类型描述
textReasonString原订单平台备注
reasonString售后原因
1:退运费
2:收到商品破损
3:商品错发/漏发
4:商品需要维修
5:发票问题
6:收到商品与描述不符
7:我不想要了
8:商品质量问题
9:未按约定时间发货
shortIdLong售后工单短号
refundExpressIdString退回快递单号
refundWarehouseIdLong退货仓库ID
refundRemindTimeoutString超时日期
shopNameString店铺名称
remarkString工单备注
sourceString工单来源
wangwangNumString买家旺旺号
refundPostFeeString应退运费
tidString平台订单号
sidLong系统订单编号
storageProgressInteger退货进度
idLong售后工单号
afterSaleTypeInteger类型
1:退款;
2:退货;
3:补发;
4:换货
5:发货前的退款
refundWarehouseNameString退货仓库名称
createdString生成时间
finishedString完成时间
refundMoneyDouble退款金额
platformStatusInteger平台状态
buyerNameString买家姓名
userIdLong店铺ID
reissueSidLong补发或换货时生成的trade(订单)的sid
buyerPhoneString买家手机号
goodStatusInteger货物状态
refundExpressCompanyString退回快递公司
dealResultInteger处理结果
statusInteger工单状态
1:未分配
2:未解决
3:优先退款
4:同意
5:拒绝
6:确认退货
7:确认发货
8:确认退款
9:处理完成
10:作废
explainsstring售后说明
rawRefundMoneystring平台实退金额
receiveGoodsTimeString入仓时间
refundableMoneyLong系统应退金额
itemsList售后工单商品明细集合

workOrders.items(售后工单商品明细)​

名称类型描述
goodItemCountInteger良品数(销退入库时使用)
receiveGoodsOperatorNamesString入仓操作员名
badItemCountInteger次品数 (销退入库时使用)
refundMoneyString退款金额
remarkString备注
typeInteger售后类型(商品级别)
1:退货商品 2:补发商品
titleString商品名称
propertiesNameString商品规格
receivableCountInteger申请数量
isMatchInteger商品状态(匹配/未匹配)
0:匹配 1:未匹配
receiveGoodsTimeString入仓时间
picPathString商品图片
mainOuterIdString主商家编码
itemRealQtyInteger实退数量
priceDouble销售价
outerIdString商家编码
paymentString实付金额
suiteinteger是否是套件商品:0=普通商品,1=套件
suiteSingleinteger是否是套件单品:0=套件本身,1=套件下单品
combineIdlong套件组id,同一套件下套件本身和套件下单品相同
rawRefundMoneylong平台实退金额
refundableMoneyLong系统应退金额