DOCS

Классификация товаров

Классификация товаров

Узнайте, как запросить классификацию в Dashboard и через API.

Ниже приведены примеры, иллюстрирующие, как запросить универсальные и страновые классификации через Dashboard или через API. Для тех, кто ищет более полные технические детали и обширную документацию, посетите наш Zonos GraphQL API reference developer site. Этот обширный ресурс предлагает подробные сведения о конечных точках API, мутациях GraphQL и обширной технической информации.

Поля ввода 

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

Описания полей ввода

ПолеОписание
Название (обязательно)Название продукта
Описание (необязательно)Подробное, длинное описание продукта
URL изображения (необязательно)Ссылка на изображение продукта. Примечание: Убедитесь, что вы используете ссылку на фактический URL изображения, а не на URL страницы продукта
Категории (необязательно)Общие подкатегории продуктов, например, Одежда и аксессуары, Товары для домашних животных, Офисные товары или Детская одежда, Кровати для домашних животных, Клеи и лента
Материал (необязательно)Из чего изготовлен продукт, например, пластик, дерево, сталь
Страна происхождения (необязательно)двухбуквенное сокращение (ISO код) для страны производства или изготовления продукта
Предоставленный HS код (необязательно)Включите существующий HS код в ваш запрос на классификацию, чтобы направить ваш запрос. В зависимости от ваших предпочтений и происхождения предоставленного HS кода, Classify может проверить HS код и проверить его согласованность с деталями описания товара. Узнайте больше.
Страна назначения (необязательно)Определяет, в какую страну будет классифицирован продукт. Страна назначения должна отображаться с двухбуквенным сокращением (ISO кодом) каждой страны (/docs/guides/country-guides/country-iso-codes#view-the-country-iso-codes-by-country) и не с фактическим названием страны, например, AU, а не Австралия. Включение этого поля позволит Classify вернуть страновой HS код из 8+ цифр вместо универсального 6-значного кода. Узнайте больше о различиях между универсальными и страновыми HS кодами.
ID продукта (необязательно)Ваш ID продукта или любое число, которое можно использовать для уникальной идентификации каждого продукта. Если ID продукта не предоставлен, Classify присвоит ID продукта, начиная с 1

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

Запрос на классификацию 

Чтобы запросить классификацию в Dashboard или через API, следуйте приведенным ниже шагам и мутации.

Пример ниже показывает универсальный (6-значный) запрос. Чтобы запросить классификации для конкретных стран, добавьте ISO коды стран в запрос Classify как показано в примере ниже. Чтобы запросить универсальный HS код, оставьте страну назначения null в запросе Classify.

Ввод принимает список, поэтому вы можете запросить множество или одну классификацию сразу.

МУТАЦИЯ

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
mutation {
  classificationsCalculate(
    input: [
      {
        categories: "women's clothing"
        imageUrl: "https://zonos.com/images/cozygloves.webp"
        name: "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
        configuration: { shipToCountries: KR }
      }
    ]
  ) {
    id
    name
    categories
    imageUrl
    hsCode {
      code
      description {
        full
      }
    }
  }
}

ОТВЕТ

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "data": {
    "classificationsCalculate": [
      {
        "id": "classification_313d8d9d-e330-4d79-9922-cb7a1ff317e2",
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
        "categories": ["women's clothing"],
        "imageUrl": null,
        "hsCode": {
          "code": "6116.99.0000",
          "description": {
            "full": "Articles of apparel and clothing accessories, knitted or crocheted: Gloves, mittens and mitts, knitted or crocheted: Other : Of other textile materials"
          }
        }
      }
    ]
  }
}

Возможные ответы API

Когда Classify получает запрос на классификацию, он пытается сопоставить данные о товаре, включенные в запрос, с данными в базе данных Classify's на основе наивысшего коэффициента уверенности. В зависимости от того, что найдено, Classify вернет один из следующих ответов:

  1. Когда hsCode возвращается с 6-8+ значным кодом HS, в зависимости от того, была ли указана страна назначения в запросе, ваш запрос на классификацию был успешным.
  2. Когда {"errors": [ { "message": "Нет адекватного ответа"}]} возвращается, это означает, что Classify не смог найти классификацию из-за недостаточной информации в запросе.

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


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