分類準備就緒

檢查項目的資訊是否詳細到足以進行分類,然後再請求 HS 代碼。

GraphQL

customsDescriptionValidate mutation 可檢查項目的資訊是否充分以自信地指派 6 位 HS 代碼 分類執行前。它會傳回準備就緒狀態供您應用自己的政策—繼續進行分類、警告、詢問購物者或商家提供更多詳細資訊,或拒絕項目。

這是預先檢查,不是分類:customsDescriptionValidate 不會分類項目,也 不會 傳回 HS 代碼。使用它可提早攔截薄弱或不可用的描述,使您最終傳送到 Classify 的描述產生準確、不依賴假設的結果。

準備就緒檢查只是一種用途。由於相同的項目資料驅動 Zonos 的關稅描述和分類服務,此 mutation 是更廣泛 關稅描述 工作流程的進入點—把守資料品質,然後從項目產生相容的關稅描述。請參閱 不只是分類把守 下面。

準備就緒狀態 

每個驗證都會傳回一個 status。狀態是諮詢性的—您的整合決定每個值的後果。

狀態意義建議的行動
READY資訊足以自信地指派 6 位 HS 代碼,沒有任何假設。繼續進行分類。
INCOMPLETE項目可辨識,但遺漏決定性屬性,所以分類將依賴假設。詢問 missingAttributes 中命名的屬性,然後重試。
UNRECOGNIZABLE文字未確定項目基本上是什麼—空值、裸 SKU 或內部代碼,或亂碼。要求使用者重新輸入項目。

當狀態為 INCOMPLETE 時,missingAttributes 欄位會以簡短片語傳回遺漏的屬性(例如 "fiber content""material, construction"),適合撰寫使用者面向的訊息。對於任何其他狀態,它為 null

透過 API 驗證項目 

直接提供項目欄位—至少需要一個描述性欄位。下面的範例驗證項目,其名稱和描述將其識別為 T 恤,但省略了分類所需的纖維含量,因此 mutation 傳回 INCOMPLETE

1mutation CustomsDescriptionValidate(
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}

輸入欄位

欄位類型描述
nameString項目的名稱。
descriptionString項目的人類可讀描述。
materialString項目的材料或成份(如果已知)(例如 "55% cotton, 45% polyester")。
categories[String!]與項目相關聯且用於描述項目的分類。
existingItemIdID要驗證的現有 Item 的 ID。提供時,會使用儲存的項目欄位,此處提供的任何欄位都會覆蓋儲存的值。

提供 existingItemId 或直接提供項目欄位—至少需要一個描述性欄位。

驗證現有項目 

如果項目已存在於 Zonos 中,請傳遞其 ID 為 existingItemId,而不是重新傳送每個欄位。儲存的項目欄位用作驗證的基礎,您在相同輸入中也提供的任何欄位都會覆蓋儲存的值—適合測試編輯是否使薄弱項目準備好進行分類。

回應 content 會回顯已驗證的項目資料(已解析 existingItemId),因此每個儲存的 CustomsDescriptionValidation 都會自我描述。

不只是分類把守 

由於準備就緒狀態是諮詢性的,相同的檢查會推動多個工作流程—不只是決定是否分類。customsDescriptionValidate 評估與 Zonos 的分類和關稅描述服務相同的項目資料,這使其成為更廣泛 關稅描述 工作流程的自然第一步:

  • 資料品質把守 — 在進入點(在 PIM、目錄匯入或結帳中)顯示薄弱或不可用的項目資訊,並在該資料流向下游之前使用 missingAttributes 提示確實遺漏的內容。
  • 產生關稅描述 — 項目為 READY 後,將相同的資料交給 customsDescriptionsCreate mutation,讓 Zonos 從項目產生簡潔的、符合關稅的 ICS2 相容關稅描述—可選地在相同呼叫中請求 HS 代碼。提前驗證準備就緒表示產生的描述是由完整資訊建置,而不是假設。
  • 自信地分類 — 繼續進行 Classify,知道描述足夠豐富以指派準確的 6 位 HS 代碼,無須猜測。

典型的端對端流程是:驗證準備就緒 → 收集任何 missingAttributes → 產生相容的關稅描述(和 HS 代碼) → 分類或申報。

GraphQL API ReferenceTypes, inputs, and operations used in this guide