Kết nối sàn TMĐT
Tổng quan kết nối sàn
Kết nối shop Shopee, Lazada, TikTok Shop với Hubport: luồng uỷ quyền, đồng bộ sản phẩm, tồn kho và đơn hàng
Hubport cho phép shop kết nối các gian hàng trên sàn thương mại điện tử để đồng bộ sản phẩm, đẩy tồn kho, nhận đơn hàng và xử lý giao hàng đơn sàn ngay trong Hubport. Mỗi gian hàng đã kết nối là một kênh (EcomPlatform Object).
Sàn được hỗ trợ
| Sàn | type | Phạm vi |
|---|---|---|
| Shopee | 7 | Shop Shopee Việt Nam (không hỗ trợ shop xuyên biên giới / tài khoản chính nhiều shop) |
| TikTok Shop | 9 | Shop TikTok Shop Việt Nam, người bán nội địa |
| Lazada | 11 | Seller Lazada Việt Nam, người bán nội địa |
Kết nối Haravan / WooCommerce hiện không hỗ trợ trên Hubport SaaS.
Điều kiện
- Người dùng có quyền
setting.sale(kết nối, đồng bộ, đẩy tồn). Các thao tác giao hàng đơn sàn cần quyềnorder.edit. - Ở Hubport SaaS, kết nối sàn là tính năng theo gói dịch vụ. Gói chưa có tính năng này trả HTTP 402:
{ "error": ["error_feature_requires_plan"], "detail": { "feature": "connector.marketplace" } }- Số gian hàng được kết nối và số đơn sàn mới được nhập mỗi tháng giới hạn theo gói. Vượt số gian hàng:
error_quota_limit_exceed. Vượt số đơn tháng: đơn mới không được tạo trong Hubport (kết quả đồng bộ của đơn đó cóerror=error_synced_order_monthly_limit_exceeded); đơn đã có vẫn được cập nhật, và đơn bị chặn sẽ được nhập lại ở lần đồng bộ sau khi còn hạn mức. - Một gian hàng sàn chỉ gắn được với một công ty Hubport.
Luồng sử dụng
- Kết nối gian hàng bằng OAuth: shop đăng nhập sàn và đồng ý uỷ quyền cho ứng dụng Hubport. Xem Kết nối gian hàng (OAuth). Không tạo kênh sàn bằng
POST /v1/ecomplatforms. - Đồng bộ sản phẩm và liên kết SKU sàn với biến thể Hubport: Đồng bộ sản phẩm, Liên kết sản phẩm.
- Đẩy tồn kho lên sàn cho các SKU đã liên kết: Đẩy tồn kho.
- Đơn hàng: đơn sàn được tự động nhập vào Hubport (sàn đẩy thông báo + đồng bộ định kỳ khoảng 10–15 phút làm lưới an toàn). Có thể đồng bộ chủ động: Đồng bộ đơn hàng.
- Giao hàng đơn sàn bằng logistics của sàn (sắp xếp lấy hàng, in phiếu giao hàng): Giao hàng đơn sàn.
- Theo dõi bản tin sàn gửi về và kết quả xử lý: Nhật ký đồng bộ.
Token và bảo mật
- Token truy cập sàn do Hubport giữ (mã hoá) và tự làm mới; API không bao giờ trả token cho client. Trạng thái kết nối xem ở trường
connectedcủa kênh. - Ứng dụng sàn (app key / partner key) là của Hubport; shop không cần đăng ký ứng dụng riêng trên sàn và không cung cấp khoá nào.
Webhook từ sàn
Shop không cần cấu hình webhook trên sàn. Thông báo đơn hàng, thay đổi uỷ quyền... được sàn gửi về ứng dụng của Hubport và Hubport tự định tuyến đến đúng kênh. Với TikTok Shop, Hubport tự đăng ký webhook cho shop khi kết nối (có thể đăng ký lại bằng POST /v1/ecomtiktokshop/webhooks/:channelid, xem Thông tin gian hàng).