## 1.31. User\_ReturnCtl ./shop/controllers/User/ReturnCtl.php 退款退货-发货退货,卖家也可以决定不退货退款，买家申请退款不支持。卖家可以主动退款。控制器 ### 1.31.1. 退款退货-发货退货,卖家也可以决定不退货退款，买家申请退款不支持。卖家可以主动退款。首页 #### 1.31.1.1. 请求URL api.php?ctl=User\_Return&met=index&typ=json #### 1.31.1.2. 返回数据 ~~~json { } ~~~ ### 1.31.2. 退款退货-发货退货,卖家也可以决定不退货退款，买家申请退款不支持。卖家可以主动退款。管理界面 #### 1.31.2.1. 请求URL api.php?ctl=User\_Return&met=manage&typ=json #### 1.31.2.2. 返回数据 ~~~json { } ~~~ ### 1.31.3. 退款退货-发货退货,卖家也可以决定不退货退款，买家申请退款不支持。卖家可以主动退款。列表数据 #### 1.31.3.1. 请求URL api.php?ctl=User\_Return&met=lists&typ=json #### 1.31.3.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | page | int | 当前页码 | | rows | int | 每页记录条数 | | return\_id | string | 描述 | | return\_id | string | 描述 | #### 1.31.3.3. 返回数据 ~~~json { } ~~~ ### 1.31.4. 读取退款退货-发货退货,卖家也可以决定不退货退款，买家申请退款不支持。卖家可以主动退款。 #### 1.31.4.1. 请求URL api.php?ctl=User\_Return&met=get&typ=json #### 1.31.4.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | return\_id | string | 退单号 | #### 1.31.4.3. 返回数据 ~~~json { } ~~~ ### 1.31.5. 订单item详情,用于退款申请 #### 1.31.5.1. 请求URL api.php?ctl=User\_Return&met=getDetailByReturnId&typ=json #### 1.31.5.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | return\_id | string | 描述 | #### 1.31.5.3. 返回数据 ~~~json { } ~~~ ### 1.31.6. 订单item详情,列出订单的item，及退款详情 #### 1.31.6.1. 请求URL api.php?ctl=User\_Return&met=returnItem&typ=json #### 1.31.6.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | order\_id | string | 描述 | | order\_item\_id | int | 描述 | #### 1.31.6.3. 返回数据 ~~~json { } ~~~ ### 1.31.7. 订单item详情,列出订单的item #### 1.31.7.1. 请求URL api.php?ctl=User\_Return&met=orderReturn&typ=json #### 1.31.7.2. 返回数据 ~~~json { } ~~~ ### 1.31.8. 取消退货 #### 1.31.8.1. 请求URL api.php?ctl=User\_Return&met=cancel&typ=json #### 1.31.8.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | return\_id | string | 描述 | #### 1.31.8.3. 返回数据 ~~~json { } ~~~ ### 1.31.9. 确认收款 #### 1.31.9.1. 请求URL api.php?ctl=User\_Return&met=confirmRefund&typ=json #### 1.31.9.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | return\_id | string | 描述 | #### 1.31.9.3. 返回数据 ~~~json { } ~~~ ### 1.31.10. 添加退款退货-发货退货,卖家也可以决定不退货退款，买家申请退款不支持。卖家可以主动退款。 #### 1.31.10.1. 请求URL api.php?ctl=User\_Return&met=addItem&typ=json #### 1.31.10.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | order\_id | string | 描述 | | return\_id | string | 退单号 | | return\_reason\_id | int | 描述 | | return\_buyer\_message | string | 描述 | | order\_item\_id | string | 退货商品编号(DOT):0为退款 | | return\_item\_num | int | 退货商品编号(DOT):0为退款 | | return\_refund\_amount | float | 退款金额 = goods\_payment\_amount/goods\_quantity, 因为涉及到折扣等等 或者 为订单中 order\_payment\_amount | | return\_reason\_id | int | 退款理由id | | return\_buyer\_message | string | 买家退货备注 | | refund\_pic | array | 描述 | | upload\_img | array | 描述 | #### 1.31.10.3. 返回数据 ~~~json { } ~~~ ### 1.31.11. 修改退款退货-发货退货,卖家也可以决定不退货退款，买家申请退款不支持。卖家可以主动退款。 #### 1.31.11.1. 请求URL api.php?ctl=User\_Return&met=edit&typ=json #### 1.31.11.2. 请求参数 | 键值 | 类型 | 描述 | | --- | --- | --- | | return\_id | string | 退单号 | | service\_type\_id | int | 服务类型 | | order\_id | string | 订单编号 | | return\_refund\_amount | float | 退款金额 = goods\_payment\_amount/goods\_quantity, 因为涉及到折扣等等 或者 为订单中 order\_payment\_amount | | store\_id | int | 店铺id | | seller\_user\_id | int | 卖家ID | | buyer\_user\_id | int | 买家ID | | return\_add\_time | string | 添加时间 | | return\_reason\_id | int | 退款理由id | | return\_reason | string | 退款理由 | | return\_buyer\_message | string | 买家退货备注 | | return\_addr\_contacter | string | 收货人 | | return\_tel | string | 联系电话 | | return\_addr | string | 收货地址详情 | | return\_post\_code | int | 邮编 | | express\_id | int | 物流公司编号 | | return\_tracking\_number | string | 物流单号 | | plantform\_return\_state\_id | int | 申请状态平台(ENUM):3180-处理中;3181-为待管理员处理卖家同意或者收货后;3182-为已完成 | | return\_state\_id | int | 卖家处理状态(ENUM): 3100-【客户】提交退单;3105-退单审核;3110-收货确认;3115-退款确认;3120-客户】收款确认;3125-完成 | | return\_flag | int | 退货类型(BOOL): 1-不用退货;2-需要退货 | | return\_type | int | 申请类型(ENUM): 1-退款申请; 2-退货申请; 3-虚拟退款 | | return\_order\_lock | int | 订单锁定类型(BOOL):1-不用锁定;2-需要锁定 | | return\_item\_state\_id | int | 物流状态(LIST):2030-待发货;2040-已发货/待收货确认;2060-已完成/已签收;2070-已取消/已作废; | | return\_store\_time | string | 商家处理时间 | | return\_store\_message | string | 商家备注 | | return\_commision\_fee | float | 退还佣金 | | return\_finish\_time | string | 退款完成时间 | | return\_platform\_message | string | 平台留言 | #### 1.31.11.3. 返回数据 ~~~json { } ~~~