DOCS

Sẵn sàng để phân loại

Kiểm tra xem thông tin mặt hàng có đủ chi tiết để phân loại—trước khi yêu cầu mã HS.

GraphQL

Mutation customsDescriptionValidate kiểm tra xem thông tin mặt hàng có đủ để tự tin gán mã HS 6 chữ số, trước khi chạy phân loại. Nó trả về trạng thái sẵn sàng mà bạn áp dụng chính sách của riêng mình—tiếp tục phân loại, cảnh báo, yêu cầu người mua hoặc nhà bán lẻ cung cấp thêm chi tiết, hoặc từ chối mặt hàng.

Đây là một bước kiểm tra sơ bộ, không phải là bước phân loại: customsDescriptionValidate không phân loại mặt hàng và không trả về mã HS. Sử dụng nó để phát hiện sớm các mô tả mỏng hoặc không sử dụng được, để các mô tả bạn cuối cùng gửi đến Classify tạo ra kết quả chính xác, không dựa vào giả định.

Tuy nhiên, kiểm tra sẵn sàng chỉ là một trong nhiều cách sử dụng. Vì cùng một dữ liệu mặt hàng điều khiển các dịch vụ mô tả tùy chỉnh và phân loại của Zonos, mutation này là điểm vào cho quy trình Mô tả Tùy chỉnh rộng hơn—kiểm soát chất lượng dữ liệu, sau đó tạo mô tả tùy chỉnh tuân thủ từ mặt hàng. Xem Nhiều hơn chỉ một cổng phân loại bên dưới.

Trạng thái sẵn sàng 

Mỗi xác thực trả về một status. Trạng thái này có tính chất tham vấn—tích hợp của bạn quyết định hậu quả của mỗi giá trị.

StatusÝ nghĩaHành động được đề xuất
READYThông tin đủ để tự tin gán mã HS 6 chữ số mà không có giả định.Tiếp tục phân loại.
INCOMPLETEMặt hàng có thể nhận dạng được, nhưng một thuộc tính quyết định bị thiếu, do đó phân loại sẽ dựa vào giả định.Yêu cầu thuộc tính được đặt tên trong missingAttributes, sau đó thử lại.
UNRECOGNIZABLEVăn bản không xác định được mặt hàng về cơ bản là gì—giá trị trống, SKU hoặc mã nội bộ đơn thuần, hoặc vô nghĩa.Yêu cầu người dùng nhập lại mặt hàng.

Khi trạng thái là INCOMPLETE, trường missingAttributes trả về (các) thuộc tính bị thiếu dưới dạng một cụm từ ngắn (ví dụ: "thành phần sợi" hoặc "vật liệu, cấu tạo") phù hợp để soạn thảo một thông báo hướng tới người dùng. Nó là null cho bất kỳ trạng thái nào khác.

Xác thực mặt hàng qua API 

Cung cấp các trường mặt hàng trực tiếp—cần ít nhất một trường mô tả. Ví dụ bên dưới xác thực một mặt hàng có tên và mô tả xác định nó là một chiếc áo phông nhưng bỏ qua thành phần sợi cần thiết để phân loại nó, do đó mutation trả về 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}

Các trường đầu vào

FieldTypeDescription
nameStringTên của mặt hàng.
descriptionStringMô tả mặt hàng có thể đọc được bởi con người.
materialStringVật liệu hoặc thành phần của mặt hàng, nếu đã biết (ví dụ: "55% cotton, 45% polyester").
categories[String!]Các danh mục được liên kết với và mô tả mặt hàng.
existingItemIdIDID của một Item hiện có để xác thực. Khi được cung cấp, các trường của mặt hàng được lưu trữ được sử dụng và bất kỳ trường nào được cung cấp ở đây sẽ ghi đè các giá trị được lưu trữ.

Cung cấp existingItemId hoặc các trường mặt hàng trực tiếp—cần ít nhất một trường mô tả.

Xác thực một mặt hàng hiện có 

Nếu mặt hàng đã tồn tại trong Zonos, chuyển ID của nó dưới dạng existingItemId thay vì gửi lại mọi trường. Các trường mặt hàng được lưu trữ được sử dụng làm cơ sở cho xác thực, và bất kỳ trường nào bạn cũng cung cấp trong cùng một đầu vào sẽ ghi đè các giá trị được lưu trữ—hữu ích để kiểm tra xem một lần chỉnh sửa có làm cho một mặt hàng mỏng sẵn sàng phân loại hay không.

content trong phản hồi lặp lại dữ liệu mặt hàng đã được xác thực, với existingItemId đã được phân giải, do đó mỗi CustomsDescriptionValidation được lưu trữ đều tự mô tả.

Nhiều hơn chỉ một cổng phân loại 

Vì trạng thái sẵn sàng có tính chất tham vấn, cùng một kiểm tra cấp nhiều quy trình hơn—nó không chỉ về việc quyết định có phân loại hay không. customsDescriptionValidate đánh giá cùng một dữ liệu mặt hàng mà các dịch vụ phân loại và mô tả tùy chỉnh của Zonos tiêu thụ, điều này làm cho nó trở thành bước tự nhiên đầu tiên trong quy trình Mô tả Tùy chỉnh rộng hơn:

  • Cổng chất lượng dữ liệu — Phát hiện thông tin mặt hàng mỏng hoặc không sử dụng được ngay tại điểm nhập liệu (trong PIM, nhập danh mục, hoặc thanh toán) và yêu cầu chính xác những gì còn thiếu bằng cách sử dụng missingAttributes, trước khi dữ liệu đó được chuyển tiếp xuống các bước sau.
  • Tạo mô tả tùy chỉnh — Khi một mặt hàng ở trạng thái READY, chuyển cùng dữ liệu đó đến mutation customsDescriptionsCreate để Zonos tạo ra một mô tả tùy chỉnh ngắn gọn, tuân thủ hải quan và ICS2 từ mặt hàng đó—có thể yêu cầu mã HS ngay trong cùng một lệnh gọi. Xác thực sẵn sàng trước tiên có nghĩa là mô tả được tạo ra được xây dựng từ thông tin hoàn chỉnh thay vì giả định.
  • Phân loại một cách tự tin — Tiếp tục Phân loại khi biết rằng mô tả đủ phong phú để gán mã HS 6 chữ số chính xác mà không cần phỏng đoán.

Một luồng quy trình từ đầu đến cuối điển hình là: xác thực sẵn sàng → thu thập mọi missingAttributes → tạo mô tả tùy chỉnh tuân thủ (và mã HS) → phân loại hoặc khai báo.

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

Trang này có hữu ích không?