Làm cách nào để tạo sản phẩm trong Zonos Catalog?

Bạn có thể tạo sản phẩm trong Zonos Catalog thông qua Dashboard hoặc API. Trong Dashboard, 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 và nhấp vào Lưu sản phẩm. Nếu bạn muốn tạo nhiều sản phẩm cùng một lúc, hãy làm theo các bước để nhập sản phẩm. Trong API, hãy tạo danh sách catalogItemInputs để thêm sản phẩm vào catalog của bạn.

Làm cách nào để chỉnh sửa sản phẩm trong Zonos Catalog?

Bạn có thể chỉnh sửa sản phẩm trong Zonos Catalog thông qua Dashboard hoặc API. Trong Dashboard, nhấp vào tab Tất cả sản phẩm, chọn sản phẩm mà bạn muốn chỉnh sửa, thực hiện các thay đổi và nhấp vào Lưu sản phẩm. Trong API, sử dụng mutation CatalogItemUpdate để chỉnh sửa sản phẩm.

Làm cách nào để xóa sản phẩm trong Zonos Catalog?

Bạn có thể xóa sản phẩm trong Zonos Catalog thông qua Dashboard hoặc API. Trong Dashboard, nhấp vào tab Tất cả sản phẩm, chọn sản phẩm hoặc sản phẩm bạn muốn xóa và nhấp vào xóa. Trong API, sử dụng mutation CatalogItemDelete để xóa sản phẩm.

Làm cách nào để hạn chế sản phẩm trong Zonos Catalog?

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 trong Zonos Catalog. Trong Dashboard, chọn sản phẩm mà bạn muốn thêm hạn chế, tìm phần 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 và nhấp vào Lưu sản phẩm. Trong API, thêm restrictedCountries khi tạo hoặc cập nhật catalogItem.

Làm cách nào để xuất sản phẩm của bạn trong Zonos Dashboard?

Khi bạn xuất sản phẩm trong Zonos Dashboard, nó sẽ tự động xuất toàn bộ catalog sản phẩm của bạn trong tệp CSV. Chuyển đến trang chính của Catalog, nhấp vào nút Xuất bên cạnh Thêm sản phẩm và tìm tệp catalog đầy đủ của bạn trong tải xuống của bạn.

Trang chủThương mại điện tử toàn cầu Danh mục Quản lý sản phẩm

Quản lý Catalog

Q: Làm cách nào để phân loại sản phẩm catalog thông qua API?

Bạn có thể phân loại sản phẩm từ catalog của bạn bằng cách sử dụng catalogItemId trong mutation 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. Để tạo và phân loại sản phẩm catalog đồng thời, hãy thêm mutation ClassificationsCreateFromCatalog vào mutation CatalogItemsCreate của bạn.

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 cho các triển khai production, hãy sử dụng API.

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 phù hợp của DHL đượ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 nhóm hàng hóa được quy định thuộc diện "rủi ro thấp" hoặc được miễn trừ—những mặt hàng về mặt kỹ thuật thuộc diện quy định nhưng được vận chuyển theo một điều khoản đặc biệt hoặc miễn trừ số lượng.

Thẻ hàng nguy hiểm được lưu trữ dưới dạng một thuộc tính (attribute) của 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.

Chỉ áp dụng cho DHL

Gắn thẻ hàng nguy hiểm chỉ ảnh hưởng đến các lô hàng DHL. Thẻ bị bỏ qua đối với các hãng vận chuyển khác.

Khóa thuộc tính được hỗ trợ

DANGEROUS_GOODS là khóa thuộc tính được hỗ trợ để gắn thẻ hàng nguy hiểm DHL. Nó chưa được liệt kê trong số các khóa được phê duyệt trong tài liệu tham khảo ItemAttributeInput, nhưng nó được API chấp nhận.

Để 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.

1mutation CatalogItemsCreate(

2$sku: String!

3$name: String

4$attributes: [ItemAttributeInput!]

5) {

6 catalogItemsCreate(

7 input: [{ sku: $sku, name: $name, attributes: $attributes }]

8 ) {

9 id

10 name

11 sku

12 attributes

13 key

14 value

Cá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 vật phẩm chịu áp lực, chẳng hạn như thanh chống khí (gas strut) 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—được miễn trừ theo quy định tải trọng nhỏ khi vận chuyển đường bộ ADR.
`LIMITED_QUANTITY`	Số lượng giới hạn (ADR)—hàng nguy hiểm được đóng gói với số lượng nhỏ trong giới hạn quy định.
`EXCEPTED_QUANTITY`	Số lượng miễn trừ (IATA)—số lượng rất nhỏ được miễn trừ khỏi hầu hết các quy tắc hàng nguy hiểm trong vận chuyển hàng không.
`CONSUMER_COMMODITY`	Hàng hóa tiêu dùng ID8000—sản phẩm bán lẻ dùng hàng ngày có hàm lượng nguy hiểm nhỏ, chẳng hạn như bình xịt và nước hoa.
`MAGNETIZED_MATERIAL`	Vật liệu từ hóa (UN2807)—các vật phẩm có từ trường đủ mạnh để ảnh hưởng đến thiết bị của 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.

Áp dụng thẻ tự động trên nhãn

Gắn thẻ sản phẩm là bước đầu tiên. Để Zonos áp dụng danh mục cho nhãn DHL của bạn tự động, hãy bật Vận chuyển hàng nguy hiểm trong cài đặt nhãn. Bạn cũng có thể chọn danh mục bằng tay trên một nhãn duy nhất—xem khai báo hàng nguy hiểm.

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 tùy chọn khóa mục của bạn. Bằng cách này, bạn có thể giữ cho catalog của mình luôn được 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.

Các ứng dụng Zonos Duty & Tax không hỗ trợ hạn chế cấp mục loại bỏ các sản phẩm cụ thể khỏi các đơn hàng quốc tế. Nếu mục bị hạn chế nằm trong giỏ hàng, toàn bộ giỏ hàng phải bị chặn khỏi vận chuyển đến quốc gia đó. Điều này được xử lý thông qua quy tắc hạn chế cấp giỏ hàng, phải được cấu hình trước trong quá trình onboarding. Mặc dù Catalog tương thích với các ứng dụng Duty & Tax, hạn chế cấp mục chỉ được hỗ trợ khi sử dụng Zonos Checkout.

Để 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ập ALL là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ập ALL- 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ập NONE là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.

Nếu bạn đang sử dụng 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 mục hoặc ít hơn 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 thư mục 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 đã sao chép vào trình duyệt của bạn và nhấn 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 mutation 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 mutation ClassificationsCreateFromCatalog dưới đây vào CatalogItemsCreate mutation của bạn.

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.

1mutation ClassificationsCreateFromCatalog(

2$catalogItemToClassify: [ClassificationFromCatalogInput!]!

3) {

4 classificationsCalculateFromCatalog(input: $catalogItemToClassify) {

5 id

6 configuration {

7 shipToCountries

8 }

9 hsCode {

10 code

11 }

12 name

13 }

14}

Đâ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.

1{

2 "catalogItemToClassify": [

3 {

4 "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",

5 "configuration": {

6 "shipToCountries": [

7 "CA"

8 ]

9 }

10 }

11 ]

12}

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.

* Chỉ áp dụng cho lỗi API

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

INPUTS

ItemAttributeInput

Đặt lịch demo