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

所属平台： 旺店通·企业奇门
类型： QUERY
作用： QUERY
接口版本： 1.0
适配器： \Adapter\Wdt\WdtQMQueryAdapter
帮助链接： https://open.wangdian.cn/qyb/open/apidoc/doc?path=refund_query.php
描述：
更新日期： 2023-06-08 17:35:45
旺店通奇门退换管理查询V3.0

接口地址：wdt.refund.query

请求方法： POST

加工厂： {"operation":{"method":"none"}}

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

卢剑航 加微信

13760755942

拥有十多年丰富的经验，擅长ERP、MES、数据中台、营销云中台等集成。他能够根据客户需求，为其提供一站式集成解决方案，帮助企业快速实现各类系统数据集成服务。

金蝶云星辰与吉客云对接
更多系统对接方案