Luồng kết nối kênh

Tổng quan 2 cơ chế kết nối đa kênh trong OVIRO (OAuth Popup và API Key Direct), vòng đời trạng thái và cách xử lý sự cố.

Trong hệ thống OVIRO, thao tác kết nối một kênh bán hàng mới bắt đầu từ nút Thêm kênh trên màn hình Tích hợp đa kênh (#/ecomchannel). Tùy thuộc vào nền tảng đối tác, quy trình sẽ rẽ theo 1 trong 2 cơ chế kỹ thuật riêng biệt.

Cửa sổ chọn kênh cần kết nối trong OVIRO

Sơ đồ tổng thể 2 luồng kết nối

Chi tiết 2 phương thức kết nối

Áp dụng cho các nền tảng thương mại điện tử và mạng xã hội có cơ chế ủy quyền người dùng:

Chuẩn bị trước: Doanh nghiệp cần hoàn thiện cấu hình App Developer (App ID, Secret Key, Callback URL) tại Cấu hình bán hàng đa kênh.
Kích hoạt ủy quyền: Khi người dùng bấm vào biểu tượng sàn, hệ thống gọi API lấy đường dẫn ủy quyền (getOauthUrl) và tự động mở một cửa sổ popup.
Người dùng cấp quyền: Đăng nhập tài khoản quản trị gian hàng/Fanpage/OA trên giao diện của đối tác và nhấn nút Đồng ý/Xác nhận ủy quyền.
Nhận phản hồi tự động: Sàn chuyển hướng kèm mã xác thực về máy chủ OVIRO qua Callback URL đã đăng ký. Hệ thống tự động ghi nhận Shop ID / Page ID, đóng popup và cập nhật danh sách kênh.

2. Phương thức API Key Direct (iPOS.vn)

Áp dụng cho các phần mềm POS quản trị nội bộ hoặc kênh tích hợp qua chuẩn API trực tiếp:

Không qua bước cấu hình nền: Không cần nhập trước thông tin tại trang Cấu hình bán hàng đa kênh.
Nhập trực tiếp trong form thêm kênh:
- Tên hiển thị của kênh.
- Chọn môi trường vận hành (Sandbox hoặc Production).
- API Endpoint (Push) và Access Token (Push) đẩy đơn sang iPOS.
- API Endpoint (Pull) kéo hóa đơn từ iPOS.
Lưu ngay lập tức: Bấm Lưu và Cài đặt, hệ thống kiểm tra và lưu trực tiếp bản ghi kênh vào cơ sở dữ liệu.

Vòng đời trạng thái của kênh

Mỗi kênh bán hàng sau khi tạo sẽ có một trong hai trạng thái:

Có hiệu lực (STATUS_ENABLE): Kênh đang hoạt động bình thường, hệ thống sẵn sàng nhận webhook, kéo đơn hàng mới và đẩy dữ liệu tồn kho.
Ngừng hoạt động (STATUS_DISABLE): Tạm dừng mọi hoạt động đồng bộ với kênh này.

Cơ chế làm mới và Kết nối lại

Với các kênh OAuth, mã truy cập (Access Token) có hạn dùng ngắn (vài giờ đến vài ngày). OVIRO tự động chạy tiến trình ngầm để làm mới token bằng Refresh Token mà không cần người dùng can thiệp.
Trong trường hợp tài khoản sàn bị đổi mật khẩu hoặc thu hồi quyền ủy quyền, token sẽ bị vô hiệu hóa. Người dùng chỉ cần vào Tích hợp đa kênh và bấm nút Kết nối lại tại dòng kênh tương ứng để xác thực lại phiên làm việc.

Bảng đối chiếu các loại kênh

Loại kênh	Phương thức	Cần Cấu hình nền	Cửa sổ popup	Thiết lập nâng cao sau kết nối
TikTok Shop	OAuth 2.0	Có	Có	Kho xuất, cửa hàng, mapping SKU, webhook đơn
Shopee	OAuth 2.0	Có	Có	Kho xuất, cửa hàng, mapping SKU, webhook đơn
Facebook	OAuth 2.0	Có	Có	Chọn Fanpage, bật chat CSKH, kho xuất đơn
Zalo OA	OAuth 2.0	Có	Có	Bật chat CSKH, phân quyền gửi tin ZNS
iPOS.vn	API Key Direct	Không	Không	Store ID, Brand ID, POS ID, khách hàng mặc định