旺店通·企业奇门旺店通奇门退换管理查询V3.0 API

Platform: 旺店通·企业奇门
Type: QUERY
Effect: QUERY
API Version: 1.0
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: 2023-06-08

旺店通奇门退换管理查询V3.0

POSTwdt.refund.query

Factory

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

Request Parameters

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

Response Parameters

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

The 旺店通奇门退换管理查询V3.0 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.