fix(alibaba): 修正阿里巴巴物流信息字段映射

- 修正 AlibabaNotify.php 中物流单号字段从 logisticsCode 改为 logisticsBillNo
- 修正 OrderService.php 中物流信息数据结构解析逻辑
- 更新物流信息字段映射：logisticsCode 替换为 logisticsBillNo，logisticsName 替换为 logisticsCompanyName
- 添加详细的物流信息返回数据结构注释文档
- 修复因字段名不匹配导致的物流信息获取失败问题

app/controller/api/AlibabaNotify.php

@@ -141,8 +141,8 @@ class AlibabaNotify
 
         // 4. 取第一条物流信息
         $firstLogistics = $logisticsResult['logisticsItems'][0];
-        $deliveryName = $firstLogistics['logisticsName'] ?? '';
-        $deliveryId   = $firstLogistics['logisticsCode'] ?? '';
+        $deliveryName = $firstLogistics['logisticsName'] ?? '';      // 物流公司名称
+        $deliveryId   = $firstLogistics['logisticsBillNo'] ?? '';    // 物流单号
 
         if (empty($deliveryName) || empty($deliveryId)) {
             Log::channel('alibaba')->warning('[发货通知] 物流信息不完整, logistics:' . json_encode($firstLogistics, JSON_UNESCAPED_UNICODE));

app/services/ThirdParty/AlibabaAgent/OrderService.php

@@ -466,6 +466,19 @@ class OrderService extends AlibabaAgentBaseService
     /**
      * 格式化物流信息返回结果
      *
+     * 实际返回数据结构（result为数组）:
+     * {
+     *   "result": [{
+     *     "logisticsId": "LP00815917141701",
+     *     "logisticsBillNo": "YT7619307479079",   // 物流单号
+     *     "logisticsCompanyName": "圆通速递(YTO)", // 物流公司名称
+     *     "logisticsCompanyNo": "YTO",             // 物流公司编码
+     *     "status": "SIGN",
+     *     ...
+     *   }],
+     *   "success": true
+     * }
+     *
      * @param array $result API原始返回数据
      * @return array
      */
@@ -474,15 +487,16 @@ class OrderService extends AlibabaAgentBaseService
         $success = $result['success'] ?? false;
         $logisticsItems = [];
 
-        if (isset($result['result']['logisticsItems']) && is_array($result['result']['logisticsItems'])) {
-            foreach ($result['result']['logisticsItems'] as $item) {
+        // result 是数组，每个元素是一条物流信息
+        if (isset($result['result']) && is_array($result['result'])) {
+            foreach ($result['result'] as $item) {
                 $logisticsItems[] = [
                     'logisticsId'      => $item['logisticsId'] ?? '',
-                    'logisticsCode'    => $item['logisticsCode'] ?? '',    // 物流单号
-                    'logisticsName'    => $item['logisticsName'] ?? '',    // 物流公司名称
-                    'logisticsCompany' => $item['logisticsCompany'] ?? '', // 物流公司编码
+                    'logisticsBillNo'  => $item['logisticsBillNo'] ?? '',          // 物流单号
+                    'logisticsName'    => $item['logisticsCompanyName'] ?? '',     // 物流公司名称
+                    'logisticsCompany' => $item['logisticsCompanyNo'] ?? '',       // 物流公司编码
                     'status'           => $item['status'] ?? '',
-                    'gmtCreate'        => $item['gmtCreate'] ?? '',
+                    'orderEntryIds'    => $item['orderEntryIds'] ?? '',
                 ];
             }
         }