Lịch sử revision
Đồng bộ tồn kho và lỗi thường gặp khi đẩy hàng lên sàn
# Đồng bộ tồn kho và lỗi thường gặp khi đẩy hàng lên sàn Bài này dành cho kế toán kho và nhân viên vận hành. Bài trả lời hai câu hay hỏi nhất: "số trên sàn lấy từ đâu ra" và "lượt đẩy hỏng thì sửa ở đâu". ## Số tồn đẩy lên sàn được tính thế nào Số gửi lên sàn là **tồn khả dụng**, tính theo công thức: > Tồn khả dụng = Tồn thực tế − Hàng đang giữ cho đơn Ba điểm cần nhớ: - Số này gom theo **kho**, không gom theo từng vị trí trong kho. - Kho được chọn là kho chứa vị trí vừa có thay đổi. Kho khác không bị tính vào lượt đẩy đó. - Nếu kết quả âm, hệ thống gửi **0**, không gửi số âm. Vì đã trừ hàng đang giữ, con số trên sàn thường **nhỏ hơn** con số ở màn hình **Tồn kho (Inventory)**. Đó là đúng, không phải lỗi. ## Khi nào tồn được đẩy lên sàn Mỗi lần số tồn thay đổi vì một trong các thao tác dưới đây, hệ thống tạo ngay một lượt đẩy: 1. Điều chỉnh tồn ở màn hình **Tồn kho (Inventory)**. 2. Chuyển hàng giữa hai vị trí. Lúc này có **hai** lượt đẩy: một cho kho nguồn, một cho kho đích. 3. Hoàn tất một phiếu nhập ở màn hình **Nhập kho (Inbound)**. 4. Tạo lệnh xuất kho cho một đơn, tức là bắt đầu giữ hàng. 5. Hủy lệnh xuất kho, tức là nhả hàng đang giữ. 6. Giao hàng ở màn hình **Xuất kho (Fulfillment)**, tức là trừ tồn thật. Nghĩa là số trên sàn giảm ngay khi VOMA **giữ** hàng cho một đơn, chứ không đợi tới lúc giao. Đây là cách chống bán quá số lượng. ## Điều kiện để một lượt đẩy tồn đi được Một mã hàng chỉ đẩy được tồn lên sàn khi **đã có liên kết giữa mã hàng trong VOMA và mã hàng trên sàn**. Liên kết này được tạo khi sản phẩm được đẩy lên sàn thành công. Mã hàng chưa có liên kết sẽ bị bỏ qua với lý do ghi rõ: "No ChannelListingLink exists for this SKU" — nghĩa là mã hàng này chưa từng lên sàn qua VOMA. Muốn đẩy được tồn, phải đưa sản phẩm lên sàn trước. ## Chiều ngược lại: tồn của sàn về VOMA **Sàn không ghi đè tồn của VOMA.** Số tồn bên sàn chỉ được đọc để xem, tại màn hình **Nhập từ sàn**, ở cột **SKU / giá / tồn**, hiển thị dạng "Tồn 12". Con số đó không chảy vào kho. Ở cùng màn hình đó, mỗi mã hàng còn có nhãn **Đã linked** hoặc **Chưa linked**. Chỉ cần **một** mã hàng của sản phẩm đã được liên kết là cả sản phẩm đó không tích chọn được nữa, để tránh nhập trùng. ## Bảng tra lỗi | Lỗi gặp phải | Nghĩa là gì | Sửa ở đâu trong VOMA | | --- | --- | --- | | `MISSING_CATEGORY_MAPPING` | Ngành hàng chưa ánh xạ, hoặc mã ánh xạ không phải chữ số | PIM → **Kênh bán hàng (Channels)** → **Cấu hình** → tab **Ánh xạ danh mục** | | `MISSING_REQUIRED_ATTRIBUTE` | Thuộc tính sàn bắt buộc chưa có giá trị | Sản phẩm → **Cấu hình đa kênh** → khối **Thuộc tính đặc thù sàn** | | `DUPLICATE_VARIANT_OPTIONS` | Hai biến thể trùng cặp phân loại | Sản phẩm → *Thông tin bán hàng* → sửa các lựa chọn phân loại cho khác nhau | | `INVALID_SKU_PRICE` | Biến thể có giá bằng 0 | Cột **Giá bán \*** ở bảng phân loại, hoặc **Giá bán trên sàn** | | `MISSING_PACKAGE_WEIGHT` / `MISSING_PACKAGE_DIMENSIONS` | Thiếu cân nặng hoặc kích thước đóng gói | Sản phẩm → mục *Vận chuyển* → **Cân nặng \***, **Chiều dài**, **Chiều rộng**, **Chiều cao** | | `TITLE_TOO_LONG` | Tên sản phẩm dài quá 200 ký tự | Ô **Tên sản phẩm \***, hoặc **Tiêu đề sản phẩm** riêng cho kênh | | `12052217` | Mã ngành hàng thuộc cây ngành hàng đời cũ | Tab **Ánh xạ danh mục** — lấy lại mã theo cây ngành hàng mới | | `12052097` | Kho gửi lên không phải kho bán hàng của gian hàng | Không sửa được trên màn hình. Chuyển cho người quản trị. | | `12052241` | Sàn không nhận cách khai phân loại của biến thể | Sản phẩm → *Thông tin bán hàng* → rà lại **Tên nhóm phân loại** và các lựa chọn | | `36009005` / `105002` | Quyền truy cập gian hàng hết hiệu lực | Không sửa được trên màn hình. Hệ thống tự gia hạn; nếu lặp lại, phải ủy quyền lại gian hàng. | | `105005` | Gian hàng đã thu hồi quyền của VOMA | Phải ủy quyền lại gian hàng. Nhờ người quản trị. | | `36009004` / `106001` | Yêu cầu gửi lên sàn không hợp lệ hoặc lệch giờ | Không sửa được trên màn hình. Chuyển cho người quản trị. | | `No ChannelListingLink exists for this SKU` | Mã hàng chưa từng lên sàn nên chưa có liên kết | Đưa sản phẩm lên sàn trước, rồi tồn mới đẩy được | | `CHANNEL_ACCOUNT_ID is required` | Kho chưa biết đẩy tồn về gian hàng nào | Không sửa được trên màn hình. Chuyển cho người quản trị. | Cách đọc bảng: nhóm mã bắt đầu bằng chữ (`MISSING_`, `TITLE_`, `INVALID_`, `DUPLICATE_`) là **VOMA tự phát hiện trước khi gửi** — nghiệp vụ sửa được. Nhóm mã toàn chữ số là **sàn từ chối sau khi đã gửi** — phần lớn phải nhờ người quản trị, trừ hai mã ngành hàng và phân loại. ## Lượt đẩy hỏng thì hệ thống làm gì Hai đường đẩy có cách xử lý khác nhau, cần phân biệt: - **Đẩy sản phẩm và đẩy tồn từ lớp kênh sang sàn**: nếu hỏng vì lý do tạm thời, hệ thống **tự thử lại sau 5 phút**, và ghi lại lý do cùng số lần đã thử. Nếu sàn thu hồi quyền, lượt đó dừng hẳn, không thử lại nữa. - **Đẩy tồn từ kho sang lớp kênh**: thử tối đa **3 lần liền**. Hết ba lần thì lượt đó nằm lại ở trạng thái hỏng và **không có ai quét lại**. Đây là điểm yếu cần biết: một lượt đẩy tồn hỏng vì mạng chập có thể nằm im vĩnh viễn. Cách phòng ngừa của nghiệp vụ rất đơn giản: sau khi làm một thao tác kho lớn, kiểm tra lại con số hiển thị trên Seller Center. Nếu lệch, tạo một điều chỉnh tồn nhỏ (ví dụ cộng 1 rồi trừ 1) để buộc hệ thống đẩy lại. ## Cái gì không làm được trên màn hình hiện tại - **Không có màn hình nào xem hàng chờ đồng bộ.** Lý do hỏng, số lần đã thử và thời điểm thử lại đều được lưu nhưng không hiện ra ở PIM, OMS hay WMS. - **Không có nút "Đẩy lại".** Muốn đẩy lại một lượt hỏng, phải nhờ người quản trị. - **WMS không có mục nào liên quan tới kênh hay sàn** trong menu. Việc đẩy tồn chạy hoàn toàn ngầm. - **Không đặt được tồn riêng cho sàn.** Số đẩy lên luôn là tồn khả dụng thực tế, không giữ lại phần dự phòng. - **Không chọn được kho nào đẩy lên sàn.** Hệ thống lấy kho của vị trí vừa thay đổi. ## Điểm cần người nghiệp vụ xác nhận - Cần xác nhận doanh nghiệp có muốn giữ lại một phần tồn dự phòng không bán trên sàn hay không; hiện hệ thống đẩy toàn bộ tồn khả dụng. - Cần xác nhận với gian hàng bán từ nhiều kho thì số nào nên hiển thị trên sàn. - Cần xác nhận ai theo dõi các lượt đẩy tồn hỏng, vì hiện không có màn hình và không có cơ chế quét lại. - Cần xác nhận ngưỡng chấp nhận được của độ lệch giữa số tồn trong VOMA và số trên Seller Center.