DOCS

UPS Unlock

UPS Unlock

Автоматизируйте выставление счетов за налоги и сборы Zonos для отправлений UPS, обработанных за пределами Dashboard.

UPS Unlock позволяет вам создавать отправления, совместимые с Zonos, с использованием собственной платформы отправлений вместо Zonos Dashboard. Добавив специальный номер ссылки при обработке отправлений UPS, UPS автоматически проверяет и обновляет данные отправления через Zonos, включая описания товаров, коды HS, номера счетов пошлин, налоговые идентификаторы и стоимость товаров. Это исключает необходимость настройки сложных правил или интеграций для передачи этой информации на вашу платформу отправлений. Вместо этого UPS получает данные непосредственно из Zonos, снижая риск расхождений или отсутствия информации при минимизации времени на ручную настройку и обслуживание.

Настройка UPS Unlock 

  1. Свяжитесь с поддержкой Zonos — перед включением UPS Unlock обратитесь в Поддержку Zonos, чтобы убедиться, что ваша учетная запись UPS правильно настроена. Этот процесс обычно занимает 24–48 часов.
  2. Включите UPS Unlock в Dashboard — перейдите в Zonos Dashboard → Settings → Rates → UPS и установите UPS Unlock на Enable
  3. Настройте ваши номера ссылок — по крайней мере один номер ссылки должен начинаться с zx или zx-. Пока хотя бы одна ссылка начинается с zx (даже если значение составляет только zx), Zonos будет сканировать все номера ссылок для поиска совпадающего ID заказа Zonos или номера заказа учетной записи.
    • Примеры:
      • zxORDER123 или zx-ORDER123 (комбинированный формат с номером заказа продавца)
      • zxorder_0jy1vh6gygcks или zx-order_0jy1vh6gygcks (комбинированный формат с ID заказа Zonos)
      • Ссылка 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 вызывает Zonos со ссылкой типа zx-ORDER123, Zonos удаляет префикс и ищет заказ. Значение после префикса (ORDER123 в этом примере) сопоставляется с тремя полями заказа Zonos:

ПолеОписаниеПример
Order IDUUID заказа Zonosorder_0jy1vh6gygcks
Account order numberНомер заказа продавцаORD-12345, #1001
Zonos order IDКороткий идентификатор Zonoszo-1232423

Zonos возвращает наиболее последний совпадающий заказ. Если совпадение не найдено, возвращается ошибка.

Требования

Для успешного выполнения UPS Unlock заказ должен соответствовать следующим требованиям:

  • Гарантия целевой стоимости (LCG) — заказ должен быть создан через процесс оплаты Zonos с гарантированной целевой стоимостью. Заказы, созданные вне Zonos, не могут быть использованы с UPS Unlock.
  • Совпадение источника/пункта назначения — страны отправления и доставки должны совпадать с исходным предложением. Для отправлений в Канаду или Бразилию провинция также должна совпадать.
  • Совпадение товаров — номера деталей должны совпадать с ID товаров или SKU из предложения, а количество не может превышать указанные суммы.

Коды ошибок 

Если проверка не пройдена, UPS получит ответ об ошибке от Zonos. Общие коды ошибок включают:

КодСообщениеПричина
10001Shipper number not foundНомер отправителя UPS не зарегистрирован в Zonos
10002No Zonos order found for any of the provided reference IDsНи одного заказа не соответствует какой-либо ссылке (после удаления префикса)
10003Invalid reference IDs. No prefix of zx- foundНи одна из ссылок не имеет префикса zx или zx-
10006The requested order is not guaranteedЗаказ существует, но не имеет гарантии целевой стоимости
10010ShipFrom.CountryCode mismatchСтрана отправления не совпадает с указанным источником
10011ShipTo.CountryCode mismatchСтрана доставки не совпадает с указанным пункт назначения
10012ShipTo.StateProvinceCode mismatchДля отправлений в Канаду/Бразилию провинция не совпадает
10013No matching Product on quote with PartNumberSKU товара/productId не найдена в заказе
10015Quantity exceeds the quoted quantityЗапрошенное количество больше указанного

Интеграция с ShipStation 

Пользователи ShipStation могут настроить UPS Unlock, добавив префикс zx либо перед системой (через API до поступления заказов в ShipStation), либо в ShipStation с использованием конфигураций Label Messages и Automation Rules. Это позволяет префиксу zx и ID заказа быть включенными в отправления UPS, обработанные через ShipStation, активирующие UPS Unlock. После завершения начальных этапов настройки вы можете начать настраивать ShipStation для работы с UPS Unlock.

Добавление zx перед системой

Если вы можете добавить префикс zx перед системой (до поступления заказов в ShipStation), вам нужно только настроить Label Messages для отображения номера заказа zx:

Конфигурация Label Messages

  1. Доступ к настройкам Label Messages: перейдите в SettingsPrintingPrinting Setup, затем нажмите Document Options для Label
  2. Настройте Label Messages: в разделе Label Messages вы можете определить до 3 пользовательских сообщений, которые будут отображаться как номера ссылок на этикетках UPS. Label Messages принимают только предустановленные значения типа "Custom Field 1", "Order #" и т. д.
  3. Установите ваши сообщения для использования номера заказа: установите Message #1 на [Order #]. Если у вас уже есть #1, добавьте #2 или #3
  4. Сохраните параметры для применения вашей конфигурации

После этого ShipStation автоматически поместит ваш номер заказа на этикетку, который включает ваш настроенный префикс zx.

Добавление zx в ShipStation

Если вы не можете добавить префикс zx перед системой (до поступления заказов в ShipStation), вам нужно будет настроить Label Messages и Automation Rules для отображения префикса zx и номера заказа, используя два отдельных Label Messages:

Шаг 1: конфигурация Label Messages

Настройте Label Messages для отображения как префикса, так и номера заказа:

  1. Доступ к настройкам Label Messages: перейдите в SettingsPrintingPrinting Setup, затем нажмите Document Options для Label
  2. Настройте Label Messages: в разделе Label Messages вы можете определить до 3 пользовательских сообщений, которые будут отображаться как номера ссылок на этикетках UPS.
  3. Установите ваши сообщения:
    • Установите Message #1 на [Custom Field 1] (это будет заполнено "zx" правилом автоматизации)
    • Установите Message #2 на [Order #] (выберите из выпадающего списка)
  4. Сохраните параметры для применения вашей конфигурации

Шаг 2: конфигурация Automation Rules

После настройки Label Messages создайте правило автоматизации для заполнения Custom Field 1 префиксом zx. Перейдите в SettingsAutomationAutomation Rules, затем нажмите Create a Rule.

Правило для заказов Zonos UPS:

  1. Name: "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 автоматически заполнит Custom Field 1 с zx и Message #2 с номером заказа для международных заказов UPS. Они будут отображаться на ваших этикетках UPS как две отдельные строки ссылок.

Важно: конфигурация Label Message в ShipStation — это глобальное изменение, которое влияет на все перевозчики. Подход с правилами автоматизации позволяет UPS Unlock работать безупречно для заказов Zonos при сохранении предпочитаемых Label Messages для других отправлений.

Была ли эта страница полезной?