就緒狀況
每個驗證都會傳回一個 status。此狀況為諮詢性——您的整合決定每個值的後果。
| 狀況↕ | 含義↕ | 建議動作↕ |
|---|---|---|
READY | 資訊足以可信地指派 6 位數 HS 代碼,不需要任何假設。 | 繼續分類。 |
INCOMPLETE | 項目可識別,但缺少決定性屬性,因此分類將依賴假設。 | 要求 missingAttributes 中命名的屬性,然後重試。 |
UNRECOGNIZABLE | 文字未確立項目的基本內容——空值、僅 SKU 或內部代碼,或亂碼。 | 要求使用者重新輸入項目。 |
當狀況為 INCOMPLETE 時,missingAttributes 欄位會以簡短短語(例如 "纖維含量" 或 "材料、結構")傳回缺少的屬性,適合組成使用者面向訊息。對於任何其他狀況,它為 null。
透過 API 驗證項目
直接提供項目欄位——至少需要一個描述性欄位。下方範例驗證項目,其名稱和描述將其識別為 T 恤,但省略了分類所需的纖維含量,因此變更查詢傳回 INCOMPLETE。
1
mutation CustomsDescriptionValidate(2
$input: CustomsDescriptionValidationInput!3
) {4
customsDescriptionValidate(input: $input) {5
id6
status7
missingAttributes8
content {9
name10
description11
material12
categories13
existingItemId14
}15
createdAt16
}17
}輸入欄位
| 欄位↕ | 類型↕ | 描述↕ |
|---|---|---|
name | String | 項目的名稱。 |
description | String | 項目的人性化描述。 |
material | String | 項目的材料或組成(如已知)(例如 "55% cotton, 45% polyester")。 |
categories | [String!] | 與項目相關聯並描述項目的類別。 |
existingItemId | ID | 現有 Item 的 ID 以驗證。提供時,使用儲存的項目欄位,此處提供的任何欄位都將覆蓋儲存的值。 |
提供 existingItemId 或直接提供項目欄位——至少需要一個描述性欄位。
驗證現有項目
如果項目已存在於 Zonos 中,請將其 ID 作為 existingItemId 傳遞,而不是重新發送每個欄位。儲存的項目欄位用作驗證的基礎,您在相同輸入中提供的任何欄位都將覆蓋儲存的值——對於測試編輯是否會使簡略項目分類就緒很有用。
回應 content 迴聲經過驗證的項目資料,並已解析 existingItemId,因此每個儲存的 CustomsDescriptionValidation 都是自我描述的。
不只是分類閘道
由於就緒狀況為諮詢性,相同的檢查為多個工作流程提供資訊——它不只是決定是否進行分類。customsDescriptionValidate 評估 Zonos 的分類和報關單據描述服務所消耗的相同項目資料,這使其成為更廣泛 報關單據描述 工作流程的自然第一步:
- 資料品質閘道 ——在進入點(在 PIM、目錄匯入或結帳中)表面簡略或不可用的項目資訊,並使用
missingAttributes提示正確缺少的內容,然後該資料流向下游。 - 產生報關單據描述 ——項目一旦
READY,就將相同的資料交給customsDescriptionsCreate變更查詢,讓 Zonos 從項目產生簡潔、符合海關規定和 ICS2 規定的報關單據描述——可選擇在相同呼叫中要求 HS 代碼。預先驗證就緒狀況意味著產生的描述是根據完整資訊而不是假設而建立的。 - 可信地分類 ——進行到 分類,了解描述足夠豐富,能指派準確的 6 位數 HS 代碼,無須猜測。
典型的端到端流程是:驗證就緒狀況 → 收集任何 missingAttributes → 產生符合規定的報關單據描述(和 HS 代碼)→ 分類或存檔。
GraphQL API ReferenceTypes, inputs, and operations used in this guide
MUTATIONS
分類就緒狀況
檢查項目的資訊是否詳細足以進行分類,然後再要求 HS 代碼。
GraphQL
customsDescriptionValidate變更查詢檢查項目的資訊是否充分,足以可信地指派 6 位數 HS 代碼,在分類執行之前。它傳回就緒狀況,您可以應用自己的政策——繼續分類、警告、向購物者或商人要求更多詳情,或拒絕項目。這是飛行前檢查,不是分類:
customsDescriptionValidate不會分類項目,也不會傳回 HS 代碼。使用它來預先捕捉簡略或不可用的描述,讓您最終發送到 分類 的描述能夠產生準確、無假設的結果。就緒檢查只是其中一種用途。由於相同的項目資料驅動 Zonos 的報關單據描述和分類服務,此變更查詢是更廣泛 報關單據描述 工作流程的進入點——把控資料品質,然後從項目產生符合規定的報關單據描述。請參閱下方的不只是分類閘道。