Проверьте, достаточно ли информации о товаре для классификации — перед запросом кода HS.
GraphQL
Мутация customsDescriptionValidate проверяет, достаточно ли информации о товаре для уверенного присвоения 6-значного кода HS, перед запуском классификации. Она возвращает статус готовности, который вы применяете в соответствии с вашей политикой — перейти к классификации, предупредить, попросить у покупателя или продавца больше деталей, или отклонить товар.
Это предварительная проверка, а не классификация: customsDescriptionValidateне классифицирует товар и не возвращает код HS. Используйте её для выявления тонких или непригодных описаний в самом начале, чтобы описания, которые вы в итоге отправляете в Classify, дали точные результаты без предположений.
Проверка готовности — это только одно применение. Поскольку одни и те же данные товара используются сервисами классификации и таможенного описания Zonos, эта мутация является точкой входа в более широкий рабочий процесс Таможенного описания — управление качеством данных и последующее создание подробного таможенного описания из информации о товаре. См. раздел Больше, чем ворота классификации ниже.
Каждая валидация возвращает один status. Статус носит рекомендательный характер — ваша интеграция определяет следствия каждого значения.
Статус↕
Значение↕
Рекомендуемое действие↕
READY
Информация достаточна для уверенного присвоения 6-значного кода HS без предположений.
Перейти к классификации.
INCOMPLETE
Товар идентифицируем, но отсутствует решающий атрибут, поэтому классификация будет полагаться на предположения.
Попросите атрибут, указанный в missingAttributes, затем повторите.
UNRECOGNIZABLE
Текст не позволяет определить, что является основой товара — пустые значения, чистые SKU или внутренние коды, или тарабарщина.
Попросите пользователя повторно ввести товар.
Когда статус INCOMPLETE, поле missingAttributes возвращает отсутствующий атрибут(ы) в виде короткой фразы (например, "fiber content" или "material, construction"), подходящей для создания сообщения для пользователя. Для любого другого статуса это значение null.
Предоставьте поля товара напрямую — требуется хотя бы одно описательное поле. В примере ниже валидируется товар, имя и описание которого определяют его как футболку, но упускают содержание волокна, необходимое для классификации, поэтому мутация возвращает INCOMPLETE.
1mutationCustomsDescriptionValidate(
2$input: CustomsDescriptionValidationInput!
3){
4 customsDescriptionValidate(input:$input) {
5 id
6 status
7 missingAttributes
8 content {
9 name
10 description
11 material
12 categories
13 existingItemId
14}
15 createdAt
16}
17}
Входные поля
Поле↕
Тип↕
Описание↕
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) → классификация или подача.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Готовность к классификации
Готовность к классификации
Проверьте, достаточно ли информации о товаре для классификации — перед запросом кода HS.
GraphQL
Мутация
customsDescriptionValidateпроверяет, достаточно ли информации о товаре для уверенного присвоения 6-значного кода HS, перед запуском классификации. Она возвращает статус готовности, который вы применяете в соответствии с вашей политикой — перейти к классификации, предупредить, попросить у покупателя или продавца больше деталей, или отклонить товар.Это предварительная проверка, а не классификация:
customsDescriptionValidateне классифицирует товар и не возвращает код HS. Используйте её для выявления тонких или непригодных описаний в самом начале, чтобы описания, которые вы в итоге отправляете в Classify, дали точные результаты без предположений.Проверка готовности — это только одно применение. Поскольку одни и те же данные товара используются сервисами классификации и таможенного описания Zonos, эта мутация является точкой входа в более широкий рабочий процесс Таможенного описания — управление качеством данных и последующее создание подробного таможенного описания из информации о товаре. См. раздел Больше, чем ворота классификации ниже.
Статусы готовности
Каждая валидация возвращает один
status. Статус носит рекомендательный характер — ваша интеграция определяет следствия каждого значения.READYINCOMPLETEmissingAttributes, затем повторите.UNRECOGNIZABLEКогда статус
INCOMPLETE, полеmissingAttributesвозвращает отсутствующий атрибут(ы) в виде короткой фразы (например,"fiber content"или"material, construction"), подходящей для создания сообщения для пользователя. Для любого другого статуса это значениеnull.Валидация товара через API
Предоставьте поля товара напрямую — требуется хотя бы одно описательное поле. В примере ниже валидируется товар, имя и описание которого определяют его как футболку, но упускают содержание волокна, необходимое для классификации, поэтому мутация возвращает
INCOMPLETE.mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) {customsDescriptionValidate(input: $input) {idstatusmissingAttributescontent {namedescriptionmaterialcategoriesexistingItemId}createdAt}}Входные поля
nameStringdescriptionStringmaterialString"55% cotton, 45% polyester").categories[String!]existingItemIdIDItemдля валидации. Если указан, используются поля сохранённого товара, а все поля, указанные здесь, переопределяют сохранённые значения.Предоставьте либо
existingItemId, либо поля товара напрямую — требуется хотя бы одно описательное поле.Валидация существующего товара
Если товар уже существует в Zonos, передайте его ID как
existingItemIdвместо повторной отправки всех полей. Поля сохранённого товара используются как основа для валидации, и все поля, которые вы также указываете в том же вводе, переопределяют сохранённые значения — полезно для проверки, не сделает ли редактирование тонкий товар готовым к классификации.Ответный
contentповторяет данные товара, которые были валидированы, с разрешённымexistingItemId, поэтому каждая сохранённаяCustomsDescriptionValidationсамодостаточна.Больше, чем ворота классификации
Поскольку статус готовности носит рекомендательный характер, та же проверка служит более чем одному рабочему процессу — это не только о решении, классифицировать ли товар.
customsDescriptionValidateоценивает одни и те же данные товара, которые потребляют сервисы классификации и таможенного описания Zonos, что делает её естественной первой ступенью в более широком рабочем процессе Таможенного описания:missingAttributes, прежде чем эти данные будут переданы далее.READY), передайте те же данные мутацииcustomsDescriptionsCreate, чтобы Zonos создала краткое, соответствующее таможне и ICS2 таможенное описание из информации о товаре — опционально запрашивая код HS в том же вызове. Предварительная валидация готовности означает, что созданное описание построено из полной информации, а не предположений.Типичный сквозной процесс: валидация готовности → сбор любых
missingAttributes→ создание соответствующего таможенного описания (и кода HS) → классификация или подача.CustomsDescriptionValidationInput
customsDescriptionValidate
Была ли эта страница полезной?