Quản lý Catalog

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ẩm và ghi đè thông tin của sản phẩm gốc bằng thông tin mới.

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 với thông tin bổ sung hoặc thông tin đã được cập nhật một cách hiệu quả. 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 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ữ cho danh mục của mình luôn cập nhật với nỗ lực tối thiểu, cho dù bạn sử dụng Bảng điều khiển 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 một sản phẩm trong danh mục đã tồn tại trong Catalog, hãy mong đợi những đ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à sản phẩm cùng loại, SKU 321, có trọng lượng là 1.3 lbs trong lần tải lên mới, trọng lượng 1.3 lb sẽ ghi đè lên trường trống trước đó.

Catalog sẽ ghi đè 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à sản phẩm cùng loại, 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 đè 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ẽ vẫn giữ nguyên.

Nếu bạn muốn ngăn chặn việc vận chuyển đến một quốc gia (hoặc các quốc gia) nhất định, 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.

Nếu bạn đang sử dụng Checkout, một thông điệp 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ế đối với quốc gia của khách hàng. Theo mặc định, thông điệp 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."

Bạn có thể tìm kiếm sản phẩm trong Catalog thông qua Dashboard hoặc qua API bằ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 mới được trả về; các kết quả khớp một phần không được hỗ trợ. 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ợ.

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:

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.

Bạn có thể classify một sản phẩm từ danh mục 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 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 trong danh mục đồng thời, hãy thêm phép biến đổi ClassificationsCreateFromCatalog bên dưới vào phép biến đổi CatalogItemsCreate.

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

Khi trường shipToCountries được điền, phân loại sẽ là mã HS 8+ chữ số (cụ thể theo quốc gia). 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ố (toàn cầu). Tìm hiểu thêm về sự khác biệt giữa mã HS toàn cầu và cụ thể theo quốc gia.

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

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.

{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

{
  "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ỗi API chỉ