Kết nối sàn TMĐT
Đồng bộ sản phẩm
Kéo toàn bộ sản phẩm của gian hàng sàn và tự liên kết SKU với biến thể Hubport
Endpoint
| Sàn | Endpoint |
|---|---|
| Shopee | POST /v1/ecomshopee/syncproducts/:channelid |
| Lazada | POST /v1/ecomlazada/syncproducts/:channelid |
| TikTok Shop | POST /v1/ecomtiktokshop/syncproducts/:channelid |
Quyền:
setting.sale
Kéo toàn bộ sản phẩm (và biến thể / model / SKU) của gian hàng. Khi auto_link bật, mỗi SKU sàn có mã SKU người bán trùng SKU biến thể Hubport cùng công ty được tự động liên kết. Liên kết là điều kiện để đẩy tồn và để nhận diện dòng hàng khi nhập đơn.
Thao tác chạy đồng bộ trong request và có thể mất vài phút với gian hàng nhiều sản phẩm.
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
channelid | int | Có | ID kênh sàn |
Request Body
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
auto_link | int | Không | 1 (mặc định) tự liên kết theo SKU; 0 chỉ đếm, không liên kết |
page_size | int | Không | Số sản phẩm mỗi trang khi gọi sàn. Shopee / TikTok Shop: tối đa 100 (mặc định 100); Lazada: tối đa 50 (mặc định 50) |
Response Schema
HTTP 200 - JSON Object
| Trường | Kiểu | Mô tả |
|---|---|---|
total_items | int | Số sản phẩm đã đọc |
total_variants | int | Số SKU / model đã đọc |
pages | int | Số trang đã gọi sàn |
linked_new | int | Số SKU vừa được liên kết |
linked_existing | int | Số SKU đã liên kết từ trước |
unmatched_sku | array | SKU sàn không tìm thấy biến thể Hubport trùng SKU (tối đa 50) |
ambiguous_sku | array | Chỉ Lazada: SKU người bán trùng ở nhiều SKU Lazada, không tự liên kết; cần liên kết tay (tối đa 50) |
empty_sku | int | Số SKU sàn chưa đặt mã SKU người bán |
{
"total_items": 120,
"total_variants": 340,
"pages": 2,
"linked_new": 310,
"linked_existing": 12,
"unmatched_sku": ["AO-THUN-XL-DO"],
"empty_sku": 18
}Error Codes
| Mã lỗi | Mô tả |
|---|---|
error_not_found | Kênh không tồn tại, sai loại sàn hoặc không thuộc công ty của bạn (HTTP 404) |
error_channel_disabled | Kênh đang tắt (HTTP 422) |
error_feature_requires_plan | Gói chưa có tính năng kết nối sàn (HTTP 402) |
error_shopee_api / error_lazada_api / error_tiktokshop_api | Lỗi do sàn trả về (HTTP 422) |
error_role_not_available | Không có quyền setting.sale (HTTP 403) |