## 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 { } ~~~