管理集成消息代码

预计阅读时间： 9 分钟

最后更新：2026年7月15日

概览

集成消息代码可帮助 Synctify OMS 在 Synctify 与已连接的合作伙伴之间转换物流相关代码，例如销售渠道、仓库、第三方物流（3PL）及承运商。

不同的合作伙伴可能会对同一承运商或服务等级使用不同的代码。例如，某个合作伙伴可能会发送类似以下形式的组合代码： UPS_GR_RES ，而另一个系统则可能要求分别提供承运商代码和服务等级信息。

集成消息代码可用于管理合作伙伴代码与 Synctify 可识别的承运商代码及服务等级之间的映射关系，帮助订单和发货信息在不同系统之间传递时使用正确的物流信息。

目前，集成消息代码支持：

承运商代码
服务等级

在您开始之前

您可以通过以下位置管理集成消息代码：集成 > 集成消息代码 .

此页面仅向已登录的管理员用户开放。可执行的操作可能会根据所选代码类型和具体使用场景而有所不同。部分系统代码为只读状态，无法直接编辑或删除。

查看代码映射

前往集成 > 集成消息代码 .
从左侧列表中选择合作伙伴、承运商或上下文。
查看代码映射表。

该表格显示以下信息：

列	描述
合作伙伴代码	所选合作伙伴上下文中发送或使用的代码。
描述	对该代码所代表含义的简要说明。
方向	该代码是用于入站、出站，还是同时用于两个方向。
承运商	该合作伙伴代码对应的承运商代码。
服务等级	该合作伙伴代码对应的服务等级。
来源	该代码是否由 Synctify 提供（系统）或由您的团队创建（自定义).

您可以使用搜索框，根据代码值或描述查找对应的代码。

了解方向选项

添加或编辑代码时，请选择与该合作伙伴代码使用方式相匹配的方向。

方向	含义
仅入站	当 Synctify 从合作伙伴接收该代码时，请选择此选项。
仅出站	当 Synctify 向合作伙伴发送该代码时，请选择此选项。
双向（入站和出站）	当同一代码可同时用于入站和出站方向时，请选择此选项。

了解来源类型

代码映射表中的 来源（Source） 列用于显示该代码的来源。

来源	含义
系统	该代码由 Synctify 提供，为只读状态，无法直接编辑或删除。如系统提供覆盖选项，您可以对其进行覆盖。
自定义	该代码由您的团队为当前上下文创建，可以进行编辑或删除。

添加代码

前往集成 > 集成消息代码 .
选择您要添加代码的合作伙伴、承运商或上下文。
点击添加代码 .
在合作伙伴代码输入合作伙伴使用的代码值。
在描述输入简短描述。
选择方向 :
仅入站 — Synctify 从合作伙伴接收该代码。
仅出站 — Synctify 将该代码发送给合作伙伴。
双向（入站和出站） — 该代码适用于入站和出站两个方向。
保留启用状态，以便在代码解析时使用该代码。
在此代码表示下，至少选择一个选项：
承运商代码
服务等级
搜索并选择该合作伙伴代码应映射到的承运商代码或服务等级。
如果要将该合作伙伴代码添加为未映射代码，请将承运商代码或服务等级字段留空。
点击保存代码 .

编辑代码

前往集成 > 集成消息代码 .
选择包含该代码的合作伙伴、承运商或上下文。
在映射表中找到该代码。
点击您要更新的代码所在行。
系统管理的代码行为只读状态，无法直接编辑。
更新可编辑的字段。
代码值创建后无法更改。
根据是否需要在代码解析过程中使用该代码，选择或取消选择启用。
如有需要，请更新相关的承运商代码或服务等级。
点击保存代码 .

如需关闭表单而不保存更改，请点击放弃更改 .

覆盖继承代码

部分继承的系统代码可能支持覆盖。当所选上下文需要使用不同于继承默认值的映射时，可使用覆盖功能。

前往集成 > 集成消息代码 .
选择包含该继承代码的合作伙伴、仓库或上下文。
打开代码详情抽屉。
点击覆盖，如果该选项可用。
检查预填的信息。
代码值已锁定，无法更改。
根据需要更新描述、方向、承运商代码或服务等级映射。
点击创建覆盖 .
查看内联确认面板。
确认信息会说明：系统将为当前上下文创建一个专属覆盖设置，之后该上下文将不再使用继承的默认映射。
点击创建覆盖再次点击以确认。
如需返回表单且不保存，请点击返回 .

保存后，该代码将在所选上下文中变为 已自定义 状态。

删除或还原代码

当删除操作可用时，部分由用户创建的代码可以删除。系统代码无法直接删除。

前往集成 > 集成消息代码 .
选择包含该代码的合作伙伴、承运商或上下文。
打开您要删除的代码。
点击删除，如果该选项可用。
查看确认信息。
确认删除。

如果删除覆盖设置，该上下文将重新显示继承的系统代码。

注意

删除操作仅适用于可以安全移除的代码。部分代码由于由 Synctify 提供，或仍被现有映射所使用，因此受到保护，无法删除。

管理承运商和服务等级代码

承运商列表会显示 Synctify 可识别的承运商代码及服务等级，合作伙伴代码可映射至这些值。

在本文中，标准目录是指承运商下列出的承运商代码和服务等级代码。这些代码作为标准值，供合作伙伴代码映射使用。

如果您使用的承运商或服务等级尚未列出，可以添加自定义的承运商代码或服务等级代码。

注意

自定义承运商代码和服务等级代码仅存在于您当前租户的标准目录中，外部集成可能无法识别这些自定义代码。创建或编辑自定义目录代码时，系统会显示相应的警告提示。

添加自定义承运商代码或服务等级代码

从左侧面板选择承运商。
选择您要管理的承运商。
点击＋添加自定义代码 .
输入代码值。
选择代码类型 :
代码类型
服务等级
可选择添加描述，并设置方向。
点击添加到目录 .

编辑自定义承运商代码或服务等级代码

只有自定义代码可以编辑。系统提供的代码为只读状态。

从承运商列表中找到该代码。
点击该代码所在行，打开详情面板。
点击编辑合作伙伴代码 .
更新描述或方向。
代码值和类型创建后无法更改。
点击保存更改 .

删除自定义承运商代码或服务等级代码

只有当自定义承运商代码或服务等级代码当前未被任何合作伙伴代码映射使用时，才能将其删除。如果该代码正在使用，请先移除相关的合作伙伴代码映射。

从承运商列表中找到该代码。
打开代码详情面板。
点击删除 .
确认删除。

预览并测试映射

使用预览与测试功能，在将代码应用于订单或发货处理前，检查代码的映射解析结果。

预览与测试支持通过以下不同方式查看映射结果：

选项	适用场景
按代码	使用此选项测试单个代码映射。当您想要检查某个合作伙伴代码在所选上下文中的映射解析结果时，可以使用此选项。
按仓库	使用此选项测试代码在特定仓库或第三方物流（3PL）数据源中的映射解析结果。仅当选择了 WMS 类型的集成时，才会显示此选项。
按订单号	使用此选项查看真实订单的完整业务流程及实际处理结果。当您需要排查某个特定订单的承运商代码或服务等级是如何完成映射解析时，可以使用此选项。

按代码测试

前往集成 > 集成消息代码 .
选择您要测试的合作伙伴、承运商或上下文。
点击预览与测试 .
点选按代码 .
使用切换按钮选择转换方向：
从 [合作伙伴名称] — 输入合作伙伴发送给 Synctify 的代码，以查看该代码将映射为什么结果。
到 [合作伙伴名称] — 输入 Synctify 标准代码（例如承运商代码或服务等级），以查看 Synctify 会发送给合作伙伴的对应代码。
当所选上下文为承运商时，不会显示此切换选项，因为承运商代码本身就是标准代码。
输入代码值。
查看预览结果。

预览结果会显示匹配的代码、代码类型、方向，以及每个代码对应的映射结果。

按仓库测试

按仓库选项仅在选择 WMS 类型的集成时显示。您可以使用此选项，在无需切换主上下文的情况下，检查代码在特定仓库或第三方物流（3PL）数据源中的映射解析结果。

前往集成 > 集成消息代码 .
选择您要测试的 WMS 类型集成或上下文。
点击预览与测试 .
点选按仓库 .
从下拉菜单中选择一个仓库或第三方物流（3PL）。
使用方向切换和代码查询的方式，与按代码相同。

如果尚未集成任何仓库或第三方物流（3PL）数据源，下拉菜单将提示当前无可用选项。

按订单号测试

前往集成 > 集成消息代码 .
选择您要测试的合作伙伴、承运商或上下文。
点击预览与测试 .
点选按订单号 .
输入订单号。
查看订单的代码转换路径。

按订单号会显示真实订单中的代码映射解析路径，包括从渠道代码映射到 Synctify 标准代码，再到出站仓库或第三方物流（3PL）代码，以及渠道 ASN 代码的完整流程。

这可以帮助您识别承运商代码或服务等级在哪个环节出现未映射、被解析为非预期值，或与实际履约过程中使用的值不一致。

注意

预览结果会反映所选上下文中当前已保存的映射设置。按订单号查看时，结果还可用于对比当前预测的映射结果与实际履约过程中使用的值。

常见问题

管理集成消息代码

一个合作伙伴代码可以同时表示承运商和服务等级吗？

可以。一个合作伙伴代码可以表示承运商代码、服务等级，或同时表示两者。对于组合代码，请同时选择承运商代码和服务等级。

创建后可以更改合作伙伴代码值吗？

不可以。代码值创建后无法更改。如果代码值有误，请使用正确的值重新创建一个新代码。

什么是未映射代码？

未映射代码是指已添加的合作伙伴代码，但尚未映射到承运商代码或服务等级。您可以稍后编辑该代码，以完成映射设置。

“来源”列显示什么？

来源列用于显示代码的来源。系统（System）代码由 Synctify 提供，为只读状态；自定义（Custom） 代码则由您的团队创建。这与代码本身的状态是分开的，例如该代码是否已被覆盖，或是否处于未映射状态。

如果代码处于非启用状态，会发生什么？

非启用状态的代码会保留在系统中，但在代码解析过程中会被忽略。

删除覆盖设置后，会发生什么？

删除覆盖设置后，所选上下文将恢复使用继承的系统代码。

什么是标准目录？

标准目录是指承运商下列出的、Synctify 可识别的承运商代码和服务等级列表。合作伙伴代码会映射到该目录中的对应项目。如果您需要的值尚未列出，也可以添加自定义承运商代码或服务等级代码。

为什么有些代码无法编辑或删除？

部分代码由 Synctify 提供，在所选上下文中为只读状态。

当某个代码为只读状态时，该行会显示系统来源标识。将鼠标悬停在锁定的代码行上时，也可能会显示提示信息，说明系统代码无法在此处直接编辑。如果覆盖选项可用，您可以通过覆盖系统代码来进行调整，而不是直接编辑该代码。