DOCS

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

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

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

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

Поля ввода 

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

ПолеОписание
Name (требуется)Название товара
Product URL (опционально)Вставьте URL товара, и Classify автоматически загрузит страницу и извлечет соответствующие детали товара (название, категории и т.д.) для классификации. Доступно в Dashboard нажатием на значок + или добавлением непосредственно в основное текстовое поле. Для интеграции API свяжитесь с представителем Zonos. Хотя это идеально для демонстраций и тестирования, производственные реализации достигают оптимальной производительности и экономической эффективности, передавая данные товара непосредственно из бэк-энд систем.
Description (опционально)Подробное, длинное описание товара
Image URL (опционально)Ссылка на изображение товара. Примечание: убедитесь, что вы используете ссылку на фактический URL изображения, а не на URL страницы товара
Categories (опционально)Общие подкатегории товара, например Одежда и аксессуары, Товары для животных, Офисные товары или Детская одежда, Кровати для животных, Клеи и скотч
Material (опционально)Из чего сделан товар, например пластик, дерево, сталь
Country of Origin (опционально)Двухбуквенная аббревиатура (ISO код) страны производства товара
Provided HS Code (опционально)Включите существующий код HS в ваш запрос классификации, чтобы направить ваш запрос. В зависимости от вашего предпочтения и происхождения предоставленного кода HS, Classify может проверить код HS и проверить его согласованность с деталями описания товара. Узнайте больше.
Destination country (опционально)Определяет, в какую страну будет классифицирован товар. Страна назначения должна отображаться с двухбуквенной аббревиатурой (ISO код) каждой страны, а не названием страны, например AU, а не Australia. Включение этого поля позволит Classify возвращать 8+ значный страноспецифичный код HS вместо универсального 6-значного кода. Узнайте больше о различиях между универсальными и страноспецифичными кодами HS.
Product ID (опционально)ID вашего товара или любой номер, который может быть использован для уникальной идентификации каждого товара. Если ID товара не предоставлен, Classify назначит ID товара, начиная с 1

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

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

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

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

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

Примечание: Чтобы сгенерировать журналы аудита через API, включите поле auditTrail в ваш запрос. Свяжитесь с представителем Zonos для получения информации о доступе и реализации.

1mutation ClassifyItems($input: [ClassificationCalculateInput!]!) {
2 classificationsCalculate(input: $input) {
3 id
4 name
5 categories
6 imageUrl
7 hsCode {
8 code
9 description {
10 full
11 }
12 }
13 }
14}

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

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

  1. Когда hsCode возвращается с 6-8+ значным кодом HS в зависимости от того, была ли включена страна отправки в запрос, ваш запрос на классификацию был успешным.
  2. Когда возвращается {"errors": [ { "message": "No adequate response"}]}, это означает, что Classify не смог найти классификацию из-за недостаточной информации о входных данных.
GraphQL API ReferenceTypes, inputs, and operations used in this guide

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


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