陆运中港整车和中港零担/集拼查价时，TMS 只认「中港」。工单仍保留细类，避免把两类原样传出去对不上运价。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-08 18:30:12 +08:00
parent 6141978a9e
commit baa4d81be9
7 changed files with 27 additions and 13 deletions
@@ -3,8 +3,8 @@

 本文件职责：核对卡通过后、建单查价前，确认当前运输类型的货物字段能拼出查价正文。
 带去：运输类型、线路类别、始发/目的/品名/报价日期，以及该类型的体积重量或车型/数量；通关口岸有值才带。
-出站类型/线路必须译成 TMS 6.1.1 英文枚举，线路键名 routeCategory。工单与卡片仍用中文。
-中港整车、中港零担/集拼出站类型都是 CHINA_HK。中港整车不带车型/数量。
+出站类型/线路译成 TMS 用的值，线路键名 routeCategory。工单与卡片仍用销售中文。
+中港整车、中港零担/集拼出站类型都只写「中港」。中港整车不带车型/数量。
 禁止：把运输分类放进出站；直连 TMS；改六态。
 线程：纯函数。
 """
@@ -29,8 +29,8 @@ _TYPE_ENUM = {
    "国内运输整车": "DOMESTIC_FTL",
    "跨境集拼": "CROSS_BORDER_LTL",
    "跨境整车": "CROSS_BORDER_FTL",
-    "中港整车": "CHINA_HK",
-    "中港零担/集拼": "CHINA_HK",
+    "中港整车": "中港",
+    "中港零担/集拼": "中港",
 }
 _ROUTE_ENUM = {
    "国内长途/零担": "DOMESTIC_LONG_LTL",
@@ -45,7 +45,7 @@ _TAIL_QTY = re.compile(r"^(.*?)[\s,，]+(\d+)\s*(台|辆)?$")


 def tms_land_type_code(raw: str) -> str:
-    """销售中文运输类型 → TMS 6.1.1 landTransportType。对不上空串。"""
+    """销售中文运输类型 → 查价 landTransportType。中港两类都是「中港」。对不上空串。"""
    text = (raw or "").strip()
    if text in _TYPE_ENUM:
        return _TYPE_ENUM[text]
@@ -30,7 +30,7 @@ class TmsLandQueryTest(unittest.TestCase):
        got = assemble_land_query(facts)
        self.assertTrue(got["ok"])
        out = got["outbound"]
-        self.assertEqual(out["landTransportType"], "CHINA_HK")
+        self.assertEqual(out["landTransportType"], "中港")
        self.assertEqual(out["routeCategory"], "SOUTHEAST_ASIA")
        self.assertNotIn("landRouteCategory", out)
        self.assertEqual(out["vehicleType"], "9米6")
@@ -52,6 +52,7 @@ class TmsLandQueryTest(unittest.TestCase):
        got = assemble_land_query(facts)
        self.assertTrue(got["ok"])
        out = got["outbound"]
+        self.assertEqual(out["landTransportType"], "中港")
        self.assertNotIn("vehicleType", out)
        self.assertNotIn("quantity", out)

@@ -4,6 +4,7 @@ package org.jeecg.modules.inquiry.tms;
 * 陆运运输类型 / 线路类别出站：产品要求原文直传，不再翻成 TMS 英文枚举。
 * <p>
 * 职责：统一 trim；空串表示未填。工单/卡片/拉人本来就是中文，出站与之一致。
+ * 中港整车、中港零担/集拼查价只传「中港」，工单仍留细类。
 * 禁止：再把「跨境整车」写成 CROSS_BORDER_FTL；把运输分类、中港装载方式塞进出站。
 * 历史英文码若仍传入，原样放过（兼容旧快照），不做双向翻译。
 */
@@ -14,10 +15,15 @@ public final class TmsLandEnumMapper {

    /**
     * @param raw 销售中文（或历史英文码）
-     * @return trim 后原文；空则 ""
+     * @return 中港两类收成「中港」；其余 trim 后原文；空则 ""
     */
    public static String transportType(String raw) {
-        return trimOrEmpty(raw);
+        String text = trimOrEmpty(raw);
+        if ("中港整车".equals(text) || "中港零担/集拼".equals(text)) {
+            // zhonggang: 两类细类查价都只传「中港」
+            return "中港";
+        }
+        return text;
    }

    /**
@@ -18,8 +18,8 @@ import java.util.regex.Pattern;
 * 职责：把工单 facts 里的中文键写成 TMS 段；运输分类只留在工单，不进出站。
 * 拼车/跨境集拼带体积重量；国内整车/跨境整车/中港零担带「车型/数量」一项再拆成出站车型与台数；
 * 中港整车不带车型/数量。通关口岸有值才放。
- * 中港整车、中港零担/集拼：出站类型仍用销售中文「中港整车」「中港零担/集拼」（产品要求不做英文枚举映射）。
- * 类型/线路键名仍是 landTransportType / routeCategory，值用中文原文。
+ * 中港整车、中港零担/集拼：出站 landTransportType 只写「中港」，工单事实仍留细类。
+ * 类型/线路键名仍是 landTransportType / routeCategory。除中港两类外，值用中文原文。
 * 禁止：按空运要包装件数；把分类当查价条件；直连 TMS；再把中文翻成 CROSS_BORDER_*。
 */
 public final class TmsLandSegmentMapper {
@@ -151,7 +151,7 @@ public final class TmsV2RequestMapper {
    }

    /**
-     * 陆运出站：类型+线路用销售中文原文（产品要求不做英文枚举映射）；线路字段名是 routeCategory。
+     * 陆运出站：类型+线路用销售中文；中港整车、中港零担/集拼收成「中港」。线路字段名是 routeCategory。
     * 分类和中港装载即使误放在 source 也不抄走。
     */
    private static void applyLandFields(Map<String, Object> source, Map<String, Object> target) {
@@ -27,6 +27,13 @@ public class TmsLandEnumMapperTest {
        assertEquals("", TmsLandEnumMapper.routeCategory("  "));
    }

+    @Test
+    public void hkTypesCollapseToZhonggang() {
+        assertEquals("中港", TmsLandEnumMapper.transportType("中港整车"));
+        assertEquals("中港", TmsLandEnumMapper.transportType("中港零担/集拼"));
+        assertEquals("中港集拼", TmsLandEnumMapper.transportType("中港集拼"));
+    }
+
    @Test
    public void legacyEnglishCodesPassThrough() {
        assertEquals("DOMESTIC_LTL", TmsLandEnumMapper.transportType("DOMESTIC_LTL"));
@@ -46,7 +46,7 @@ public class TmsLandSegmentMapperTest {
        facts.put("车型/数量", "9米6/1");
        facts.put("体积", "99");
        Map<String, Object> seg = TmsLandSegmentMapper.build(facts);
-        assertEquals("中港零担/集拼", seg.get("landTransportType"));
+        assertEquals("中港", seg.get("landTransportType"));
        assertEquals("9米6", seg.get("vehicleType"));
        assertNull(seg.get("volumeCbm"));
        assertFalse(seg.containsKey("hkLoadType"));
@@ -62,7 +62,7 @@ public class TmsLandSegmentMapperTest {
        facts.put("目的港", "香港");
        facts.put("品名", "衣服");
        Map<String, Object> seg = TmsLandSegmentMapper.build(facts);
-        assertEquals("中港整车", seg.get("landTransportType"));
+        assertEquals("中港", seg.get("landTransportType"));
        assertNull(seg.get("vehicleType"));
        assertNull(seg.get("quantity"));
        java.util.List<String> missing = TmsLandSegmentMapper.missingQuery(