DOCS

Manage products

/

Управление каталогом

Создавайте и изменяйте продукты.

Узнайте, как добавлять, изменять и удалять ваши продукты в каталоге Zonos в Dashboard или через API. Используйте каталог в Dashboard, чтобы избежать написания кода или если вы вносите небольшие изменения. Если вы хотите напрямую интегрироваться с каталогом для производственных реализаций, используйте API.

Создание продукта

Dashboard
API

Создайте продукт в каталоге:

  1. Перейдите в Каталог и нажмите Добавить продукт в правом верхнем углу.
  2. Добавьте детали вашего продукта. Единственное поле, необходимое для создания продукта, это поле SKU и/или ID продукта. Эти поля будут использоваться для ссылки на ваши продукты в каталоге. Узнайте больше о идентификаторах каталога.
  3. Необязательно—Добавьте ваши коды HS.
  4. Необязательно—Добавьте информацию о доставке (вес, размеры, единицы измерения и т.д.).
  5. Необязательно—Добавьте ограниченные страны.
  6. Нажмите сохранить продукт.

Создайте несколько продуктов в каталоге:

Загрузите несколько продуктов или весь ваш каталог продуктов сразу.

Важно: Если вы попытаетесь создать продукт, который уже существует, Каталог распознает продукт на основе SKU и/или идентификатора продукта и перезапишет детали оригинального продукта новыми данными.

Редактирование продукта

Редактирование продуктов позволяет вам эффективно обновлять существующие продукты с дополнительной или обновленной информацией. Вместо того чтобы удалять и загружать продукт заново, вы можете загрузить обновленную информацию, и Каталог сопоставит ее с существующим продуктом, используя ваш SKU или идентификатор продукта, в зависимости от ваших предпочтений ключа товара. Таким образом, вы можете поддерживать свой каталог в актуальном состоянии с минимальными усилиями, независимо от того, используете ли вы Панель управления или API для создания новых продуктов или редактирования существующих.

Если вы создаете/редактируете продукт каталога, который уже существует в Каталоге, ожидайте следующее:

Каталог перезапишет пустые поля в существующих товарах.

  • Например, если у существующего продукта, SKU 321, не было значения для веса, а у того же продукта, SKU 321, вес в новом загрузке составляет 1.3 фунта, то вес 1.3 фунта перезапишет ранее пустое поле.

Каталог перезапишет существующие поля новыми значениями полей.

  • Например, если у существующего продукта, SKU 123, была цена 18.99 USD, а у того же продукта, SKU 123, обновленная цена составляет 22.99 USD, новая цена 22.99 USD перезапишет предыдущую цену.

Каталог не перезапишет существующие значения пустыми полями.

  • Например, если у существующего продукта, SKU 456, был код HS 6109.10, но код HS обновленного продукта, SKU 456, пуст, существующий код HS останется.
Панель управления
API

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

  1. Нажмите на вкладку Продукты.
  2. Выберите продукт, который вы хотите отредактировать.
  3. Внесите изменения.
  4. Нажмите сохранить продукт.

Чтобы отредактировать несколько или все продукты сразу, просто загрузите обновленный CSV файл в Каталог, включая ваши комбинации SKU/идентификатора продукта. Это вызовет автоматические обновления ваших существующих товаров.

Удалить продукт

Панель управления
API

Чтобы удалить продукт:

  1. Нажмите на вкладку Продукты в Панели управления.
  2. Выберите продукт(ы), которые вы хотите удалить. После выбора вашего продукта(ов) появится кнопка удаления.
  3. Нажмите Удалить, а затем Удалить все, чтобы подтвердить ваше удаление.

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

  1. Выберите вкладку Продукты в Панели управления.
  2. Нажмите Управление каталогом в правом верхнем углу, а затем Удалить все.
  3. Нажмите Удалить все еще раз, чтобы подтвердить ваше удаление.

Обратите внимание, что если вы удаляете большое количество товаров (более 20,000 продуктов или около того), появится уведомление, указывающее на то, что ваше удаление в процессе. В это время вы не сможете взаимодействовать с Каталогом, пока удаление не будет завершено. Однако вы можете закрыть уведомление и перейти на другую страницу, не прерывая процесс удаления.

Restrict продукт

Если вы хотите предотвратить отправку товаров в определенную страну (или страны), вы можете добавить ограничения при создании или обновлении продукта.

Панель управления
API

Чтобы restrict один продукт в Каталоге:

  1. Нажмите на вкладку Продукты.
  2. Выберите продукт, к которому вы хотите добавить ограничение, что откроет страницу редактирования.
  3. Найдите раздел Ограниченные страны внизу страницы редактирования.
  4. Добавьте страны, в которые вы хотите restrict ваш продукт, выбрав или введя название страны(ей).
  5. Нажмите сохранить продукт.

Чтобы restrict несколько продуктов в Каталоге:

  1. Нажмите на вкладку Импорт/экспорт.
  2. Скачайте Шаблон каталога CSV.
  3. Заполните шаблон данными о вашем продукте, включая ваш SKU/ID продукта и ограниченные страны. Введите 2-значный ISO код, разделенный вертикальными линиями (например, AU|KR|MY|SG). Чтобы restrict все страны, просто введите ALL в качестве значения. Если вы хотите restrict все страны, кроме одной или нескольких, введите ALL-, за которым следуют страны, которые вы хотите разблокировать, разделенные вертикальными линиями (например, ALL-CA|FR|US). Узнайте больше о форматировании CSV. Если вы хотите удалить все существующие ограниченные страны, введите NONE в качестве значения.
  4. Сохраните ваш файл в формате CSV и загрузите в Каталог, перетащив файл или выбрав его, нажав обзор на той же странице, с которой вы скачали CSV.
  5. Просмотрите загруженные продукты в предварительном screen и нажмите загрузить.

Фильтрация ограниченных продуктов:

Вы можете фильтровать ограниченные продукты непосредственно в каталоге, скачав весь ваш каталог в формате CSV с Панели управления и открыв его в Excel или Google Sheets. Оттуда вы можете использовать функцию фильтрации, чтобы просмотреть только ограниченные продукты. Это позволяет вам легко находить и управлять ограниченными продуктами в вашем каталоге.

Если вам нужно обновить ваш каталог после внесения изменений в ваш CSV, повторно загрузите файл, и все совпадающие продукты будут заменены обновленной версией. Это делается путем идентификации и сопоставления SKU и/или ID продукта.

Если вы используете Checkout, в вашем checkout будет отображено ограниченное сообщение, когда продукт ограничен для страны клиента. По умолчанию сообщение будет гласить "Этот товар запрещен к импорту в вашу страну", но вы можете настроить собственное ограниченное сообщение, указав его в поле restrictedCountriesMessage при добавлении ограничений для вашей страны.

Фильтрация продукта

Вы можете искать продукты в Каталоге через Панель управления или через API, используя либо SKU, либо идентификатор продукта. Обратите внимание, что только точные совпадения вернут результаты; частичные совпадения не будут распознаны.

Панель управления
API

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

  1. Нажмите на вкладку Продукты.
  2. Выберите SKU или Идентификатор продукта в верхнем левом углу вашего Каталога.
  3. Введите ваш SKU или идентификатор продукта.
  4. Нажмите Применить, чтобы просмотреть отфильтрованные продукт(ы).

Экспортируйте ваши продукты

Если вы выберете 50 или менее товаров из таблицы Каталога, ваш каталог будет загружен напрямую с Dashboard. Однако, если вы выберете Экспортировать все или более 50 товаров, ваш CSV будет экспортирован по электронной почте.

Чтобы экспортировать 50 товаров или менее, выполните следующие шаги:

  1. Выберите 50 или менее товаров непосредственно из таблицы Каталога.
  2. Нажмите Экспорт в правом верхнем углу.
  3. Найдите ваш CSV файл в вашем почтовом ящике.

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

Dashboard
API
  1. Перейдите в Dashboard -> Products -> Каталог.
  2. Нажмите на выпадающее меню Управление каталогом рядом с Добавить продукт и выберите Экспортировать все.
  3. Найдите ваш файл каталога в ваших загрузках.

Проблемы с загрузкой из вашей электронной почты?

Если у вас возникли проблемы с загрузкой CSV по ссылке в электронной почте, это может быть связано с тем, что ваш браузер блокирует загрузку. Если это так, выполните следующие шаги:

  1. Щелкните правой кнопкой мыши на кнопке "Скачать" в вашей электронной почте.
  2. Выберите "Копировать адрес ссылки", чтобы скопировать URL для загрузки.
  3. Вставьте скопированный URL в ваш браузер и нажмите Enter.
  4. Ваш каталог будет загружен напрямую из вашего браузера.

Classify продукт

Вы можете classify продукт из вашего каталога с помощью API, используя catalogItemId в мутации ClassificationsCreateFromCatalog.

Обратите внимание, что для classify продукта из вашего каталога требуется name. Ознакомьтесь с документацией GraphQL API для получения полного списка полей каталога и классификации.

Чтобы создать и classify продукт каталога одновременно, добавьте мутацию ClassificationsCreateFromCatalog ниже к вашей мутации CatalogItemsCreate мутация.

Classify продукт каталога с 8+ цифрами (специфично для страны)

Когда поле shipToCountries заполнено, классификация будет 8+ цифр (специфично для страны) HS-код. Если shipToCountries не указаны, классификация по умолчанию будет 6-значным (универсальным) HS-кодом. Узнайте больше о различиях между универсальными и специфичными для страны HS-кодами.

В приведенном ниже примере поле shipToCountries указано для генерации специфичного для страны кода для Канады.

Mutation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

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

Переменные

1
2
3
4
5
6
7
8
9
10
{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

Ответ

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

Ошибки API и их решения

ОшибкаРешение
Требуется SKU или идентификатор продукта для создания продуктаНеобходим идентификатор (SKU/идентификатор продукта) для создания, редактирования или удаления элемента каталога. Чтобы решить эту проблему, добавьте SKU и/или идентификатор продукта.
Продукт, который вы пытаетесь отредактировать, не существует*Вы не можете редактировать продукт, который не существует. Чтобы решить эту проблему, создайте новый продукт с желаемым SKU и/или идентификатором продукта.
Описание для таможни превышает лимит в 30 символов.По умолчанию описания для таможни ограничены 30 символами, что соответствует наиболее распространенному лимиту символов для коммерческих счетов-фактур.
Тип продукта недействителен. Каталог поддерживает следующие типы продуктов: digital_good. Для физических товаров оставьте поле пустым.Каталог поддерживает только следующие типы продуктов: digital_good и physical_good. Если ваш продукт является физическим товаром (что наиболее распространено), оставьте это поле пустым.
Недействительный предпочтительный способ упаковки. Каталог поддерживает следующие предпочтения упаковки: ships_alone и consolidated. Если ваш продукт может быть объединен с другими продуктами, оставьте поле пустым.Недействительный предпочтительный способ упаковки. Каталог поддерживает следующие предпочтения упаковки: ships_alone и consolidated. Если ваш продукт может быть объединен с другими продуктами, вы можете оставить это поле пустым, так как consolidated является значением по умолчанию.
Страна должна быть указана при предоставлении кода HSЕсли вы предоставляете код HS, специфичный для страны при создании элемента, требуется указать страну доставки. Чтобы решить эту проблему, добавьте страну доставки.
Цена должна быть больше 0Каталог не поддерживает отрицательные значения цены. Чтобы решить эту проблему, добавьте цену, большую нуля.
Код валюты должен быть предоставлен, когда указано значение ценыЕсли вы указываете цену, требуется код валюты. Чтобы решить эту проблему, добавьте код валюты.
Цена должна быть указана, когда предоставлен код валютыЕсли вы указываете код валюты, требуется цена. Чтобы решить эту проблему, добавьте цену.
Сопутствующее измерительное поле не может быть пустымЕсли одно измерительное поле указано, требуются два других. Например, если вы указываете ширину "8 дюймов", то высота и длина также должны быть указаны.
Значение измерения должно быть больше 0Каталог не поддерживает отрицательные или нулевые значения измерений. Чтобы решить эту проблему, добавьте значение, большее нуля.
При указании измерительного значения единицы измерения не могут быть пустымиЕсли вы указываете измерительное значение, требуется единица измерения. Чтобы решить эту проблему, добавьте единицу измерения.
При указании значения веса единица веса не может быть пустойЕсли вы указываете значение веса, требуется единица веса. Чтобы решить эту проблему, добавьте единицу веса.

* Ошибка API только

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


На этой странице: