Создание товара
Создайте товар в Catalog:
- Перейдите в Catalog и нажмите Add product в верхнем правом углу.
- Добавьте данные о товаре. Единственные обязательные поля для создания товара — это SKU и/или поле идентификатора товара. Эти поля используются для ссылки на ваши товары в каталоге. Узнайте больше о идентификаторах Catalog.
- Необязательно—Добавьте коды HS.
- Необязательно—Добавьте информацию о доставке (вес, размеры, единицы измерения и т. д.).
- Необязательно—Добавьте страны с ограничениями.
- Нажмите save product.
Создание нескольких товаров в Catalog:
Загрузите несколько товаров или весь каталог товаров одновременно.
Важно: Если вы попытаетесь создать товар, который уже существует, Catalog распознает товар на основе SKU и/или идентификатора товара и переопределит детали исходного товара новыми деталями.
Пометить товар как опасный груз (DHL)
Для отправок DHL вы можете пометить товар как опасный груз, чтобы правильный сервис DHL с добавленной стоимостью применялся автоматически каждый раз, когда вы создаете этикетку для этого товара. Это охватывает категории «низкий риск» или исключенные классы регулируемых товаров — товары, которые технически регулируются, но отправляются в соответствии со специальным положением или исключением количества.
Тег опасного груза хранится как атрибут товара каталога: пара key/value на товаре. Атрибуты устанавливаются через API (catalogItemsCreate или catalogItemsUpdate) — нет поля Dashboard или столбца CSV для них.
Чтобы пометить товар, добавьте атрибут с ключом DANGEROUS_GOODS и значением одной из поддерживаемых категорий ниже.
mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) { catalogItemsCreate( input: [{ sku: $sku, name: $name, attributes: $attributes }] ) { id name sku attributes { key value }Поддерживаемые значения опасного груза
| Значение↕ | Категория↕ |
|---|---|
NOT_RESTRICTED_A70 | Not Restricted, Special Provision A70—pressurized articles, such as gas struts and shock absorbers (UN3164). |
NOT_RESTRICTED_A67 | Not Restricted, Special Provision A67—engines or machinery powered by flammable liquid (UN3528). |
NOT_RESTRICTED_A02 | Not Restricted, Special Provision A02—exempt under the ADR road-transport small-load provision. |
LIMITED_QUANTITY | Limited Quantity (ADR)—hazardous goods packed in small quantities within regulatory limits. |
EXCEPTED_QUANTITY | Excepted Quantity (IATA)—very small quantities exempt from most air-transport dangerous goods rules. |
CONSUMER_COMMODITY | Consumer commodity ID8000—retail-ready everyday products with minor hazardous content, such as aerosols and perfume. |
MAGNETIZED_MATERIAL | Magnetized material (UN2807)—items with a magnetic field strong enough to affect aircraft instruments. |
BIOLOGICAL_SUBSTANCE | Biological substance (UN3373)—Category B biological substances, such as diagnostic or clinical specimens. |
Редактирование товара
Редактирование товаров позволяет эффективно обновлять существующие товары дополнительной или обновленной информацией. Вместо удаления и повторной загрузки товара вы можете загрузить обновленную информацию, и 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 до завершения удаления. Однако вы можете закрыть уведомление и перейти на другую страницу без прерывания процесса удаления.
Ограничение товара
Если вы хотите предотвратить отправки в определенную страну (или страны), вы можете добавить ограничения при создании или обновлении товара.
Чтобы ограничить один товар в Catalog:
- Нажмите на вкладку Products.
- Выберите товар, к которому хотите добавить ограничение, что откроет страницу редактирования.
- Найдите раздел Restricted countries в нижней части страницы редактирования.
- Добавьте страны, к которым хотите ограничить ваш товар, выбрав или введя название(я) страны(стран).
- Нажмите save product.
Чтобы ограничить несколько товаров в Catalog:
- Нажмите на вкладку Import/export.
- Загрузите Catalog template CSV.
- Заполните шаблон данными о товарах, включив 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 и/или идентификатора товара.
If you're using 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 файл в папке входящих сообщений электронной почты.
Чтобы экспортировать все товары:
- Перейдите в Dashboard -> Products -> Catalog.
- Нажмите на раскрывающееся меню Manage Catalog рядом с Add product и нажмите Export all.
- Найдите файл каталога в загрузках.
Проблемы с загрузкой из электронной почты?
Если у вас возникли проблемы с загрузкой CSV из ссылки в электронном письме, это может быть из-за того, что ваш браузер блокирует загрузку. Если это так, выполните следующие действия:
- Щелкните правой кнопкой мыши на кнопку "Download" в электронном письме.
- Выберите "Copy link address" для копирования URL загрузки.
- Вставьте скопированный URL в браузер и нажмите Enter.
- Ваш каталог затем загрузится непосредственно из браузера.
Классификация товара
Вы можете классифицировать товар из вашего каталога с помощью API, используя catalogItemId в мутации ClassificationsCreateFromCatalog.
Обратите внимание, что name требуется для классификации товара из вашего каталога. Обратитесь к справочнику GraphQL API для получения полного списка полей каталога и классификации.
Чтобы создать и классифицировать товар каталога одновременно, добавьте мутацию ClassificationsCreateFromCatalog ниже в вашу мутацию CatalogItemsCreate mutation.
Классифицировать товар каталога на 8+ цифр (специфичный для страны)
Когда поле shipToCountries заполнено, классификация будет иметь 8+ цифр (специфичные для страны) HS кодов. Если shipToCountries не предоставлены, классификация по умолчанию будет 6-значным (универсальным) кодом HS. Узнайте больше о различиях между универсальными и страно-специфичными HS кодами.
В примере ниже поле shipToCountries предоставлено для создания страно-специфичного кода для Канады.
mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) { classificationsCalculateFromCatalog(input: $catalogItemToClassify) { id configuration { shipToCountries } hsCode { code } name }}Вот пример запроса. Хотя Zonos Classify создаст классификацию только с name, мы настоятельно рекомендуем добавить как можно больше деталей для лучших результатов классификации.
Ошибки API и их решения
| Ошибка↕ | Решение↕ |
|---|---|
| A SKU or product ID is required to create a product | An identifier (SKU/product ID) is required to create, edit, or delete a catalog item. To resolve this, add a SKU and/or product ID. |
| The product you are trying to edit does not exist* | You cannot edit a product that does not exist. To resolve this, create a new product with your desired SKU and/or product ID. |
| Customs description exceeds character limit of 30 characters. | By default, customs descriptions are limited to 30 characters, which aligns with the most common character limit for commercial invoices. |
| Product type invalid. Catalog supports the following product types: digital_good. For physical goods, leave it blank. | Catalog only supports the following product types: digital_good and physical_good. If your product is a physical good (most common), leave this field blank. |
| Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank. | Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, you can leave it blank as consolidated is the default. |
| Country must be specified when providing an HS code | If you provide a country-specific HS code when creating an item, a ship-to-country is required. To resolve this, add a ship-to country. |
| Price must be greater than 0 | Catalog does not support negative price values. To resolve this, add a price greater than zero. |
| Currency code must be provided when a price value is supplied | If you supply a price, a currency code is required. To resolve this, add a currency code. |
| Price must be provided when a currency code is supplied | If you supply a currency code, a price is required. To resolve this, add a price. |
| The accompanying dimensional field cannot be left blank | If one dimensional field is provided, the other two are required, e.g., If you supply a width of 8 inches, then the height and length would be required. |
| Measurement value must be greater than 0 | Catalog does not support negative or zero measurement values. To resolve this, add a value greater than zero. |
| When providing a dimensional value, dimensional units cannot be left empty | If you supply a dimensional value, a dimensional unit is required. To resolve this, add a dimensional unit. |
| When providing a weight value, the weight unit cannot be left empty | If you supply a weight value, a weight unit is required. To resolve this, add a weight unit. |
* API error only
Управление каталогом
Создавайте и изменяйте товары.Узнайте, как добавлять, изменять и удалять товары каталога Zonos в Dashboard или через API. Используйте Catalog в Dashboard, если вы не хотите писать код или делаете небольшие изменения. Если вы хотите прямую интеграцию с Catalog для производственной реализации, используйте API.