Поля ввода
Хотя для генерации классификации требуется только описание, чем больше деталей о продукте вы предоставите, тем точнее будет ваша классификация. Ниже представлено полное объяснение каждого поля ввода, принимаемого 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
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
{
"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 вернет один из следующих ответов:
- Когда
hsCode
возвращается с 6-8+ значным кодом HS, в зависимости от того, была ли указана страна назначения в запросе, ваш запрос на классификацию был успешным. - Когда
{"errors": [ { "message": "Нет адекватного ответа"}]}
возвращается, это означает, что Classify не смог найти классификацию из-за недостаточной информации в запросе.
Классификация товаров
Узнайте, как запросить классификацию в Dashboard и через API.
Ниже приведены примеры, иллюстрирующие, как запросить универсальные и страновые классификации через Dashboard или через API. Для тех, кто ищет более полные технические детали и обширную документацию, посетите наш Zonos GraphQL API reference developer site. Этот обширный ресурс предлагает подробные сведения о конечных точках API, мутациях GraphQL и обширной технической информации.