Настройка UPS Unlock
- Свяжитесь с поддержкой Zonos — перед включением UPS Unlock обратитесь в Поддержку Zonos, чтобы убедиться, что ваша учетная запись UPS правильно настроена. Этот процесс обычно занимает 24–48 часов.
- Включите UPS Unlock в Dashboard — перейдите в Zonos Dashboard → Settings → Rates → UPS и установите UPS Unlock на Enable
- Настройте ваши номера ссылок — по крайней мере один номер ссылки должен начинаться с
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. Вот как работает этот процесс:
- UPS автоматически вызывает Zonos для проверки заказа с предоставленными полями ссылок
- Zonos проверяет и возвращает обновленные данные таможни в UPS — Zonos проверяет, что отправление соответствует исходному предложению путем проверки:
- Товары в отправлении совпадают с товарами в предложении
- Количество меньше или равно указанному количеству
- Номера деталей совпадают с ID товаров или SKU из предложения
- Детали пункта назначения (страна/провинция) совпадают с предложением
- UPS обрабатывает ваше отправление с информацией о соответствии
- UPS вызывает Zonos для создания записи отправления с номером отслеживания
- Zonos записывает отправление в заказ
Сопоставление ссылок
Когда UPS вызывает Zonos со ссылкой типа zx-ORDER123, Zonos удаляет префикс и ищет заказ. Значение после префикса (ORDER123 в этом примере) сопоставляется с тремя полями заказа Zonos:
| Поле↕ | Описание↕ | Пример↕ |
|---|---|---|
| Order ID | UUID заказа Zonos | order_0jy1vh6gygcks |
| Account order number | Номер заказа продавца | ORD-12345, #1001 |
| Zonos order ID | Короткий идентификатор Zonos | zo-1232423 |
Zonos возвращает наиболее последний совпадающий заказ. Если совпадение не найдено, возвращается ошибка.
Требования
Для успешного выполнения UPS Unlock заказ должен соответствовать следующим требованиям:
- Гарантия целевой стоимости (LCG) — заказ должен быть создан через процесс оплаты Zonos с гарантированной целевой стоимостью. Заказы, созданные вне Zonos, не могут быть использованы с UPS Unlock.
- Совпадение источника/пункта назначения — страны отправления и доставки должны совпадать с исходным предложением. Для отправлений в Канаду или Бразилию провинция также должна совпадать.
- Совпадение товаров — номера деталей должны совпадать с ID товаров или SKU из предложения, а количество не может превышать указанные суммы.
Коды ошибок
Если проверка не пройдена, UPS получит ответ об ошибке от Zonos. Общие коды ошибок включают:
| Код↕ | Сообщение↕ | Причина↕ |
|---|---|---|
| 10001 | Shipper number not found | Номер отправителя UPS не зарегистрирован в Zonos |
| 10002 | No Zonos order found for any of the provided reference IDs | Ни одного заказа не соответствует какой-либо ссылке (после удаления префикса) |
| 10003 | Invalid reference IDs. No prefix of zx- found | Ни одна из ссылок не имеет префикса zx или zx- |
| 10006 | The requested order is not guaranteed | Заказ существует, но не имеет гарантии целевой стоимости |
| 10010 | ShipFrom.CountryCode mismatch | Страна отправления не совпадает с указанным источником |
| 10011 | ShipTo.CountryCode mismatch | Страна доставки не совпадает с указанным пункт назначения |
| 10012 | ShipTo.StateProvinceCode mismatch | Для отправлений в Канаду/Бразилию провинция не совпадает |
| 10013 | No matching Product on quote with PartNumber | SKU товара/productId не найдена в заказе |
| 10015 | Quantity 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
- Доступ к настройкам Label Messages: перейдите в Settings → Printing → Printing Setup, затем нажмите Document Options для Label
- Настройте Label Messages: в разделе Label Messages вы можете определить до 3 пользовательских сообщений, которые будут отображаться как номера ссылок на этикетках UPS. Label Messages принимают только предустановленные значения типа "Custom Field 1", "Order #" и т. д.
- Установите ваши сообщения для использования номера заказа: установите Message #1 на
[Order #]. Если у вас уже есть #1, добавьте #2 или #3 - Сохраните параметры для применения вашей конфигурации
После этого ShipStation автоматически поместит ваш номер заказа на этикетку, который включает ваш настроенный префикс zx.
Добавление zx в ShipStation
Если вы не можете добавить префикс zx перед системой (до поступления заказов в ShipStation), вам нужно будет настроить Label Messages и Automation Rules для отображения префикса zx и номера заказа, используя два отдельных Label Messages:
Шаг 1: конфигурация Label Messages
Настройте Label Messages для отображения как префикса, так и номера заказа:
- Доступ к настройкам Label Messages: перейдите в Settings → Printing → Printing Setup, затем нажмите Document Options для Label
- Настройте Label Messages: в разделе Label Messages вы можете определить до 3 пользовательских сообщений, которые будут отображаться как номера ссылок на этикетках UPS.
- Установите ваши сообщения:
- Установите Message #1 на
[Custom Field 1](это будет заполнено "zx" правилом автоматизации) - Установите Message #2 на
[Order #](выберите из выпадающего списка)
- Установите Message #1 на
- Сохраните параметры для применения вашей конфигурации
Шаг 2: конфигурация Automation Rules
После настройки Label Messages создайте правило автоматизации для заполнения Custom Field 1 префиксом zx. Перейдите в Settings → Automation → Automation Rules, затем нажмите Create a Rule.
Правило для заказов Zonos UPS:
- Name: "Zonos UPS Unlock"
- Убедитесь, что Active Rule включено
- Выберите Orders match these specific criteria
- Установите критерии: "International Order" = "True" AND "Carrier" + "Includes" + "UPS"
Примечание: ваши критерии срабатывания могут отличаться в зависимости от конфигурации ShipStation. Это рекомендуемая начальная точка — настройте условия в соответствии с вашим конкретным рабочим процессом и предпочтениями, чтобы гарантировать, что UPS Unlock применяется только к соответствующим заказам.
- Установите действия:
- Action Type: выберите "Set Custom Field 1..."
- Custom Field 1:
zx(это устанавливает префикс)
- Нажмите Save Rule
После этого ShipStation автоматически заполнит Custom Field 1 с zx и Message #2 с номером заказа для международных заказов UPS. Они будут отображаться на ваших этикетках UPS как две отдельные строки ссылок.
Важно: конфигурация Label Message в ShipStation — это глобальное изменение, которое влияет на все перевозчики. Подход с правилами автоматизации позволяет UPS Unlock работать безупречно для заказов Zonos при сохранении предпочитаемых Label Messages для других отправлений.
UPS Unlock
Автоматизируйте выставление счетов за налоги и сборы Zonos для отправлений UPS, обработанных за пределами Dashboard.
UPS Unlock позволяет вам создавать отправления, совместимые с Zonos, с использованием собственной платформы отправлений вместо Zonos Dashboard. Добавив специальный номер ссылки при обработке отправлений UPS, UPS автоматически проверяет и обновляет данные отправления через Zonos, включая описания товаров, коды HS, номера счетов пошлин, налоговые идентификаторы и стоимость товаров. Это исключает необходимость настройки сложных правил или интеграций для передачи этой информации на вашу платформу отправлений. Вместо этого UPS получает данные непосредственно из Zonos, снижая риск расхождений или отсутствия информации при минимизации времени на ручную настройку и обслуживание.