HS code를 요청하기 전에 item 정보가 classification에 충분한지 확인합니다.
GraphQL
customsDescriptionValidate mutation은 classification이 실행되기 전에 item 정보가 6자리 HS code를 자신 있게 할당하기에 충분한지 확인합니다. readiness status를 반환하며, 이를 바탕으로 자체 정책을 적용합니다—classify를 진행하거나, 경고하거나, shopper 또는 merchant에게 추가 detail을 요청하거나, item을 거부할 수 있습니다.
이것은 pre-flight check이며 classification이 아닙니다: customsDescriptionValidate는 item을 classify하지 않으며 HS code를 반환하지 않습니다. 부족하거나 사용할 수 없는 description을 사전에 잡아, 결국 Classify로 보내는 description이 정확하고 가정 없는 결과를 내도록 하세요.
readiness checking은 한 가지 용도일 뿐입니다. 동일한 item data가 Zonos의 customs-description 및 classification service를 구동하기 때문에, 이 mutation은 더 넓은 Customs Description workflow의 진입점입니다—data quality를 gate한 뒤 item에서 compliant customs description을 생성합니다. 아래 More than a classification gate를 참조하세요.
item field를 직접 제공합니다—descriptive field가 최소 하나 필요합니다. 아래 예시는 name과 description이 t-shirt임을 식별하지만 classification에 필요한 fiber content가 빠져 있어 mutation이 INCOMPLETE를 반환하는 item을 validate합니다.
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}
Input fields
Field↕
Type↕
Description↕
name
String
item의 name입니다.
description
String
item의 human-readable description입니다.
material
String
알려진 경우 item의 material 또는 composition입니다(예: "55% cotton, 45% polyester").
categories
[String!]
item과 연관되고 item을 설명하는 category입니다.
existingItemId
ID
validate할 기존 Item의 ID입니다. 제공하면 저장된 item field가 사용되며, 여기서 함께 제공한 field는 저장된 값을 override합니다.
existingItemId 또는 item field를 직접 제공합니다—descriptive field가 최소 하나 필요합니다.
item이 이미 Zonos에 있으면 모든 field를 다시 보내는 대신 ID를 existingItemId로 전달합니다. 저장된 item field가 validation의 기준이 되며, 같은 input에서 함께 제공한 field는 저장된 값을 override합니다—thin item을 classification-ready로 만드는 edit을 테스트할 때 유용합니다.
readiness status가 advisory이므로, 동일한 check가 여러 workflow에 공급됩니다—classify 여부만 결정하는 것이 아닙니다. customsDescriptionValidate는 Zonos의 classification 및 customs-description service가 소비하는 동일한 item data를 평가하므로, 더 넓은 Customs Description workflow의 자연스러운 첫 단계입니다:
Data-quality gate — PIM, catalog import, checkout 등 진입 시점에서 thin하거나 사용할 수 없는 item 정보를 surface하고, downstream으로 흐르기 전에 missingAttributes로 정확히 무엇이 빠졌는지 prompt합니다.
Generate a customs description — item이 READY가 되면 동일한 data를 customsDescriptionsCreate mutation에 넘겨 Zonos가 item에서 concise하고 customs 및 ICS2-compliant customs description을 생성하도록 합니다—같은 call에서 HS code를 요청할 수도 있습니다. readiness를 먼저 validate하면 생성된 description이 가정이 아닌 complete information에서 만들어집니다.
Classify with confidence — description이 6자리 HS code를 guesswork 없이 정확히 할당하기에 충분히 풍부하다는 것을 알고 Classify로 진행합니다.
일반적인 end-to-end flow는 다음과 같습니다: readiness validate → missingAttributes 수집 → compliant customs description(및 HS code) 생성 → classify 또는 file.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Classification readiness
Classification readiness
HS code를 요청하기 전에 item 정보가 classification에 충분한지 확인합니다.
GraphQL
customsDescriptionValidatemutation은 classification이 실행되기 전에 item 정보가 6자리 HS code를 자신 있게 할당하기에 충분한지 확인합니다. readiness status를 반환하며, 이를 바탕으로 자체 정책을 적용합니다—classify를 진행하거나, 경고하거나, shopper 또는 merchant에게 추가 detail을 요청하거나, item을 거부할 수 있습니다.이것은 pre-flight check이며 classification이 아닙니다:
customsDescriptionValidate는 item을 classify하지 않으며 HS code를 반환하지 않습니다. 부족하거나 사용할 수 없는 description을 사전에 잡아, 결국 Classify로 보내는 description이 정확하고 가정 없는 결과를 내도록 하세요.readiness checking은 한 가지 용도일 뿐입니다. 동일한 item data가 Zonos의 customs-description 및 classification service를 구동하기 때문에, 이 mutation은 더 넓은 Customs Description workflow의 진입점입니다—data quality를 gate한 뒤 item에서 compliant customs description을 생성합니다. 아래 More than a classification gate를 참조하세요.
Readiness statuses
모든 validation은 하나의
status를 반환합니다. status는 advisory이며, integration이 각 값의 결과를 결정합니다.READYINCOMPLETEmissingAttributes에 명시된 attribute를 요청한 뒤 재시도합니다.UNRECOGNIZABLEstatus가
INCOMPLETE일 때missingAttributesfield는 누락된 attribute를 짧은 phrase(예:"fiber content"또는"material, construction")로 반환하며, user-facing message 작성에 적합합니다. 다른 status에서는null입니다.Validate an item via API
item field를 직접 제공합니다—descriptive field가 최소 하나 필요합니다. 아래 예시는 name과 description이 t-shirt임을 식별하지만 classification에 필요한 fiber content가 빠져 있어 mutation이
INCOMPLETE를 반환하는 item을 validate합니다.mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) {customsDescriptionValidate(input: $input) {idstatusmissingAttributescontent {namedescriptionmaterialcategoriesexistingItemId}createdAt}}Input fields
nameStringdescriptionStringmaterialString"55% cotton, 45% polyester").categories[String!]existingItemIdIDItem의 ID입니다. 제공하면 저장된 item field가 사용되며, 여기서 함께 제공한 field는 저장된 값을 override합니다.existingItemId또는 item field를 직접 제공합니다—descriptive field가 최소 하나 필요합니다.Validate an existing item
item이 이미 Zonos에 있으면 모든 field를 다시 보내는 대신 ID를
existingItemId로 전달합니다. 저장된 item field가 validation의 기준이 되며, 같은 input에서 함께 제공한 field는 저장된 값을 override합니다—thin item을 classification-ready로 만드는 edit을 테스트할 때 유용합니다.response
content는 validate된 item data를 echo하며existingItemId가 resolve되므로, 각 저장된CustomsDescriptionValidation은 self-describing입니다.More than a classification gate
readiness status가 advisory이므로, 동일한 check가 여러 workflow에 공급됩니다—classify 여부만 결정하는 것이 아닙니다.
customsDescriptionValidate는 Zonos의 classification 및 customs-description service가 소비하는 동일한 item data를 평가하므로, 더 넓은 Customs Description workflow의 자연스러운 첫 단계입니다:missingAttributes로 정확히 무엇이 빠졌는지 prompt합니다.READY가 되면 동일한 data를customsDescriptionsCreatemutation에 넘겨 Zonos가 item에서 concise하고 customs 및 ICS2-compliant customs description을 생성하도록 합니다—같은 call에서 HS code를 요청할 수도 있습니다. readiness를 먼저 validate하면 생성된 description이 가정이 아닌 complete information에서 만들어집니다.일반적인 end-to-end flow는 다음과 같습니다: readiness validate →
missingAttributes수집 → compliant customs description(및 HS code) 생성 → classify 또는 file.CustomsDescriptionValidationInput
customsDescriptionValidate
이 페이지가 도움이 되었나요?