feat(alibaba): 添加1688快速创建订单功能并集成到店铺订单系统

- 新增 fastCreateOrder 方法实现1688快速创建订单API调用
- 新增 formatCreateOrderResult 方法格式化订单创建返回结果
- 在店铺订单仓库中集成1688运费计算逻辑
- 为商品属性值实体添加specId字段支持阿里巴巴规格ID
- 为商品实体添加isAlibaba字段标识是否为阿里商品
- 实现1688商品预览订单获取运费功能

app/common/repositories/store/order/StoreGroupOrderRepository.php

@@ -42,6 +42,7 @@ use app\entity\data\user\UserEntity;
 use app\entity\monomer\store\FzonePayTypeEntity;
 use app\entity\monomer\store\StoreOrderPensionJsonEntity;
 use app\entity\request\api\store\order\StoreOrderCreateRequestEntity;
+use app\services\ThirdParty\AlibabaAgent\OrderService;
 use think\db\exception\DbException;
 use think\exception\ValidateException;
 use think\facade\Db;
@@ -741,6 +742,29 @@ class StoreGroupOrderRepository extends BaseRepository
             //     $addressEntity->getCityId()
             // );
             $postage = 0.00; // 默认全都包邮s
+            // 1688商品要获取运费
+            if ($productEntity->getIsAlibaba() == 1) {
+                // 地址数据
+                $addressParam = [
+                    'fullName' => $addressEntity->getRealName(),
+                    'mobile' => $addressEntity->getPhone(),
+                    'provinceText' => $addressEntity->getProvince(),
+                    'cityText' => $addressEntity->getCity(),
+                    'areaText' => $addressEntity->getDistrict(),
+                    'address' => $addressEntity->getDetail(),
+                ];
+                // 商品数据
+                $cargoParamList = [
+                    'offerId' => $productEntity->getSpuId(),
+                    'specId' => $productAttrValueEntity->getSpecId(),
+                    'quantity' => $cartEntity->getCartNum()
+                ];
+                $orderService = new OrderService();
+                $alibabaOrder = $orderService->previewOrder(['cargoParamList' => $cargoParamList, 'addressParam' => $addressParam]);
+                $postage = $alibabaOrder['preview']['sumCarriage'] / 100;
+            }
+
+
 
             // 汇付手续费 （订单价格 + 邮费） * 汇付手续费比例
             $commissionRate = bcmul(bcadd($price, $postage, CommonEnum::DECIMAL_PLACES_OF_THE_AMOUNT), CommonEnum::HUIFU_COMMISSION_CHARGE, CommonEnum::DECIMAL_PLACES_OF_THE_AMOUNT);

app/entity/data/store/StoreProductAttrValueEntity.php

@@ -34,6 +34,8 @@ class StoreProductAttrValueEntity extends DataEntity
     public $stockNum = null;  // 股权%
     public $sharesNum = null;  // 股票
 
+    public $specId = null; // 阿里巴巴规格ID
+
     /**
      * @return mixed
      */
@@ -519,4 +521,15 @@ class StoreProductAttrValueEntity extends DataEntity
         $this->sharesNum = $sharesNum;
         return $this;
     }
+
+    public function getSpecId()
+    {
+        return $this->specId;
+    }
+
+    public function setSpecId($specId): StoreProductAttrValueEntity
+    {
+        $this->specId = $specId;
+        return $this;
+    }
 }

app/entity/data/store/StoreProductEntity.php

@@ -69,6 +69,8 @@ class StoreProductEntity extends DataEntity
     public $argument = null;  // 下架说明理由
     public $isStatus = null;  // 下架状态
 
+    public $isAlibaba = null; // 是否是阿里商品
+
     /**
      * @return mixed
      */
@@ -1184,4 +1186,15 @@ class StoreProductEntity extends DataEntity
         $this->isStatus = $isStatus;
         return $this;
     }
+
+    public function getIsAlibaba()
+    {
+        return $this->isAlibaba;
+    }
+
+    public function setIsAlibaba($isAlibaba): StoreProductEntity
+    {
+        $this->isAlibaba = $isAlibaba;
+        return $this;
+    }
 }

app/services/ThirdParty/AlibabaAgent/OrderService.php

@@ -147,6 +147,81 @@ class OrderService extends AlibabaAgentBaseService
     }
 
     /**
+     * 快速创建订单
+     *
+     * API: com.alibaba.trade:alibaba.trade.fastCreateOrder-1
+     *
+     * 接口文档: https://open.1688.com/api/apidocdetail.htm?id=com.alibaba.trade%3Aalibaba.trade.fastCreateOrder-1
+     *
+     * 请求参数:
+     *   - flow: 流程标识（saleproxy=分销采购, general=普通下单）
+     *   - cargoParamList: 商品列表JSON数组（alibaba.trade.fast.cargo[]），每个商品包含 offerId, quantity, specId
+     *   - addressParam: 地址参数JSON对象，包含 fullName, mobile, provinceText, cityText, areaText, address
+     *   - totalAmount: 总金额（单位：分，可选）
+     *   - message: 买家留言（可选）
+     *   - orderGroup: 订单分组标识（从预下单返回的 orderGroup 字段获取，可选）
+     *
+     * @param array $params 创建订单参数
+     * @return array|false
+     */
+    public function fastCreateOrder(array $params = [])
+    {
+        $businessParams = [];
+
+        // --- flow（流程标识） ---
+        $businessParams['flow'] = $params['flow'] ?? 'general';
+
+        // --- cargoParamList（商品列表，JSON字符串） ---
+        if (!empty($params['cargoParamList'])) {
+            $businessParams['cargoParamList'] = is_array($params['cargoParamList'])
+                ? json_encode($params['cargoParamList'], JSON_UNESCAPED_UNICODE)
+                : $params['cargoParamList'];
+        }
+
+        // --- addressParam（地址参数，JSON字符串） ---
+        if (!empty($params['addressParam'])) {
+            $businessParams['addressParam'] = is_array($params['addressParam'])
+                ? json_encode($params['addressParam'], JSON_UNESCAPED_UNICODE)
+                : $params['addressParam'];
+        }
+
+        // --- 调用API ---
+        $result = $this->executeParam2(
+            self::NAMESPACE,
+            'alibaba.trade.fastCreateOrder',
+            1,
+            $businessParams
+        );
+
+        if ($result === false) {
+            Log::channel('alibaba')->error('[创建订单] API请求失败', $businessParams);
+            return false;
+        }
+
+        return $this->formatCreateOrderResult($result);
+    }
+
+    /**
+     * 格式化创建订单返回结果
+     *
+     * @param array $result API原始返回数据
+     * @return array
+     */
+    protected function formatCreateOrderResult(array $result): array
+    {
+        // 创建订单成功返回: { "result": { "orderId": "123456", "totalAmount": 370 }, "success": true }
+        $data = $result['result'] ?? $result;
+        $success = $result['success'] ?? false;
+
+        return [
+            'success'     => $success,
+            'orderId'     => $data['orderId'] ?? 0,
+            'totalAmount' => $data['totalAmount'] ?? 0,
+            'rawData'     => $data,
+        ];
+    }
+
+    /**
      * 构建商品列表参数（便捷方法）
      *
      * @param array $items 商品列表 [['offerId' => 123, 'quantity' => 2, 'skuId' => 456], ...]