Các trường đầu vào
Mặc dù chỉ cần mô tả để tạo phân loại, nhưng bạn cung cấp càng nhiều chi tiết sản phẩm thì phân loại của bạn sẽ càng chính xác. Ngoài ra, bạn có thể chỉ cần cung cấp URL sản phẩm và Classify sẽ tự động trích xuất tất cả các chi tiết hạng mục có liên quan cho bạn. Dưới đây là giải thích toàn diện về từng trường đầu vào được Classify chấp nhận. Bằng cách hiểu những trường đầu vào này, bạn có thể tối đa hóa việc sử dụng chúng và tạo ra các phân loại rất chính xác.
Mô tả các trường đầu vào
| Trường↕ | Mô tả↕ |
|---|---|
| Tên (bắt buộc) | Tên của sản phẩm |
| URL sản phẩm (tùy chọn) | Dán URL sản phẩm và Classify sẽ tự động tìm nạp trang và trích xuất các chi tiết hạng mục có liên quan (tên, mô tả, danh mục, v.v.) để phân loại. Có sẵn trong Dashboard bằng cách nhấp vào biểu tượng + hoặc thêm trực tiếp vào trường văn bản chính. Đối với các tích hợp API, vui lòng liên hệ với đại diện Zonos của bạn. Mặc dù lý tưởng cho các bản demo và thử nghiệm, nhưng các triển khai sản xuất đạt hiệu suất tối ưu và hiệu quả chi phí bằng cách chuyển trực tiếp dữ liệu hạng mục từ các hệ thống phụ trợ. |
| Mô tả (tùy chọn) | Một mô tả sâu rộng, dài của sản phẩm |
| URL hình ảnh (tùy chọn) | Liên kết đến hình ảnh của sản phẩm. Lưu ý: Hãy đảm bảo bạn sử dụng liên kết đến URL hình ảnh thực tế và không phải URL trang sản phẩm |
| Danh mục (tùy chọn) | Các danh mục sản phẩm con chung, ví dụ: Quần áo & Phụ kiện, Chăm sóc thú cưng, Sản phẩm văn phòng hoặc Quần áo trẻ em, Giường cho thú cưng, Chất dính & Băng |
| Vật liệu (tùy chọn) | Sản phẩm được làm từ những gì, ví dụ: nhựa, gỗ, thép |
| Nước sản xuất (tùy chọn) | Viết tắt hai chữ cái (mã ISO) cho quốc gia sản xuất hoặc sản xuất sản phẩm |
| Mã HS được cung cấp (tùy chọn) | Bao gồm mã HS hiện có trong yêu cầu phân loại của bạn để hướng dẫn yêu cầu của bạn. Tùy thuộc vào sở thích của bạn và nguồn gốc của mã HS được cung cấp, Classify có thể xác thực mã HS và kiểm tra tính kết hợp của nó so với chi tiết mô tả hạng mục. Tìm hiểu thêm. |
| Quốc gia đích (tùy chọn) | Xác định quốc gia nào sản phẩm sẽ được phân loại. Quốc gia đích phải được hiển thị với viết tắt hai chữ cái (mã ISO) của mỗi quốc gia và không phải tên quốc gia thực tế, ví dụ: AU, không phải Australia. Bao gồm trường này sẽ cho phép Classify trả lại mã HS 8+ chữ số dành riêng cho quốc gia thay vì mã 6 chữ số phổ quát. Tìm hiểu thêm về sự khác biệt giữa mã HS 6 chữ số phổ quát và 8+ chữ số dành riêng cho quốc gia. |
| ID sản phẩm (tùy chọn) | ID sản phẩm của bạn hoặc bất kỳ số nào có thể được sử dụng để xác định duy nhất từng sản phẩm. Nếu không cung cấp ID sản phẩm, Classify sẽ gán ID sản phẩm bắt đầu từ 1 |
Lưu ý: Nếu bạn đang tải lên yêu cầu hàng loạt CSV của mình trong Dashboard, quốc gia đích sẽ không là một phần của mẫu; thay vào đó, bạn sẽ chọn quốc gia đích của mình sau khi tải lên yêu cầu hàng loạt CSV của bạn.
Yêu cầu phân loại
Để yêu cầu phân loại trong Dashboard hoặc qua API, hãy làm theo các bước và đột biến dưới đây.
Ví dụ dưới đây cho thấy một yêu cầu phổ quát (6 chữ số). Để yêu cầu phân loại cho các quốc gia cụ thể, hãy thêm mã ISO của các quốc gia vào yêu cầu Classify như được thấy trong ví dụ dưới đây. Để yêu cầu mã HS phổ quát, hãy để quốc gia gửi hàng null trong yêu cầu Classify.
Đầu vào có một danh sách để bạn có thể yêu cầu nhiều hoặc một phân loại cùng một lúc.
Lưu ý: Để tạo dấu vết kiểm toán qua API, hãy bao gồm trường
auditTrailtrong truy vấn của bạn. Liên hệ với đại diện Zonos của bạn để có quyền truy cập và chi tiết triển khai.
mutation ClassifyItems($input: [ClassificationCalculateInput!]!) { classificationsCalculate(input: $input) { id name categories imageUrl hsCode { code description { full } } }}Phản hồi API có thể
Khi Classify nhận được yêu cầu phân loại, nó sẽ cố gắng khớp dữ liệu hạng mục đầu vào có trong yêu cầu với một trận đấu trong cơ sở dữ liệu của Classify dựa trên điểm tin cậy cao nhất. Dựa trên những gì được tìm thấy, Classify sẽ trả về một trong các phản hồi sau:
- Khi
hsCodeđược trả về với mã HS 6 đến 8+ chữ số, tùy thuộc vào liệu có đưa quốc gia gửi hàng vào yêu cầu hay không, yêu cầu phân loại của bạn đã thành công. - Khi
{"errors": [ { "message": "No adequate response"}]}được trả về, điều đó có nghĩa là Classify không thể tìm thấy phân loại do thông tin đầu vào không đủ.
Phân loại hạng mục
Tìm hiểu cách yêu cầu phân loại trong Dashboard và qua API.
Dưới đây, bạn sẽ tìm thấy các ví dụ minh họa cách yêu cầu phân loại phổ quát và dành riêng cho quốc gia thông qua Dashboard hoặc qua API. Đối với những người tìm kiếm chi tiết kỹ thuật toàn diện và tài liệu mở rộng, hãy truy cập trang tham khảo API GraphQL Zonos. Tài nguyên toàn diện này cung cấp thông tin chi tiết về các điểm cuối API, đột biến GraphQL và thông tin kỹ thuật mở rộng.