SelSup Developers

Giai đoạn công việc cuối đến cuối · Các hướng dẫn

Danh mục sản phẩm và thẻ

Tìm kiếm sản phẩm, tìm kiếm thẻ đầy đủ, tạo mô hình, từ điển thương hiệu và danh mục và tham số thị trường.

4 Các phầnHướng dẫn nhà phát triển
→

Một thẻ SelSup là mô hình phân cấp, biến thể màu sắc và sản phẩm cuối cùng hoặc kích thước.

PIM, ERP và tích hợp danh mục

02

Tạo một thẻ tối thiểu

Một mô hình vẫn cần một biến thể và một sản phẩm cuối cùng ngay cả khi doanh nghiệp không sử dụng màu sắc hoặc kích thước.

Tìm hoặc tạo ra thương hiệu và danh mục trước. Giữ các nhận dạng của họ trong hệ thống của bạn để nhập khẩu lặp lại không tạo ra bản sao.

Sử dụng mô hình bài viết như một khóa bên ngoài ổn định. SelSup có thể tạo ra mã vạch thiếu, nhưng bản đồ mã vạn rõ ràng là an toàn hơn cho đồng bộ hai chiều.

!
Kiểm tra sơ đồ yêu cầu

Các mô hình chia sẻ chứa các trường dịch vụ. Chỉ gửi các trường được liệt kê trong cơ thể yêu cầu điểm cuối hiện tại.

Mô hình tối thiểu · JSON
{
  "article": "MODEL-001",
  "title": "Basic T-shirt",
  "brandId": 8124,
  "categoryId": 27640,
  "organizationId": 1,
  "views": [
    {
      "color": "Black",
      "sizes": [
        {
          "name": "Basic T-shirt, M",
          "size": "M"
        }
      ]
    }
  ]
}

Các điểm cuối API liên quan

GET/api/brand/findTìm một thương hiệuPOST/api/brandTạo một thương hiệuGET/api/category/findTìm một danh mục SelSupPOST/api/category/Tạo một danh mụcPOST/api/model/Tạo mô hình

03

Cập nhật mà không mất dữ liệu

Sử dụng PATCH để thay đổi sản phẩm cuối cùng một phần khi điểm cuối hỗ trợ sáp nhập.

Trước khi PUT, tải mẫu mới nhất, thay đổi các trường cần thiết trong bản sao của bạn và gửi cấu trúc được hòa hợp. Đừng sử dụng lại câu trả lời cũ khi thẻ có thể đã thay đổi trong UI.

!
Các chỉnh sửa đồng thời

Khi không có phiên bản thực thể hoặc ETag có sẵn, giảm thiểu cửa sổ đọc-đọc và thực hiện kiểm tra đọc sau khi lưu.

Các điểm cuối API liên quan

PATCH/api/product/{productId}Tối cập nhật một phần sản phẩmPUT/api/model/{modelId}Thay thế dữ liệu mô hình

04

Các tham số và giá trị được phép

Các giá trị tham số có thể sống ở cấp độ loại, mô hình, biến thể hoặc sản phẩm. Một cấp độ cụ thể hơn thường thắng, trong khi các quy tắc thị trường xác định những gì thực sự có thể được gửi.

Đối với multiValueAllowed, gửi nhiều giá trị với cùng một paramId. Chọn hình dạng giá trị từ valueType, và giải quyết một tùy chọn được phép trước khi displayType là SUGGEST.

Các danh mục và tham số thị trường thay đổi. Hãy cập nhật chúng thường xuyên và không bao giờ sử dụng tên màn hình như một khóa vĩnh viễn.

Dịch vụ từ điển · HTTP
GET https://params.selsup.ru/knowledge/getParams?ozonCategoryId=91025609

GET https://options.selsup.ru/option/fetchOption?paramId=60019&query=cotton&limit=10

Các điểm cuối API liên quan

GET/api/param/findTìm các tham số SelSupGET/api/category/ozon/findTìm một danh mục OzonGET/api/category/wildberries/findTìm một chủ đề Wildberries