Chuyển tới nội dung chính

PHỤ TÙNG Ô TÔ: TƯƠNG THÍCH PHỤ TÙNG

Kể từ ngày 24 tháng 6 năm 2024, Shopee đã ra mắt tính năng cho phép thêm thông tin tương thích giữa xe cộ và sản phẩm phụ tùng ô tô. Theo đó, một số endpoint mới đã được tạo và một số endpoint hiện có đã được cập nhật liên quan đến chủ đề này.

Ưu điểm của tính năng tương thích​

  • Người bán có thể thiết lập các sản phẩm đầy đủ thông tin hơn, bao gồm dữ liệu về các loại xe tương thích với sản phẩm của họ;
  • Các sản phẩm có thông tin tương thích sẽ xuất hiện ở vị trí cao hơn trong trang kết quả tìm kiếm (SRP) của người mua;
  • Người mua sẽ có độ tin cậy cao hơn khi mua hàng, vì sẽ dễ dàng hơn để xác nhận một sản phẩm có thực sự tương thích với xe của họ hay không.

Với bối cảnh này, nếu khách hàng của bạn (người bán) kinh doanh các sản phẩm phụ tùng ô tô, chúng tôi khuyến nghị mạnh mẽ việc tích hợp các endpoint mới vào nền tảng của bạn.

Cấu trúc dữ liệu​

Dữ liệu xe được lưu trữ theo cấu trúc sau:

Tham sốÝ nghĩaVí dụ
brand_idID của một thương hiệu cụ thể.5770
brand_nameTên thương hiệu tương ứng với brand_id."Chevrolet"
model_idID của một mẫu xe cụ thể.5905
model_nameTên mẫu xe tương ứng với model_id."Chevette"
year_idID của mỗi năm sản xuất.5712
year_nameNăm sản xuất tương ứng với year_id."1979"
version_idID của mỗi phiên bản xe.5907
version_nameTên phiên bản tương ứng với version_id."Hatch"

Cần lưu ý rằng các tham số liệt kê ở trên có quan hệ phụ thuộc theo thứ tự: brand > model > year > version.

Các endpoint mới:​

v2.product.get_all_vehicle_list

  • Như tên gọi, đây là endpoint trả về toàn bộ danh sách xe trong cơ sở dữ liệu của Shopee. Để sử dụng, tham số bắt buộc là kích thước trang (page_size), tối đa 100 mục. Xem chi tiết endpoint tại trang API Reference.
  • Ví dụ kết quả trả về:

Python

{
    "error": "",
    "message": "",
    "warning": "",
    "request_id": "6535ecb33a3f8c6900c8d2b515f3c821",
    "response": {
        "vehicle_list": [
            {
                "brand_id": 5770,
                "brand_name": "Chevrolet",
                "model_id": 5905,
                "model_name": "Chevette",
                "year_id": 5712,
                "year_name": "1979",
                "version_id": 5907,
                "version_name": "Hatch"
            },
            {
                "brand_id": 5770,
                "brand_name": "Chevrolet",
                "model_id": 5905,
                "model_name": "Chevette",
                "year_id": 5712,
                "year_name": "1979",
                "version_id": 5906,
                "version_name": "S"
            }....
           ],
        "has_next_page": true,
        "next_offset": 61
    }
}

v2.product.get_vehicle_list_by_compatibility_detail

  • Endpoint này cho phép xác định chi tiết từng thành phần của xe (thương hiệu / mẫu / năm / phiên bản). Tham số bắt buộc là "compatibility_details", nơi bạn có thể chỉ định mức độ chi tiết muốn xem. Các tham số tùy chọn (brand_id / model_id / year_id / version_id) giúp thu hẹp kết quả tìm kiếm. Xem thêm tại trang API Reference.
  • Ví dụ các lệnh gọi endpoint:
RequestResponse
compatibility_details="Brand"Python "response": \{ "compatibility_tree": [ \{ "compatibility_details": [ \{ "brand_id": 12345, "brand_name": "Toyota", \}, \{ "brand_id": 13524, "brand_name": "Renault", \}, \{ "brand_id": 14235, "brand_name": "Chevrolet", \}, …
compatibility_brand_id=12345&compatibility_details="Model"Python "response": \{ "compatibility_tree": [ \{ "compatibility_details": [ \{ "model_id": 222234, "model_name": "Etios", \}, \{ "model_id": 234234, "model_name": "Corolla", \}, \{ "model_id": 225243, "model_name": "Bandeirante", \}, …

Thay đổi ở các endpoint hiện có​

Một số endpoint đã được điều chỉnh để tích hợp với luồng tương thích, bao gồm:

  • V2.product.add_item;
  • V2.product.update_item;
  • v2.product.get_item_base_info;

Hai endpoint đầu tiên cho phép thêm thông tin tương thích cho sản phẩm mới / đã có tương ứng. Endpoint thứ ba giúp xác nhận thông tin tương thích đã được thêm đúng hay chưa.

Ví dụ cấu trúc lệnh gọi cho v2.product.add_item và v2.product.update_item

Python

    "compatibility_info": {
        "vehicle_info_list": [
            {
                "brand_id": 5770,
                "model_id": 5911,
                "year_id": 5590,
                "version_id": 5912
            },
            {
                "brand_id": 5508,
                "model_id": 5509,
                "year_id": 5516
            },
            {
                "brand_id": 5770,
                "model_id": 5905
            }
        ]
    },

Một số lưu ý quan trọng:

  • Nếu một sản phẩm tương thích với tất cả các phiên bản của một năm cụ thể, chỉ cần cung cấp brand, model và year id — hệ thống sẽ hiểu rằng tất cả phiên bản của năm đó đều được đưa vào danh sách tương thích;

Python

			{
                "brand_id": 5508,
                "model_id": 5509,
                "year_id": 5516
            }
  • Tương tự, nếu tất cả các phiên bản của mọi năm thuộc một mẫu xe nhất định đều tương thích với sản phẩm, chỉ cần cung cấp brand và model id;

Python

            {
                "brand_id": 5770,
                "model_id": 5905
            }

  • Có thể sử dụng v2.product.update_item bình thường để thêm thông tin tương thích vào các sản phẩm hiện có chưa có thông tin này. Trong trường hợp đó, chỉ cần cung cấp danh sách tương thích theo các ví dụ trên;

  • LƯU Ý: Khi sử dụng v2.product.update_item để thêm tương thích vào sản phẩm đã có danh sách xe, bạn phải cung cấp toàn bộ danh sách id hiện có trong sản phẩm + các id tương thích mới. Nếu không, danh sách id hiện có sẽ bị ghi đè bởi các id mới cung cấp trong lệnh gọi update item.

Nếu còn thắc mắc về cách sử dụng các endpoint mới, hãy mở ticket và chúng tôi sẽ hỗ trợ bạn tích hợp đúng cách với tính năng mới này.