Kết nối sàn TMĐT
EcomPlatform Object Schema
Đối tượng kênh bán hàng sàn TMĐT (gian hàng Shopee / Lazada / TikTok Shop đã kết nối)
JSON Schema
| Trường (Field) | Kiểu (Type) | Mô tả (Description) |
|---|---|---|
creator_id | int | ID người kết nối |
company_id | int | ID công ty |
id | int | ID kênh (dùng làm :channelid trong các API đồng bộ) |
title | string | Tên kênh (mặc định lấy theo tên shop trên sàn khi kết nối) |
url | string | Link gian hàng trên sàn (có thể rỗng) |
type | int | Loại sàn: 7 (Shopee), 9 (TikTok Shop), 11 (Lazada) |
foreign_id | string | ID gian hàng phía sàn (Shopee shop_id, Lazada seller_id, TikTok Shop shop_id) |
api_key | string | Luôn rỗng với kênh sàn |
api_secret | string | Luôn rỗng với kênh sàn |
access_token | string | Luôn rỗng với kênh sàn (token do Hubport giữ, không trả ra) |
refresh_token | string | Luôn rỗng với kênh sàn |
connected | int | 1 = đang kết nối được (có token hợp lệ); 0 = mất kết nối / cần uỷ quyền lại |
store | int | ID cửa hàng Hubport gán cho đơn nhập từ kênh |
settings | object | Cấu hình kênh (xem bên dưới) |
status | int | 1 (Bật), 3 (Tắt). Kênh tắt không đồng bộ được (error_channel_disabled) |
date_created | int | Thời gian kết nối (Unix timestamp) |
date_modified | int | Thời gian sửa đổi (Unix timestamp) |
date_last_synced | int | Lần đồng bộ (sản phẩm / đơn) gần nhất (Unix timestamp) |
date_last_order_synced | int | Mốc thời gian đã đồng bộ đơn tới (Unix timestamp) |
date_last_hooked | int | Lần nhận thông báo từ sàn gần nhất (Unix timestamp) |
date_webhook_registered | int | Thời điểm đăng ký webhook (Unix timestamp) |
settings
Do shop cấu hình (qua Cập nhật kênh):
| Khoá | Kiểu | Mô tả |
|---|---|---|
receipt_warehouse | int | ID kho Hubport dùng cho đơn nhập từ kênh |
Do Hubport quản lý (chỉ đọc; khoá bắt đầu bằng shopee_, lazada_, tiktok_ theo sàn, gửi lên khi sửa sẽ bị bỏ qua). Một số khoá hữu ích:
| Khoá | Mô tả |
|---|---|
shopee_access_expire_at, lazada_access_expire_at, tiktok_access_expire_at | Thời điểm token truy cập hết hạn (Unix timestamp, Hubport tự làm mới) |
shopee_refresh_expire_at, lazada_refresh_expire_at, tiktok_refresh_expire_at | Thời điểm hết hạn uỷ quyền làm mới; sau mốc này shop phải kết nối lại |
shopee_auth_expire_time | Thời điểm uỷ quyền Shopee hết hạn |
shopee_auth_expire_soon, lazada_auth_expire_soon, tiktok_auth_expire_soon | Có giá trị khi sàn báo uỷ quyền sắp hết hạn |
shopee_token_error, lazada_token_error, tiktok_token_error | Có giá trị khi token lỗi / bị thu hồi (khi đó connected = 0) |
shopee_region, shopee_shop_status | Khu vực, trạng thái shop Shopee |
lazada_short_code, lazada_account, lazada_seller_status | Mã shop, tài khoản, trạng thái seller Lazada |
tiktok_shop_name, tiktok_shop_code, tiktok_seller_name | Tên, mã shop TikTok Shop |
tiktok_webhook_error | Lỗi khi đăng ký webhook TikTok Shop (nếu có) |
Ví dụ JSON
{
"creator_id": 5,
"company_id": 1001,
"id": 31,
"title": "Shop Demo Official",
"url": "https://shopee.vn/shop/123456789",
"type": 7,
"api_key": "",
"api_secret": "",
"foreign_id": "123456789",
"access_token": "",
"refresh_token": "",
"connected": 1,
"store": 2,
"settings": {
"receipt_warehouse": 3,
"shopee_access_expire_at": 1760014400,
"shopee_refresh_expire_at": 1762592000,
"shopee_auth_expire_time": 1791536000,
"shopee_region": "VN",
"shopee_shop_status": "NORMAL"
},
"status": 1,
"date_created": 1760000000,
"date_modified": 1760000000,
"date_last_synced": 1760003600,
"date_last_order_synced": 1760003600,
"date_last_hooked": 1760003000,
"date_webhook_registered": 0
}