Статусы готовности
Каждая валидация возвращает один status. Статус носит рекомендательный характер — ваша интеграция определяет следствия каждого значения.
| Статус↕ | Значение↕ | Рекомендуемое действие↕ |
|---|---|---|
READY | Информация достаточна для уверенного присвоения 6-значного кода HS без предположений. | Перейти к классификации. |
INCOMPLETE | Товар идентифицируем, но отсутствует решающий атрибут, поэтому классификация будет полагаться на предположения. | Попросите атрибут, указанный в missingAttributes, затем повторите. |
UNRECOGNIZABLE | Текст не позволяет определить, что является основой товара — пустые значения, чистые SKU или внутренние коды, или тарабарщина. | Попросите пользователя повторно ввести товар. |
Когда статус INCOMPLETE, поле missingAttributes возвращает отсутствующий атрибут(ы) в виде короткой фразы (например, "fiber content" или "material, construction"), подходящей для создания сообщения для пользователя. Для любого другого статуса это значение null.
Валидация товара через API
Предоставьте поля товара напрямую — требуется хотя бы одно описательное поле. В примере ниже валидируется товар, имя и описание которого определяют его как футболку, но упускают содержание волокна, необходимое для классификации, поэтому мутация возвращает INCOMPLETE.
mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) { customsDescriptionValidate(input: $input) { id status missingAttributes content { name description material categories existingItemId } createdAt }}Входные поля
| Поле↕ | Тип↕ | Описание↕ |
|---|---|---|
name | String | Имя товара. |
description | String | Понятное описание товара. |
material | String | Материал или состав товара, если известен (например, "55% cotton, 45% polyester"). |
categories | [String!] | Категории, связанные с товаром и описывающие его. |
existingItemId | ID | ID существующего Item для валидации. Если указан, используются поля сохранённого товара, а все поля, указанные здесь, переопределяют сохранённые значения. |
Предоставьте либо existingItemId, либо поля товара напрямую — требуется хотя бы одно описательное поле.
Валидация существующего товара
Если товар уже существует в Zonos, передайте его ID как existingItemId вместо повторной отправки всех полей. Поля сохранённого товара используются как основа для валидации, и все поля, которые вы также указываете в том же вводе, переопределяют сохранённые значения — полезно для проверки, будет ли редактирование тонкого товара готово к классификации.
Ответный content повторяет данные товара, которые были валидированы, с разрешённым existingItemId, поэтому каждая сохранённая CustomsDescriptionValidation саморазъясняющаяся.
Больше, чем ворота классификации
Поскольку статус готовности носит рекомендательный характер, та же проверка служит более чем одному рабочему процессу — это не только о решении, классифицировать ли товар. customsDescriptionValidate оценивает одни и те же данные товара, которые потребляют сервисы классификации и таможенного описания Zonos, что делает её естественной первой ступенью в более широком рабочем процессе Таможенного описания:
- Ворота качества данных — выявите тонкую или непригодную информацию о товаре в точке входа (в PIM, импорте каталога или оформлении покупки) и запросите точно то, что отсутствует, используя
missingAttributes, прежде чем эти данные будут переданы далее. - Создание таможенного описания — когда товар готов (
READY), передайте те же данные мутацииcustomsDescriptionsCreate, чтобы Zonos создала краткое, соответствующее таможне и ICS2 таможенное описание из информации товара — опционально запрашивая код HS в том же вызове. Предварительная валидация готовности означает, что созданное описание построено из полной информации, а не предположений. - Классифицировать с уверенностью — перейдите к Classify, зная, что описание достаточно подробно для присвоения точного 6-значного кода HS без догадок.
Типичный сквозной процесс: валидация готовности → сбор любых missingAttributes → создание соответствующего таможенного описания (и кода HS) → классификация или подача.
Готовность к классификации
Проверьте, достаточно ли информации об товаре для классификации — перед запросом кода HS.
GraphQL
Мутация
customsDescriptionValidateпроверяет, достаточно ли информации об товаре для уверенного присвоения 6-значного кода HS, перед запуском классификации. Она возвращает статус готовности, который вы применяете в соответствии с вашей политикой — перейти к классификации, предупредить, попросить у покупателя или продавца больше деталей, или отклонить товар.Это предварительная проверка, а не классификация:
customsDescriptionValidateне классифицирует товар и не возвращает код HS. Используйте её для выявления тонких или непригодных описаний в самом начале, чтобы описания, которые вы в итоге отправляете в Classify, дали точные результаты без предположений.Проверка готовности — это только одно применение. Поскольку одни и те же данные товара используются сервисами классификации и таможенного описания Zonos, эта мутация является точкой входа в более широкий рабочий процесс Таможенного описания — управление качеством данных и последующее создание подробного таможенного описания из информации товара. См. раздел Больше, чем ворота классификации ниже.