UPS Unlock

UPS Unlock 让您能够从自己的运输平台生成符合 Zonos 标准的货物，而不需要使用 Zonos Dashboard。通过在处理 UPS 货物时添加特定的参考号，UPS 会自动验证并通过 Zonos 更新货物数据，包括报关描述、HS 代码、关税账户号码、税号和商品价值。 这样就无需配置复杂的规则或集成来将此信息传递给运输平台。相反，UPS 直接从 Zonos 检索数据，降低差异或信息缺失的风险，同时最大化地减少手动设置和维护时间。

设置 UPS Unlock 

1. 联系 Zonos 支持 - 启用 UPS Unlock 之前，请联系 Zonos Support 以确保您的 UPS 账户配置正确。此流程通常需要 24-48 小时完成。
2. 在 Dashboard 中启用 UPS Unlock - 转到 Zonos Dashboard → Settings → Rates → UPS，并将 UPS Unlock 切换为 Enable
3. 配置您的参考号 - 至少有一个参考号必须以 zx 或 zx- 开头。只要至少有一个参考号以 zx 开头（即使只有 zx 这个值），Zonos 就会扫描所有参考号以查找匹配的 Zonos 订单 ID 或账户订单号。
   • 示例:
     • zxORDER123 或 zx-ORDER123（与商户订单号结合的格式）
     • zxorder_0jy1vh6gygcks 或 zx-order_0jy1vh6gygcks（与 Zonos 订单 ID 结合的格式）
     • 参考号 1: zx，参考号 2: ORDER123（分别放在两个参考号字段中）

工作原理 

设置 UPS Unlock 后，UPS 货物将引用 Zonos 订单数据。工作流程如下：

1. UPS 自动调用 Zonos 以验证使用所提供的参考号字段的订单
2. Zonos 验证并向 UPS 返回更新的报关详情 - Zonos 通过检查以下内容来验证货物与原始报价匹配：
   1. 货物中的商品与报价中的商品匹配
   2. 数量小于或等于报价的数量
   3. 商品编号与报价中的产品 ID 或 SKU 匹配
   4. 目的地详情（国家/省份）与报价相符
3. UPS 使用合规信息处理您的货物
4. UPS 调用 Zonos 以使用跟踪号创建货物记录
5. Zonos 在订单上记录货物

参考号匹配 

当 UPS 使用类似 zx-ORDER123 的参考号调用 Zonos 时，Zonos 会去掉前缀并搜索订单。前缀后的值（本例中为 ORDER123）会与 Zonos 订单上的三个字段进行匹配：

Zonos 返回最近匹配的订单。如果未找到匹配，将返回错误。

要求

要使 UPS Unlock 成功，订单必须满足以下要求：

• 着陆成本保证 (LCG) - 订单必须通过 Zonos 结账流程创建，且具有保证的着陆成本。在 Zonos 外创建的订单不能与 UPS Unlock 一起使用。
• 匹配的起点/终点 - 发货国和收货国必须与原始报价相匹配。对于发送到加拿大或巴西的货物，省份也必须相匹配。
• 匹配的产品 - 商品编号必须与报价中的产品 ID 或 SKU 相匹配，数量不能超过报价的数量。

错误代码 

如果验证失败，UPS 会从 Zonos 收到错误响应。常见错误代码包括：

ShipStation 集成 

ShipStation 用户可以通过在上游添加 zx 前缀（通过 API 在订单到达 ShipStation 之前）或在 ShipStation 内使用 Label Messages 和 Automation Rules 配置来配置 UPS Unlock。这允许 zx 前缀和订单 ID 包含在通过 ShipStation 处理的 UPS 货物中，触发 UPS Unlock。 完成初始 设置步骤 后，您可以开始配置 ShipStation 以与 UPS Unlock 一起工作。

上游添加 zx

如果您可以在上游添加 zx 前缀（在订单到达 ShipStation 之前），您只需配置标签消息以显示 zx 订单号：

标签消息配置

1. 访问标签消息设置: 转到 Settings → Printing → Printing Setup，然后点击标签的 Document Options
2. 配置标签消息: 在"标签消息"部分，您可以定义最多 3 条自定义消息，这些消息将在 UPS 标签上显示为参考号。标签消息仅接受预设值，例如"Custom Field 1"、"Order #" 等。
3. 将消息设置为使用订单号: 将消息 #1 设置为 [Order #]。如果您已有 #1，请添加 #2 或 #3
4. 保存设置以应用您的配置

完成后，ShipStation 将自动在标签上放置您的订单号，其中包含您配置的 zx 前缀。

在 ShipStation 中添加 zx

如果您无法在上游添加 zx 前缀（在订单到达 ShipStation 之前），您将需要配置标签消息和自动化规则，以使用两个单独的标签消息显示 zx 前缀和订单号：

步骤 1: 标签消息配置

配置标签消息以同时显示前缀和订单号：

1. 访问标签消息设置: 转到 Settings → Printing → Printing Setup，然后点击标签的 Document Options
2. 配置标签消息: 在"标签消息"部分，您可以定义最多 3 条自定义消息，这些消息将在 UPS 标签上显示为参考号。
3. 设置您的消息:
   • 将消息 #1 设置为 [Custom Field 1]（这将由自动化规则填充"zx"）
   • 将消息 #2 设置为 [Order #]（从下拉列表中选择）
4. 保存设置以应用您的配置

步骤 2: 自动化规则配置

设置标签消息后，创建自动化规则以使用 zx 前缀填充自定义字段 1。转到 Settings → Automation → Automation Rules，然后点击 Create a Rule。

Zonos UPS 订单规则：

1. 名称: "Zonos UPS Unlock"
2. 确保 Active Rule 已切换开启
3. 选择 Orders match these specific criteria
4. 设置条件: "International Order" = "True" AND "Carrier" + "Includes" + "UPS"

注意: 您的触发条件可能因您的 ShipStation 配置而异。这是推荐的起点 - 根据您的特定工作流程和偏好自定义条件，以确保 UPS Unlock 仅应用于适当的订单。

1. 设置操作:
   • Action Type: 选择"Set Custom Field 1..."
   • Custom Field 1: zx（这设置前缀）
2. 点击 Save Rule

完成后，ShipStation 将自动为国际 UPS 订单用 zx 和订单号填充自定义字段 1 和消息 #2。这些将在您的 UPS 标签上显示为两条单独的参考号行。

重要: ShipStation 中的标签消息配置是一项全局更改，会影响所有承运商。自动化规则方法允许 UPS Unlock 无缝为 Zonos 订单工作，同时为其他货物保持您首选的标签消息。