分類就緒狀況

customsDescriptionValidate mutation 檢查項目的資訊是否充分，足以可信地指派 6 位數 HS 代碼，在分類執行之前。它傳回就緒狀況，您可以應用自己的政策——繼續分類、警告、向購物者或商人要求更多詳情，或拒絕項目。

這是飛行前檢查，不是分類：customsDescriptionValidate 不會分類項目，也不會傳回 HS 代碼。使用它來預先捕捉簡略或不可用的描述，讓您最終發送到 分類 的描述能夠產生準確、無假設的結果。

就緒檢查只是其中一種用途。由於相同的項目資料驅動 Zonos 的報關單據描述和分類服務，此 mutation 是更廣泛 報關單據描述 工作流程的進入點——把控資料品質，然後從項目產生符合規定的報關單據描述。請參閱下方的不只是分類閘道。

就緒狀況 

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

當狀況為 INCOMPLETE 時，missingAttributes 欄位會以簡短短語（例如 "fiber content" 或 "material, construction"）傳回缺少的屬性，適合組成使用者面向訊息。對於任何其他狀況，它為 null。

透過 API 驗證項目 

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

輸入欄位

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

驗證現有項目 

如果項目已存在於 Zonos 中，請將其 ID 作為 existingItemId 傳遞，而不是重新發送每個欄位。儲存的項目欄位用作驗證的基礎，您在相同輸入中提供的任何欄位都將覆蓋儲存的值——對於測試編輯是否會使簡略項目分類就緒很有用。

回應的 content 會傳回經過驗證的項目資料，並已解析 existingItemId，因此每個儲存的 CustomsDescriptionValidation 都是自我描述的。

不只是分類閘道 

由於就緒狀況為諮詢性，相同的檢查為多個工作流程提供資訊——它不只是決定是否進行分類。customsDescriptionValidate 評估 Zonos 的分類和報關單據描述服務所消耗的相同項目資料，這使其成為更廣泛 報關單據描述 工作流程的自然第一步：

• 資料品質閘道 ——在進入點（PIM、目錄匯入或結帳）及早發現簡略或不可用的項目資訊，並在資料流向下游之前使用 missingAttributes 準確提示缺少的內容。
• 產生報關單據描述 ——項目一旦 READY，就將相同的資料交給 customsDescriptionsCreate mutation，讓 Zonos 從項目產生簡潔、符合海關規定和 ICS2 規定的報關單據描述——可選擇在相同呼叫中要求 HS 代碼。預先驗證就緒狀況意味著產生的描述是根據完整資訊而不是假設而建立的。
• 可信地分類 ——進行到 分類，了解描述足夠豐富，能指派準確的 6 位數 HS 代碼，無須猜測。

典型的端到端流程是：驗證就緒狀況 → 收集任何 missingAttributes → 產生符合規定的報關單據描述（和 HS 代碼）→ 分類或存檔。