更新

server/app/common/service/gancao/GancaoLogisticsRouteService.php

@@ -69,7 +69,11 @@ final class GancaoLogisticsRouteService
 
         $resp = self::callRouteApi($appOrderNo);
         if (!$resp['success']) {
-            self::logQuery($order, '', 'auto', false, 0, $resp['message']);
+            self::logQuery($order, '', 'auto', false, (int) ($resp['runtime_ms'] ?? 0), $resp['message']);
+            if (self::shouldFallbackToKuaidi100($resp)) {
+                return self::syncOneViaKuaidi100($order, (string) $resp['message']);
+            }
+
             return ['success' => false, 'message' => $resp['message'], 'traces_count' => 0, 'state' => ''];
         }
 
@@ -87,6 +91,10 @@ final class GancaoLogisticsRouteService
 
         if ($trackingNumber === '') {
             self::logQuery($order, '', 'auto', false, $resp['runtime_ms'], '甘草未返回 sp_order_no（快递单号），可能尚未发货');
+            if (trim((string) ($order->tracking_number ?? '')) !== '') {
+                return self::syncOneViaKuaidi100($order, '甘草未返回快递单号，业务单已填写运单号');
+            }
+
             return ['success' => false, 'message' => '尚未发货（无快递单号）', 'traces_count' => 0, 'state' => ''];
         }
 
@@ -136,11 +144,54 @@ final class GancaoLogisticsRouteService
             'message' => 'ok',
             'traces_count' => $tracesCount,
             'state' => $newState,
+            'source' => 'gancao',
             'raw' => $result,
             'assistant_sync' => $assistantSync,
         ];
     }
 
+    /**
+     * 甘草侧无快递任务 / 路由拉取失败时，按业务单运单号降级快递100（自发货）
+     *
+     * @return array{success:bool, message:string, traces_count:int, state:string, source?:string, assistant_sync?:array|null}
+     */
+    private static function syncOneViaKuaidi100(PrescriptionOrder $order, string $gancaoReason): array
+    {
+        $ret = ExpressTrackingService::queryKuaidiForPrescriptionOrder($order, true);
+        if (!$ret['success']) {
+            $ret['message'] = trim((string) $ret['message']) . '；甘草：' . mb_substr($gancaoReason, 0, 200);
+        }
+
+        return $ret;
+    }
+
+    /**
+     * 是否因甘草「快递任务」类错误降级走快递100
+     *
+     * @param array{success?:bool, message?:string, api_code?:string} $gancaoResp
+     */
+    private static function shouldFallbackToKuaidi100(array $gancaoResp): bool
+    {
+        $code = trim((string) ($gancaoResp['api_code'] ?? ''));
+        if ($code === '10101') {
+            return true;
+        }
+
+        $msg = (string) ($gancaoResp['message'] ?? '');
+        if ($msg === '') {
+            return false;
+        }
+
+        $needles = ['快递任务', '任务id不存在', '任务不存在', '无快递任务', '物流任务'];
+        foreach ($needles as $needle) {
+            if (mb_strpos($msg, $needle) !== false) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
     /**
      * 调用甘草 GET_TASK_ROUTE_LIST 接口
      *
@@ -181,6 +232,7 @@ final class GancaoLogisticsRouteService
             return [
                 'success' => false,
                 'message' => 'API 错误：' . GancaoScmRecipelService::apiStatusMessage($body),
+                'api_code' => (string) ($body['status']['code'] ?? ''),
                 'runtime_ms' => $runtimeMs,
             ];
         }
@@ -499,6 +551,7 @@ final class GancaoLogisticsRouteService
                 'message' => $r['message'],
                 'traces' => $r['traces_count'],
                 'state' => $r['state'],
+                'source' => $r['source'] ?? 'gancao',
             ];
             if ($r['success']) {
                 $stats['success']++;
@@ -507,8 +560,10 @@ final class GancaoLogisticsRouteService
                     $act = (string) ($sync['action'] ?? '');
                     if ($act === 'cleared') {
                         $stats['assistant_cleared']++;
+                        $channel = (($r['source'] ?? '') === 'kuaidi100_fallback') ? '快递100降级' : '甘草路由';
                         $stats['assistant_lines'][] = sprintf(
-                            '[移除医助+指派日志][甘草路由] 诊单=%d 业务订单=%d 运单=%s 原医助ID=%s 履约状态=%d',
+                            '[移除医助+指派日志][%s] 诊单=%d 业务订单=%d 运单=%s 原医助ID=%s 履约状态=%d',
+                            $channel,
                             (int) ($sync['diagnosis_id'] ?? 0),
                             (int) ($sync['prescription_order_id'] ?? 0),
                             (string) ($sync['tracking_number'] ?? ''),