Kết nối sàn TMĐT
Đẩy tồn kho lên sàn
Cập nhật số tồn có thể bán của các SKU đã liên kết lên gian hàng sàn
Endpoint
| Sàn | Endpoint |
|---|---|
| Shopee | POST /v1/ecomshopee/pushstock/:channelid |
| Lazada | POST /v1/ecomlazada/pushstock/:channelid |
| TikTok Shop | POST /v1/ecomtiktokshop/pushstock/:channelid |
Quyền:
setting.sale
Ghi đè số tồn có thể bán trên sàn bằng số lượng gửi lên, cho các SKU Hubport đã liên kết với kênh. Hubport chưa tự động đẩy tồn khi tồn kho thay đổi; hệ thống của shop gọi endpoint này khi cần.
TikTok Shop nhiều kho
Với SKU TikTok Shop gán nhiều kho, số tồn được đặt vào kho chính của shop (hoặc kho đầu tiên của SKU); các kho khác giữ nguyên số tồn hiện tại trên TikTok.
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ả |
|---|---|---|---|
items | array | Có | 1–200 SKU |
items[].sku | string | Có | SKU biến thể Hubport |
items[].quantity | int | Có | Số tồn có thể bán (số âm được tính là 0) |
{ "items": [ { "sku": "AO-THUN-M-DO", "quantity": 12 }, { "sku": "AO-THUN-L-DO", "quantity": 0 } ] }Response Schema
HTTP 200 - JSON Object
| Trường | Kiểu | Mô tả |
|---|---|---|
success | array | SKU đã cập nhật |
failure | array | SKU sàn từ chối: ID sản phẩm/SKU phía sàn, error (TikTok Shop thêm code, sku) |
not_linked | array | SKU gửi lên nhưng chưa liên kết với kênh (không đẩy) |
Phần tử success theo sàn:
| Sàn | Trường |
|---|---|
| Shopee | sku, item_id, model_id, stock |
| Lazada | sku, item_id, sku_id, quantity |
| TikTok Shop | sku, product_id, sku_id, quantity, warehouses |
{
"success": [ { "sku": "AO-THUN-M-DO", "item_id": "2200000001", "model_id": "1500000001", "stock": 12 } ],
"failure": [],
"not_linked": ["AO-THUN-L-DO"]
}Error Codes
| Mã lỗi | Mô tả |
|---|---|
error_items_required_max_200 | items rỗng hoặc quá 200 SKU (HTTP 422) |
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) |