Tạo sản phẩm
Tạo sản phẩm trong Catalog:
- Chuyển đến Catalog và nhấp vào Thêm sản phẩm ở góc trên cùng bên phải.
- Thêm chi tiết sản phẩm của bạn. Trường bắt buộc duy nhất để tạo sản phẩm là trường SKU và/hoặc ID sản phẩm. Những trường này sẽ được sử dụng để tham chiếu các sản phẩm catalog của bạn. Tìm hiểu thêm về các định danh của Catalog.
- Tùy chọn—Thêm mã HS của bạn.
- Tùy chọn—Thêm thông tin vận chuyển của bạn (trọng lượng, kích thước, đơn vị đo lường, v.v.).
- Tùy chọn—Thêm các quốc gia bị hạn chế.
- Nhấp vào Lưu sản phẩm.
Tạo nhiều sản phẩm trong Catalog:
Tải lên nhiều sản phẩm hoặc toàn bộ catalog sản phẩm của bạn cùng một lúc.
Quan trọng: Nếu bạn cố gắng tạo sản phẩm đã tồn tại, Catalog sẽ nhận dạng sản phẩm dựa trên SKU và/hoặc ID sản phẩm và ghi đè chi tiết sản phẩm gốc bằng chi tiết mới.
Gắn thẻ sản phẩm là hàng nguy hiểm (DHL)
Đối với các lô hàng DHL, bạn có thể gắn thẻ sản phẩm là hàng nguy hiểm để dịch vụ giá trị gia tăng DHL chính xác được áp dụng tự động mỗi khi bạn tạo nhãn cho sản phẩm đó. Điều này bao gồm các lớp "rủi ro thấp" hoặc miễn trừ hàng được quy định—những mục được quy định về kỹ thuật nhưng vận chuyển theo một quy định đặc biệt hoặc miễn trừ số lượng.
Thẻ hàng nguy hiểm được lưu trữ như một thuộc tính mục catalog: một cặp key/value trên sản phẩm. Các thuộc tính được đặt thông qua API (catalogItemsCreate hoặc catalogItemsUpdate)—không có trường Dashboard hoặc cột CSV cho chúng.
Để gắn thẻ sản phẩm, hãy thêm thuộc tính có khóa DANGEROUS_GOODS và giá trị là một trong các danh mục được hỗ trợ dưới đây.
mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) { catalogItemsCreate( input: [{ sku: $sku, name: $name, attributes: $attributes }] ) { id name sku attributes { key valueCác giá trị hàng nguy hiểm được hỗ trợ
| Giá trị↕ | Danh mục↕ |
|---|---|
NOT_RESTRICTED_A70 | Không hạn chế, Quy định đặc biệt A70—các bài viết bị áp lực, chẳng hạn như các cây cầu chống sốc và bộ giảm xốc (UN3164). |
NOT_RESTRICTED_A67 | Không hạn chế, Quy định đặc biệt A67—động cơ hoặc máy móc chạy bằng chất lỏng dễ cháy (UN3528). |
NOT_RESTRICTED_A02 | Không hạn chế, Quy định đặc biệt A02—miễn trừ theo quy định tải nhỏ vận chuyển đường ADR. |
LIMITED_QUANTITY | Số lượng giới hạn (ADR)—hàng nguy hiểm được đóng gói thành những lượng nhỏ trong các giới hạn quy định. |
EXCEPTED_QUANTITY | Số lượng miễn trừ (IATA)—những lượng rất nhỏ được miễn trừ từ hầu hết các quy tắc hàng nguy hiểm vận chuyển hàng không. |
CONSUMER_COMMODITY | ID hàng hóa tiêu dùng 8000—những sản phẩm hàng ngày sẵn sàng bán lẻ với nội dung nguy hiểm nhỏ, chẳng hạn như xịt và nước hoa. |
MAGNETIZED_MATERIAL | Vật liệu từ hóa (UN2807)—các mục có từ trường đủ mạnh để ảnh hưởng đến các dụng cụ máy bay. |
BIOLOGICAL_SUBSTANCE | Chất sinh học (UN3373)—Các chất sinh học Danh mục B, chẳng hạn như các mẫu chẩn đoán hoặc lâm sàng. |
Chỉnh sửa sản phẩm
Chỉnh sửa sản phẩm cho phép bạn cập nhật các sản phẩm hiện có của mình bằng thông tin bổ sung hoặc cập nhật một cách hiệu quả. Thay vì phải xóa và tải lên lại sản phẩm, bạn có thể tải lên thông tin cập nhật và Catalog sẽ khớp nó với sản phẩm hiện có bằng cách sử dụng SKU hoặc ID sản phẩm của bạn, tùy thuộc vào sở thích khóa mục của bạn. Bằng cách này, bạn có thể giữ catalog của mình cập nhật với nỗ lực tối thiểu, cho dù bạn sử dụng Dashboard hay API để tạo sản phẩm mới hoặc chỉnh sửa sản phẩm hiện có.
Nếu bạn tạo/chỉnh sửa sản phẩm catalog đã tồn tại trong Catalog, hãy mong đợi những điều sau:
Catalog sẽ ghi đè các trường trống trên các mục hiện có.
- Ví dụ: nếu một sản phẩm hiện có, SKU 321, không có giá trị cho trọng lượng, và cùng sản phẩm đó, SKU 321, có trọng lượng 1,3 lbs trong lần tải lên mới, thì trọng lượng 1,3 lbs sẽ ghi đè trường trước đó trống.
Catalog sẽ ghi đè các trường hiện có bằng giá trị trường mới.
- Ví dụ: nếu một sản phẩm hiện có, SKU 123, có giá 18,99 USD và cùng sản phẩm đó, SKU 123, có giá cập nhật 22,99 USD, thì giá mới 22,99 USD sẽ ghi đè giá trước đó.
Catalog sẽ không ghi đè các giá trị hiện có bằng các trường trống.
- Ví dụ: nếu một sản phẩm hiện có, SKU 456, có mã HS là 6109.10, nhưng mã HS của sản phẩm cập nhật, SKU 456, là trống, thì mã HS hiện có vẫn còn.
Để chỉnh sửa sản phẩm:
- Nhấp vào tab Sản phẩm.
- Chọn sản phẩm bạn muốn chỉnh sửa.
- Thực hiện các thay đổi của bạn.
- Nhấp vào Lưu sản phẩm.
Để chỉnh sửa nhiều hoặc tất cả sản phẩm cùng một lúc, chỉ cần tải lên tệp CSV cập nhật vào Catalog, bao gồm SKU hoặc ID sản phẩm của bạn. Điều này sẽ kích hoạt cập nhật tự động cho các mục hiện có của bạn.
Xóa sản phẩm
Để xóa sản phẩm:
- Nhấp vào tab Sản phẩm trong Dashboard.
- Chọn sản phẩm mà bạn muốn xóa. Sau khi chọn sản phẩm của bạn, nút xóa sẽ xuất hiện.
- Nhấp vào Xóa rồi Xóa tất cả để xác nhận xóa của bạn.
Để xóa tất cả sản phẩm:
- Chọn tab Sản phẩm trong Dashboard.
- Nhấp vào Quản lý Catalog ở góc trên cùng bên phải rồi nhấp vào Xóa tất cả.
- Nhấp vào Xóa tất cả một lần nữa để xác nhận xóa của bạn.
Lưu ý rằng nếu bạn đang xóa một số lượng lớn mục (hơn 20.000 sản phẩm hoặc tương tự), một thông báo sẽ xuất hiện cho biết rằng việc xóa của bạn đang tiến hành. Trong thời gian này, bạn sẽ không thể tương tác với Catalog cho đến khi việc xóa hoàn tất. Tuy nhiên, bạn có thể loại bỏ thông báo và điều hướng đi mà không gián đoạn quá trình xóa.
Hạn chế sản phẩm
Nếu bạn muốn ngăn chặn các lô hàng đến một quốc gia (hoặc nhiều quốc gia) nhất định, bạn có thể thêm hạn chế khi tạo hoặc cập nhật sản phẩm.
Để hạn chế một sản phẩm duy nhất trong Catalog:
- Nhấp vào tab Sản phẩm.
- Chọn sản phẩm mà bạn muốn thêm hạn chế, sẽ mở trang chỉnh sửa.
- Tìm phần Các quốc gia bị hạn chế ở cuối trang chỉnh sửa.
- Thêm các quốc gia mà bạn muốn hạn chế sản phẩm của mình bằng cách chọn hoặc nhập tên quốc gia.
- Nhấp vào Lưu sản phẩm.
Để hạn chế nhiều sản phẩm trong Catalog:
- Nhấp vào tab Nhập/xuất.
- Tải xuống Mẫu Catalog CSV.
- Điền vào mẫu với chi tiết sản phẩm của bạn, bao gồm SKU/ID Sản phẩm và các quốc gia bị hạn chế. Nhập mã ISO 2 chữ cái được phân tách bằng thanh dọc, ví dụ:
AU|KR|MY|SG. Để hạn chế tất cả các quốc gia, chỉ cần nhậpALLlàm giá trị. Nếu bạn muốn hạn chế tất cả các quốc gia ngoại trừ một hoặc một vài quốc gia, hãy nhậpALL-theo sau là các quốc gia bạn muốn bỏ hạn chế, được phân tách bằng thanh dọc, ví dụ:ALL-CA|FR|US. Tìm hiểu thêm về định dạng CSV. Nếu bạn muốn xóa tất cả các quốc gia bị hạn chế hiện có, hãy nhậpNONElàm giá trị. - Lưu tệp dưới dạng CSV và tải lên Catalog bằng cách kéo thả hoặc chọn tệp của bạn bằng cách nhấp vào duyệt trên cùng một trang bạn tải xuống CSV.
- Xem lại các sản phẩm được tải lên trong màn hình xem trước và nhấp vào tải lên.
Lọc sản phẩm bị hạn chế:
Bạn có thể lọc các sản phẩm bị hạn chế trực tiếp trong catalog bằng cách tải xuống toàn bộ catalog dưới dạng CSV từ Dashboard và mở nó trong Excel hoặc Google Sheets. Từ đó, bạn có thể sử dụng tính năng lọc để xem chỉ các sản phẩm bị hạn chế. Điều này cho phép bạn dễ dàng định vị và quản lý các sản phẩm bị hạn chế trong catalog của bạn.
Nếu bạn cần cập nhật catalog sau khi thực hiện các thay đổi trên CSV của mình, hãy tải lại tệp và bất kỳ sản phẩm nào phù hợp sẽ được thay thế bằng phiên bản cập nhật. Điều này được thực hiện bằng cách xác định và so khớp SKU và/hoặc ID sản phẩm.
If you're using Checkout, một thông báo hạn chế sẽ được hiển thị trong checkout của bạn khi sản phẩm bị hạn chế đối với quốc gia của khách hàng. Theo mặc định, thông báo sẽ nói "This item is restricted from import to your country."
Lọc sản phẩm
Bạn có thể tìm kiếm sản phẩm trong Catalog thông qua Dashboard hoặc qua API bằng cách sử dụng SKU, ID sản phẩm hoặc tên sản phẩm. Đối với tìm kiếm SKU và ID sản phẩm, chỉ các kết quả khớp chính xác sẽ được trả về; không hỗ trợ kết quả khớp một phần. Tuy nhiên, khi tìm kiếm theo tên sản phẩm, các kết quả khớp một phần được hỗ trợ.
Để lọc theo SKU hoặc ID sản phẩm:
- Nhấp vào tab Sản phẩm trong Dashboard.
- Chọn SKU hoặc ID Sản phẩm ở phía trên cùng bên trái của Catalog của bạn.
- Nhập SKU, ID sản phẩm hoặc tên sản phẩm của bạn.
- Nhấp vào Áp dụng để xem sản phẩm được lọc của bạn.
Để tìm kiếm tên sản phẩm:
- Nhấp vào tab Sản phẩm trong Dashboard.
- Ở phía trên cùng bên phải của Catalog của bạn, hãy nhập tên sản phẩm vào trường tìm kiếm.
- Xem sản phẩm được lọc của bạn.
Xuất sản phẩm của bạn
Nếu bạn chọn 50 mục hoặc ít hơn từ bảng Catalog, catalog của bạn sẽ được tải xuống trực tiếp từ Dashboard. Tuy nhiên, nếu bạn chọn Xuất tất cả hoặc hơn 50 mục, CSV của bạn sẽ được xuất qua email.
Để xuất 50 mục hoặc ít hơn, hãy làm theo các bước sau:
- Chọn 50 hoặc ít hơn mục trực tiếp từ bảng Catalog.
- Nhấp vào Xuất ở góc trên cùng bên phải.
- Tìm tệp CSV của bạn trong hộp thư đến email của bạn.
Để xuất tất cả sản phẩm:
- Chuyển đến Dashboard -> Sản phẩm -> Catalog.
- Nhấp vào menu thả xuống Quản lý Catalog bên cạnh Thêm sản phẩm và nhấp vào Xuất tất cả.
- Tìm tệp catalog của bạn trong tải xuống của bạn.
Gặp sự cố khi tải xuống từ email của bạn?
Nếu bạn gặp sự cố khi tải xuống CSV từ liên kết email, điều này có thể là do trình duyệt của bạn chặn tải xuống. Nếu vậy, hãy làm theo các bước sau:
- Nhấp chuột phải vào nút "Tải xuống" trong email của bạn.
- Chọn "Sao chép địa chỉ liên kết" để sao chép URL tải xuống.
- Dán URL được sao chép vào trình duyệt của bạn và nhấp vào Enter.
- Catalog của bạn sau đó sẽ tải xuống trực tiếp từ trình duyệt của bạn.
Phân loại sản phẩm
Bạn có thể phân loại sản phẩm từ catalog của bạn bằng API bằng cách sử dụng catalogItemId trong phép biến đổi ClassificationsCreateFromCatalog.
Lưu ý rằng name là bắt buộc để phân loại sản phẩm từ catalog của bạn. Tham khảo tài liệu tham khảo GraphQL API để biết danh sách đầy đủ các trường catalog và phân loại.
Để tạo và phân loại sản phẩm catalog đồng thời, hãy thêm phép biến đổi ClassificationsCreateFromCatalog dưới đây vào phép biến đổi CatalogItemsCreate của bạn mutation.
Phân loại sản phẩm catalog thành 8+ chữ số (dành riêng cho quốc gia)
Khi trường shipToCountries được điền, phân loại sẽ là mã HS 8+ chữ số (dành riêng cho quốc gia). Nếu không cung cấp shipToCountries, phân loại sẽ mặc định là mã HS 6 chữ số (phổ quát). Tìm hiểu thêm về những khác biệt giữa mã HS phổ quát và dành riêng cho quốc gia.
Trong ví dụ dưới đây, trường shipToCountries được cung cấp để tạo mã dành riêng cho quốc gia cho Canada.
mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) { classificationsCalculateFromCatalog(input: $catalogItemToClassify) { id configuration { shipToCountries } hsCode { code } name }}Đây là ví dụ về yêu cầu. Mặc dù Zonos Classify sẽ tạo phân loại chỉ với name, nhưng chúng tôi thực sự khuyên bạn nên thêm càng nhiều chi tiết càng tốt để có kết quả phân loại tốt nhất.
{ "catalogItemToClassify": [ { "catalogItemId": "catalog_item_893jkdkllg03k9khjd9", "configuration": { "shipToCountries": [ "CA" ] } } ]}Lỗi API và giải pháp
| Lỗi↕ | Giải pháp↕ |
|---|---|
| A SKU or product ID is required to create a product | Một định danh (SKU/product ID) là bắt buộc để tạo, chỉnh sửa hoặc xóa mục catalog. Để giải quyết vấn đề này, hãy thêm SKU và/hoặc ID sản phẩm. |
| The product you are trying to edit does not exist* | Bạn không thể chỉnh sửa sản phẩm không tồn tại. Để giải quyết vấn đề này, hãy tạo sản phẩm mới bằng SKU và/hoặc ID sản phẩm mong muốn. |
| Customs description exceeds character limit of 30 characters. | Theo mặc định, các mô tả hải quan bị giới hạn ở 30 ký tự, phù hợp với giới hạn ký tự phổ biến nhất cho hóa đơn thương mại. |
| Product type invalid. Catalog supports the following product types: digital_good. For physical goods, leave it blank. | Catalog chỉ hỗ trợ các loại sản phẩm sau: digital_good và physical_good. Nếu sản phẩm của bạn là hàng hóa vật lý (phổ biến nhất), hãy để trống trường này. |
| Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank. | Sở thích đóng gói không hợp lệ. Catalog hỗ trợ các sở thích đóng gói sau: ships_alone và consolidated. Nếu sản phẩm của bạn có thể được kết hợp với các sản phẩm khác, bạn có thể để trống vì consolidated là mặc định. |
| Country must be specified when providing an HS code | Nếu bạn cung cấp mã HS dành riêng cho quốc gia khi tạo mục, cần phải có quốc gia gửi hàng đến. Để giải quyết vấn đề này, hãy thêm quốc gia gửi hàng đến. |
| Price must be greater than 0 | Catalog không hỗ trợ các giá trị giá âm. Để giải quyết vấn đề này, hãy thêm giá lớn hơn không. |
| Currency code must be provided when a price value is supplied | Nếu bạn cung cấp giá, mã tiền tệ là bắt buộc. Để giải quyết vấn đề này, hãy thêm mã tiền tệ. |
| Price must be provided when a currency code is supplied | Nếu bạn cung cấp mã tiền tệ, giá là bắt buộc. Để giải quyết vấn đề này, hãy thêm giá. |
| The accompanying dimensional field cannot be left blank | Nếu cung cấp một trường kích thước, hai trường khác là bắt buộc, ví dụ: Nếu bạn cung cấp chiều rộng 8 inch, thì chiều cao và chiều dài sẽ là bắt buộc. |
| Measurement value must be greater than 0 | Catalog không hỗ trợ các giá trị đo lường âm hoặc bằng không. Để giải quyết vấn đề này, hãy thêm giá trị lớn hơn không. |
| When providing a dimensional value, dimensional units cannot be left empty | Nếu bạn cung cấp giá trị kích thước, đơn vị kích thước là bắt buộc. Để giải quyết vấn đề này, hãy thêm đơn vị kích thước. |
| When providing a weight value, the weight unit cannot be left empty | Nếu bạn cung cấp giá trị trọng lượng, đơn vị trọng lượng là bắt buộc. Để giải quyết vấn đề này, hãy thêm đơn vị trọng lượng. |
* API error only
Quản lý Catalog
Tạo và sửa đổi sản phẩm.Tìm hiểu cách thêm, sửa đổi và xóa sản phẩm Zonos Catalog của bạn trong Dashboard hoặc qua API. Sử dụng Catalog trong Dashboard để tránh viết mã hoặc nếu bạn đang thực hiện những thay đổi nhỏ. Nếu bạn muốn tích hợp trực tiếp với Catalog để triển khai sản xuất, hãy sử dụng API.