当前位置: API文档

aftersales.refund.Refund.search(退换单查询)

¥标准

1.接口说明

1.1 接口描:获取ERP销售退货(换货)订单信息
1.2 适用版本:客户端 V1.4.5.3及以上版本
1.3 增量获取:支持
1.4 时间跨度:请求时间最大跨度为30天。

1.5注意事项:【权限校验】:店铺权限 

为了达到保护用户隐私数据安全的目的本接口不返回淘系及系统供销平台订单数据相关平台规则点击这里淘系及系统供销平台数据获取办法点击这里

本接口中涉及到用户隐私的字段数据仅自有平台及线下平台订单返回。具体字段详情见下面表格;

字段描述字段名
买家支付宝账号
pay_account
客户网名
buyer_nick
退款订单中收件人姓名receiver_name
退款订单中收件人电话receiver_telno
客户姓名customer_name

2.调用场景

2.1 举例说明:自研商城、分销系统、全渠道等系统对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境http://wdt.wangdian.cn/openapi

  3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
卖家账号, 由旺店通分配
接口账号keyString
由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
saltString
由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
调用的接口名称
版本号vString
1.0
秒级时间戳timestampint
秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
签名
分页大小page_sizeint
分页大小,分页查询必传
分页编号page_noint
分页编号,分页查询必传,标准接口page_no从0开始
是否计算查询结果的总条数calc_totalint
是否计算查询结果的总条数, 需要计算则1, 否则填0       

   3.3 业务请求参数

名称字段类型长度
必须描述
查询参数

params

Map<String, Object>

查询参数

分页

pager

pager


分页

params

名称字段类型长度
必须描述
店铺编号

shop_nos

String

255

由英文逗号分隔的店铺编号

原始单号tidString40
原始单号
客户网名buyer_nickString100客户网名
系统订单编号trade_noString40系统订单编号
退换单号refund_no

String

40退换单号
物流单号
return_logistics_no

String

40物流单号(退换单上的退回物流单号)
修改起始时间modified_from

String

40修改起始时间
修改结束时间

modified_to

String40

修改结束时间

开始时间

settle_from

String40

结算时间

结束时间

settle_to

String40

结算时间

审核起始时间

agree_from

String40

审核起始时间

审核结束时间

agree_to

String40

审核结束时间

退换单状态statusInt410:已取消;20:待审核;30:已审核;40已推送:80:已结算;81:待回传;85:待过账;86:已过账;87:成本确认;90:已完成
入库状态

stockin_status

Int

40:无需入库;1:待入库;2:部分入库;3:全部入库;4:终止入库
退回仓库编号
return_warehouse_nos

String

1000退回仓库编号,用英文逗号分隔
退换单类型type

Int

41:售前退款;2:退货;3:换货;4:退款不退货;6:保价退款
模糊查询fuzzy_queryboolean1默认false,业务单号进行模糊查询匹配,匹配数量大于1条时会报错
是否为拦截件

return_mask_manual_intercept

boolean1

0:否   1:是

不传不判断

是否拒收

refund_mask_reject_return

boolean1

0:否   1:是

传不判断

pager

名称字段类型长度
必须描述
分页大小page_sizeInt4分页大小(单量较大的卖家,page_size建议200以下)
页号page_noInt4从0开始

4.响应参

  4.1 公共响应参数

名称字段类型长度
必须描述
状态码statusInt
状态码:0表示成功,在调用错误时不返回该值
错误信息messageString
无错误信息不返回
单据数据data

Map<String, Object>


单据数据

data

响应参数说明示例值或者格式、具体含义、使用方法及注意事项(如隐私数据仅自有平台及线下平台订单返回,其他平台均不返回

名称字段类型长度
必须描述
单据数据

order

List<Map<String, Object>>


单据数据

数据总条数

total_count

Int


单据数据总条数

order

名称字段类型长度
必须描述
退换单idrefund_idInt11退换单id
原始单号src_tidsString255原始单号(平台订单号)
退换单号refund_noString40退换单号
备注

remark

String255备注
退换单类型

type

Int4

1:售前退款;2:退货;3:换货;4:退款不退货;6:保价退款

入库状态stockin_statusInt40:无需入库;1:待入库;2:部分入库;3:全部入库;4:终止入库
标记名称flag_nameString32标记名称
退回货品数量return_goods_countInt11退回货品数量
退款订单中收件人电话receiver_telnoString100
退款订单中收件人电话(仅自有平台及线下平台返回,其他平台均不返回
退款订单中收件人姓名receiver_nameString100退款订单中收件人姓名仅自有平台及线下平台返回,其他平台均不返回
修改时间modifiedString40修改时间
便签数量note_countInt6便签数量
店铺编号shop_noString20店铺编号
建单方式from_typeInt4

0:API抓单;1:手工建单;2:Excel导入;3:分销商推送

建单时间createdstring40建单时间
结算时间settle_timestring40

若无结算时间,返回空字符串

退货物流单号return_logistics_noString40退货物流单号
系统订单号列表trade_no_listString255系统订单号列表
平台退款金额guarantee_refund_amount

Decimal(19,4)


平台退款金额(担保退款金额
退货金额return_goods_amount

Decimal(19,4)


退货金额
物流公司名称return_logistics_nameString40
物流公司名称
退换说明

reason_name

String255退换说明
退款原因

refund_reason

String255退款原因
客户网名buyer_nickString100客户网名仅自有平台及线下平台返回,其他平台均不返回
建单者
operator_nameString40建单者
实际退款金额actual_refund_amount

Decimal(19,4)


实际退款金额
驳回原因revert_reason_nameString255驳回原因
退回仓库编号return_warehouse_noString40退回仓库编号
线下退款金额direct_refund_amount

Decimal(19,4)


线下退款金额(非担保退款金额
收款金额receive_amount

Decimal(19,4)


收款金额,买家支付给卖家
客户姓名customer_nameString40客户姓名仅自有平台及线下平台返回,其他平台均不返回
分销商昵称fenxiao_nick_nameString40分销商昵称,若无值则字段不返回
退换单状态statusInt410:已取消;20:待审核;30:已审核;40已推送:80:已结算;81:待回传;85:待过账;86:已过账;87:成本确认;90:已完成
店铺idshop_idInt11店铺id
订单idtrade_idInt11订单id
原始退换单号
raw_refund_nosString
255
原始退换单号
支付订单号
pay_idString
40
支付订单号
分销退换单号
provider_refund_noString
40
分销原始单号
店铺平台id
shop_platform_idInt

店铺平台id
原始单号
tid_listString

原始单号
子平台id
sub_platform_idInt
子平台id
退回仓库id
return_warehouse_idInt
退回仓库id
平台id
platform_idInt
平台id
奇门货主编号
wms_owner_noString40
奇门货主编号
退回仓库类型warehouse_typeInt4退回仓库类型
拦截原因bad_reasonInt11拦截原因
最后修改时间modified_dateString40最后修改时间
退换信息return_mask_infoString255退换信息
处理状态process_statusInt4处理状态
退款原因idreason_idInt11退款原因id
驳回原因idrevert_reasonInt11驳回原因id
客户idcustomer_idInt11客户id
发货方式consign_modeInt

0:并

1:交替

2:顺延

退款创建时间refund_timeString40

退款创建时间,格式: yyyy-MM-dd HH:mm:ss

退换单详情detail_listList<Map<String, Object>>
退换单详情
金额明细amount_detail_listList<Map<String, Object>>
金额明细
换出订单

swap_order

Map<String,Object>
非换货类型的单据不返回

detail_list

名称字段类型长度
必须描述
退换单明细Idrec_id
Int11明细唯一键
退换单idrefund_id
Int11退换单id
原始子单号oid
String40原始子单号
订单明细idtrade_order_id
Int11订单明细id
平台idplatform_idInt11平台id,见附件
原始单号
tidString40原始单号
系统订单编号trade_noString40系统订单编号
数量num

Decimal(19,4)


实际发出数量
价格price

Decimal(19,4)


价格, 系统订单明细分摊后价格
原价

original_price

Decimal(19,4)


原价, 系统订单明细标价
成本价checked_cost_price

Decimal(19,4)


成本价
退款数量

refund_num

Decimal(19,4)


退款数量
退款总额

total_amount

Decimal(19,4)


退款总额, 系统订单明细的分摊后金额

退款金额refund_amount

Decimal(19,4)


已经退款的总金额
担保退款is_guaranteebool1

是否担保退款

是:true;否:false

货品编号goods_noString40货品编号
货品名称goods_nameString255货品名称
规格名spec_nameString100规格名
商家编码spec_noString40商家编码
平台货品idgoods_idString40平台货品id
平台规格idspec_idString40平台规格id
系统货品idsys_goods_idInt11系统货品id(旺店通货品档案中货品维度自增生成的id)
系统规格idsys_spec_idInt11系统规格id(旺店通货品档案中单品维度自增生成的id)
规格码spec_codeString40规格码
条码
barcodeString50条码
入库数量stockin_num

Decimal(19,4)


退货入库数量
备注remarkString255备注
平台规格名称api_spec_nameString100平台规格名称
平台货品名称api_goods_nameString255
平台货品名称
最后修改时间modifiedString40最后修改时间
组合装编号suite_noString40组合装编号(单据中若不包含组合装,该字段不返回)
组合装名称suite_nameString255组合装名称(单据中若不包含组合装,该字段不返回)
原始退款单号raw_refund_nosString

按照oid和platform_id匹配原始退款单数据, 包含已取消的原始退款单号,

多个原始退款单号之间使用英文逗号隔开
原始退款单号raw_refund_noString40原始退款单递交时刷新该值,取值与客户端保持一致
订单idsales_trade_idInt11订单id
总折扣金额discountDecimal(19,4)
总折扣金额
已支付金额paidDecimal(19,4)
已支付金额
组合装idsuite_idInt
组合装id
组合装数量suite_numDecimal(19,4)
组合装数量
创建时间createdString40创建时间
最后修改时间modified_dateString40最后修改时间

amount_detail_list

名称字段类型长度
必须描述
金额明细记录idrec_idInt11
金额明细记录id
退换单idrefund_idInt11退换单id
退换类型refund_typeInt
111: 货款 2:邮费 99:返现
金额流向is_returnInt4

0:商家->买家

1:买家->商家

退款金额refund_amountDecimal(19,4)
退款金额
收款金额receive_amountDecimal(19,4)
收款金额
是否担保支付is_guaranteebool

1:担保支付

0:非担保支付

支付账户
account_idInt11
支付账户
买家账号
pay_accountString128
买家账号仅自有平台及线下平台返回,其他平台均不返回
买家开户人姓名
account_nameString100买家开户人姓名
开户银行
account_bankString40开户银行
是否系统自动生成

is_auto

boolean

是否系统自动生成
备注remarkString255备注

swap_order

名称字段类型长度
必须描述
换出订单原始单号tid

String

40
换出订单原始单号
店铺编号shop_no

String

20店铺编号
店铺名称shop_name

String

50店铺名称
仓库名称

warehouse_no

String

40仓库名称
店铺id
shop_idInt
店铺id
仓库id
warehouse_id

Int


仓库id
省份idswap_province

Int

11省份id
城市idswap_city

Int

11城市id
地区swap_area

String

40地区
地区idswap_district

Int

11地区id
换货新订单物流公司idswap_logistics_id

Int

6换货新订单物流公司id
换货邮费post_amount

Decimal(19,4)


换货邮费
其他金额other_amount

Decimal(19,4)


其他金额
换出订单明细swap_order_detail_list

List<Map<String, Object>>


换出订单明细

swap_order_detail_list

名称字段类型长度
必须描述
原始子单号oidString40原始子单号
货品类型target_typeByte6货品类型(1 单品,2 组合装)
换出货品idtarget_idInt
11换出货品id
是否残次品defectboolean1是否残次品
货品名称goods_nameString255货品名称
货品编号goods_noString40货品编号
规格名称spec_nameString100规格名称
规格码spec_codeString40规格码
商家编码merchant_noString40
商家编码,换出货品为组合装则此编码为组合装的商家编码
零售价
price

Decimal(19,4)


零售价
总价
total_amount

Decimal(19,4)


总价
数量num

Decimal(19,4)


数量
备注remarkString255备注


5.请求示例

Json格式请求报文
[{
"modified_from": "2020-01-01 00:00:00",
"modified_to": "2020-01-20 00:00:00"
}]
PHP

<?php
header("Content-Type: text/html; charset=UTF-8");
date_default_timezone_set("Asia/Shanghai");
require_once('wdtsdk.php');
 
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret");
 
$parMap = new stdClass();
$parMap->modified_from= "2020-01-01 00:00:00";
$parMap->modified_to= "2020-01-20 00:00:00";
 
$pager = new Pager(1, 0, true);
 
$response = $client->pageCall("aftersales.refund.Refund.search", $pager, $parMap);
 
?>

6.响应示

   6.1 正常响应示例 

JSON

{
	"status": 0,
	"data": {
		"total_count": 1,
		"order": [{
			"warehouse_type": 1,
			"provider_refund_no": "",
			"detail_list": [{
				"rec_id": 1135852,
				"refund_id": 1129928,
				"platform_id": 0,
				"oid": "AD202110260013",
				"tid": "ys111465",
				"trade_no": "JY20220530000025",
				"checked_cost_price": 1.8,
				"num": 1,
				"price": 21,
				"original_price": 21,
				"refund_num": 1,
				"total_amount": 21,
				"refund_amount": 21,
				"is_guarantee": false,
				"goods_no": "54260005",
				"goods_name": "番茄味雪糕",
				"spec_name": "中",
				"spec_no": "1999910005",
				"spec_code": "M",
				"barcode": "BC201911280006",
				"stockin_num": 1,
				"remark": "",
				"api_goods_name": "番茄味雪糕",
				"sales_trade_id": 2504824,
				"api_spec_name": "中",
				"trade_order_id": 4999052,
				"modified": 1679366011000,
				"sys_goods_id": 46092,
				"sys_spec_id": 183923,
				"discount": 0,
				"paid": 21,
				"suite_id": 0,
				"suite_no": "",
				"suite_name": "",
				"suite_num": 0,
				"created": "2023-02-10 13:49:41",
				"modified_date": "2023-03-21 10:33:31",
				"raw_refund_no": "",
				"raw_refund_nos": ""
			}],
			"refund_no": "TK2302100004",
			"bad_reason": 0,
			"return_telno": "",
			"type": 2,
			"trade_id": 2504824,
			"modified": 1679435561000,
			"shop_no": "mxgd",
			"created": 1676008181000,
			"trade_no_list": "JY20220530000025",
			"return_logistics_no": "202206020001",
			"return_goods_amount": 21,
			"modified_date": "2023-03-22 05:52:41",
			"shop_platform_id": 0,
			"refund_id": 1129928,
			"shop_id": 267,
			"src_tids": "ys111465",
			"actual_refund_amount": 21,
			"refund_time": "",
			"receive_amount": 0,
			"pay_id": "",
			"status": 80,
			"return_mask_info": "",
			"tmp_data": 290,
			"tid_list": "ys111465",
			"remark": "物流:202206020001;货品:[1999910005*1];追加:66600;建单人:jiangxue",
			"sub_platform_id": 0,
			"stockin_status": 3,
			"flag_name": "无",
			"return_goods_count": 1,
			"receiver_telno": "18723090064",
			"receiver_name": "小火柴",
			"return_warehouse_id": 290,
			"note_count": 0,
			"from_type": 1,
			"raw_refund_nos": "",
			"amount_detail_list": [{
				"rec_id": 1129497,
				"refund_id": 1129928,
				"refund_type": 1,
				"is_return": 1,
				"refund_amount": 21,
				"receive_amount": 0,
				"is_guarantee": false,
				"account_id": 0,
				"pay_account": "",
				"account_name": "",
				"account_bank": "",
				"remark": "",
				"is_auto": false
			}],
			"consign_mode": 0,
			"guarantee_refund_amount": 0,
			"return_logistics_name": "奇门销退顺丰",
			"settle_time": "2023-03-22 05:52:41",
			"reason_id": 0,
			"buyer_nick": "小火柴",
			"operator_name": "jiangxue",
			"revert_reason": 0,
			"return_warehouse_no": "xhcck",
			"direct_refund_amount": 21,
			"platform_id": "0",
			"sync_return": true,
			"customer_name": "~HHqnmLnxphoxZtjmNSHoyQ==~1~",
			"reason_name": "无",
			"customer_id": 4142321,
			"return_mask": 0,
			"revert_reason_name": "无"
		}]
	}
}

   6.2 异常响应示例

JSON

{
"status": 100,
"message": "参数中必须包含起止时间"
}


常用工具