Узнайте, как добавлять, изменять и удалять товары каталога Zonos в Dashboard или через API. Используйте Catalog в Dashboard, если вы не хотите писать код или делаете небольшие изменения. Если вы хотите прямую интеграцию с Catalog для производственной реализации, используйте API.
Создание товара
Создайте товар в Catalog:
Перейдите в Catalog и нажмите Add product в верхнем правом углу.
Добавьте данные о товаре. Единственные обязательные поля для создания товара — это SKU и/или поле идентификатора товара. Эти поля используются для ссылки на ваши товары в каталоге. Узнайте больше о идентификаторах Catalog.
Необязательно—Добавьте коды HS.
Необязательно—Добавьте информацию о доставке (вес, размеры, единицы измерения и т. д.).
Для отправок DHL вы можете пометить товар как опасный груз, чтобы правильный сервис DHL с добавленной стоимостью применялся автоматически каждый раз, когда вы создаете этикетку для этого товара. Это охватывает категории «низкий риск» или исключенные классы регулируемых товаров — товары, которые технически регулируются, но отправляются в соответствии со специальным положением или исключением количества.
Тег опасного груза хранится как атрибут товара каталога: пара key/value на товаре. Атрибуты устанавливаются через API (catalogItemsCreate или catalogItemsUpdate) — нет поля Dashboard или столбца CSV для них.
Только DHL
Маркировка опасного груза влияет только на отправки DHL. Тег игнорируется
для других перевозчиков.
Поддерживаемый ключ атрибута
DANGEROUS_GOODS — это поддерживаемый ключ атрибута для маркировки опасного груза DHL.
Он еще не указан среди одобренных ключей в справочнике
ItemAttributeInput, но его принимает
API.
Чтобы пометить товар, добавьте атрибут с ключом DANGEROUS_GOODS и значением одной из поддерживаемых категорий ниже.
Не ограничено, специальное положение A70 — изделия под давлением, такие как газовые амортизаторы и стойки (UN3164).
NOT_RESTRICTED_A67
Не ограничено, специальное положение A67 — двигатели или механизмы, работающие на легковоспламеняющейся жидкости (UN3528).
NOT_RESTRICTED_A02
Не ограничено, специальное положение A02 — исключение по положению ADR для небольших партий при автомобильной перевозке.
LIMITED_QUANTITY
Ограниченное количество (ADR) — опасные грузы, упакованные в небольших количествах в пределах нормативных ограничений.
EXCEPTED_QUANTITY
Исключённое количество (IATA) — очень малые количества, освобождённые от большинства правил перевозки опасных грузов авиатранспортом.
CONSUMER_COMMODITY
Потребительский товар ID8000 — готовые к продаже повседневные товары с незначительным содержанием опасных веществ, например аэрозоли и парфюмерия.
MAGNETIZED_MATERIAL
Магнетизированный материал (UN2807) — изделия с магнитным полем, достаточно сильным, чтобы влиять на приборы самолёта.
BIOLOGICAL_SUBSTANCE
Биологическое вещество (UN3373) — биологические вещества категории B, например диагностические или клинические образцы.
Применять теги автоматически на этикетках
Маркировка товара — это первый шаг. Чтобы Zonos применял категорию к вашим
этикеткам DHL автоматически, включите Ship dangerous goods в
параметрах этикетки. Вы также можете
выбрать категорию вручную на одной этикетке — см.
объявить опасный груз.
Редактирование товара
Редактирование товаров позволяет эффективно обновлять существующие товары дополнительной или обновленной информацией. Вместо удаления и повторной загрузки товара вы можете загрузить обновленную информацию, и Catalog сопоставит его с существующим товаром, используя ваш SKU или идентификатор товара, в зависимости от вашего предпочтения ключа элемента. Таким образом, вы можете поддерживать актуальность каталога с минимальными усилиями, используете ли вы Dashboard или API для создания новых товаров или редактирования существующих.
Если вы создаете/редактируете товар каталога, который уже существует в Catalog, ожидайте следующего:
Catalog будет перезаписывать пустые поля существующих товаров.
Например, если существующий товар SKU 321 не имел значения для веса, а тот же товар SKU 321 в новой загрузке имел вес 1,3 фунта, вес 1,3 фунта переопределит ранее пустое поле.
Catalog переопределит существующие поля новыми значениями полей.
Например, если существующий товар SKU 123 имел цену 18,99 USD, а тот же товар SKU 123 имел обновленную цену 22,99 USD, новая цена 22,99 USD переопределит предыдущую цену.
Catalog не переопределит существующие значения пустыми полями.
Например, если существующий товар SKU 456 имел код HS 6109.10, но код HS обновленного товара SKU 456 пуст, существующий код HS остается.
Чтобы отредактировать товар:
Нажмите на вкладку Products.
Выберите товар, который хотите отредактировать.
Внесите свои изменения.
Нажмите save product.
Чтобы отредактировать несколько или все товары одновременно, просто загрузите обновленный CSV файл в Catalog, включив ваш SKU или идентификатор товара. Это инициирует автоматические обновления существующих товаров.
Удаление товара
Чтобы удалить товар:
Нажмите на вкладку Products в Dashboard.
Выберите товар(ы), которые хотите удалить. После выбора товара(ов) появится кнопка удаления.
Нажмите Delete и затем Delete all для подтверждения удаления.
Чтобы удалить все товары:
Выберите вкладку Products в Dashboard.
Нажмите Manage Catalog в верхнем правом углу, затем Delete all.
Нажмите Delete all еще раз для подтверждения удаления.
Обратите внимание, что если вы удаляете большое количество товаров (более 20 000 товаров или около того), появится уведомление, указывающее, что ваше удаление выполняется. В это время вы не сможете взаимодействовать с Catalog до завершения удаления. Однако вы можете закрыть уведомление и перейти на другую страницу без прерывания процесса удаления.
Ограничение товара
Если вы хотите предотвратить отправки в определенную страну (или страны), вы можете добавить ограничения при создании или обновлении товара.
Приложения Zonos Duty & Tax не поддерживают ограничения на уровне товара, которые удаляют определенные товары из международных заказов. Если ограниченный товар находится в корзине, вся корзина должна быть заблокирована от отправки в эту страну. Это обрабатывается через правило ограничения на уровне корзины, которое должно быть настроено заранее во время подключения. Хотя Catalog совместим с приложениями Duty & Tax, ограничения на уровне товара поддерживаются только при использовании Zonos Checkout.
Чтобы ограничить один товар в Catalog:
Нажмите на вкладку Products.
Выберите товар, к которому хотите добавить ограничение, что откроет страницу редактирования.
Найдите раздел Restricted countries в нижней части страницы редактирования.
Добавьте страны, к которым хотите ограничить ваш товар, выбрав или введя название(я) страны(стран).
Заполните шаблон данными о товарах, включив SKU/Product ID и ограниченные страны. Введите 2-символьный код ISO, разделенный вертикальными полосами, например AU|KR|MY|SG. Чтобы ограничить все страны, просто введите ALL как значение. Если вы хотите ограничить все страны, кроме одной или нескольких, введите ALL- с последующими странами, которые вы хотите разблокировать, разделенными вертикальными полосами, например ALL-CA|FR|US. Узнайте больше о форматировании CSV. Если вы хотите удалить все существующие ограниченные страны, введите NONE как значение.
Сохраните файл как CSV и загрузите в Catalog, перетащив его или выбрав файл, нажав browse на той же странице, откуда вы загрузили CSV.
Проверьте загруженные товары на экране предварительного просмотра и нажмите upload.
Фильтрация ограниченных товаров:
Вы можете фильтровать ограниченные товары прямо в каталоге, загружая весь каталог в формате CSV из Dashboard и открывая его в Excel или Google Sheets. Оттуда вы можете использовать функцию фильтрации для просмотра только ограниченных товаров. Это позволяет вам легко находить и управлять ограниченными товарами в каталоге.
Если вам нужно обновить каталог после внесения изменений в CSV, перезагрузите файл, и все соответствующие товары будут заменены обновленной версией. Это делается путем идентификации и сопоставления SKU и/или идентификатора товара.
Если вы используете Checkout, то при ограничении товара для страны покупателя в вашем Checkout будет отображаться сообщение об ограничении. По умолчанию оно будет выглядеть так: "This item is restricted from import to your country."
Фильтрация товара
Вы можете искать товары в Catalog через Dashboard или через API, используя SKU, идентификатор товара или название товара. Для поиска по SKU и идентификатору товара будут возвращены только точные совпадения; частичные совпадения не поддерживаются. При поиске по названию товара, однако, поддерживаются частичные совпадения.
Чтобы отфильтровать по SKU или идентификатору товара:
Нажмите на вкладку Products в Dashboard.
Выберите SKU или Product ID в верхнем левом углу вашего Catalog.
Введите ваш SKU, идентификатор товара или название товара.
Нажмите Apply для просмотра отфильтрованного товара(ов).
Чтобы искать название товара:
Нажмите на вкладку Products в Dashboard.
В верхнем правом углу вашего Catalog введите название товара в поле поиска.
Просмотрите отфильтрованный товар(ы).
Экспорт ваших товаров
Если вы выберете 50 или менее товаров из таблицы Catalog, ваш каталог будет загружен непосредственно из Dashboard. Однако если вы выберете Export all или более 50 товаров, ваш CSV будет экспортирован по электронной почте.
Чтобы экспортировать 50 товаров или менее, выполните следующие действия:
Выберите 50 или менее товаров непосредственно из таблицы Catalog.
Нажмите Export в верхнем правом углу.
Найдите ваш CSV файл в папке входящих сообщений электронной почты.
Нажмите на раскрывающееся меню Manage Catalog рядом с Add product и нажмите Export all.
Найдите файл каталога в загрузках.
Проблемы с загрузкой из электронной почты?
Если у вас возникли проблемы с загрузкой CSV из ссылки в электронном письме, это может быть из-за того, что ваш браузер блокирует загрузку. Если это так, выполните следующие действия:
Щелкните правой кнопкой мыши на кнопку "Download" в электронном письме.
Выберите "Copy link address" для копирования URL загрузки.
Вставьте скопированный URL в браузер и нажмите Enter.
Ваш каталог затем загрузится непосредственно из браузера.
Классификация товара
Вы можете классифицировать товар из вашего каталога с помощью API, используя catalogItemId в мутации ClassificationsCreateFromCatalog.
Обратите внимание, что name требуется для классификации товара из вашего каталога. Обратитесь к справочнику GraphQL API для получения полного списка полей каталога и классификации.
Чтобы создать и классифицировать товар каталога одновременно, добавьте мутацию ClassificationsCreateFromCatalog ниже в вашу мутацию CatalogItemsCreatemutation.
Когда поле shipToCountries заполнено, классификация будет представлять собой 8-значный (специфичный для страны) код HS. Если поле shipToCountries не указано, по умолчанию будет использован 6-значный (универсальный) код HS. Узнайте больше о различиях между универсальными и специфичными для страны кодами HS.
В примере ниже поле shipToCountries указано, чтобы создать код HS, специфичный для страны — в данном случае для Канады.
Вот пример запроса. Хотя Zonos Classify создаст классификацию только с name, мы настоятельно рекомендуем добавить как можно больше деталей для лучших результатов классификации.
A SKU or product ID is required to create a product
Для создания, редактирования или удаления товара каталога требуется идентификатор (SKU/ID товара). Чтобы устранить эту ошибку, добавьте SKU и/или ID товара.
The product you are trying to edit does not exist*
Вы не можете редактировать товар, которого не существует. Чтобы устранить эту ошибку, создайте новый товар с нужным SKU и/или ID товара.
Customs description exceeds character limit of 30 characters.
По умолчанию таможенное описание ограничено 30 символами, что соответствует наиболее распространённому ограничению для коммерческих инвойсов.
Product type invalid. Catalog supports the following product types: digital_good. For physical goods, leave it blank.
Catalog поддерживает только следующие типы товаров: digital_good и physical_good. Если ваш товар является физическим товаром (самый распространённый случай), оставьте это поле пустым.
Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank.
Недействительное предпочтение упаковки. Catalog поддерживает следующие предпочтения упаковки: ships_alone и consolidated. Если ваш товар можно объединять с другими товарами, можно оставить поле пустым, так как значением по умолчанию является consolidated.
Country must be specified when providing an HS code
Если при создании товара вы указываете код HS, специфичный для страны, необходимо указать страну доставки. Чтобы устранить эту ошибку, добавьте страну доставки.
Price must be greater than 0
Catalog не поддерживает отрицательные значения цены. Чтобы устранить эту ошибку, укажите цену больше нуля.
Currency code must be provided when a price value is supplied
Если вы указываете цену, необходимо также указать код валюты. Чтобы устранить эту ошибку, добавьте код валюты.
Price must be provided when a currency code is supplied
Если вы указываете код валюты, необходимо также указать цену. Чтобы устранить эту ошибку, добавьте цену.
The accompanying dimensional field cannot be left blank
Если указано одно из полей размеров, два других становятся обязательными, например, если вы указали ширину 8 дюймов, то высота и длина также обязательны.
Measurement value must be greater than 0
Catalog не поддерживает отрицательные или нулевые значения размеров. Чтобы устранить эту ошибку, укажите значение больше нуля.
When providing a dimensional value, dimensional units cannot be left empty
Если вы указываете значение размера, необходимо также указать единицу измерения размера. Чтобы устранить эту ошибку, добавьте единицу измерения.
When providing a weight value, the weight unit cannot be left empty
Если вы указываете значение веса, необходимо также указать единицу измерения веса. Чтобы устранить эту ошибку, добавьте единицу измерения веса.
* Только для API
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Управление товарами
Управление каталогом
Создавайте и изменяйте товары.Узнайте, как добавлять, изменять и удалять товары каталога Zonos в Dashboard или через API. Используйте Catalog в Dashboard, если вы не хотите писать код или делаете небольшие изменения. Если вы хотите прямую интеграцию с Catalog для производственной реализации, используйте API.
Создание товара
Создайте товар в Catalog:
Создание нескольких товаров в Catalog:
Загрузите несколько товаров или весь каталог товаров одновременно.
Пометить товар как опасный груз (DHL)
Для отправок DHL вы можете пометить товар как опасный груз, чтобы правильный сервис DHL с добавленной стоимостью применялся автоматически каждый раз, когда вы создаете этикетку для этого товара. Это охватывает категории «низкий риск» или исключенные классы регулируемых товаров — товары, которые технически регулируются, но отправляются в соответствии со специальным положением или исключением количества.
Тег опасного груза хранится как атрибут товара каталога: пара
key/valueна товаре. Атрибуты устанавливаются через API (catalogItemsCreateилиcatalogItemsUpdate) — нет поля Dashboard или столбца CSV для них.Маркировка опасного груза влияет только на отправки DHL. Тег игнорируется для других перевозчиков.
DANGEROUS_GOODS— это поддерживаемый ключ атрибута для маркировки опасного груза DHL. Он еще не указан среди одобренных ключей в справочникеItemAttributeInput, но его принимает API.Чтобы пометить товар, добавьте атрибут с ключом
DANGEROUS_GOODSи значением одной из поддерживаемых категорий ниже.mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) {catalogItemsCreate(input: [{ sku: $sku, name: $name, attributes: $attributes }]) {idnameskuattributes {keyvalue}Поддерживаемые значения опасного груза
NOT_RESTRICTED_A70NOT_RESTRICTED_A67NOT_RESTRICTED_A02LIMITED_QUANTITYEXCEPTED_QUANTITYCONSUMER_COMMODITYMAGNETIZED_MATERIALBIOLOGICAL_SUBSTANCEМаркировка товара — это первый шаг. Чтобы Zonos применял категорию к вашим этикеткам DHL автоматически, включите Ship dangerous goods в параметрах этикетки. Вы также можете выбрать категорию вручную на одной этикетке — см. объявить опасный груз.
Редактирование товара
Редактирование товаров позволяет эффективно обновлять существующие товары дополнительной или обновленной информацией. Вместо удаления и повторной загрузки товара вы можете загрузить обновленную информацию, и Catalog сопоставит его с существующим товаром, используя ваш SKU или идентификатор товара, в зависимости от вашего предпочтения ключа элемента. Таким образом, вы можете поддерживать актуальность каталога с минимальными усилиями, используете ли вы Dashboard или API для создания новых товаров или редактирования существующих.
Если вы создаете/редактируете товар каталога, который уже существует в Catalog, ожидайте следующего:
Catalog будет перезаписывать пустые поля существующих товаров.
Catalog переопределит существующие поля новыми значениями полей.
Catalog не переопределит существующие значения пустыми полями.
Чтобы отредактировать товар:
Чтобы отредактировать несколько или все товары одновременно, просто загрузите обновленный CSV файл в Catalog, включив ваш SKU или идентификатор товара. Это инициирует автоматические обновления существующих товаров.
Удаление товара
Чтобы удалить товар:
Чтобы удалить все товары:
Обратите внимание, что если вы удаляете большое количество товаров (более 20 000 товаров или около того), появится уведомление, указывающее, что ваше удаление выполняется. В это время вы не сможете взаимодействовать с Catalog до завершения удаления. Однако вы можете закрыть уведомление и перейти на другую страницу без прерывания процесса удаления.
Ограничение товара
Если вы хотите предотвратить отправки в определенную страну (или страны), вы можете добавить ограничения при создании или обновлении товара.
Приложения Zonos Duty & Tax не поддерживают ограничения на уровне товара, которые удаляют определенные товары из международных заказов. Если ограниченный товар находится в корзине, вся корзина должна быть заблокирована от отправки в эту страну. Это обрабатывается через правило ограничения на уровне корзины, которое должно быть настроено заранее во время подключения. Хотя Catalog совместим с приложениями Duty & Tax, ограничения на уровне товара поддерживаются только при использовании Zonos Checkout.
Чтобы ограничить один товар в Catalog:
Чтобы ограничить несколько товаров в Catalog:
AU|KR|MY|SG. Чтобы ограничить все страны, просто введитеALLкак значение. Если вы хотите ограничить все страны, кроме одной или нескольких, введитеALL-с последующими странами, которые вы хотите разблокировать, разделенными вертикальными полосами, напримерALL-CA|FR|US. Узнайте больше о форматировании CSV. Если вы хотите удалить все существующие ограниченные страны, введитеNONEкак значение.Фильтрация ограниченных товаров:
Вы можете фильтровать ограниченные товары прямо в каталоге, загружая весь каталог в формате CSV из Dashboard и открывая его в Excel или Google Sheets. Оттуда вы можете использовать функцию фильтрации для просмотра только ограниченных товаров. Это позволяет вам легко находить и управлять ограниченными товарами в каталоге.
Если вам нужно обновить каталог после внесения изменений в CSV, перезагрузите файл, и все соответствующие товары будут заменены обновленной версией. Это делается путем идентификации и сопоставления SKU и/или идентификатора товара.
Если вы используете Checkout, то при ограничении товара для страны покупателя в вашем Checkout будет отображаться сообщение об ограничении. По умолчанию оно будет выглядеть так: "This item is restricted from import to your country."
Фильтрация товара
Вы можете искать товары в Catalog через Dashboard или через API, используя SKU, идентификатор товара или название товара. Для поиска по SKU и идентификатору товара будут возвращены только точные совпадения; частичные совпадения не поддерживаются. При поиске по названию товара, однако, поддерживаются частичные совпадения.
Чтобы отфильтровать по SKU или идентификатору товара:
Чтобы искать название товара:
Экспорт ваших товаров
Если вы выберете 50 или менее товаров из таблицы Catalog, ваш каталог будет загружен непосредственно из Dashboard. Однако если вы выберете Export all или более 50 товаров, ваш CSV будет экспортирован по электронной почте.
Чтобы экспортировать 50 товаров или менее, выполните следующие действия:
Чтобы экспортировать все товары:
Проблемы с загрузкой из электронной почты?
Если у вас возникли проблемы с загрузкой CSV из ссылки в электронном письме, это может быть из-за того, что ваш браузер блокирует загрузку. Если это так, выполните следующие действия:
Классификация товара
Вы можете классифицировать товар из вашего каталога с помощью API, используя
catalogItemIdв мутацииClassificationsCreateFromCatalog.Обратите внимание, что
nameтребуется для классификации товара из вашего каталога. Обратитесь к справочнику GraphQL API для получения полного списка полей каталога и классификации.Чтобы создать и классифицировать товар каталога одновременно, добавьте мутацию
ClassificationsCreateFromCatalogниже в вашу мутациюCatalogItemsCreatemutation.Классифицировать товар каталога на 8+ цифр (специфичный для страны)
Когда поле
shipToCountriesзаполнено, классификация будет представлять собой 8-значный (специфичный для страны) код HS. Если полеshipToCountriesне указано, по умолчанию будет использован 6-значный (универсальный) код HS. Узнайте больше о различиях между универсальными и специфичными для страны кодами HS.В примере ниже поле
shipToCountriesуказано, чтобы создать код HS, специфичный для страны — в данном случае для Канады.mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) {classificationsCalculateFromCatalog(input: $catalogItemToClassify) {idconfiguration {shipToCountries}hsCode {code}name}}Вот пример запроса. Хотя Zonos Classify создаст классификацию только с
name, мы настоятельно рекомендуем добавить как можно больше деталей для лучших результатов классификации.Ошибки API и их решения
digital_goodиphysical_good. Если ваш товар является физическим товаром (самый распространённый случай), оставьте это поле пустым.ships_aloneиconsolidated. Если ваш товар можно объединять с другими товарами, можно оставить поле пустым, так как значением по умолчанию являетсяconsolidated.ItemAttributeInput
Была ли эта страница полезной?