Lịch sử revision
Kết nối một gian hàng TikTok Shop
# Kết nối một gian hàng TikTok Shop Bài này dành cho người phụ trách gian hàng và kế toán cần biết một gian hàng đã được nối vào VOMA hay chưa, ai làm việc nối, và phải chuẩn bị gì trước khi bắt đầu. ## Cần chuẩn bị gì trước 1. Một gian hàng TikTok Shop còn hoạt động, và người đăng nhập được vào gian hàng đó bằng tài khoản chủ shop. 2. Một tài khoản VOMA thuộc đúng người bán (seller) mà bạn muốn gắn gian hàng vào. Gian hàng sẽ được gắn cho đúng người bán đang đăng nhập, không chọn lại được sau đó. 3. Kênh **TikTok Shop** đã có trong danh sách kênh của PIM và công tắc **Trạng thái kích hoạt** đang bật. Không cần chuẩn bị mã khóa hay chuỗi bí mật nào. Trước đây màn hình cấu hình kênh có bốn ô nhập khóa; các ô đó đã được bỏ, vì kết nối thật không dùng tới chúng. ## Kiểm tra kênh trên màn hình 1. Trong PIM, mở **Kênh bán hàng (Channels)** ở nhóm *Cài đặt hệ thống*. 2. Tìm thẻ **TikTok Shop**, mã kênh hiển thị bên dưới tên là `tiktok_shop`. 3. Xem nhãn ở góc phải thẻ: **Đang hoạt động** hoặc **Tạm tắt**. 4. Bấm **Cấu hình** để mở trang **Cấu hình kênh: TikTok Shop**. 5. Ở tab **Cấu hình chung & API**, sửa **Tên hiển thị kênh bán hàng** nếu cần, bật hoặc tắt **Trạng thái kích hoạt**, rồi bấm **Lưu Cấu Hình**. Nếu lưu được, màn hình hiện "Đã lưu cấu hình kênh thành công!". ## Việc ủy quyền gian hàng nằm ở đâu Ngay dưới phần cấu hình chung có khối **Trạng thái kết nối tài khoản sàn**. Khối này hiện chỉ có một câu thông báo: > Kết nối tài khoản sàn chưa được cấu hình tại màn hình này. Nói cách khác: **màn hình nghiệp vụ hiện không có nút bắt đầu ủy quyền**. Việc nối gian hàng do người quản trị hệ thống thực hiện. Đừng đi tìm nút "Kết nối" hay "Kiểm tra kết nối" — chúng đã bị gỡ vì trước đây không làm gì thật. ## Việc gì xảy ra khi ủy quyền Để bạn biết mình đang chờ điều gì, đây là trình tự thực tế: 1. Hệ thống tạo một đường dẫn tới **trang ủy quyền của TikTok Shop** và gắn kèm một mã dùng một lần. 2. Chủ gian hàng mở đường dẫn đó, đăng nhập TikTok Shop và bấm đồng ý cấp quyền. 3. TikTok gọi ngược về VOMA, kèm mã đã cấp. 4. VOMA hỏi TikTok danh sách **tất cả gian hàng** mà lần ủy quyền này bao phủ, rồi ghi mỗi gian hàng thành một dòng kết nối riêng. 5. Trình duyệt được đưa về PIM. Ba điểm nghiệp vụ đáng nhớ: - **Mã dùng một lần chỉ sống 10 phút.** Mở đường dẫn muộn hơn thì hệ thống báo mã không hợp lệ hoặc đã hết hạn, phải xin đường dẫn mới. - **Một lần ủy quyền có thể tạo nhiều dòng kết nối**, nếu tài khoản đó quản lý nhiều gian hàng. - **Một gian hàng chỉ thuộc về một người bán trong VOMA.** Nếu gian hàng đã được nối cho người bán khác, hệ thống từ chối và không ghi nửa vời. Muốn chuyển, phải gỡ kết nối cũ trước. ## Đọc trạng thái kết nối | Trạng thái | Ý nghĩa dễ hiểu | Ai tác động được | | --- | --- | --- | | `PENDING` | Dòng kết nối vừa được tạo, chưa dùng đủ | Hệ thống đặt; không có nút trên màn hình. | | `ACTIVE` | Đang tốt; đẩy hàng, đẩy tồn, nhận đơn đều chạy | Hệ thống đặt ngay sau khi ủy quyền xong. | | `EXPIRING` | Quyền sắp hết hạn, hệ thống đang chuẩn bị tự gia hạn | Hệ thống tự xử lý. Không cần thao tác. | | `EXPIRED` | Quyền đã hết hạn, không tự gia hạn được nữa | Phải ủy quyền lại từ đầu; nhờ người quản trị. | | `REVOKED` | Quyền bị thu hồi, hoặc người quản trị đã gỡ kết nối | Là mốc kết thúc. Dòng cũ được giữ làm lịch sử. | Cách hệ thống tự giữ kết nối sống: - Hệ thống bắt đầu gia hạn **trước khi quyền hết hạn 30 phút**, không đợi tới lúc hỏng. - Nếu lần gia hạn hỏng vì lý do tạm thời, hệ thống **chờ đúng 5 phút rồi thử lại**, và giữ nguyên quyền cũ trong lúc chờ. - Nếu sàn từ chối hẳn, dòng kết nối chuyển `EXPIRED`. - Nếu sàn báo VOMA không còn quyền, dòng kết nối chuyển `REVOKED` và dừng hẳn, không thử lại. ## Biết mình đã nối xong hay chưa Cách kiểm tra nhanh nhất không nằm ở trang cấu hình kênh, mà ở màn hình nhập hàng: 1. Trong PIM, mở **Kênh bán hàng (Channels)**. 2. Trên thẻ kênh, bấm **Nhập từ sàn**. 3. Xem ô chọn **Shop đã nối** ở đầu trang. Nếu ô này có tên gian hàng của bạn, kết nối đã sống. Nếu ô trống hoặc trang báo "Không thể tải dữ liệu nhập từ sàn.", kết nối chưa có hoặc đã hỏng. ## Cái gì không làm được trên màn hình hiện tại - Không có nút bắt đầu ủy quyền, không có nút "Kiểm tra kết nối". - Không có nút gỡ kết nối một gian hàng. Nút thùng rác trên thẻ kênh chỉ xóa **kênh** trong PIM cùng toàn bộ ánh xạ ngành hàng và thuộc tính, chứ không phải gỡ gian hàng khỏi sàn. - Nút **Thêm Kênh Mới** hiện chỉ hiện thông báo "Tính năng đăng ký kênh bán hàng mới đang được phát triển." - Không có bảng liệt kê các dòng kết nối kèm ngày hết hạn trên giao diện nghiệp vụ. ## Điểm cần người nghiệp vụ xác nhận - Cần xác nhận ai giữ tài khoản chủ gian hàng TikTok Shop và ai được phép bấm đồng ý ủy quyền. - Cần xác nhận quy trình xử lý khi kết nối chuyển `EXPIRED`: ai được báo, trong bao lâu phải nối lại. - Cần xác nhận với gian hàng nhiều shop thì mỗi shop được gắn cho một người bán riêng trong VOMA hay dùng chung một người bán.