承运商服务映射：渠道承运商/服务 ↔ 内部代码

拉单时自动把渠道侧承运商/服务文本（如 UPS / Ground）翻译成内部标准 carrier_code / service_code。含字段说明和配置步骤。

每个渠道对承运商和服务的叫法都不一样——这家叫 "UPS / Ground"，那家叫 "United Parcel Service / Standard"。承运商服务映射把渠道侧文本翻译成您的内部标准代码（carrier_code / service_code），TMS、OMS、WMS 从此说同一种话。

翻译发生在哪里#

位置在 channel.pull_orders 拉单之后、Flow 把单写进 OMS 之前：每单的 carrier / service 来这张表查，命中就给订单加上 carrier_code / service_code。原来的 carrier / service 文本永远保留不动。

字段说明#

• Channel Carrier（必填）：渠道上报的承运商文本，如 "UPS"。匹配忽略大小写和首尾空格。
• Channel Service（必填）：渠道上报的服务文本，如 "Ground"。
• Internal Carrier（必填）：您的内部标准 carrier_code，如 "ups"。TMS 查价、打 label 读这个。
• Internal Service（必填）：您的内部标准 service_code，如 "ground"。
• Channel Code：这条映射适用于哪个渠道平台（如 shopify）。空着=全局映射，所有渠道都用。
• Connection：可选，绑到某一个具体连接。绑了连接的行优先于渠道通用行。
• Active：启用开关。关掉即停用，不删除。

匹配优先级#

1. 绑了本连接的行（channel_id 等于这单的连接）最优先。
2. 渠道通用行（同渠道平台、任意连接）。
3. 全局行（不填渠道代码、不绑连接）。

配置步骤#

1. 打开 Master Data → 承运商服务映射。
2. 点"新建"。Channel Carrier 和 Channel Service 照渠道上报的一字不差填（不确定就从拉回来的订单里复制）。
3. Internal Carrier 和 Internal Service 填您的内部标准代码（小写，如 ups / ground）。
4. 填 Channel Code（如 shopify）做渠道通用映射；或选 Connection 做某店铺专用。两个都空=全局兜底。
5. 保存后拉一单测试——订单应该带着 carrier_code / service_code 进来。

常见问题#

• 订单进来没有 carrier_code：渠道的承运商/服务还没配映射。去 Flow 运行日志里找 "carrier-mapping" warning，按提示补一条映射，后面的单就自动翻译了。
• 没配映射不会卡单：原 carrier / service 文本保留，订单照常写进 OMS。
• "UPS" 和 "ups"：匹配不区分大小写，一条就够。
• 临时停用某条映射（如渠道改了服务名）：把 Active 开关关掉，别删除——历史记录还留着。