旺店通·企业奇门查询退换管理_v1 API

Platform: 旺店通·企业奇门
Type: WebAPI
Effect: QUERY
API Version: 0.1
Adapter: \Adapter\Wdt\WdtQMQueryAdapter
Auth Mode: OTHER
Help Link: https://open.wangdian.cn/qyb/open/apidoc/doc?path=refund_query.php
Doc Link: https://open.wangdian.cn/qyb/open/apidoc/doc?path=refund_query.php
Updated At: 2022-05-26

查询退换管理_v1

POSTwdt.refund.query

Factory

{
  "operation": {
    "method": "none"
  }
}

Request Parameters

No.	Field	Name	Type	Default	Required	Description
1	process_status	process_status	string	1	Optional	退换单处理状态 5 补款 10已取消 20待审核 30已同意 40已拒绝 50待财审 60待收货 63待推送 64推送失败 65委外待收货 69待收货(已结算) 70部分到货 71部分到货(已结算) 80待结算 90已完成
2	time_type	time_type	string	1	Optional	0，最后更新时间，1，结算时间。默认值0
3	start_time	start_time	string	1	Optional	按最后修改（结算）时间增量获取数据,start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
4	end_time	end_time	string	1	Optional	按最后修改时间（结算）增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
5	page_size	page_size	string	{{PAGINATION_PAGE_SIZE}}	Optional	每页返回的数据条数，输入值范围1~40，不传本参数，输入值默认为40，使用举例单击这里
6	shop_no	shop_no	string	1	Optional	店铺编号
7	page_no	page_no	string	1	Optional	不传值默认从0页开始
8	refund_no	refund_no	string	1	Optional	Erp内退换单编号，传该字段可以不传时间
9	src_refund_no	src_refund_no	string	1	Optional	平台原始退换单号，传该字段可以不传时间
10	trade_no	trade_no	string	1	Optional	系统订单编号，传该字段可以不传时间
11	tid	tid	string	1	Optional	原始单号，传该字段可以不传时间

Response Parameters

No.	Field	Name	Type	Default	Required	Description
1	modified	modified	string	1	Optional	最后修改时间格式：yyyy-MM-dd HH:mm:ss
2	refund_id	refund_id	string	1	Optional	退换单主键
3	refund_no	refund_no	string	1	Optional	erp退换单号，默认TK开头
4	finish_time	finish_time	string	1	Optional	旺店通内操作结算的时间格式：yyyy-MM-dd HH:mm:ss
5	customer_no	customer_no	string	1	Optional	客户档案编号
6	api_outer_no	api_outer_no	string	1	Optional	接口创建退换单的外部单号
7	platform_id	platform_id	string	1	Optional	平台类型，响应值为代表平台的ID数字，ID对应的平台名称单击这里
8	customer_name	customer_name	string	1	Optional	收件人姓名（如需唯一值，以receiver_name为准）
9	src_no	src_no	string	1	Optional	平台退款单号
10	swap_zip	swap_zip	string	1	Optional	收件人邮编
11	swap_logistics_type	swap_logistics_type	string	1	Optional	响应值为代表换货新订单物流公司类别的数字，数字对应的物流公司类别名称单击这里
12	type	type	string	1	Optional	1退款(未发货，退款申请)2退货3换货4退款不退货5订单补款
13	process_status	process_status	string	1	Optional	5补款10已取消20待审核30已同意40已拒绝50待财审60待收货63待推送64推送失败65委外待收货69待收货(已结算)70部分到货71部分到货(已结算)80待结算90已完成
14	swap_logistics_name	swap_logistics_name	string	1	Optional	换货新订单物流公司名称
15	creator_name	creator_name	string	1	Optional	建单员姓名
16	status	status	string	1	Optional	平台状态0表示为空，1取消退款，2已申请退款，3等待退货，4等待收货，5退款成功，10换货待处理，20待买家退货，30买家已退货待收货，40待买家修改，50待发出换货商品，55待买家收货，60换货改退货，70换货关闭，80换货成功
17	guarantee_mode	guarantee_mode	string	1	Optional	担保方式1担保交易2非担保交易3非担保在线交易（ecshop）
18	error_msg	error_msg	string	1	Optional	逆向物流错误信息
19	cs_status	cs_status	string	1	Optional	退款阶段 0售中 1售后
20	created	created	string	1	Optional	创建时间
21	shop_no	shop_no	string	1	Optional	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置）
22	outer_no	outer_no	string	1	Optional	默认为''，外部编号,与wms对接使用
23	shop_name	shop_name	string	1	Optional	店铺名称
24	swap_trade_id	swap_trade_id	string	1	Optional	换出原始单id
25	warehouse_id	warehouse_id	string	1	Optional	默认为'0'，期望退回的仓库
26	pay_account	pay_account	string	1	Optional	买家支付帐号
27	shop_id	shop_id	string	1	Optional	店铺id
28	pay_no	pay_no	string	1	Optional	支付订单号
29	advance_status	advance_status	string	1	Optional	111
30	goods_amount	goods_amount	string	1	Optional	退货金额
31	refund_amount	refund_amount	string	1	Optional	买家申请退款金额
32	is_goods_received	is_goods_received	string	1	Optional	默认为'0'，买家是否收到货
33	customer_id	customer_id	string	1	Optional	默认为'0'，客户id
34	direct_refund_amount	direct_refund_amount	string	1	Optional	订单确认收货之后的退款金额
35	guarante_refund_amount	guarante_refund_amount	string	1	Optional	平台退款金额
36	swap_warehouse_id	swap_warehouse_id	string	1	Optional	默认为'0'，换出货品出库仓库
37	actual_refund_amount	actual_refund_amount	string	1	Optional	实际退款/收款金额
38	swap_logistics_id	swap_logistics_id	string	1	Optional	默认为'0'，换货新订单物流公司ID
39	warehouse_type	warehouse_type	string	1	Optional	111
40	exchange_amount	exchange_amount	string	1	Optional	换货金额
41	post_amount	post_amount	string	1	Optional	邮费金额
42	wms_status	wms_status	string	1	Optional	默认为'0'，外部状态,与wms对接使用0初始化1失败2成功
43	other_amount	other_amount	string	1	Optional	其它金额
44	wms_result	wms_result	string	1	Optional	默认为''，外部结果,与wms对接使用
45	wms_outer_no	wms_outer_no	string	1	Optional	默认为''，对应外部仓库的单号
46	paid	paid	string	1	Optional	已退款/已收款
47	from_type	from_type	string	1	Optional	默认为'1'，建立方式1api抓单2手式建单3外部导入4天猫换货5菜鸟回传自动创建
48	tid	tid	string	1	Optional	订单的原始单号
49	sales_trade_id	sales_trade_id	string	1	Optional	系统订单ID
50	return_goods_count	return_goods_count	string	1	Optional	默认为'0'，退回货品数量
51	sales_tid	sales_tid	string	1	Optional	系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
52	op_constraint	op_constraint	string	1	Optional	默认为'0'，1不允许拒绝2需要到网页版操作
53	buyer_nick	buyer_nick	string	1	Optional	昵称
54	refund_version	refund_version	string	1	Optional	默认为''，退款版本,大于0后表明已经从平台下载完成，退款单不可修改
55	receiver_name	receiver_name	string	1	Optional	收件人姓名
56	consign_mode	consign_mode	string	1	Optional	默认为'0'，发货方式：0默认1审核退款单后立即生成换货订单2退货完成后生成换货订单
57	receiver_address	receiver_address	string	1	Optional	收件人地址
58	logistics_name	logistics_name	string	1	Optional	默认为''，物流公司名称
59	receiver_telno	receiver_telno	string	1	Optional	收件人电话
60	logistics_no	logistics_no	string	1	Optional	默认为''，物流单号
61	push_no	push_no	string	1	Optional	默认为''，物流递交单号
62	return_name	return_name	string	1	Optional	退货人姓名
63	return_mobile	return_mobile	string	1	Optional	退货人手机号
64	logistics_style	logistics_style	string	1	Optional	默认为'0'，取件方式:0客户取件，1顺丰取件，2拒收退回
65	reason_id	reason_id	string	1	Optional	默认为'0'，原因
66	return_telno	return_telno	string	1	Optional	退货人电话
67	revert_reason	revert_reason	string	1	Optional	默认为'0'，驳回原因
68	return_address	return_address	string	1	Optional	退回仓库地址
69	return_logistics_name	return_logistics_name	string	1	Optional	退回物流公司名称
70	bad_reason	bad_reason	string	1	Optional	默认为'0'，错误原因
71	return_mask	return_mask	string	1	Optional	111
72	return_logistics_no	return_logistics_no	string	1	Optional	退回物流单号
73	swap_receiver	swap_receiver	string	1	Optional	换货收件人姓名
74	is_trade_charged	is_trade_charged	string	1	Optional	默认为'0'，是否结算后生成订单
75	swap_mobile	swap_mobile	string	1	Optional	换收发件人姓名手机
76	stockin_pre_no	stockin_pre_no	string	1	Optional	默认为''，预入库单
77	swap_telno	swap_telno	string	1	Optional	换货收件人姓名电话
78	revert_reason_info	revert_reason_info	string	1	Optional	驳回原因名称
79	refund_order_list	refund_order_list	array	1	Optional	退款子订单信息,refund_order_list结构
80	swap_province	swap_province	string	1	Optional	换货收件人省份
81	refund_out_goods_list	refund_out_goods_list	array	1	Optional	换出货品信息列表,refund_out_goods_list结构
82	swap_city	swap_city	string	1	Optional	换货收件人城市
83	swap_district	swap_district	string	1	Optional	换货收件人区县
84	order_id	order_id	string	1	Optional	退换单退回货品明细主键
85	refund_id	refund_id	string	1	Optional	退换单主键
86	swap_area	swap_area	string	1	Optional	换货收件人省市区
87	oid	oid	string	1	Optional	原始子订单编号
88	swap_warehouse_no	swap_warehouse_no	string	1	Optional	换出货品出库仓库编号
89	tid	tid	string	1	Optional	订单子订单的原始单号
90	swap_address	swap_address	string	1	Optional	换货收件人姓名地址
91	warehouse_no	warehouse_no	string	1	Optional	期望退回的仓库编号
92	src_no	src_no	string	1	Optional	平台退款单号
93	refund_time	refund_time	string	1	Optional	退款创建时间格式：yyyy-MM-dd HH:mm:ss
94	process_status	process_status	string	1	Optional	处理状态0已取消10待递交20待审核30已同意40已拒绝50待财审60待收货70部分到货80已完成
95	sales_tid	sales_tid	string	1	Optional	销售订单编号
96	remark	remark	string	1	Optional	退款说明
97	refund_reason	refund_reason	string	1	Optional	退款的具体原因说明
98	order_num	order_num	string	1	Optional	实际数量
99	price	price	string	1	Optional	价格
100	swap_trade_no	swap_trade_no	string	1	Optional	ERP生成的换出订单的原始订单编号
101	platform_id	platform_id	string	1	Optional	平台类型，响应值为代表平台的ID数字，ID对应的平台名称单击这里
102	cost_price	cost_price	string	1	Optional	成本价
103	original_price	original_price	string	1	Optional	原价
104	discount	discount	string	1	Optional	优惠
105	paid	paid	string	1	Optional	已付金额
106	market_price	market_price	string	1	Optional	单品市场价
107	refund_num	refund_num	string	1	Optional	退款数量
108	refund_order_amount	refund_order_amount	string	1	Optional	明细退款金额，由主单退款金额分摊
109	total_amount	total_amount	string	1	Optional	退货金额
110	spec_id	spec_id	string	1	Optional	erp商品主键
111	spec_no	spec_no	string	1	Optional	代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里
112	goods_name	goods_name	string	1	Optional	货品名称
113	goods_no	goods_no	string	1	Optional	代表货品(spu)所有属性的唯一编号，用于系统货品区分，，SPU概念介绍,单击这里
114	spec_name	spec_name	string	1	Optional	规格名称
115	spec_code	spec_code	string	1	Optional	规格编码
116	suite_no	suite_no	string	1	Optional	组合装编号
117	suite_name	suite_name	string	1	Optional	组合装名称
118	suite_num	suite_num	string	1	Optional	组合装数量
119	stockin_num	stockin_num	string	1	Optional	退货入库数量
120	remark	remark	string	1	Optional	退换明细的备注
121	is_sn_enable	is_sn_enable	string	1	Optional	默认为'0'，0不启用序列号1强序列号2弱序列号
122	position_no	position_no	string	1	Optional	货位编号
123	position_id	position_id	string	1	Optional	货位ID，入库时默认ID
124	sales_trade_id	sales_trade_id	string	1	Optional	系统订单ID
125	sales_order_id	sales_order_id	string	1	Optional	默认为'0'
126	goods_id	goods_id	string	1	Optional	平台货品ID
127	suite_id	suite_id	string	1	Optional	默认为'0'，组合装ID
128	stockin_amount	stockin_amount	string	1	Optional	默认为'0.0000'，退货入库总额
129	modified	modified	string	1	Optional	最后修改时间格式：yyyy-MM-dd HH:mm:ss
130	created	created	string	1	Optional	创建时间

The 查询退换管理_v1 API (wdt.refund.query) of 旺店通·企业奇门 is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 旺店通·企业奇门 version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.