Các vấn đề thường gặp khi đăng bán sản phẩm đa sàn

Việc đăng bán sản phẩm lên nhiều sàn thương mại điện tử (TMĐT) cùng lúc giúp bạn mở rộng kênh bán hàng hiệu quả. Tuy nhiên, trong quá trình thao tác từ Sapo Omni lên các sàn như Shopee, Lazada, TikTok, bạn có thể gặp phải một số thông báo lỗi hoặc vấn đề do sự khác biệt về quy định, yêu cầu dữ liệu hoặc lỗi kết nối.

Hướng dẫn này tổng hợp các vấn đề thường gặp và cung cấp nguyên nhân cũng như cách xử lý chi tiết, giúp bạn khắc phục sự cố và đăng bán sản phẩm thành công.

I. Các vấn đề thường gặp khi đăng bán trên Shopee

Vấn đề / Thông báo lỗi	Nguyên nhân và Cách xử lý
Must contains all mandatory attribute	Nguyên nhân: Thiếu thông tin bắt buộc theo yêu cầu của Shopee cho ngành hàng sản phẩm. Cách xử lý: Kiểm tra lại các trường thông tin sản phẩm trong Sapo, đảm bảo đã điền đầy đủ các trường có dấu sao (*) hoặc các thuộc tính bắt buộc khác mà Shopee yêu cầu cho ngành hàng đó trước khi đăng bán.
Đăng bán Shopee: Invalid attribute. expected float for attribute_id: 100278 (hoặc ID khác)	Nguyên nhân: Nhập sai định dạng dữ liệu cho một trường thông tin số (ví dụ: Dung tích, Khối lượng). Shopee yêu cầu nhập số, không kèm đơn vị chữ (ml, kg...). Cách xử lý: Chỉ nhập số vào trường đó. Nếu là số thập phân, sử dụng dấu chấm (.), không dùng dấu phẩy (,). Ví dụ hợp lệ: 6.5.
Đăng bán Shopee không hiện Đơn vị vận chuyển (ĐVVC)	Nguyên nhân: Token (quyền truy cập) kết nối giữa Sapo và Shopee đã hết hạn. Cách xử lý: Truy cập phần quản lý kênh bán hàng trên Sapo, chọn gian hàng Shopee bị lỗi và thực hiện kết nối lại hoặc xác thực lại quyền.
Đăng bán Shopee báo lỗi khối lượng và kích thước không hợp lệ (check logistics fail,[{'fail_info': weight or size is invalid for the open channel)	Nguyên nhân: Khối lượng hoặc kích thước (sau khi quy đổi) của gói hàng vượt quá giới hạn cho phép của một hoặc nhiều đơn vị vận chuyển bạn đã bật. Cách xử lý: Xem lại quy định về kích thước và khối lượng của Shopee Kiểm tra mã ĐVVC báo lỗi trong thông báo (ví dụ: 5001-Nhanh, 5002-Tiết kiệm, 5000-Hỏa tốc). Điều chỉnh lại Kích thước (Dài/Rộng/Cao) và Khối lượng sản phẩm trên Sapo cho phù hợp. Hoặc, vào phần thiết lập vận chuyển khi đăng bán, bỏ chọn ĐVVC không hỗ trợ kích thước/khối lượng đó.
Đăng sản phẩm Shopee nhưng không đăng được phiên bản, do ảnh phiên bản < 800x800px	Nguyên nhân: Ảnh đại diện cho phiên bản sản phẩm có kích thước nhỏ hơn yêu cầu tối thiểu 800x800 pixels của Shopee. Cách xử lý: Chỉnh sửa hoặc thay thế ảnh phiên bản, đảm bảo tất cả ảnh đều đạt kích thước tối thiểu 800x800 pixels.
invalid field Image.ImageIdList: value '[]' must contain at least 1 elements hoặc global tier option image is not equal to tier one option num	Nguyên nhân: Nếu bạn đã thêm ảnh cho một vài phiên bản, thì tất cả các phiên bản khác cũng phải có ảnh. Hoặc, một trong các ảnh phiên bản có dung lượng vượt quá 1MB. Cách xử lý: Đảm bảo tất cả các phiên bản đều có ảnh đại diện được tải lên. Kiểm tra và đảm bảo dung lượng mỗi ảnh phiên bản đều dưới 1MB.
Đăng bán thất bại: Chưa chọn phương thức vận chuyển Shopee	Nguyên nhân: Hệ thống Sapo không thể lấy được danh sách đơn vị vận chuyển từ Shopee, thường do có một gian hàng Shopee khác đang kết nối bị hết hạn token. Cách xử lý: Vào phần quản lý kênh bán hàng trên Sapo, kiểm tra và kết nối lại tất cả các gian hàng Shopee đang liên kết.
Lỗi định dạng ngày tháng (`invalid field field_name= item_attr_value_ext_info...input_validator= VALIDATOR_DATE`) Item_id is not found	Nguyên nhân: Lỗi xảy ra khi bước tạo sản phẩm gốc trên Shopee bị thất bại (có thể do lỗi ngầm hoặc một lỗi khác không hiển thị rõ), nhưng Sapo vẫn tiếp tục thực hiện bước thêm phiên bản vào sản phẩm không tồn tại đó. Cách xử lý: Thử đăng bán lại sản phẩm từ đầu. Kiểm tra kỹ các thông tin sản phẩm xem có vi phạm quy định nào khác không.
Tên thuộc tính quá 14 ký tự	Nguyên nhân: Shopee giới hạn tên thuộc tính (ví dụ: "Màu sắc", "Kích thước") không được vượt quá 14 ký tự. Cách xử lý: Rút ngắn tên các thuộc tính sản phẩm trong Sapo trước khi đăng bán (ví dụ: "Màu Sắc Dài" -> "Màu Sắc").
price gap is greater than max limit	Nguyên nhân: Chênh lệch giá giữa phiên bản rẻ nhất và phiên bản đắt nhất của cùng một sản phẩm vượt quá giới hạn cho phép của Shopee (thường là 5-7 lần tùy ngành hàng). Cách xử lý: Điều chỉnh lại giá bán của các phiên bản sao cho tỷ lệ chênh lệch nằm trong giới hạn Shopee cho phép.
Product not found	Nguyên nhân: Lỗi chung do Shopee trả về, không rõ nguyên nhân cụ thể từ Sapo. Cách xử lý: Truy cập Shopee Seller Center, vào chi tiết sản phẩm đó (nếu đã được tạo một phần) để xem thông báo lỗi chi tiết hơn từ Shopee. Thử đăng bán lại sau vài phút.
variation option name length is greater than max limit (limit: 20)	Nguyên nhân: Tên giá trị của thuộc tính (ví dụ: "Xanh Dương Nhạt", "Size Lớn Nhất") vượt quá 20 ký tự. Cách xử lý: Rút ngắn tên các giá trị thuộc tính trong Sapo.
item.duplicate	Nguyên nhân: Sản phẩm bạn đang cố đăng đã tồn tại trên gian hàng Shopee (trùng lặp về tên, hình ảnh, mô tả...). Cách xử lý: Nếu muốn cập nhật sản phẩm cũ: Tìm sản phẩm đó trên Sapo và thực hiện cập nhật thay vì đăng mới. Nếu muốn đăng thành sản phẩm mới riêng biệt: Thay đổi đáng kể thông tin sản phẩm (Tên, mô tả, hình ảnh) để khác biệt với sản phẩm đã có.
Cannot create product because the shop is VN local shop and KYC not pass	Nguyên nhân: Gian hàng Shopee của bạn chưa hoàn tất quy trình Xác minh danh tính (KYC - định danh thuế và/hoặc định danh cá nhân). Cách xử lý: Truy cập Shopee Seller Center > Mục "Hồ sơ Shop" > "Thông tin định danh" và hoàn thành các thông tin theo yêu cầu của Shopee.
invalid logistic info, channel id: 5000 (max sku price over channel limit)	Nguyên nhân: Giá sản phẩm vượt quá mức giá tối đa cho phép đối với kênh vận chuyển Hỏa tốc (mã kênh 5000). Cách xử lý: Vào phần thiết lập vận chuyển khi đăng bán trên Sapo, bỏ chọn kênh vận chuyển "Hỏa tốc" cho sản phẩm này.

II. Các vấn đề thường gặp khi đăng bán trên Lazada

Vấn đề / Thông báo lỗi	Nguyên nhân và Cách xử lý
[C021: Id sku của người bán bị trùng lặp..] hoặc [THD_IC_ERR_F_IC_INFRA_PRODUCT_036: Insert sku outer id relation failed, outerId already exists...]	Nguyên nhân: Mã SKU bạn đang sử dụng đã tồn tại trên gian hàng Lazada của bạn (cho một sản phẩm hoặc phiên bản khác). Cách xử lý: Sử dụng một Mã SKU khác, chưa từng tồn tại trên Lazada cho sản phẩm/phiên bản này. Hoặc tìm sản phẩm/phiên bản đang dùng SKU đó trên Sapo và cập nhật thay vì đăng mới.
Invalid Request Format (Do ký tự đặc biệt)	Nguyên nhân: Trong trường "Mô tả sản phẩm" hoặc "Đặc điểm nổi bật" có chứa các ký tự đặc biệt không được Lazada hỗ trợ (ví dụ: ký tự ô vuông □). Cách xử lý: Kiểm tra và xóa bỏ các ký tự đặc biệt, ký tự không hợp lệ ra khỏi nội dung mô tả, đặc điểm nổi bật rồi thử đăng lại.
Seller not active, please check seller status	Nguyên nhân: Tài khoản gian hàng Lazada của bạn chưa được kích hoạt hoàn toàn hoặc đang bị tạm ngưng. Cách xử lý: Liên hệ Bộ phận hỗ trợ của Lazada (Lazada Seller Support) để kiểm tra và xác minh trạng thái hoạt động của gian hàng.
BIZ_CHECK_TOTAL_SALE_PROP_MAX_ITEMS: Total sale prop more than maxItems 2	Nguyên nhân: Sản phẩm có nhiều hơn 2 thuộc tính dùng để tạo phiên bản (ví dụ: bạn có cả Màu sắc, Kích thước, Chất liệu). Lazada chỉ cho phép tối đa 2 thuộc tính tạo phiên bản. Cách xử lý: Giảm số lượng thuộc tính tạo phiên bản của sản phẩm xuống còn tối đa 2 thuộc tính. Bạn có thể đưa thuộc tính thứ 3 vào tên phiên bản hoặc mô tả.
BIZ_CHECK_MANGROVE_RULE_QC: Kiểm tra chất lượng, (E130933) Sản phẩm không được bán trên Lazada...	Nguyên nhân: Nội dung sản phẩm (tên, mô tả, hình ảnh, ngành hàng...) chứa thông tin vi phạm chính sách về hàng hóa cấm/hạn chế kinh doanh của Lazada. Cách xử lý: Tham khảo kỹ Quy định về hàng hóa cấm/hạn chế của Lazada. Rà soát lại toàn bộ thông tin sản phẩm, loại bỏ các từ ngữ, hình ảnh có thể vi phạm. Nếu không xác định được lỗi cụ thể, liên hệ Lazada Seller Support để được hỗ trợ kiểm tra chi tiết.
[INV_PARAM_ILLEGAL: illegal parameter] (Thường do Kho âm)	Nguyên nhân: Có thể do giá trị tồn kho của sản phẩm/phiên bản đang là số âm (đôi khi xảy ra nếu dùng dữ liệu mẫu hoặc có lỗi đồng bộ). Cách xử lý: Đảm bảo số lượng tồn kho của sản phẩm và tất cả phiên bản đều là số không âm (>=0) trước khi đăng bán.
Item published item count reaches limit.	Nguyên nhân: Bạn đã đăng đạt số lượng sản phẩm tối đa cho phép trên gian hàng Lazada của mình. Cách xử lý: Kiểm tra giới hạn số lượng sản phẩm trên Lazada Seller Center. Xóa bớt các sản phẩm không còn kinh doanh hoặc liên hệ Lazada để hỏi về việc nâng giới hạn (nếu có thể).
[BIZ_CHECK_EXIST_OUTER_IMAGE: external image url not allowed.Description] hoặc [BIZ_CHECK_EXIST_OUTER_ DESCRIPTION_IMAGE...]	Nguyên nhân: Mô tả sản phẩm chứa hình ảnh được nhúng từ một nguồn bên ngoài (URL ảnh). Lazada không còn hỗ trợ điều này. Hoặc hình ảnh trong mô tả chứa các ký tự/nội dung text không được Lazada cho phép. Cách xử lý: Xóa tất cả hình ảnh ra khỏi phần Mô tả sản phẩm trên Sapo trước khi đăng lên Lazada. Đảm bảo các ảnh (nếu trước đó đã đăng thành công) không chứa text vi phạm. Thử đăng bán lại.
[BIZ_CHECK_EXIST_OUTER_IMAGE: external image url not allowed.MainImage] hoặc [BIZ_CHECK_EXIST_OUTER_MAIN_IMAGE...]	Nguyên nhân: Ảnh đại diện (ảnh bìa) của sản phẩm có kích thước nhỏ hơn yêu cầu tối thiểu 500x500 pixels của Lazada. Hoặc ảnh đại diện chứa các ký tự/nội dung text, logo, URL không được Lazada cho phép. Cách xử lý: Đảm bảo tất cả ảnh đại diện có kích thước tối thiểu 500x500 pixels. Xóa bỏ các text, logo, URL không hợp lệ khỏi ảnh đại diện. Thử đăng bán lại, có thể cần xóa ảnh bìa và chọn lại ảnh khác.
[Thông tin biến thể: BIZ_CHECK_EXIST_OUTER_IMAGE: hình ảnh: external image url not allowed.SkuImages]	Nguyên nhân: Ảnh đại diện của phiên bản sản phẩm có kích thước nhỏ hơn yêu cầu tối thiểu 500x500 pixels của Lazada. Cách xử lý: Đảm bảo tất cả ảnh của các phiên bản đều đạt kích thước tối thiểu 500x500 pixels.
[THD_IC_ERR_F_DOMAIN_IMAGE_00_01_003: duplicate image limit...]	Nguyên nhân: Sử dụng cùng một hình ảnh cho nhiều mục đích khác nhau trong cùng một sản phẩm (ví dụ: ảnh đại diện sản phẩm giống hệt ảnh của một phiên bản). Lazada yêu cầu ảnh phải khác nhau. Cách xử lý: Sử dụng các file ảnh khác nhau cho ảnh đại diện sản phẩm và ảnh đại diện của từng phiên bản.
Tên thuộc tính quá 20 ký tự	Nguyên nhân: Lazada giới hạn tên thuộc tính (ví dụ: "Màu sắc", "Kích thước") không được vượt quá 20 ký tự. Cách xử lý: Rút ngắn tên các thuộc tính sản phẩm trong Sapo trước khi đăng bán.
Không hỗ trợ thuộc tính (Custom attribute)	Nguyên nhân: Bạn đang sử dụng một thuộc tính tùy chỉnh (tự tạo) không nằm trong danh sách thuộc tính được Lazada định nghĩa sẵn cho ngành hàng đó. Cách xử lý: Chỉ sử dụng các thuộc tính có sẵn trong danh sách thuộc tính của Lazada cho ngành hàng tương ứng khi cấu hình sản phẩm trên Sapo.
Thông tin biến thể: C004 SellerSku: Seller Sku is required	Nguyên nhân: Một hoặc nhiều phiên bản sản phẩm đang bị thiếu Mã SKU. Cách xử lý: Kiểm tra và đảm bảo tất cả các phiên bản của sản phẩm đều được gán một Mã SKU duy nhất trên Sapo.
E005: Invalid Request Format (Do kích thước hoặc ký tự <>)	Nguyên nhân: Nhập sai định dạng cho trường thông tin Kích thước đóng gói (Dài/Rộng/Cao). Hoặc trong các trường text (tên, mô tả...) có chứa các ký tự < hoặc > không hợp lệ. Cách xử lý: Kiểm tra và nhập đúng định dạng số cho các trường kích thước. Xóa các ký tự < và > không cần thiết khỏi các trường text.
[The request has failed due to RPC runtime failure]	Nguyên nhân: Lỗi tạm thời từ hệ thống của Lazada. Cách xử lý: Chờ vài phút và thử đăng bán lại sản phẩm.
[App access frequency exceeds the limit. This ban will last X seconds]	Nguyên nhân: Bạn đã thực hiện quá nhiều yêu cầu đăng/cập nhật sản phẩm lên Lazada trong một khoảng thời gian ngắn, vượt quá giới hạn cho phép của API. Cách xử lý: Chờ hết khoảng thời gian bị giới hạn (X giây) như trong thông báo rồi thử lại. Thường thì việc giới hạn sẽ được gỡ bỏ vào ngày hôm sau.

III. Các vấn đề thường gặp khi đăng bán trên TikTok Shop

Vấn đề / Thông báo lỗi	Nguyên nhân và Cách xử lý
Không đồng bộ SP đăng bán lên Seller TikTok	Nguyên nhân: Đã đăng thành công trên Sapo, xem chi tiết trên TikTok Seller thấy sản phẩm, nhưng vào mục "Quản lý sản phẩm" trên TikTok Seller lại không thấy. Đây thường là lỗi đồng bộ dữ liệu từ phía TikTok. Cách xử lý: Liên hệ bộ phận hỗ trợ của TikTok Shop (TikTok Seller Support) để được hỗ trợ kiểm tra và đồng bộ lại sản phẩm.
seller tax number invalid	Nguyên nhân: Bạn chưa cung cấp hoặc thông tin thuế cung cấp trên TikTok Seller Center không hợp lệ. Cách xử lý: Truy cập TikTok Seller Center > Hồ sơ người bán > Thông tin thuế, kiểm tra và điền đầy đủ, chính xác thông tin theo yêu cầu.
Không hiển thị chi nhánh khi đăng bán	Nguyên nhân: Chưa chọn Kho/Chi nhánh đồng bộ trong cấu hình gian hàng TikTok trên Sapo. Hoặc Kho/Chi nhánh chưa được tạo/thiết lập trên TikTok Seller Center. Hoặc quyền kết nối giữa Sapo và TikTok bị lỗi. Cách xử lý: 1. Kiểm tra Cấu hình gian hàng TikTok trên Sapo, đảm bảo đã chọn đúng Chi nhánh/Kho đồng bộ tồn kho. 2. Kiểm tra trên TikTok Seller Center xem đã có Kho hàng được thiết lập chưa. Nếu chưa, tạo kho trên đó trước. 3. Nếu đã có Kho trên cả hai nền tảng mà vẫn lỗi, hãy thực hiện cấp quyền lại (re-authorize) cho gian hàng TikTok từ mục quản lý kênh bán hàng trên Sapo.
The sale attribute name or attribute ID should not be empty	Nguyên nhân: Có sự không khớp giữa các thuộc tính yêu cầu của ngành hàng trên TikTok Shop và các thuộc tính bạn đang cung cấp từ Sapo (do TikTok có thể đã cập nhật yêu cầu thuộc tính). Cách xử lý: Liên hệ bộ phận hỗ trợ của Sapo (Hotline 1900 6750) để báo cáo lỗi và yêu cầu cập nhật lại dữ liệu thuộc tính cho ngành hàng tương ứng với TikTok Shop.

IV. Hỗ trợ thêm

Trong quá trình sử dụng, nếu bạn gặp các vấn đề khác không được liệt kê ở trên, hoặc đã thực hiện theo hướng dẫn nhưng vẫn không khắc phục được lỗi, vui lòng liên hệ bộ phận hỗ trợ của Sapo qua Hotline 1900 6750 để được trợ giúp kịp thời.