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: customsDescriptionValidatekhô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.
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ĩa↕
Hành động được đề xuất↕
READY
Thô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.
INCOMPLETE
Mặ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.
UNRECOGNIZABLE
Vă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.
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.
1mutationCustomsDescriptionValidate(
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
Field↕
Type↕
Description↕
name
String
Tên của mặt hàng.
description
String
Mô tả mặt hàng có thể đọc được bởi con người.
material
String
Vậ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.
existingItemId
ID
ID 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ả.
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ả.
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
Sẵn sàng để phân loại
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
customsDescriptionValidatekiể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:
customsDescriptionValidatekhô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ị.READYINCOMPLETEmissingAttributes, sau đó thử lại.UNRECOGNIZABLEKhi trạng thái là
INCOMPLETE, trườngmissingAttributestrả 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ànullcho 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.mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) {customsDescriptionValidate(input: $input) {idstatusmissingAttributescontent {namedescriptionmaterialcategoriesexistingItemId}createdAt}}Các trường đầu vào
nameStringdescriptionStringmaterialString"55% cotton, 45% polyester").categories[String!]existingItemIdIDItemhiệ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
existingItemIdhoặ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
existingItemIdthay 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.contenttrong phản hồi lặp lại dữ liệu mặt hàng đã được xác thực, vớiexistingItemIdđã được phân giải, do đó mỗiCustomsDescriptionValidationđượ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:missingAttributes, trước khi dữ liệu đó được chuyển tiếp xuống các bước sau.READY, chuyển cùng dữ liệu đó đến mutationcustomsDescriptionsCreateđể 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.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.CustomsDescriptionValidationInput
customsDescriptionValidate
Trang này có hữu ích không?