Liên kết sản phẩm sàn
Xem, tạo và xoá liên kết giữa SKU trên sàn và biến thể sản phẩm Hubport
Mỗi liên kết (EcomChannelProduct) nối một SKU / model trên sàn với một biến thể sản phẩm Hubport. Liên kết thường được tạo tự động khi đồng bộ sản phẩm; các endpoint dưới đây để tra cứu và xử lý tay.
EcomChannelProduct Object
| Trường (Field) | Kiểu (Type) | Mô tả (Description) |
|---|---|---|
id | int | ID liên kết |
company_id | int | ID công ty |
creator_id | int | ID người tạo |
channel_id | int | ID kênh sàn |
product_id | int | ID sản phẩm Hubport |
product_option_id | int | ID biến thể Hubport |
sku | string | SKU biến thể Hubport |
channel_product_id | int | ID sản phẩm trên sàn (Shopee item_id, Lazada item_id, TikTok product_id) |
channel_variant_id | int | ID SKU / model trên sàn |
inventory_quantity | int | Tồn trên sàn ở lần đồng bộ / đẩy tồn gần nhất |
inventory_item_id | int | Không dùng với sàn (0) |
date_created | int | Thời gian tạo (Unix timestamp) |
date_modified | int | Thời gian sửa đổi (Unix timestamp) |
date_last_synced | int | Lần đẩy tồn thành công gần nhất (Unix timestamp) |
Quyền: các endpoint xem / tìm / tạo liên kết yêu cầu quyền
setting.sale(giống các API kết nối sàn khác) và kênh phải thuộc công ty của bạn. Thiếu quyền trả HTTP 403error_role_not_available.
Tìm liên kết theo SKU
POST /v1/ecomchannelproducts/findlink/:channelid
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty |
creator_id | int | Có | ID người gọi |
skulist | array<string> | Có | Danh sách SKU Hubport (tối đa 100) |
Response (HTTP 200): { total, currentpage, limit, items: [EcomChannelProduct Object] }.
Lỗi: error_sku_list_required, error_max_sku_list_limit_exceed (HTTP 422).
Xoá liên kết
DELETE /v1/ecomchannelproducts/:id
Quyền:
company.setting
Xoá một liên kết (SKU đó sẽ không còn được đẩy tồn). HTTP 204 khi thành công; error_not_found (HTTP 404) nếu không tồn tại.
Sản phẩm trên sàn và liên kết tay (chỉ Shopee)
GET /v1/ecomchannelproducts/:channelid — liệt kê sản phẩm đang có trên gian hàng Shopee (đọc trực tiếp từ sàn). Query: page, limit (tối đa 50), keyword, id (ID sản phẩm sàn). Response: { total, currentpage, limit, items }, mỗi item là sản phẩm sàn kèm danh sách biến thể.
POST /v1/ecomchannelproducts/link/:channelid/:productid/:sku — liên kết tay biến thể có SKU :sku của sản phẩm sàn :productid với biến thể Hubport cùng SKU. Body: company_id, creator_id. HTTP 201 trả EcomChannelProduct Object.
| Mã lỗi | Mô tả |
|---|---|
error_sku_not_found_in_product_variants | Không có biến thể sàn / biến thể Hubport trùng SKU (HTTP 422) |
error_sku_has_linked | SKU đã được liên kết với kênh (HTTP 422) |
error_remote_product_not_found | Không tìm thấy sản phẩm trên sàn (HTTP 404) |
error_connector_notfound | Sàn của kênh chưa hỗ trợ thao tác này (Lazada, TikTok Shop) (HTTP 422) |