feat(order): 添加1688订单售后退款原因查询功能

- 在admin路由中新增refundReasonList接口用于查询退款原因
- 实现AlibabaOrder控制器中的refundReasonList方法，简化参数传递逻辑
- 新增getOrderDetailBuyerView方法获取订单详情（买家视角）
- 定义REFUND_GOOD_STATUS常量映射货物状态
- 重构getRefundReasonList方法自动获取子订单号和货物状态
- 更新formatRefundReasonListResult方法返回完整的退款信息
- 在RefundOrder控制器中添加1688订单退款原因查询接口

app/controller/admin/order/RefundOrder.php

@@ -10,6 +10,7 @@
 namespace app\controller\admin\order;
 
 use app\common\repositories\user\UserRepository;
+use app\services\ThirdParty\AlibabaAgent\OrderService;
 use crmeb\basic\BaseController;
 use app\common\repositories\store\order\MerchantReconciliationorderRepository;
 use app\common\repositories\store\order\MerchantReconciliationRepository;
@@ -64,6 +65,31 @@ class RefundOrder extends BaseController
         $where = $this->request->params(['refund_order_sn','status','refund_type','date','mer_id','order_sn']);
         return app('json')->success($this->repository->getAllList($where, $page, $limit));
     }
+
+    /**
+     * @return mixed
+     * @author 史晨
+     * @date 2026/5/8 17:27
+     * 1688订单获取退款原因
+     */
+    public function refundReasonList()
+    {
+        $orderId = request()->param('order_id');
+
+        if (empty($orderId)) {
+            return app('json')->fail('订单号不能为空');
+        }
+
+        $orderService = new OrderService();
+        $params = ['orderId' => $orderId];
+        $result = $orderService->getRefundReasonList($params);
+        if ($result === false) {
+            return app('json')->fail('获取退款原因失败');
+        }
+
+        return app('json')->success($result);
+    }
+
     public function detail($id)
     {
         $data=$this->repository->getOne($id);

app/controller/api/store/order/AlibabaOrder.php

@@ -60,6 +60,9 @@ class AlibabaOrder
     /**
      * 查询退款退货原因列表
      *
+     * 客户端只需传入 order_id，服务端自动调用 alibaba.trade.get.buyerView
+     * 获取订单详情，提取子订单号和货物状态后，再调用 alibaba.trade.getRefundReasonList
+     *
      * API: alibaba.trade.getRefundReasonList-1
      *
      * @return \think\Response
@@ -67,23 +70,13 @@ class AlibabaOrder
     public function refundReasonList()
     {
         $orderId = request()->param('order_id');
-        $orderEntryIds = request()->param('order_entry_ids', '');
-        $goodsStatus = request()->param('goods_status', '');
 
         if (empty($orderId)) {
             return app('json')->fail('订单号不能为空');
         }
 
         $orderService = new OrderService();
-        $params = ['orderId' => $orderId];
-        if (!empty($orderEntryIds)) {
-            $params['orderEntryIds'] = $orderEntryIds;
-        }
-        if (!empty($goodsStatus)) {
-            $params['goodsStatus'] = $goodsStatus;
-        }
-
-        $result = $orderService->getRefundReasonList($params);
+        $result = $orderService->getRefundReasonList(['orderId' => $orderId]);
         if ($result === false) {
             return app('json')->fail('获取退款原因失败');
         }

app/services/ThirdParty/AlibabaAgent/OrderService.php

@@ -27,6 +27,20 @@ class OrderService extends AlibabaAgentBaseService
      */
     const LOGISTICS_NAMESPACE = 'com.alibaba.logistics';
 
+    const REFUND_GOOD_STATUS = [
+        // 售中等待卖家发货
+        'waitsellersend' => 'refundWaitSellerSend',
+        // 售中等待买家收货
+        'waitbuyerreceive'=>'refundWaitBuyerReceive',
+        // // 售中已收货（未确认完成交易）
+        // 'BuyerReceived'=>'refundBuyerReceived',
+        // // 售后未收货
+        // 'saleBuyerNotReceived'=>'aftersaleBuyerNotReceived',
+        // // 售后已收到货
+        // 'saleBuyerReceived'=>'aftersaleBuyerReceived',
+
+    ];
+
     /**
      * 预下单
      *
@@ -509,33 +523,51 @@ class OrderService extends AlibabaAgentBaseService
     }
 
     /**
-     * 查询退款退货原因列表
+     * 获取订单详情（买家视角）
      *
-     * API: com.alibaba.trade:alibaba.trade.getRefundReasonList-1
+     * API: com.alibaba.trade:alibaba.trade.get.buyerView-1
      *
-     * 接口文档: https://open.1688.com/api/apidocdetail.htm?id=com.alibaba.trade%3Aalibaba.trade.getRefundReasonList-1
+     * @param string $orderId 1688订单号
+     * @return array|false
+     */
+    public function getOrderDetailBuyerView(string $orderId)
+    {
+        if (empty($orderId)) {
+            Log::channel('alibaba')->error('[获取订单详情] orderId不能为空');
+            return false;
+        }
+
+        $businessParams = [
+            'orderId' => $orderId,
+            'webSite' => 1688,
+        ];
+
+        $result = $this->executeParam2(
+            self::NAMESPACE,
+            'alibaba.trade.get.buyerView',
+            1,
+            $businessParams
+        );
+
+        if ($result === false) {
+            Log::channel('alibaba')->error('[获取订单详情] API请求失败, orderId:' . $orderId);
+            return false;
+        }
+
+        Log::channel('alibaba')->info('[获取订单详情] API请求成功, orderId:' . $orderId . ', result:' . json_encode($result, JSON_UNESCAPED_UNICODE));
+
+        return $result;
+    }
+
+    /**
+     * 查询退款退货原因列表
      *
-     * 请求参数:
-     *   - orderId: 订单号（必填）
-     *   - orderEntryIds: 子订单号（可选，多个用逗号分隔）
+     * 流程:
+     * 1. 先调用 alibaba.trade.get.buyerView 获取订单详情
+     * 2. 从订单详情中提取子订单号(orderEntryIds)、货物状态、可退款金额、可退运费
+     * 3. 再调用 alibaba.trade.getRefundReasonList 获取退款原因
      *
-     * 返回示例:
-     * {
-     *   "result": [
-     *     {
-     *       "refundId": "REFUND123456",
-     *       "refundType": "退货退款",
-     *       "refundStatus": "waitSellerAgree",
-     *       "refundReasonList": [
-     *         {
-     *           "reasonId": 1,
-     *           "reasonText": "质量问题"
-     *         }
-     *       ]
-     *     }
-     *   ],
-     *   "success": true
-     * }
+     * API: com.alibaba.trade:alibaba.trade.getRefundReasonList-1
      *
      * @param array $params 请求参数（orderId 必填）
      * @return array|false
@@ -548,20 +580,38 @@ class OrderService extends AlibabaAgentBaseService
             return false;
         }
 
-        $businessParams = [
-            'orderId' => (string)$params['orderId'],
-        ];
+        $orderId = (string)$params['orderId'];
+
+        // 1. 先获取订单详情，提取子订单号和货物状态
+        $orderDetail = $this->getOrderDetailBuyerView($orderId);
 
-        // 子订单号
-        if (!empty($params['orderEntryIds'])) {
-            $businessParams['orderEntryIds'] = '[' . (string)$params['orderEntryIds'] . ']';
+        if ($orderDetail === false) {
+            Log::channel('alibaba')->error('[获取退款原因] 获取订单详情失败, orderId:' . $orderId);
+            return false;
         }
 
-        // 货物状态
-        if (!empty($params['goodsStatus'])) {
-            $businessParams['goodsStatus'] = (string)$params['goodsStatus'];
+        // 从订单详情中提取子订单ID列表
+        $orderEntryIds = $orderDetail['result']['productItems'][0]['subItemID'] ?: '';
+        $goodsStatus = self::REFUND_GOOD_STATUS[$orderDetail['result']['productItems'][0]['status']] ?: '';
+        if (!$goodsStatus) {
+            Log::channel('alibaba')->error('[获取退款原因] 获取货物状态失败, orderId:' . $orderId);
+            return false;
         }
 
+        // 提取可退款金额和可退运费（从订单详情中）
+        // totalSuccessAmount: 实付款（分），carriage: 运费（分）
+        $applyPayment = (string)$orderDetail['result']['baseInfo']['totalAmount'] ?? 0;
+        $applyCarriage = (string)$orderDetail['result']['baseInfo']['shippingFee'] ?? 0;
+
+        // 2. 调用退款原因查询API
+        $businessParams = [
+            'orderId' => $orderId,
+            'orderEntryIds' => '[' . $orderEntryIds . ']',
+            'goodsStatus' => $goodsStatus,
+        ];
+
+        Log::channel('alibaba')->info('[获取退款原因] 准备请求, orderId:' . $orderId . ', orderEntryIds:' . json_encode($orderEntryIds) . ', goodsStatus:' . $goodsStatus);
+
         // --- 调用API ---
         $result = $this->executeParam2(
             self::NAMESPACE,
@@ -577,7 +627,7 @@ class OrderService extends AlibabaAgentBaseService
 
         Log::channel('alibaba')->info('[获取退款原因] API请求成功, result:' . json_encode($result, JSON_UNESCAPED_UNICODE));
 
-        return $this->formatRefundReasonListResult($result);
+        return $this->formatRefundReasonListResult($result, $orderId, $orderEntryIds, $goodsStatus, $applyPayment, $applyCarriage);
     }
 
     /**
@@ -595,10 +645,15 @@ class OrderService extends AlibabaAgentBaseService
      *   }
      * }
      *
-     * @param array $result API原始返回数据
+     * @param array  $result        API原始返回数据
+     * @param string $orderId       1688订单号
+     * @param string $orderEntryIds 子订单ID列表
+     * @param string $goodsStatus   货物状态
+     * @param int    $applyPayment  可退款金额（分）
+     * @param int    $applyCarriage 可退运费（分）
      * @return array
      */
-    protected function formatRefundReasonListResult(array $result): array
+    protected function formatRefundReasonListResult(array $result, string $orderId = '', string $orderEntryIds = '', string $goodsStatus = '', string $applyPayment = '0', string $applyCarriage = '0'): array
     {
         $reasons = [];
         if (isset($result['result']['result']['reasons']) && is_array($result['result']['result']['reasons'])) {
@@ -610,6 +665,13 @@ class OrderService extends AlibabaAgentBaseService
             }
         }
 
-        return $reasons;
+        return [
+            'orderId'       => $orderId,
+            'orderEntryIds' => $orderEntryIds,
+            'goodsStatus'   => $goodsStatus,
+            'applyPayment'  => $applyPayment,
+            'applyCarriage' => $applyCarriage,
+            'reasons'       => $reasons,
+        ];
     }
 }

route/admin.php

@@ -1004,6 +1004,9 @@ Route::group(config('admin.api_admin_prefix') . '/', function () {
             Route::get('refund/express/:id', 'RefundOrder/express')->name('systemStoreRefundExpress');//查询用户退货物流
 
 
+            // 1688订单售后
+            Route::get('refundReasonList','RefundOrder/refundReasonList');
+
             Route::get('dhm_list/lst', 'RefundOrder/dhm_list')->name('systemRefundOrderDhmLst');
             Route::get('dhm_status', 'RefundOrder/dhm_status')->name('systemRefundOrderDhmStatus');
             Route::get('excel', 'Order/Excel')->name('systemOrderExcel');