退款管理 · 英文版開發文檔

# 退款管理一、買家申請退款文件路徑：shop/controllers/Buyer/Service/ReturnCtl.php ``` <pre class="calibre14">``` //根據URL參數act，判斷視圖 if ($act == "detail") { $data = $this->detail(); $this->view->setMet('detail'); $d = $data; } elseif ($act == "add") { $data = $this->add(); if ($data == -3) { $this->view->setMet('error3'); }elseif($data == -4){ $this->view->setMet('error4'); } elseif ($data == -1) { $this->view->setMet('error2'); } elseif ($data == 0) { $this->view->setMet('error'); } else { $this->view->setMet('add'); } } ``` ``` 視圖：shop/views/default/Buyer/Service/ReturnCtl/add.php 退款表單提交： ``` <pre class="calibre14">``` $('#form').validator({ ...... }).on("click", "#handle_submit", function (e) { submit_trigger ? $(e.delegateTarget).trigger("validate") : submit_trigger = false; }); ``` ``` 方法：addReturn() ``` <pre class="calibre14">``` //如果是貨到付款，確認收貨（付款）后才能退款 if($order['payment_id'] == PaymentChannlModel::PAY_CONFIRM){ if($order['order_status'] < Order_StateModel::ORDER_RECEIVED) { $flag2 = false; } fb($flag2); fb('flag22'); } //退款(貨到付款只支持退貨，不支持退款) if($goods['order_goods_status'] == Order_StateModel::ORDER_PAYED && $order['payment_id'] !== PaymentChannlModel::PAY_CONFIRM) { //白條支付不支持退款和退貨 if(strstr($order['payment_name'],'白條支付')){ $flag2 = false; } fb($flag2); fb('flag23'); $field['return_goods_return'] = 0; //是否需要退貨 0-不需要 1-需要 $return = $this->orderReturnModel->getByWhere(array( 'order_goods_id' => $goods_id, 'return_type' => Order_ReturnModel::RETURN_TYPE_ORDER, 'return_state:!=' => Order_ReturnModel::RETURN_SELLER_UNPASS )); } ``` ``` 二、買家審核退款文件路徑：shop/controllers/Seller/Service/ReturnCtl.php 視圖：shop/views/default/Seller/Service/ReturnCtl/detail.php 處理結果表單提交： ``` <pre class="calibre14">``` $('#form').validator({ ignore: ':hidden', theme: 'yellow_right', timely: 1, stopOnError: false, fields: {return_shop_message: "required"}, valid: function (form) { //表單驗證通過，提交表單 ...... }).on("click", "#handle_submit", function (e) { //同意 ajax_url = SITE_URL + '?ctl=Seller_Service_Return&met=agreeReturn&typ=json'; $(e.delegateTarget).trigger("validate"); }).on("click", "#handle_close", function (e) { //不同意 ajax_url = SITE_URL + '?ctl=Seller_Service_Return&met=closeReturn&typ=json'; $(e.delegateTarget).trigger("validate"); }); ``` ``` 三、平臺審核，退款完成文件路徑：shop/controllers/Api/Trade/ReturnCtl.php 視圖：shop\_admin/view/default/Trade/ReturnCtl/detail.php JS：shop\_admin/static/default/js/controllers/trade/return/detail.js 四、買家退款管理文件路徑：shop/controllers/Seller/Service/ReturnCtl.php - 退款流程：申請退款->賣家同意->平臺同意->退款成功 - 退款狀態： ``` <pre class="calibre14">``` //模型：shop/models/Order/ReturnModel.php public function __construct() { parent::__construct(); $this->return_state = array( '1' => __("等待賣家審核"), '2' => __("賣家審核通過"), '3' => __("賣家審核未通過"), '4' => __("等待平臺審核"), '5' => __("退款/貨完成"), ); $this->return_type = array( '1' => __("退款"), '2' => __("退貨"), '3' => __("虛擬訂單退款") ); } ``` ``` - 視圖：根據URL獲得參數act的值，判斷視圖 ``` <pre class="calibre14">``` if ($act == "detail") { $data = $this->detail(); $this->view->setMet('detail'); } else { //orderReturn.php } ``` ``` 1.退款管理列表方法：orderReturn()、listReturn() ``` <pre class="calibre14">``` $data = $this->listReturn(Order_ReturnModel::RETURN_TYPE_ORDER); public function listReturn($type) { $data = $this->orderReturnModel->getReturnList($cond_row, array('return_add_time' => 'DESC'), $page, $rows); } ``` ``` 2.查看退款詳情視圖：shop/views/default/Seller/Service/ReturnCtl/detail.php - 賣家同意退款方法：agreeReturn() ``` <pre class="calibre14">``` //判斷該筆退款金額的訂單是否已經結算 $Order_BaseModel = new Order_BaseModel(); $order_base = $Order_BaseModel->getOne($return['order_number']); //判斷該筆訂單是否已經收貨，如果沒有收貨的話，不扣除賣家資金。已確認收貨則扣除賣家資金 if($order_base['order_status'] == $Order_StateModel::ORDER_FINISH ) { $order_finish = false; //獲取用戶的賬戶資金資源 $key = Yf_Registry::get('shop_api_key'); $formvars = array(); $user_id = Perm::$userId; $formvars['user_id'] = $user_id; $formvars['app_id'] = Yf_Registry::get('shop_app_id'); $money_row = get_url_with_encrypt($key, sprintf('%s?ctl=Api_User_Info&met=getUserResourceInfo&typ=json', Yf_Registry::get('paycenter_api_url')), $formvars); $user_money = 0; $user_money_frozen = 0; if ($money_row['status'] == '200') { $money = $money_row['data']; $user_money = $money['user_money']; $user_money_frozen = $money['user_money_frozen']; } $shop_return_amount = $return['return_cash'] - $return['return_commision_fee']; //獲取該店鋪最新的結算結束日期 $Order_SettlementModel = new Order_SettlementModel(); $settlement_last_info = $Order_SettlementModel->getLastSettlementByShopid(Perm::$shopId, $return['order_is_virtual']); if($settlement_last_info) { $settlement_unixtime = $settlement_last_info['os_end_date'] ; } else { $settlement_unixtime = ''; } $settlement_unixtime = strtotime($settlement_unixtime); $order_finish_time = $order_base['order_finished_time']; $order_finish_unixtime = strtotime($order_finish_time); fb($settlement_unixtime); if($settlement_unixtime >= $order_finish_unixtime ) { //結算時間大于訂單完成時間。需要扣除賣家的現金賬戶 $money = $user_money; $pay_type = 'cash'; } else { //結算時間小于訂單完成時間。需要扣除賣家的凍結資金,如果凍結資金不足就扣除賬戶余額 $money = $user_money_frozen + $user_money; $pay_type = 'frozen_cash'; } } else { $order_finish = true; } ``` ``` - 賣家不同意退款方法：closeReturn() `$edit_flag = $this->orderReturnModel->editReturn($order_return_id, $data);` 五、買家退款管理 1.退款申請列表文件路徑：shop/controllers/Buyer/Service/ReturnCtl.php 視圖：shop/views/default/Buyer/Service/ReturnCtl/index.php `$data = $this->orderReturnModel->getReturnList($cond_row, array('return_add_time' => 'DESC'), $page, $rows);` 2.退款詳情文件路徑：shop/controllers/Buyer/Service/ReturnCtl.php 視圖：shop/views/default/Buyer/Service/ReturnCtl/detail.php ``` <pre class="calibre15">``` //查找退貨單信息 $data = $this->orderReturnModel->getReturn($cond_row); //查找訂單信息 $order_base = $this->orderBaseModel->getOne($data['order_number']); //如果下單這為當前用戶或者此訂單是主管賬號支付訂單并且當前用戶是主管賬號，則當前用戶可以查看該筆訂單的退款退貨狀態 if($order_base['buyer_user_id'] == Perm::$userId || ($order_base['order_sub_pay'] == Order_StateModel::SUB_USER_PAY && $order_base['order_sub_user'] == Perm::$userId)) { if ($data['return_type'] == Order_ReturnModel::RETURN_TYPE_GOODS) { $data['text'] = __("退貨"); } else { $data['text'] = __("退款"); } if($data['order_goods_id']) { $data['refund_goods'] = $this->orderGoodsModel->getOne($data['order_goods_id']); } $data['order'] = $order_base; $return_limit = $this->orderReturnModel->getByWhere(array( 'order_number' => $data['order']['order_id'], 'return_state:!=' => Order_ReturnModel::RETURN_SELLER_UNPASS )); $cash = 0; foreach ($return_limit as $v) { $cash += $v['return_cash']; } $data['return_limit'] = $cash; ``` ```