Kênh TikTok Shop

Tích hợp TikTok Shop cho phép doanh nghiệp đồng bộ tự động sản phẩm, tồn kho và đơn hàng phát sinh từ sàn thương mại điện tử TikTok Shop về hệ thống quản trị OVIRO theo thời gian thực.

Cơ chế kết nối

TikTok Shop sử dụng cơ chế Ủy quyền OAuth 2.0 (OAuth Popup). Quá trình kết nối không yêu cầu nhập thủ công token của từng shop, mà hệ thống sẽ mở cửa sổ đăng nhập của TikTok Shop để chủ gian hàng trực tiếp cấp quyền cho ứng dụng OVIRO.

---

Quy trình 3 bước kết nối TikTok Shop

Bước 1: Chuẩn bị thông tin ứng dụng đối tác

Trước khi thêm kênh, quản trị viên cần đảm bảo thông tin ứng dụng đối tác đã được điền đầy đủ tại Cấu hình bán hàng đa kênh:

• Developer App ID: Lấy từ TikTok Shop Partner Center.
• Developer App Key: Khóa công khai của ứng dụng.
• Developer App Secret: Khóa bí mật của ứng dụng.

[!TIP] Ứng dụng trên TikTok Shop Partner Center cần được cấu hình quyền quản lý danh mục sản phẩm (Product), đơn hàng (Order), kho hàng (Fulfillment) và tin nhắn (IM/Chat).

---

Bước 2: Thêm kênh và Ủy quyền gian hàng

1. Vào menu Bán hàng đa kênh > Tích hợp đa kênh.
2. Nhấn nút Thêm kênh ở góc trên bên phải.
3. Trong cửa sổ Chọn kênh cần kết nối, nhấp chọn biểu tượng TikTok Shop.
4. Một cửa sổ popup của TikTok Shop sẽ xuất hiện:
   • Đăng nhập bằng tài khoản chủ sở hữu gian hàng TikTok Shop.
   • Chọn khu vực/quốc gia của shop (ví dụ: Việt Nam).
   • Đọc danh sách các quyền yêu cầu và bấm Authorize (Ủy quyền).
5. Sau khi ủy quyền thành công, popup sẽ tự động đóng lại. Hệ thống OVIRO tiếp nhận mã ủy quyền, sinh Access Token / Refresh Token và tạo bản ghi kênh mới với trạng thái Có hiệu lực.

---

Bước 3: Cấu hình tính năng và kho vận cho kênh

Sau khi kết nối thành công, nhấn nút Sửa (hoặc nhấn trực tiếp vào tên kênh) trong danh sách kênh để vào màn hình Cập nhật thông tin:

1. Thông tin chung & Đơn hàng

• Kho mặc định: Chọn kho hàng trong OVIRO sẽ chịu trách nhiệm trừ tồn kho và xuất hàng khi có đơn hàng mới từ TikTok Shop đổ về.
• Lưu đơn hàng vào cửa hàng: Chọn chi nhánh/cửa hàng tương ứng để ghi nhận doanh thu và báo cáo.
• Đơn vị vận chuyển mặc định: Gán đối tác vận chuyển mặc định của đơn TikTok Shop.
• Xử lý khi nhận webhook: Bật tính năng để đơn hàng được tạo tự động ngay khi khách đặt hàng trên TikTok.
• Chỉ đồng bộ đơn có ngày tạo sau: Thiết lập mốc thời gian bắt đầu lấy đơn, tránh kéo lại các đơn hàng cũ đã hoàn tất trước khi tích hợp.

2. Đồng bộ sản phẩm & Tồn kho

• Bật công tắc Bật tính năng trong phần Sản phẩm.
• Chuyển sang tab Mapping sản phẩm để tiến hành liên kết mã SKU của TikTok Shop với mã hàng hóa quản lý trên OVIRO.

3. Chat & CSKH

• Bật công tắc Bật tính năng trong phần Chat để nhận và phản hồi tin nhắn khách hàng từ TikTok Shop ngay trên giao diện OVIRO (nếu gói dịch vụ có hỗ trợ).

---

Duy trì và Khôi phục kết nối

Mỗi phiên ủy quyền OAuth của TikTok Shop có thời hạn sử dụng nhất định:

• Hệ thống tự động sử dụng Refresh Token để gia hạn phiên làm việc định kỳ trong nền.
• Nếu người dùng đổi mật khẩu tài khoản TikTok Shop hoặc thu hồi quyền trên Partner Center, trạng thái kênh có thể bị gián đoạn.
• Khi đó, quản trị viên chỉ cần vào lại Bán hàng đa kênh > Tích hợp đa kênh, tìm đến dòng kênh TikTok Shop tương ứng và nhấn nút Kết nối lại để ủy quyền lại mà không làm mất cấu hình kho và mapping sản phẩm đã cài đặt trước đó.

---

Lỗi thường gặp và cách xử lý