檢查項目的資訊是否詳細到足以進行分類,然後再請求 HS 代碼。
GraphQL
customsDescriptionValidate 變更可檢查項目的資訊是否充分以自信地指派 6 位 HS 代碼,在分類執行前。它會傳回準備就緒狀態供您應用自己的政策—繼續進行分類、警告、詢問購物者或商家提供更多詳細資訊,或拒絕項目。
customsDescriptionValidate
這是預先檢查,不是分類:customsDescriptionValidate 不會分類項目,也 不會 傳回 HS 代碼。使用它可提早攔截薄弱或不可用的描述,使您最終傳送到 Classify 的描述產生準確、不依賴假設的結果。
準備就緒檢查只是一種用途。由於相同的項目資料驅動 Zonos 的關稅描述和分類服務,此變更是更廣泛 關稅描述 工作流程的進入點—把守資料品質,然後從項目產生相容的關稅描述。請參閱下面的 不只是分類把守。
每個驗證都會傳回一個 status。狀態是諮詢性的—您的整合決定每個值的後果。
status
READY
INCOMPLETE
missingAttributes
UNRECOGNIZABLE
當狀態為 INCOMPLETE 時,missingAttributes 欄位會以簡短片語傳回遺漏的屬性(例如 "fiber content" 或 "material, construction"),適合撰寫使用者面向的訊息。對於任何其他狀態,它為 null。
"fiber content"
"material, construction"
null
直接提供項目欄位—至少需要一個描述性欄位。下面的範例驗證項目,其名稱和描述將其識別為 T 恤,但省略了分類所需的纖維含量,因此變更傳回 INCOMPLETE。
mutation CustomsDescriptionValidate(
$input: CustomsDescriptionValidationInput!
) {
customsDescriptionValidate(input: $input) {
id
content {
name
description
material
categories
existingItemId
}
createdAt
String
"55% cotton, 45% polyester"
[String!]
ID
Item
提供 existingItemId 或直接提供項目欄位—至少需要一個描述性欄位。
如果項目已存在於 Zonos 中,請傳遞其 ID 為 existingItemId,而不是重新傳送每個欄位。儲存的項目欄位用作驗證的基礎,您在相同輸入中也提供的任何欄位都會覆蓋儲存的值—適合測試編輯是否使薄弱項目準備好進行分類。
回應 content 會回顯已驗證的項目資料(已解析 existingItemId),因此每個儲存的 CustomsDescriptionValidation 都會自我描述。
content
CustomsDescriptionValidation
由於準備就緒狀態是諮詢性的,相同的檢查會推動多個工作流程—不只是決定是否分類。customsDescriptionValidate 評估與 Zonos 的分類和關稅描述服務相同的項目資料,這使其成為更廣泛 關稅描述 工作流程的自然第一步:
customsDescriptionsCreate
典型的端對端流程是:驗證準備就緒 → 收集任何 missingAttributes → 產生相容的關稅描述(和 HS 代碼) → 分類或申報。
CustomsDescriptionValidationInput
分類準備就緒
分類準備就緒
檢查項目的資訊是否詳細到足以進行分類,然後再請求 HS 代碼。
GraphQL
customsDescriptionValidate變更可檢查項目的資訊是否充分以自信地指派 6 位 HS 代碼,在分類執行前。它會傳回準備就緒狀態供您應用自己的政策—繼續進行分類、警告、詢問購物者或商家提供更多詳細資訊,或拒絕項目。這是預先檢查,不是分類:
customsDescriptionValidate不會分類項目,也 不會 傳回 HS 代碼。使用它可提早攔截薄弱或不可用的描述,使您最終傳送到 Classify 的描述產生準確、不依賴假設的結果。準備就緒檢查只是一種用途。由於相同的項目資料驅動 Zonos 的關稅描述和分類服務,此變更是更廣泛 關稅描述 工作流程的進入點—把守資料品質,然後從項目產生相容的關稅描述。請參閱下面的 不只是分類把守。
準備就緒狀態
每個驗證都會傳回一個
status。狀態是諮詢性的—您的整合決定每個值的後果。READYINCOMPLETEmissingAttributes中命名的屬性,然後重試。UNRECOGNIZABLE當狀態為
INCOMPLETE時,missingAttributes欄位會以簡短片語傳回遺漏的屬性(例如"fiber content"或"material, construction"),適合撰寫使用者面向的訊息。對於任何其他狀態,它為null。透過 API 驗證項目
直接提供項目欄位—至少需要一個描述性欄位。下面的範例驗證項目,其名稱和描述將其識別為 T 恤,但省略了分類所需的纖維含量,因此變更傳回
INCOMPLETE。mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) {customsDescriptionValidate(input: $input) {idstatusmissingAttributescontent {namedescriptionmaterialcategoriesexistingItemId}createdAt}}輸入欄位
nameStringdescriptionStringmaterialString"55% cotton, 45% polyester")。categories[String!]existingItemIdIDItem的 ID。提供時,會使用儲存的項目欄位,此處提供的任何欄位都會覆蓋儲存的值。提供
existingItemId或直接提供項目欄位—至少需要一個描述性欄位。驗證現有項目
如果項目已存在於 Zonos 中,請傳遞其 ID 為
existingItemId,而不是重新傳送每個欄位。儲存的項目欄位用作驗證的基礎,您在相同輸入中也提供的任何欄位都會覆蓋儲存的值—適合測試編輯是否使薄弱項目準備好進行分類。回應
content會回顯已驗證的項目資料(已解析existingItemId),因此每個儲存的CustomsDescriptionValidation都會自我描述。不只是分類把守
由於準備就緒狀態是諮詢性的,相同的檢查會推動多個工作流程—不只是決定是否分類。
customsDescriptionValidate評估與 Zonos 的分類和關稅描述服務相同的項目資料,這使其成為更廣泛 關稅描述 工作流程的自然第一步:missingAttributes提示確實遺漏的內容。READY後,將相同的資料交給customsDescriptionsCreate變更,讓 Zonos 從項目產生簡潔的、符合關稅的 ICS2 相容關稅描述—可選地在相同呼叫中請求 HS 代碼。提前驗證準備就緒表示產生的描述是由完整資訊建置,而不是假設。典型的端對端流程是:驗證準備就緒 → 收集任何
missingAttributes→ 產生相容的關稅描述(和 HS 代碼) → 分類或申報。CustomsDescriptionValidationInput
customsDescriptionValidate
這個頁面有幫助嗎?