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ĩ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ộ không gắn chặt, 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 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) { id status missingAttributes content { name description material categories existingItemId } createdAt }}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ả.
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 phản hồi tiếng vang 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ữ là 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 — Bề mặt thông tin mặt hàng mỏng hoặc không sử dụng được tại điểm vào (trong PIM, nhập danh mục, hoặc thanh toán) và nhắc nhở những gì bị thiếu chính xác bằng cách sử dụng
missingAttributes, trước khi dữ liệu đó chảy xuống theo hướng. - Tạo mô tả tùy chỉnh — Khi một mặt hàng là
READY, tay cơ sở dữ liệu tương tự với mutationcustomsDescriptionsCreateđể Zonos tạo một mô tả tùy chỉnh ngắn gọn, tuân thủ tùy chỉnh và ICS2 từ mặt hàng—tùy chọn yêu cầu mã HS trong cùng một cuộc gọi. Xác thực sẵn sàng trước tiên có nghĩa là mô tả được tạo được xây dựng từ thông tin hoàn chỉnh thay vì giả định. - Phân loại với tự tin — Tiếp tục Phân loại biết rằng mô tả đủ phong phú để gán mã HS 6 chữ số chính xác mà không có phỏng đoán.
Luồng cuối cùng đầu cuối điển hình là: xác thực sẵn sàng → thu thập bất kỳ missingAttributes → tạo mô tả tùy chỉnh tuân thủ (và mã HS) → phân loại hoặc lưu trữ.
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à kiểm tra trước chuyến bay, không phải 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ó để bắt các mô tả mỏng hoặc không sử dụng được từ trướ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.Kiểm tra sẵn sàng chỉ là một cách sử dụng, mặc dù. 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—gating 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.