MSO Cloud · Documentation

Kết nối sàn thương mại

Source: docs/guides/admin/marketplace-setup.md Updated 2026-09-21
On this page

Nối tài khoản người bán TikTok Shop, Shopee hoặc Lazada để đơn hàng, tồn kho và creator tự về theo lịch.

Đối tượng: chủ sở hữu hoặc quản trị viên tổ chức chạy mảng thương mại. Cần đọc trước: Kết nối dữ liệu.

Chuẩn bị#

  • Tổ chức phải có ít nhất một thương hiệu (/settings/brands). Mỗi kết nối gắn với đúng một thương hiệu, và số liệu về sau đều tách theo thương hiệu đó.
  • Người lấy khoá phải là quản trị viên của chính tài khoản người bán trên sàn.
Kết nối Khoá cần có Nạp về
TikTok Shop App key, App secret, access token và refresh token Đơn hàng, creator
Shopee Partner ID, Partner key, access token và refresh token Đơn hàng, tồn kho
Lazada App key, App secret, access token và refresh token Đơn hàng, tồn kho
Shopee · CSV không cần khoá Đơn hàng, từ file export
Lazada · CSV không cần khoá Đơn hàng, từ file export

Hai thẻ TikTok Affiliate và Warehouse vẫn hiện trong danh mục và vẫn lưu được khoá, nhưng chưa có trình đồng bộ: đừng chọn chúng làm đường nạp dữ liệu cho một tổ chức thật.

Các bước#

  1. /connectors → nhóm sàn thương mại → chọn sàn → + Kết nối.
  2. Điền Nhãn, chọn Thương hiệu, dán khoá. Khoá được mã hoá ngay khi lưu và không hiển thị lại; muốn đổi thì dán khoá mới đè lên.
  3. Bấm Kiểm tra. Kết quả xanh nghĩa là khoá đọc được, chưa nghĩa là dữ liệu lịch sử đã về đủ.
  4. Lưu. Từ đây kết nối chạy theo lịch riêng của sàn và luôn kéo lùi một cửa sổ ngày để nhận các đơn được sàn cập nhật muộn.
  5. Mở Đối soát dữ liệu (/validation) và đối chiếu một file export gốc của sàn với số hệ thống đã nạp, trước khi coi kết nối là xong.

Nếu sàn chưa cấp được khoá API, dùng biến thể CSV của chính sàn đó: xuất file từ trang quản trị người bán rồi nạp qua Tải CSV/Excel. Số lên cùng một chỗ, chỉ khác đường vào.

Khi có gì đó không đúng#

Hiện tượng Nguyên nhân thường gặp Cách xử lý
Không thấy thẻ kết nối sàn nào workspace của tổ chức không chạy mảng thương mại Đây là chủ ý của gói khởi tạo; xem Loại tổ chức.
Kiểm tra đỏ ngay sau khi dán khoá token hết hạn hoặc sai môi trường Lấy lại token từ trang quản trị người bán rồi dán đè.
Đơn về nhưng thiếu vài ngày gần nhất sàn chốt số muộn Chờ chu kỳ đồng bộ kế tiếp; cửa sổ kéo lùi sẽ bù.
Đơn cũ không về khoảng lịch sử nằm ngoài cửa sổ kéo lùi Cần một đợt nạp lịch sử riêng; báo đội vận hành dữ liệu.

Liên quan#