DOCS

Manage products

/

Quản lý Catalog

Tạo và sửa đổi sản phẩm.

Học cách thêm, sửa đổi và xóa sản phẩm trong Catalog Zonos 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 chỉ 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 sản xuất, hãy sử dụng API.

Tạo một sản phẩm

Dashboard
API

Tạo một sản phẩm trong Catalog:

  1. Đi đến Catalog và nhấp vào Thêm sản phẩm ở góc trên bên phải.
  2. Thêm chi tiết sản phẩm của bạn. Trường duy nhất bắt buộc để tạo một 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 đến các sản phẩm trong catalog của bạn. Tìm hiểu thêm về các định danh của Catalog.
  3. Tùy chọn—Thêm mã HS của bạn.
  4. 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, v.v.).
  5. Tùy chọn—Thêm các quốc gia bị hạn chế.
  6. 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 một sản phẩm đã tồn tại, Catalog sẽ nhận diện sản phẩm dựa trên SKU và/hoặc ID sản phẩmghi đè các chi tiết của sản phẩm ban đầu bằng các chi tiết mới.

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 thông tin hiện có của sản phẩm một cách hiệu quả với thông tin bổ sung hoặc cập nhật. Thay vì phải xóa và tải lại sản phẩm, bạn có thể tải lên thông tin cập nhật và Catalog sẽ phù hợp với sản phẩm hiện có bằ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. Điều này giúp bạn duy trì bản danh mục của mình luôn cập nhật một cách dễ dàng, cho dù bạn sử dụng Bảng điều khiển hoặc 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 một sản phẩm trong Catalog mà đã tồn tại, hãy chờ đợi các điều sau:

Catalog sẽ ghi đè lên 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 một sản phẩm, SKU 321, có trọng lượng là 1.3 lbs trong tải lên mới, trọng lượng 1.3 lbs sẽ ghi đè lên trường trống trước đó.

Catalog sẽ ghi đè lên các trường hiện có bằng các giá trị trường mới.

  • Ví dụ, nếu một sản phẩm hiện có, SKU 123, có giá là 18.99 USD và cùng một sản phẩm, SKU 123, có giá cập nhật là 22.99 USD, giá mới 22.99 USD sẽ ghi đè lên giá trước đó.

Catalog sẽ không ghi đè lên 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, mã HS hiện có sẽ được giữ nguyên.
Bảng điều khiển
API

Để chỉnh sửa sản phẩm:

  1. Nhấp vào tab Sản phẩm.
  2. Chọn sản phẩm bạn muốn chỉnh sửa.
  3. Thực hiện các thay đổi của bạn.
  4. 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 một tệp CSV cập nhật vào Catalog, bao gồm các kết hợp SKU/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

Bảng điều khiển
API

Để xóa một sản phẩm:

  1. Nhấp vào tab Sản phẩm trong Bảng điều khiển.
  2. Chọn sản phẩm bạn muốn xóa. Khi sản phẩm của bạn được chọn, một nút xóa sẽ xuất hiện.
  3. Nhấp vào Xóa và sau đó Xóa tất cả để xác nhận việc xóa của bạn.

Để xóa tất cả sản phẩm:

  1. Chọn tab Sản phẩm trong Bảng điều khiển.
  2. Nhấp vào Quản lý Danh mục ở góc trên bên phải và sau đó Xóa tất cả.
  3. Nhấp vào Xóa tất cả một lần nữa để xác nhận việc xóa của bạn.

Lưu ý rằng nếu bạn đang xóa một lượng lớn các mặt hàng (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 việc xóa của bạn đang được tiến hành. Trong thời gian này, bạn sẽ không thể tương tác với Danh mục cho đến khi quá trình xóa hoàn tất. Tuy nhiên, bạn có thể bỏ qua thông báo và di chuyển đi mà không làm gián đoạn quá trình xóa.

Restrict một sản phẩm

Nếu bạn muốn ngăn chặn việc vận chuyển đến một quốc gia cụ thể (hoặc các quốc gia), bạn có thể thêm các hạn chế khi tạo hoặc cập nhật một sản phẩm.

Bảng điều khiển
API

Để restrict một sản phẩm duy nhất trong Catalog:

  1. Nhấp vào tab Sản phẩm.
  2. Chọn sản phẩm mà bạn muốn thêm hạn chế, điều này sẽ mở trang chỉnh sửa.
  3. Tìm phần Các quốc gia bị hạn chế ở cuối trang chỉnh sửa.
  4. Thêm các quốc gia mà bạn muốn restrict sản phẩm của mình bằng cách chọn hoặc nhập tên quốc gia.
  5. Nhấp vào lưu sản phẩm.

Để restrict nhiều sản phẩm trong Catalog:

  1. Nhấp vào tab Nhập/xuất.
  2. Tải xuống Mẫu CSV Catalog.
  3. Điền thông tin 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ữ số được phân tách bằng dấu thẳng đứng (ví dụ, AU|KR|MY|SG). Để restrict tất cả các quốc gia, chỉ cần nhập TẤT CẢ là giá trị. Nếu bạn muốn restrict tất cả các quốc gia ngoại trừ một hoặc một số quốc gia, nhập TẤT CẢ- tiếp theo là các quốc gia mà bạn muốn bỏ hạn chế, phân tách bằng dấu thẳng đứng (ví dụ, TẤT CẢ-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ó, nhập KHÔNG CÓ là giá trị.
  4. Lưu tệp của bạn dưới dạng CSV và tải lên Catalog bằng cách kéo và 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 mà bạn đã tải xuống CSV từ đó.
  5. Xem lại các sản phẩm đã tải lên trong screen xem trước và nhấp vào tải lên.

Lọc cá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 của bạn dưới dạng CSV từ Bảng điều khiển và mở nó trong Excel hoặc Google Sheets. Từ đó, bạn có thể sử dụng tính năng lọc để chỉ xem các sản phẩm bị hạn chế. Điều này giúp bạn dễ dàng xác định và quản lý các sản phẩm bị hạn chế trong catalog của mình.

Nếu bạn cần cập nhật catalog của mình sau khi thay đổi CSV, hãy tải lên tệp và bất kỳ sản phẩm nào khớ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à 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 bị hạn chế sẽ được hiển thị trong checkout của bạn khi một sản phẩm bị hạn chế đến quốc gia của khách hàng. Theo mặc định, thông báo sẽ nói "Mặt hàng này bị hạn chế nhập khẩu vào quốc gia của bạn," nhưng bạn có thể tùy chỉnh thông báo hạn chế của riêng bạn bằng cách cung cấp nó trong trường restrictedCountriesMessage khi thêm các hạn chế quốc gia của bạn.

Lọc sản phẩm

Bạn có thể tìm kiếm sản phẩm trong Catalog thông qua Bảng điều khiển hoặc qua API bằng cách sử dụng SKU hoặc ID sản phẩm. Lưu ý rằng chỉ có kết quả chính xác sẽ trả về; các kết quả phần mềm sẽ không được nhận dạng.

Bảng điều khiển
API

Để lọc theo SKU hoặc ID sản phẩm:

  1. Nhấp vào tab Sản phẩm.
  2. Chọn SKU hoặc ID Sản phẩm ở góc trên bên trái của Catalog của bạn.
  3. Nhập SKU hoặc ID sản phẩm của bạn.
  4. Nhấp vào Áp dụng để xem sản phẩm đã 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 Danh mục, danh mục của bạn sẽ được tải xuống trực tiếp từ Bảng điều khiển. Tuy nhiên, nếu bạn chọn Xuất tất cả hoặc hơn 50 mục, tệp 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:

  1. Chọn 50 mục hoặc ít hơn trực tiếp từ bảng Danh mục.
  2. Nhấp vào Xuất ở góc trên bên phải.
  3. Tìm tệp CSV của bạn trong hộp thư đến email.

Để xuất tất cả sản phẩm:

Bảng điều khiển
API
  1. Đi đến Bảng điều khiển -> Sản phẩm -> Danh mục.
  2. Nhấp vào menu thả xuống Quản lý Danh mục bên cạnh Thêm sản phẩm và nhấp vào Xuất tất cả.
  3. Tìm tệp danh mục của bạn trong thư mục tải xuống.

Gặp khó khăn khi tải xuống từ email của bạn?

Nếu bạn gặp khó khăn khi tải xuống tệp CSV từ liên kết trong email, điều này có thể 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:

  1. Nhấp chuột phải vào nút "Tải xuống" trong email của bạn.
  2. Chọn "Sao chép địa chỉ liên kết" để sao chép URL tải xuống.
  3. Dán URL đã sao chép vào trình duyệt của bạn và nhấn enter.
  4. Danh mục của bạn sẽ được tải xuống trực tiếp từ trình duyệt của bạn.

Classify một sản phẩm

Bạn có thể classify một sản phẩm từ danh mục của mình bằng API bằng cách sử dụng catalogItemId trong mutation ClassificationsCreateFromCatalog.

Lưu ý rằng một name là bắt buộc để classify một sản phẩm từ danh mục của bạn. Tham khảo tài liệu tham khảo API GraphQL để có danh sách đầy đủ các trường danh mục và phân loại.

Để tạo và classify một sản phẩm danh mục đồng thời, thêm mutation ClassificationsCreateFromCatalog dưới đây vào mutation CatalogItemsCreate của bạn mutation.

Classify một sản phẩm danh mục đến mã 8+ chữ số (theo quốc gia cụ thể)

Khi trường shipToCountries được điền, phân loại sẽ là mã HS 8+ chữ số (theo quốc gia cụ thể). Nếu không có shipToCountries nào được cung cấp, phân loại sẽ mặc định là mã HS 6 chữ số (phổ quát). Tìm hiểu thêm về sự khác biệt giữa mã HS phổ quát và mã HS theo quốc gia cụ thể.

Trong ví dụ dưới đây, trường shipToCountries được cung cấp để tạo mã theo quốc gia cụ thể cho Canada.

Mutation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

Dưới đây là một ví dụ về yêu cầu. Trong khi Zonos Classify sẽ tạo ra một phân loại chỉ với một name, chúng tôi khuyến nghị mạnh mẽ việc thêm càng nhiều chi tiết càng tốt để có được kết quả phân loại tốt nhất.

Biến số

1
2
3
4
5
6
7
8
9
10
{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

Phản hồi

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

Lỗi API và cách giải quyết

LỗiCách giải quyết
Yêu cầu một SKU hoặc ID sản phẩm để tạo sản phẩmMột bộ nhận dạng (SKU/ID sản phẩm) được yêu cầu để tạo, chỉnh sửa hoặc xóa một mục trong danh mục. Để giải quyết vấn đề này, hãy thêm một SKU và/hoặc ID sản phẩm.
Sản phẩm bạn đang cố gắng chỉnh sửa không tồn tại*Bạn không thể chỉnh sửa một sản phẩm không tồn tại. Để giải quyết vấn đề này, hãy tạo một sản phẩm mới với SKU và/hoặc ID sản phẩm mong muốn của bạn.
Mô tả hải quan vượt quá giới hạn ký tự 30.Theo mặc định, mô tả hải quan được giới hạn trong 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.
Loại sản phẩm không hợp lệ. Danh mục hỗ trợ các loại sản phẩm sau: digital_good. Đối với hàng hóa vật lý, hãy để trống.Danh mục chỉ hỗ trợ các loại sản phẩm sau: digital_goodphysical_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.
Sở thích đóng gói không hợp lệ. Danh mục 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, hãy để trống.Sở thích đóng gói không hợp lệ. Danh mục hỗ trợ các sở thích đóng gói sau: ships_aloneconsolidated. 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 như consolidated là mặc định.
Quốc gia phải được chỉ định khi cung cấp một mã HSNếu bạn cung cấp một mã HS cụ thể cho quốc gia khi tạo một mục, cần phải có một quốc gia nhận hàng. Để giải quyết vấn đề này, hãy thêm một quốc gia nhận hàng.
Giá phải lớn hơn 0Danh mục không hỗ trợ các giá trị âm. Để giải quyết vấn đề này, hãy thêm một giá trị lớn hơn không.
Mã tiền tệ phải được cung cấp khi có giá trị giáNếu bạn cung cấp một giá, cần phải có một mã tiền tệ. Để giải quyết vấn đề này, hãy thêm một mã tiền tệ.
Giá phải được cung cấp khi có mã tiền tệNếu bạn cung cấp một mã tiền tệ, cần phải có một giá. Để giải quyết vấn đề này, hãy thêm một giá.
Trường kích thước đi kèm không được để trốngNếu cung cấp một trường kích thước, hai trường kích thước khác cần được điền. Ví dụ, nếu bạn cung cấp chiều rộng "8 inches," thì chiều cao và chiều dài sẽ cần phải được điền.
Giá trị đo lường phải lớn hơn 0Danh mục 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 một giá trị lớn hơn không.
Khi cung cấp một giá trị kích thước, đơn vị kích thước không thể để trốngNếu bạn cung cấp một giá trị kích thước, cần phải có một đơn vị kích thước. Để giải quyết vấn đề này, hãy thêm một đơn vị kích thước.
Khi cung cấp một giá trị trọng lượng, đơn vị trọng lượng không thể để trốngNếu bạn cung cấp một giá trị trọng lượng, cần phải có một đơn vị trọng lượng. Để giải quyết vấn đề này, hãy thêm một đơn vị trọng lượng.

* Chỉ là lỗi API

Trang này có hữu ích không?