Lịch sử revision
Chuẩn bị dữ liệu Shopee bằng xuất tệp
# Chuẩn bị dữ liệu Shopee bằng xuất tệp Bài này dành cho nhân viên nghiệp vụ phụ trách dữ liệu sản phẩm, muốn dùng VOMA để chuẩn bị dữ liệu đăng bán trên Shopee. Đọc bài **Tổng quan bán hàng đa kênh** trước: hiện tại **chỉ TikTok Shop** có đường nối API thật. Bài này nói về phần còn dùng được cho Shopee — một đường thủ công, tách rời hoàn toàn khỏi đường nối trực tiếp. ## Vì sao Shopee vẫn có màn hình cấu hình PIM dùng chung một khung màn hình **Kênh bán hàng (Channels)** cho mọi sàn: ánh xạ danh mục, ánh xạ thuộc tính, và một tab cấu hình riêng trên từng sản phẩm. Khung này được dựng sẵn cho nhiều sàn, và Shopee dùng lại được phần **chuẩn bị dữ liệu** của khung đó. Điều Shopee không có là phần **gửi đi**: không có tài khoản gian hàng nối API, không có worker đẩy hàng hay đẩy tồn, không có nhận đơn tự động. Kết quả cuối của nhánh Shopee luôn là **một tệp CSV bạn tự tải lên Shopee**, không phải một lượt đẩy chạy ngầm. ## Bước 1 — Ánh xạ ngành hàng Shopee 1. Trong PIM, mở **Kênh bán hàng (Channels)**. 2. Trên thẻ **Shopee Việt Nam**, bấm **Cấu hình**. 3. Mở tab **Ánh xạ danh mục** — thao tác giống hệt bước ánh xạ danh mục của TikTok Shop, chỉ khác là mã và tên danh mục ở đây là của Shopee. 4. Bấm **Lưu Ánh Xạ Đồng Loạt**. ## Bước 2 — Khai thuộc tính Shopee đòi Vẫn ở trang cấu hình kênh Shopee, mở tab **Ánh xạ thuộc tính** và khai tương tự TikTok Shop: **Thuộc tính PIM**, **Cột sàn yêu cầu**, **Tên hiển thị thuộc tính sàn**, **Áp dụng cho danh mục sàn** (hoặc để `-- Áp dụng Global --`). ## Bước 3 — Cấu hình từng sản phẩm cho Shopee 1. Mở **Sản phẩm**, chọn sản phẩm cần chuẩn bị cho Shopee. 2. Ở thanh điều hướng bên phải, bấm **Cấu hình đa kênh**. 3. Chọn tab **Cấu hình Shopee** (tách riêng với tab **Cấu hình TikTok Shop** — bật hay tắt tab này không ảnh hưởng tới TikTok Shop và ngược lại). 4. Bật công tắc **Niêm yết trên Shopee Việt Nam**. 5. Điền các khối giống hệt cấu trúc của TikTok Shop: **Ghi đè thông tin cơ bản** (tiêu đề, mô tả riêng cho Shopee, **Mã sản phẩm trên sàn**), **Ngành hàng Marketplace** (tự khớp nếu Bước 1 đã đúng), **Bảng giá riêng trên sàn** (theo từng biến thể, bỏ trống thì dùng giá gốc), **Thuộc tính đặc thù sàn** (theo Bước 2). 6. Bấm **Lưu & Hiển thị**. Bấm lưu ở đây **không gửi gì lên Shopee**. Nó chỉ ghi lại dữ liệu để tệp xuất ở bước sau có nội dung đúng. ## Xuất tệp và tự đăng lên Shopee 1. Ở màn hình **Sản phẩm**, tích chọn các sản phẩm đã cấu hình xong cho Shopee. 2. Bấm **Xuất dữ liệu** → **Xuất file Shopee (Đã chọn)**. 3. Tệp CSV tải về có các cột: mã sản phẩm, mã ngành hàng Shopee, tên sản phẩm, mô tả, mã SKU, giá, cân nặng, dài/rộng/cao, mã vạch, mã HS, mã thuế, cùng các cột thuộc tính đã khai ở Bước 2. 4. Tự tải tệp này lên công cụ tải hàng loạt (Mass Upload) của Shopee Seller Centre. Có thể lọc theo trạng thái listing hoặc chỉ xuất đúng các sản phẩm đã tích chọn, giống cách xuất file TikTok. ## Khác biệt bắt buộc phải nhớ so với TikTok Shop - **Không có gì tự động.** Đổi giá, đổi tồn, đổi ảnh trong PIM sau khi đã xuất tệp không tự cập nhật gì trên Shopee. Muốn cập nhật, phải xuất tệp lại và tự tải lên lại. - **Không có tồn kho tự đẩy.** Toàn bộ cơ chế "tồn khả dụng tự đẩy khi kho thay đổi" mô tả ở bài đồng bộ tồn kho chỉ áp dụng cho TikTok Shop. Số tồn trên Shopee do người bán tự cập nhật tay hoặc qua công cụ riêng của Shopee. - **Không có đơn nào từ Shopee tự về VOMA.** Đường nhận đơn tự động (webhook, đối chiếu SKU, khớp khách hàng…) chỉ chạy cho TikTok Shop. Nếu doanh nghiệp thật sự bán trên Shopee, đơn của Shopee không xuất hiện trong OMS trừ khi được nhập tay. - **Không có bước ủy quyền gian hàng nào.** Không có OAuth, không có trạng thái kết nối `ACTIVE`/`EXPIRED` cho Shopee, vì không có tài khoản gian hàng nào được nối. ## Cái gì không làm được trên màn hình hiện tại - **Không có nút "Đẩy lên Shopee".** Chỉ có xuất tệp. - **Không nhận đơn, không đẩy tồn, không đẩy giá tự động cho Shopee**, dù màn hình cấu hình trông giống hệt TikTok Shop. - **Không có cảnh báo riêng cho Shopee** kiểu bảng lỗi `MISSING_CATEGORY_MAPPING`, `TITLE_TOO_LONG`… của TikTok Shop. Tệp xuất ra dù thiếu dữ liệu vẫn xuất được; việc kiểm tra đủ điều kiện là do Shopee Seller Centre báo khi tải file lên, không phải VOMA báo trước. - **Không có nhãn Nháp/Hiển thị riêng cho Shopee.** Trạng thái sản phẩm dùng chung với PIM. ## Điểm cần người nghiệp vụ xác nhận - Cần xác nhận doanh nghiệp có đang thực sự dùng đường xuất tệp này để bán trên Shopee hay không, vì nếu không có gian hàng Shopee thật đang hoạt động thì phần cấu hình này chỉ mang tính chuẩn bị sẵn. - Nếu có bán trên Shopee, cần xác nhận đơn từ Shopee hiện đang được nhập vào OMS bằng cách nào (nhập tay, hay không nhập vào VOMA mà xử lý hoàn toàn ở nơi khác). - Cần xác nhận ai chịu trách nhiệm xuất lại và tải lại tệp mỗi khi giá hoặc tồn trên Shopee cần cập nhật, vì không có cơ chế nhắc hay tự động. - Cần xác nhận việc thiếu bảng lỗi trước khi xuất (khác với TikTok Shop) có phải là khoảng trống cần bổ sung không, hay nghiệp vụ chấp nhận kiểm tra trên Shopee Seller Centre.