DOCS

Пакеты

Пакеты

Продавайте комплектные товары с точным расчетом полной стоимости и гибкими вариантами упаковки.

Пакет — это товар, продаваемый как единый (родительский) товар, который при оформлении заказа разбивается на отдельные компоненты. Когда покупатель приобретает пакет, Zonos разбивает его на компоненты, применяет скидку к цене каждого компонента, чтобы она соответствовала цене пакета, и рассчитывает пошлины и налоги на основе кода HS и страны происхождения каждого компонента.

Например, продавец продает рубашки поодиночке по 30 долларов каждая или пакетом из 4 штук за 100 долларов. Когда покупатель приобретает пакет:

  • В заказе и коммерческом счете-фактуре указано 4 рубашки по 25 долларов каждая (а не 1 пакет за 100 долларов или 4 рубашки по 30 долларов каждая)
  • Код HS и страна происхождения каждой рубашки используются для расчета полной стоимости
  • Расходы на доставку рассчитываются исходя из фактических размеров коробки, в которой продавец их отправляет

Режимы упаковки 

Пакеты поддерживают два режима упаковки, определяющих, как товары упаковываются для доставки:

Assigned box

Продавец заранее назначает товары конкретным коробкам с известными размерами. Каждая коробка определяется длиной, шириной, высотой и грузоподъемностью. Картонизация использует эти точные коробки вместо оценки.

Подходит для: товаров, для которых вы точно знаете, в какой коробке они отправляются, или пакетов, которые всегда отправляются в одной и той же коробке.

Auto-box

Продавец группирует товары в пакет, не указывая коробки. Во время оформления заказа Zonos использует свой алгоритм картонизации, чтобы определить оптимальную упаковку в коробки на основе размеров товаров и доступных вариантов упаковки.

Подходит для: пакетов, упаковка которых варьируется, товаров с гибкой упаковкой или случаев, когда вы хотите, чтобы Zonos автоматически оптимизировал выбор коробки.

Оба режима разбивают пакет на отдельные компоненты с кодом HS, страной происхождения и скидочной ценой для каждого товара. Разница только в том, как определяются коробки.

Как работают пакеты 

Когда вы создаете пакет в Catalog, вы определяете:

  • Артикул пакета или идентификатор товара — идентификатор товара, совпадающий с вашим магазином
  • Цена пакета — общая цена, как она отображается в вашем магазине
  • Режим упаковки — Assigned box или Auto-box
  • Компоненты товара — каждый отдельный товар, включенный в пакет, на который ссылаются по его идентификатору элемента каталога. Компоненты должны уже существовать как элементы каталога, прежде чем их можно будет добавить в пакет.
  • Назначение коробок (только для режима Assigned box) — какие компоненты отправляются в какой коробке, с реальными размерами и весом

Когда размещается заказ, содержащий пакет, Zonos автоматически:

  1. Разбивает пакет на его отдельные компоненты
  2. Применяет скидку к каждому компоненту, используя рассчитанные коэффициенты цены, чтобы цена за единицу совпадала с ценой пакета
  3. Рассчитывает полную стоимость, используя код HS, страну происхождения и размеры коробки каждого компонента — что дает точный итог по пошлинам, налогам и доставке
  4. Формирует ярлыки — пакеты с Assigned box получают один ярлык на каждую определенную коробку; пакеты с Auto-box получают ярлыки на основе результатов картонизации

Предварительные условия 

Перед созданием пакета убедитесь, что:

  • Все компоненты товара существуют как элементы каталога в вашем Zonos Catalog. Пакет ссылается на компоненты по их идентификатору элемента каталога — вы не можете добавить товары, которые еще не существуют. Компоненты не обязаны продаваться отдельно в вашем магазине — они могут существовать в каталоге исключительно как части пакета.
  • Каждый компонент имеет точные коды HS, страну происхождения и измерения (вес и размеры). Они используются для расчета полной стоимости, когда пакет разбивается на компоненты.
  • Артикул или идентификатор товара пакета совпадает с идентификатором, который ваша платформа электронной коммерции отправляет в Zonos, и с настройкой Item key preference в вашей Zonos Dashboard. Для магазинов Shopify идентификатор товара пакета должен быть идентификатором варианта Shopify товара пакета.

Каждый пакет должен содержать не менее 2 компонентов. Пакет с одним товаром должен быть отдельным элементом каталога.

  1. Перейдите в Dashboard > Products > Bundles.
  2. Нажмите Add Bundle в верхнем правом углу.
  3. Введите артикул или идентификатор товара пакета — он должен совпадать с идентификатором, который ваш магазин отправляет в Zonos. Настройка Item key preference в вашей Zonos Dashboard также должна быть установлена на правильный идентификатор.
  4. Введите имя, цену и валюту пакета.
  5. Выберите Assigned box в качестве режима упаковки.
  6. Добавьте коробки с конкретными размерами (длина, ширина, высота и грузоподъемность).
  7. Добавьте компоненты, выполнив поиск в каталоге, и назначьте каждый из них коробке. Для каждого компонента укажите:
    • Quantity — сколько единиц этого компонента находится в пакете
    • Box — в какой коробке отправляется этот компонент
    • Price ratio — доля цены пакета, которую представляет этот компонент (рассчитывается автоматически, если оставить поле пустым)
  8. Нажмите Save.

В разделе Manage > Import доступны два варианта импорта:

Import bundles 

Создает пакеты, ссылающиеся на существующие элементы каталога. Компоненты должны уже существовать в вашем каталоге перед импортом.

  1. Перейдите в Dashboard > Products > Bundles.
  2. Нажмите Manage > Import bundles.
  3. Загрузите шаблон CSV — выберите формат Assigned box или Auto-box.
  4. Заполните одну строку для каждого компонента. Поля уровня пакета (SKU, name, price) повторяются в каждой строке одного и того же пакета.
  5. Загрузите заполненный CSV и нажмите Import.

Поля CSV пакета 

СтолбецОписание
Bundle SKUАртикул пакета, как он отображается в вашем магазине.
Bundle Product IDИдентификатор товара пакета, как он отображается в вашем магазине.
Bundle NameНазвание пакета.
Bundle DescriptionОписание пакета.
Bundle Image URLURL-адрес изображения пакета.
Bundle AmountОбщая цена пакета.
Bundle CurrencyВалюта цены пакета, например USD.
Box NumberНомер коробки, в которую отправляется компонент этой строки, например 1 или 2. Используйте один и тот же номер для всех компонентов в одной коробке.
Box LengthДлина коробки для этой строки.
Box WidthШирина коробки для этой строки.
Box HeightВысота коробки для этой строки.
Box Dimensional UnitЕдиница измерения размеров коробки, например INCH.
Box Weight CapacityМаксимальная грузоподъемность коробки.
Box Weight UnitЕдиница измерения веса коробки, например POUND.
Item SKUАртикул этого компонента. Должен совпадать с существующим элементом каталога.
Item Product IDИдентификатор товара этого компонента. Должен совпадать с существующим элементом каталога.
Item QuantityСколько единиц этого компонента находится в пакете.

Примечание: оба префикса столбцов — "Bundle" и "Kit" — принимаются для обратной совместимости (например, "Kit SKU" работает так же, как "Bundle SKU").

Правила валидации импорта CSV 

Следующие правила валидации применяются ко всем импортам CSV пакетов:

  • Минимум 2 товара — каждый пакет должен содержать не менее 2 компонентов. Пакет с одним товаром должен быть отдельным элементом каталога.
  • Все поля коробки или ни одного — для пакетов с Assigned box во всех строках должны присутствовать все 6 полей коробки: Box Length, Box Width, Box Height, Box Dimensional Unit, Box Weight Capacity и Box Weight Unit. Если задано хотя бы одно поле коробки, требуются все 6. Если все поля коробки пусты, пакет считается пакетом с Auto-box.
  • Без смешения режимов упаковки — один пакет не может сочетать строки с Assigned box (с указанными размерами) и строки с Auto-box (без размеров). Все строки одного пакета должны использовать один и тот же режим.
  • Нормализация кода HS — коды HS автоматически форматируются при импорте. Неалфавитно-цифровые символы (точки, дефисы, пробелы) удаляются, а код нормализуется до формата с четным числом цифр.

Import bundles + catalog items 

Создает элементы каталога И пакеты за одну загрузку. Используйте этот вариант, если ваши компоненты еще не существуют в каталоге — они будут созданы или обновлены автоматически.

  1. Перейдите в Dashboard > Products > Bundles.
  2. Нажмите Manage > Import bundles + catalog items.
  3. Загрузите шаблон CSV — выберите формат Assigned box или Auto-box.
  4. Заполните одну строку для каждого компонента, включая столбцы с данными товара (название, код HS, страна происхождения, измерения).
  5. Загрузите заполненный CSV и нажмите Import.

Импорт сначала создает или обновляет дочерние элементы каталога, а затем создает пакеты, ссылающиеся на них. Если товар с таким же артикулом или идентификатором товара уже существует, его данные обновляются значениями из CSV. Коды HS автоматически нормализуются при импорте (неалфавитно-цифровые символы удаляются, а код форматируется до стандартного формата с четным числом цифр).

Поля комбинированного CSV 

Включает все поля CSV пакета плюс столбцы с данными товара:

СтолбецОписание
Bundle SKUАртикул пакета.
Bundle Product IDИдентификатор товара пакета.
Bundle NameНазвание пакета.
Bundle DescriptionОписание пакета.
Bundle Image URLURL-адрес изображения пакета.
Bundle AmountОбщая цена пакета.
Bundle CurrencyВалюта цены пакета, например USD.
Box NumberКоробка, в которую отправляется этот компонент.
Box LengthДлина коробки.
Box WidthШирина коробки.
Box HeightВысота коробки.
Box Dimensional UnitЕдиница измерения размеров, например INCH.
Box Weight CapacityГрузоподъемность коробки.
Box Weight UnitЕдиница измерения веса, например POUND.
Item SKUАртикул компонента.
Item Product IDИдентификатор товара компонента.
Item NameОтображаемое название элемента каталога.
Item DescriptionОписание товара.
Item HS CodeКод Гармонизированной системы (HS) для таможенной классификации.
Item Country of OriginДвухбуквенный код страны, где произведен товар, например CN.
Item WeightВес товара.
Item Weight UnitЕдиница измерения веса, например POUND.
Item LengthДлина товара.
Item WidthШирина товара.
Item HeightВысота товара.
Item Dimensional UnitЕдиница измерения размеров товара, например INCH.
Item QuantityСколько единиц этого компонента находится в пакете.
Item AmountЦена отдельного компонента. Используется при создании или обновлении элемента каталога.
Item CurrencyВалюта цены товара, например USD.
Item Packing PreferenceКак следует упаковывать этот товар. Используйте ASSIGNED_BOX для товаров, упакованных в указанную коробку, CONSOLIDATED для картонизации или SHIPS_ALONE для товаров, которые должны отправляться отдельно. Необязательно — по умолчанию используется ASSIGNED_BOX, если указаны столбцы коробки.
  1. Перейдите в Dashboard > Products > Bundles.
  2. Нажмите Manage > Export.
  3. Выберите вариант экспорта:
    • Export all bundles — экспортирует все пакеты
    • Export assigned box bundles — экспортирует только пакеты с заранее назначенными коробками
    • Export auto bundles — экспортирует только пакеты с Auto-box
  4. Нажмите Export. CSV будет отправлен вам по электронной почте, когда будет готов.

Примечание: изменения пакета влияют только на будущие заказы. Уже размещенные и выполненные заказы не затрагиваются.

  1. Перейдите в Dashboard > Products > Bundles.
  2. Нажмите на пакет, который хотите отредактировать.
  3. Обновите поля и нажмите Save.

Вы можете изменить режим упаковки, добавить или удалить компоненты, обновить назначение коробок и изменить цену пакета.

Чтобы удалить один пакет, откройте его и нажмите Delete.

Чтобы удалить несколько пакетов одновременно:

  1. Выберите пакеты, которые вы хотите удалить, с помощью флажков.
  2. Нажмите Delete selected.
  3. Подтвердите удаление.

Чтобы удалить все пакеты на текущей странице, нажмите Manage > Delete page.

Вы можете добавить пакеты в расчет непосредственно из quoter, чтобы увидеть полную стоимость еще до размещения заказа.

  1. В quoter переключитесь на вкладку Search bundles в разделе Items.
  2. Найдите пакет по названию, артикулу или идентификатору товара.
  3. Выберите пакет. Zonos автоматически:
    • Разбивает пакет на отдельные компоненты в списке товаров, каждый со своим кодом HS, страной происхождения и скидочной ценой.
    • Заполняет коробки (только для пакетов с Assigned box) — заранее определенные коробки пакета добавляются в раздел Boxes с уже заполненными размерами.
    • Пропускает заполнение коробок (для пакетов с Auto-box) — картонизация определяет коробки при расчете.
  4. Компоненты отображаются сгруппированными под названием пакета в списке товаров.
  5. Рассчитайте стоимость. Полная стоимость отражает реальную структуру пакета — пошлины, налоги и доставку для каждого компонента на основе реальных или автоматически определенных размеров коробки.

Вы можете добавить в один расчет несколько пакетов и отдельные товары. Каждый пакет разбивается независимо.

Почему пакеты важны для расчета полной стоимости 

Без пакетов Zonos видит одну позицию (например, «Truck Tire 4-Pack — $1,000») без какой-либо информации о том, что в ней содержится. Это создает проблемы:

  • Нет кодов HS для каждого товара — Zonos не может классифицировать компоненты для точного расчета пошлин
  • Нет реальных размеров коробки — расходы на доставку оцениваются с помощью алгоритма автоматической упаковки вместо фактических коробок продавца
  • Нет цены для каждого товара — для расчета пошлин используется полная цена пакета вместо скидочной цены каждого компонента

Пакеты решают все три проблемы, заранее предоставляя Zonos разбивку по компонентам, назначение коробок (или группировку для Auto-box) и распределение цены. В результате получается расчет полной стоимости, который отражает то, что покупатель действительно заплатит на границе.

Коэффициенты цены и ценообразование компонентов 

Когда пакет продается, Zonos должен знать, сколько стоит каждый компонент по отдельности. Это связано с тем, что для международных отправлений требуется заявленная стоимость на каждый товар в коммерческом счете-фактуре, а пошлины и налоги рассчитываются для каждого товара отдельно.

priceRatio определяет, как общая цена пакета распределяется между его компонентами. Вам не обязательно задавать это значение самостоятельно — если оставить поле пустым, Zonos автоматически распределит цену поровну между всеми компонентами.

Например, пакет за 1000 долларов с 4 шинами без заданных коэффициентов цены автоматически объявит каждую шину по 250 долларов (0,25 каждая). Если ваши компоненты имеют разную стоимость — например, 2 премиальные шины и 2 стандартные — вы можете вручную задать коэффициенты, например 0,35 и 0,15, чтобы отразить фактическую разницу в стоимости.

Zonos автоматически нормализует коэффициенты, поэтому вам не нужно беспокоиться о математике:

  • Если некоторые коэффициенты оставлены пустыми, оставшееся значение равномерно распределяется между этими компонентами
  • Если сумма коэффициентов не равна ровно 1,0, Zonos масштабирует их пропорционально
  • Итоговые коэффициенты всегда в сумме составляют ровно 1,0

Картонизация и ярлыки 

Компоненты пакетов с Assigned box используют коробки, определенные продавцом, вместо стандартного алгоритма упаковки в контейнеры. packingPreference каждого компонента установлен на ASSIGNED_BOX, что указывает картонизации размещать его в коробке, заданной packageOptionId и packageOptionIdIndex.

Это основное преимущество пакетов с Assigned box — продавец точно знает, как отправляется его товар, поэтому размеры и вес коробки, используемые для расчета полной стоимости, точны, а не оценены.

Каждая коробка в пакете формирует свой собственный ярлык доставки со своим номером отслеживания. Пакет с двумя коробками формирует два ярлыка.

Смешанные заказы

Товары, не входящие в пакет, в том же заказе упаковываются отдельно с использованием стандартного алгоритма картонизации, независимо от того, какой режим упаковки используют пакеты.

Смешанные заказы с пакетами 

Один заказ может одновременно содержать несколько пакетов и отдельные товары. Например, заказ с:

  • 1 пакетом из 4 товаров с Assigned box (отправляется в 2 коробках)
  • 1 пакетом из 3 товаров с Auto-box (упаковку определяет картонизация)
  • 1 отдельным товаром

Zonos разбивает каждый пакет независимо. Расчет полной стоимости охватывает все коробки с точными размерами и все отдельные цены компонентов. Каждая коробка получает свой собственный ярлык.

Интеграция Shopify 

Пакеты имеют определенное поведение при использовании с магазинами Shopify.

Настройка

Идентификатор товара пакета в Zonos Catalog должен совпадать с идентификатором варианта Shopify товара пакета. Это то, как Zonos сопоставляет позицию заказа Shopify с определением пакета. Вы можете найти идентификатор варианта в URL-адресе админ-панели Shopify при просмотре варианта товара.

Ход выполнения заказа

Когда покупатель заказывает пакет в магазине Shopify:

  1. Shopify отправляет одну позицию заказа для родительского пакета (например, «Truck Tire 4-Pack x 1»).
  2. Zonos сопоставляет идентификатор варианта товара идентификатору товара пакета в вашем каталоге.
  3. Zonos разбивает пакет на его отдельные компоненты для расчета полной стоимости — каждый код HS компонента, страна происхождения и скидочная цена используются для точного расчета пошлин и налогов.
  4. Заказ Shopify по-прежнему показывает одну позицию пакета — разбивка компонентов полностью обрабатывается Zonos.

Выполнение

При создании выполнений Zonos сопоставляет разбитые компоненты пакета обратно с исходной позицией пакета Shopify. Продавец видит выполненный пакет в Shopify (например, «Truck Tire 4-Pack x 1 выполнено»), в то время как коммерческий счет-фактура и таможенные документы перечисляют каждый компонент отдельно.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

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