Các vấn đề thường gặp khi đồng bộ kho và giá giữa Sapo và sàn TMĐT

Việc đồng bộ tồn kho và giá bán giữa Sapo và các Sàn Thương mại điện tử (TMĐT) như Shopee, Lazada, TikTok Shop là cực kỳ quan trọng để đảm bảo thông tin nhất quán, tránh tình trạng bán vượt hàng tồn hoặc sai giá. Tuy nhiên, trong quá trình đồng bộ, có thể phát sinh một số vấn đề do sự khác biệt về quy định, lỗi hệ thống hoặc thao tác người dùng.

Hướng dẫn này tổng hợp các vấn đề thường gặp nhất khi đồng bộ kho và giá giữa Sapo và các Sàn TMĐT, giải thích nguyên nhân và cung cấp các bước xử lý chi tiết, giúp bạn duy trì dữ liệu chính xác trên tất cả các kênh bán hàng.

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

Vấn đề / Thông báo lỗi	Nguyên nhân có thể	Cách xử lý / Giải pháp
Đồng bộ kho báo lỗi: error_holiday_ on_change_item: Shop is under vacation mode	Gian hàng Shopee của bạn đang được đặt ở chế độ "Tạm nghỉ" (Vacation Mode).	Truy cập Shopee Seller Center, vào phần Thiết lập Shop và tắt chế độ Tạm nghỉ. Sau đó, thực hiện đồng bộ lại kho/giá trên Sapo.
Sapo đồng bộ kho thành công, nhưng số lượng trên Shopee khác số lượng Sapo đồng bộ	Bạn hoặc nhân viên đã chỉnh sửa tồn kho trực tiếp trên Shopee Seller Center. Bạn đang sử dụng phần mềm quản lý kho/bán hàng khác song song với Sapo và phần mềm đó cũng đồng bộ lên Shopee. (Với TikTok) Sản phẩm đang tham gia CTKM nên không cập nhật kho ngay.	B1: Kiểm tra "Lịch sử đồng bộ kho" trên Sapo (tại mục quản lý kênh Shopee) để xác nhận lần cuối Sapo đồng bộ số lượng là bao nhiêu. B2: Nếu Sapo đã đồng bộ đúng, hãy liên hệ bộ phận hỗ trợ của Shopee để kiểm tra log thay đổi tồn kho trên Seller Center xem nguồn thay đổi đến từ đâu. Khuyến nghị: Chỉ nên quản lý và đồng bộ tồn kho từ một nguồn duy nhất (Sapo) để tránh xung đột. (Với TikTok) Chờ kết thúc CTKM hoặc kiểm tra lại sau.
Đồng bộ giá báo lỗi: The price of the most expensive sku divided by the price of the cheapest sku limit:5	Chênh lệch giá giữa phiên bản rẻ nhất và đắt nhất của cùng sản phẩm vượt quá 5 lần (quy định của Shopee).	Điều chỉnh lại giá bán của các phiên bản trên Sapo sao cho tỷ lệ chênh lệch giá giữa phiên bản cao nhất và thấp nhất không vượt quá 5 lần. Sau đó, đồng bộ lại giá.
Đồng bộ thất bại do hết hạn quyền truy cập gian hàng	Token (quyền truy cập) kết nối Sapo - Shopee đã hết hạn (thường sau 6 tháng kể từ lần kết nối/đăng nhập lại gần nhất).	Truy cập mục quản lý kênh Shopee trên Sapo và thực hiện Đăng nhập lại/Kết nối lại để làm mới quyền truy cập.
spec error : stock.business.update _normal_stock failed	Lỗi tạm thời từ phía hệ thống Shopee.	Chờ vài phút và nhấn "Đồng bộ lại" kho/giá cho sản phẩm/gian hàng đó.
Wrong model_id hoặc model_id not exist in sku/ wrong model hoặc Input item_id and model_id are not match	Sản phẩm trên Sapo đã bị thay đổi cấu trúc phiên bản (ví dụ: từ không có phiên bản thành có phiên bản, hoặc ngược lại) sau khi đã đăng bán/liên kết. Hoặc phiên bản tương ứng đã bị xóa trên Shopee Seller Center.	Cách 1 (Ưu tiên): Truy cập mục Sản phẩm Kênh bán hàng trên Sapo, chọn gian hàng Shopee, nhấn "Cập nhật dữ liệu sản phẩm" (chọn Toàn thời gian). Lưu ý: Thao tác này có thể làm mất liên kết sản phẩm hiện tại, bạn cần vào mục "Sản phẩm chưa liên kết" để liên kết lại các sản phẩm. Cách 2: Kiểm tra sản phẩm/phiên bản trực tiếp trên Shopee Seller Center xem còn tồn tại không. Nếu đã xóa, cần xử lý trên Sapo (hủy liên kết, xóa...).
Stock should be larger than reserved stock / Total stock must be more than reserved stock / less reserve stock limit, current reserve stock: xxx	Số lượng tồn kho bạn đang đồng bộ từ Sapo thấp hơn số lượng sản phẩm đã được đăng ký tham gia chương trình khuyến mãi (Flash Sale - FS, hoặc các CTKM khác có giữ kho) trên Shopee.	Tăng số lượng tồn kho của sản phẩm trên Sapo sao cho lớn hơn hoặc bằng số lượng đang tham gia khuyến mãi trên Shopee. Sau đó, đồng bộ lại kho. Đây được xem là một cảnh báo để bạn đảm bảo đủ hàng cho khuyến mãi.
Không đồng bộ tồn kho từ Sapo lên Shopee (Dù không báo lỗi)	Sản phẩm đó có thể đang tham gia một Chương trình khuyến mãi (CTKM) trên Shopee mà chương trình đó chặn việc cập nhật tồn kho từ bên ngoài.	Truy cập Shopee Seller Center, vào mục Kênh Marketing, kiểm tra các CTKM đang chạy. Gỡ sản phẩm đó ra khỏi CTKM đang chặn cập nhật kho, sau đó đồng bộ lại kho từ Sapo.
Đồng bộ tự động Thất bại - mã TRUE	Lỗi không xác định cụ thể từ phía hệ thống Shopee trả về qua API.	Nhấn "Đồng bộ lại" kho/giá cho sản phẩm/gian hàng đó. Nếu vẫn tiếp diễn, liên hệ hỗ trợ Sapo.
Không cập nhật đủ sản phẩm / Không xóa sản phẩm khỏi danh sách khi thao tác trên sàn	Lỗi phân trang tạm thời từ phía đối tác (Sapo hoặc Shopee) khi lấy dữ liệu sản phẩm về.	Sapo đã có điều chỉnh để khắc phục lỗi này. Nếu vẫn gặp, thử "Cập nhật dữ liệu sản phẩm" lại từ mục quản lý kênh Shopee trên Sapo.
The merchant/shop has multi warehouse. please input location id	Gian hàng Shopee của bạn đã được kích hoạt tính năng Quản lý đa kho trên Shopee Seller Center, nhưng Sapo chưa được cấu hình tương ứng.	Liên hệ bộ phận hỗ trợ của Sapo (1900 6750) và yêu cầu mở/kích hoạt tính năng đa kho cho gian hàng Shopee của bạn trên hệ thống Sapo để đồng bộ tương thích.
Đồng bộ kho báo lỗi 'attribute' is mandatory if item is under model level...	Shopee đã cập nhật và yêu cầu bắt buộc phải có một thuộc tính (attribute) nào đó cho ngành hàng này (trước đây không bắt buộc).	Truy cập Shopee Seller Center, tìm đến sản phẩm bị lỗi, bổ sung giá trị cho thuộc tính bắt buộc mà Shopee đang yêu cầu. Sau đó, quay lại Sapo và đồng bộ lại kho.

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

Vấn đề / Thông báo lỗi	Nguyên nhân có thể	Cách xử lý / Giải pháp
Đồng bộ kho Lazada sai (Đặc biệt với FBL/Dropship)	Sản phẩm tham gia FBL (Fulfilled by Lazada) hoặc Dropship: Cơ chế quản lý kho đặc biệt của Lazada có thể gây sai lệch khi Sapo cố gắng đồng bộ kho thường. Đơn hàng FBL vẫn đồng bộ về Sapo và trừ vào kho Sapo gây âm kho ảo.	Đối với sản phẩm FBL/Dropship, bạn không nên bật đồng bộ tồn kho từ Sapo lên Lazada cho sản phẩm đó. Kho hàng sẽ do Lazada quản lý. Nếu đơn FBL về gây âm kho Sapo, bạn cần tạo phiếu nhập kho thủ công trên Sapo để cân bằng lại hoặc loại trừ các đơn FBL khỏi báo cáo kho Sapo.
Đồng bộ báo lỗi null (Do SKU có ký tự đặc biệt)	Mã SKU của sản phẩm/phiên bản chứa ký tự đặc biệt mà API của Lazada không xử lý đúng khi đồng bộ.	Truy cập Lazada Seller Center, sửa lại Mã SKU cho sản phẩm/phiên bản đó, loại bỏ ký tự đặc biệt. Sau đó, quay lại Sapo, vào mục Sản phẩm Kênh bán hàng > Gian Lazada, nhấn "Cập nhật dữ liệu sản phẩm". Cuối cùng, đồng bộ lại kho/giá.
Đồng bộ thất bại: CHANNEL_INV_ NEGATIVE_SELLABLE	Sản phẩm đang tham gia một Chương trình khuyến mãi (CTKM) trên Lazada và có thể đang bị giới hạn cập nhật kho.	Truy cập Lazada Seller Center, vào mục Khuyến mãi, kiểm tra và ngắt sản phẩm đó ra khỏi CTKM đang chạy. Sau đó, đồng bộ lại kho từ Sapo.
Khởi tạo sản phẩm về Sapo bị thất bại: Product edit was blocked by tag...	Lỗi này thường xảy ra vào những ngày Sale lớn của Lazada (ví dụ: 10/10, 11/11...). Lazada tạm thời khóa việc chỉnh sửa/cập nhật thông tin sản phẩm (ngay cả khi sản phẩm không tham gia Sale) để đảm bảo hệ thống ổn định.	Chờ qua đợt Sale hoặc khi Lazada mở lại chức năng cập nhật sản phẩm, sau đó thực hiện lại thao tác "Cập nhật dữ liệu sản phẩm" trên Sapo.
Đồng bộ kho báo lỗi Có lỗi xảy ra khi đồng bộ kho: null (Gian hàng mới)	Gian hàng Lazada mới tạo chưa hoàn tất việc điền đầy đủ thông tin theo yêu cầu trên Seller Center (thông tin cửa hàng, kho, tài khoản...).	Truy cập Lazada Seller Center, kiểm tra và hoàn tất tất cả các thông tin còn thiếu trong hồ sơ gian hàng. Sau đó, quay lại Sapo và đồng bộ lại kho.
Đồng bộ kho báo lỗi No data to update (Liên quan đa kho)	Có thể do gian hàng của bạn trước đây đã được Lazada mở tính năng đa kho, nhưng sau đó lại bị đóng lại, gây ra sự không nhất quán với cấu hình trên Sapo.	Liên hệ bộ phận hỗ trợ của Sapo (1900 6750) và yêu cầu kiểm tra, thực hiện đóng/tắt tính năng đa kho cho gian hàng Lazada của bạn trên hệ thống Sapo để đồng bộ lại tương thích.

III. Các vấn đề thường gặp trên sàn Tiki

Vấn đề / Thông báo lỗi	Nguyên nhân có thể	Cách xử lý / Giải pháp
Lệch kho (Không đồng bộ kho)	Sản phẩm trên Tiki đang ở trạng thái "Tắt" (Inactive). Tiki không cho phép đồng bộ kho cho sản phẩm bị tắt.	Truy cập Tiki Seller Center, tìm sản phẩm đó và chuyển trạng thái sang "Bật" (Active). Sau đó, thực hiện đồng bộ lại kho từ Sapo.
Lỗi chọn liên kết kho Sapo với Tiki (Khi chỉ có 1 chi nhánh Sapo)	Bạn đang cố gắng kết nối chi nhánh Sapo duy nhất đó với một kho Tiki thứ hai, trong khi chi nhánh này đã được kết nối với một kho Tiki khác trước đó. Sapo quy định: 1 chi nhánh Sapo chỉ kết nối được với 1 kho Tiki.	Nếu muốn kết nối với kho Tiki mới, bạn cần: Ngắt kết nối chi nhánh Sapo hiện tại khỏi kho Tiki cũ. Hoặc, mua thêm gói chi nhánh Sapo để có chi nhánh riêng kết nối với kho Tiki mới.
"Có vấn đề xảy ra trong quá trình cập nhật dữ liệu sản phẩm sang đối tác Tiki. Vui lòng thử lại sau!" (Lỗi hàng loạt)	Token (quyền truy cập) kết nối Sapo - Tiki đã hết hạn.	Truy cập mục quản lý kênh Tiki trên Sapo và thực hiện Đăng nhập lại/Kết nối lại để làm mới quyền truy cập.
Lỗi đồng bộ kho: error warehouse, warehouse are not active	Kho hàng được chọn để liên kết trong cấu hình kênh Tiki trên Sapo không còn hoạt động hoặc đã bị thay đổi trên Tiki Seller Center.	Truy cập Tiki Seller Center, kiểm tra lại các kho hàng đang hoạt động. Sau đó, vào Cấu hình gian hàng Tiki trên Sapo, chọn lại đúng kho hàng đang hoạt động để liên kết và đồng bộ.

IV. Các vấn đề thường gặp trên sàn TikTok Shop

Vấn đề / Thông báo lỗi	Nguyên nhân có thể	Cách xử lý / Giải pháp
Lỗi "Bạn cần chọn ít nhất 1 chi nhánh để đồng bộ kho"	Bạn chưa thiết lập Kho lấy hàng và liên kết nó với Chi nhánh Sapo trong cấu hình đồng bộ kho của kênh TikTok Shop trên Sapo.	Truy cập TikTok Seller Center > Vận chuyển > Kho hàng, đảm bảo bạn đã tạo ít nhất một Kho lấy hàng. Sau đó, vào Cấu hình gian hàng TikTok trên Sapo > Cấu hình kho, chọn Chi nhánh Sapo và liên kết nó với Kho lấy hàng tương ứng trên TikTok Shop.
Lỗi đồng bộ giá: product status is invalid	Sản phẩm trên TikTok Shop đang ở trạng thái không hợp lệ (ví dụ: Bị khóa, Ngừng hoạt động, Chờ duyệt...) nên không thể cập nhật giá/kho.	Truy cập TikTok Seller Center, vào Quản lý Sản phẩm, kiểm tra và đảm bảo sản phẩm đó đang ở trạng thái Hoạt động (Active). Sau khi trạng thái sản phẩm trên sàn ổn định, bạn có thể: Đồng bộ lại thủ công: Nhấn nút đồng bộ lại cho từng sản phẩm bị lỗi trên Sapo. Sử dụng Công cụ Đồng bộ: Nếu có nhiều lỗi, sử dụng công cụ đồng bộ kho/giá hàng loạt của Sapo (nếu có) để cập nhật lại.
Lỗi đồng bộ kho: Stock count is invalid	Số lượng tồn kho bạn đang cố gắng đồng bộ lên TikTok Shop vượt quá giới hạn cho phép (Thường là 99,999 hoặc 999,999 tùy cài đặt).	Giảm số lượng tồn kho của sản phẩm trên Sapo xuống dưới mức giới hạn của TikTok Shop. Sau đó, đồng bộ lại kho.
Lỗi đồng bộ giá: E106585 : Các sản phẩm chứa các từ ngữ cấm...	Tên hoặc mô tả sản phẩm chứa các từ ngữ bị cấm theo quy định của TikTok Shop (ví dụ: "tốt nhất", "duy nhất", các từ liên quan đến y tế/sức khỏe không được phép...).	Rà soát lại Tên sản phẩm và Mô tả sản phẩm trên Sapo, xóa bỏ các từ ngữ bị cấm theo quy định của TikTok Shop. Sau đó, đồng bộ lại giá/sản phẩm.
Sapo đồng bộ kho thành công nhưng số lượng trên TikTok Shop khác (Tương tự Shopee)	Xem lại nguyên nhân và cách xử lý tương tự như mục "Sapo đồng bộ kho thành công, nhưng số lượng trên Shopee khác..." ở phần I.	Xem lại cách xử lý tương tự như mục "Sapo đồng bộ kho thành công, nhưng số lượng trên Shopee khác..." ở phần I.
Lỗi đồng bộ giá: price edit forbid	Sản phẩm đang tham gia một Chương trình khuyến mãi (Flash Sale, CTKM...) trên TikTok Shop mà chương trình đó chặn việc chỉnh sửa giá.	Chờ cho đến khi sản phẩm kết thúc Chương trình khuyến mãi đó trên TikTok Shop. Sau đó, bạn mới có thể đồng bộ lại giá từ Sapo.
Đồng bộ giá khác với giá gốc sản phẩm trên Sapo Core	Do sản phẩm trên Sapo được thiết lập áp dụng thuế. Giá đồng bộ lên Sàn sẽ là giá đã bao gồm thuế.	Đây là hành vi đúng dự kiến. Giá trên Sàn sẽ là giá cuối cùng khách hàng thấy (bao gồm thuế nếu có). Nếu bạn muốn giá trên Sàn bằng giá gốc Sapo, hãy vào chi tiết sản phẩm trên Sapo và tắt tùy chọn "Áp dụng thuế".
Lỗi đồng bộ giá: sku invalid error; detail:invalid sku	SKU của phiên bản sản phẩm trên Sapo và trên TikTok Seller Center không khớp nhau (thường do bạn đã xóa/sửa phiên bản trực tiếp trên Seller mà chưa cập nhật về Sapo).	Vào mục Sản phẩm Kênh bán hàng trên Sapo > Gian TikTok Shop, nhấn "Cập nhật dữ liệu sản phẩm" (Toàn thời gian) để lấy thông tin phiên bản mới nhất từ Sàn về. Sau đó, vào "Sản phẩm chưa liên kết" để liên kết lại sản phẩm/phiên bản cho đúng. Cuối cùng, đồng bộ lại giá/kho.
Lỗi đồng bộ kho: The SKU stock exceed limit	Số lượng tồn kho bạn đang đồng bộ từ Sapo vượt quá giới hạn tối đa cho phép của TikTok Shop (Thường là 999,999).	Giảm số lượng tồn kho của sản phẩm trên Sapo xuống dưới mức giới hạn tối đa của TikTok Shop. Sau đó, đồng bộ lại kho.

V. 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.