準備就緒狀態
每個驗證都會傳回一個 status。狀態是諮詢性的—您的整合決定每個值的後果。
| 狀態↕ | 意義↕ | 建議的行動↕ |
|---|---|---|
READY | 資訊足以自信地指派 6 位 HS 代碼,沒有任何假設。 | 繼續進行分類。 |
INCOMPLETE | 項目可辨識,但遺漏決定性屬性,所以分類將依賴假設。 | 詢問 missingAttributes 中命名的屬性,然後重試。 |
UNRECOGNIZABLE | 文字未確定項目基本上是什麼—空值、裸 SKU 或內部代碼,或亂碼。 | 要求使用者重新輸入項目。 |
當狀態為 INCOMPLETE 時,missingAttributes 欄位會以簡短片語傳回遺漏的屬性(例如 "fiber content" 或 "material, construction"),適合撰寫使用者面向的訊息。對於任何其他狀態,它為 null。
透過 API 驗證項目
直接提供項目欄位—至少需要一個描述性欄位。下面的範例驗證項目,其名稱和描述將其識別為 T 恤,但省略了分類所需的纖維含量,因此 mutation 傳回 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後,將相同的資料交給customsDescriptionsCreatemutation,讓 Zonos 從項目產生簡潔的、符合關稅的 ICS2 相容關稅描述—可選地在相同呼叫中請求 HS 代碼。提前驗證準備就緒表示產生的描述是由完整資訊建置,而不是假設。 - 自信地分類 — 繼續進行 Classify,知道描述足夠豐富以指派準確的 6 位 HS 代碼,無須猜測。
典型的端對端流程是:驗證準備就緒 → 收集任何 missingAttributes → 產生相容的關稅描述(和 HS 代碼) → 分類或申報。
GraphQL API ReferenceTypes, inputs, and operations used in this guide
MUTATIONS
分類準備就緒
檢查項目的資訊是否詳細到足以進行分類,然後再請求 HS 代碼。
GraphQL
customsDescriptionValidatemutation 可檢查項目的資訊是否充分以自信地指派 6 位 HS 代碼,在 分類執行前。它會傳回準備就緒狀態供您應用自己的政策—繼續進行分類、警告、詢問購物者或商家提供更多詳細資訊,或拒絕項目。這是預先檢查,不是分類:
customsDescriptionValidate不會分類項目,也 不會 傳回 HS 代碼。使用它可提早攔截薄弱或不可用的描述,使您最終傳送到 Classify 的描述產生準確、不依賴假設的結果。準備就緒檢查只是一種用途。由於相同的項目資料驅動 Zonos 的關稅描述和分類服務,此 mutation 是更廣泛 關稅描述 工作流程的進入點—把守資料品質,然後從項目產生相容的關稅描述。請參閱 不只是分類把守 下面。