Trung tâm trợ giúp Khách hàng Sapo
Xử lý lỗi thường gặp khi nhập file đơn hàng trên Sapo OmniAI

Trong quá trình nhập file đơn hàng hàng loạt, có thể bạn sẽ gặp một số lỗi khiến file không được tải lên thành công. Sapo đã tổng hợp các lỗi phổ biến nhất và chi tiết cách khắc phục ngay dưới đây để bạn có thể nhanh chóng hoàn tất công việc của mình.

A. Lỗi chung & cấu trúc file

Đây là những lỗi nghiêm trọng, thường khiến toàn bộ file không thể được xử lý.

Lỗi cột "STT" (Số thứ tự)

Thông báo lỗi: "Không tìm thấy STT để xác định đơn hàng" hoặc "STT bị lặp ở nhiều nhóm không liền nhau".

Nguyên nhân: Cột STT dùng để nhóm các dòng sản phẩm thành một đơn hàng. Lỗi xảy ra khi:

  • Dòng đầu tiên của đơn hàng không có STT.
  • Các dòng của cùng một đơn hàng không được xếp liền kề nhau.
  • Một số STT bị lặp lại ở các nhóm đơn hàng khác nhau.

Cách khắc phục: Đảm bảo mỗi đơn hàng có một STT duy nhất và các dòng sản phẩm của đơn đó phải được xếp liền kề nhau.

Lỗi thiếu cột bắt buộc

Thông báo lỗi: "File nhập của anh/chị thiếu cột bắt buộc [...] Vui lòng thử lại...".

Nguyên nhân: File Excel của bạn thiếu các cột tối thiểu mà hệ thống yêu cầu để tạo đơn.

Cách khắc phục: File của bạn phải có đủ các cột sau: STT, Tác động tồn kho, Số lượng. Nếu không có cột SKU hoặc Mã phiên bản, thì bắt buộc phải có thêm cột Tên sản phẩm và Giá bán.

Lỗi định dạng hoặc dung lượng file

Thông báo lỗi: "Dung lượng đơn nhập chỉ hỗ trợ tối đa 3 MB" hoặc "File nhập không khớp với kiểu dữ liệu".

Nguyên nhân:

  • File vượt quá dung lượng 3MB hoặc quá 3000 dòng.
  • File không được lưu ở định dạng .xlsx hoặc .csv.
  • Tên các cột trong file không khớp với file mẫu của Sapo.

Cách khắc phục: Luôn sử dụng file mẫu của Sapo, không đổi tên cột, và đảm bảo file không quá lớn. Nếu file lớn, hãy tách thành nhiều file nhỏ hơn.


B. Lỗi dữ liệu đơn hàng

Trường "Mã đơn hàng"

Thông báo lỗi: "Mã đơn hàng đã tồn tại trên hệ thống" hoặc "Mã đơn hàng không được vượt quá 50 ký tự".

Nguyên nhân: Mã đơn bạn nhập đã có trên hệ thống, hoặc dài hơn 50 ký tự.

Cách khắc phục: Sử dụng một mã đơn hàng mới, duy nhất. Nếu không cần mã riêng, bạn có thể để trống, hệ thống sẽ tự tạo.

Trường "Nguồn đơn hàng"

Thông báo lỗi: "Nguồn đơn hàng không được vượt quá 50 ký tự".

Nguyên nhân: Tên nguồn đơn hàng (kênh bán) bạn nhập quá dài.

Cách khắc phục: Rút gọn tên nguồn đơn hàng dưới 50 ký tự.

Trường "Ngày đặt hàng"

Thông báo lỗi:

  • "Định dạng ngày đặt hàng không hợp lệ, vui lòng nhập theo định dạng YYYY-MM-DD HH:mm."
  • "Ngày đặt hàng không được lớn hơn ngày ghi nhận file."
  • "Ngày đặt hàng không được sớm hơn 2 năm so với ngày ghi nhận file."

Nguyên nhân: Sai định dạng ngày, ngày ở tương lai, hoặc ngày quá xa trong quá khứ.

Cách khắc phục: Nhập ngày theo đúng định dạng YYYY-MM-DD HH:mm và đảm bảo thời gian hợp lệ.

Trường "Giảm giá đơn hàng" (% và VND)

Thông báo lỗi:

  • "Giảm giá đơn hàng chỉ được nhập tại một trong hai ô VND hoặc %, không được nhập cả hai"
  • "Chiết khấu (%) nhập số trong khoảng từ 0 đến 100"
  • "Mô tả giảm giá đơn hàng không được vượt quá 250 ký tự"

Nguyên nhân:

  • Nhập giảm giá ở cả 2 cột % và VND cho cùng một đơn hàng.
  • Nhập số % lớn hơn 100.

Cách khắc phục: Chỉ điền vào một trong hai cột giảm giá (% hoặc VND) và đảm bảo giá trị hợp lệ.


C. Lỗi dữ liệu sản phẩm và thuế

Trường "Tên sản phẩm" và "Tên phiên bản"

Thông báo lỗi: "Tên sản phẩm là bắt buộc" hoặc "Tên sản phẩm/phiên bản không được vượt quá 255 ký tự".

Nguyên nhân:

  • Hệ thống không tìm thấy sản phẩm qua SKU hoặc Mã phiên bản, và bạn cũng không điền Tên sản phẩm.
  • Tên bạn nhập quá dài.

Cách khắc phục: Nếu là sản phẩm tùy chỉnh (không có sẵn), bạn bắt buộc phải điền Tên sản phẩm và Giá bán. Rút gọn tên nếu quá dài.

Trường "Số lượng"

Thông báo lỗi: "Trường Số lượng là bắt buộc" hoặc "Số lượng sản phẩm phải là số lớn hơn 0...".

Nguyên nhân: Bỏ trống cột Số lượng, hoặc nhập không phải là số (ví dụ: chứa chữ).

Cách khắc phục: Cột Số lượng luôn phải được điền và là một số lớn hơn 0.

Trường "Giá bán"

Thông báo lỗi: "Trường Giá bán là bắt buộc" hoặc "Giá bán sản phẩm phải là số nguyên lớn hơn hoặc bằng 0".

Nguyên nhân: Không nhập giá bán cho sản phẩm tùy chỉnh, hoặc nhập giá trị không phải là số.

Cách khắc phục: Luôn nhập Giá bán cho sản phẩm không có sẵn trong kho.

Trường "Giảm giá sản phẩm"

Thông báo lỗi: "Giảm giá trên dòng sản phẩm phải là số nguyên lớn hơn 0".

Nguyên nhân: Nhập giá trị không phải là số.

Cách khắc phục: Đảm bảo giá trị giảm giá là một số.

Trường "Khối lượng"

Thông báo lỗi: "Khối lượng phải là số nguyên lớn hơn hoặc bằng 0".

Nguyên nhân: Nhập giá trị không phải là số.

Cách khắc phục: Đảm bảo khối lượng là một số.

Trường "Đơn vị"

Thông báo lỗi: "Đơn vị sản phẩm không được vượt quá 50 ký tự".

Nguyên nhân: Tên đơn vị tính quá dài.

Cách khắc phục: Rút gọn tên đơn vị.

Trường "Thuế" (Tỉ lệ và Số tiền)

Thông báo lỗi:

  • "Trường tỉ lệ thuế là bắt buộc" (khi đã nhập số tiền thuế).
  • "Số tiền thuế không được vượt quá X" (vượt quá giá trị sản phẩm).
  • "Số tiền thuế phải là số nguyên lớn hơn hoặc 0"

Nguyên nhân: Nhập sai logic về thuế, ví dụ chỉ nhập số tiền mà không nhập tỉ lệ, hoặc số tiền thuế lớn hơn giá trị hàng.

Cách khắc phục: Nhập đúng và đủ cả Tỉ lệ và Số tiền thuế. Nếu không có thuế, hãy để trống cả hai cột.


D. Lỗi thông tin giao hàng và vận chuyển

Trường "Phí giao hàng"

Thông báo lỗi: "Phí vận chuyển là số nguyên lớn hơn hoặc bằng 0".

Nguyên nhân: Nhập giá trị không phải là số.

Cách khắc phục: Đảm bảo phí giao hàng là một số.

Trường "Đối tác vận chuyển"

Hệ quả (Không báo lỗi dừng): Hệ thống sẽ tự động ghi nhận đối tác vận chuyển là "other" (khác).

Nguyên nhân: Khi đơn hàng có Trạng thái giao hàng là "Đã giao hàng" và Hình thức giao hàng là "Giao hàng", bạn đã để trống hoặc nhập sai mã đối tác vận chuyển.

Cách khắc phục: Với các đơn đã giao, bạn phải điền chính xác mã


E. Lỗi thông tin khách hàng

Trường "Số điện thoại" và "Email"

Thông báo lỗi: "Định dạng số điện thoại không hợp lệ" hoặc "Định dạng email không hợp lệ".

Nguyên nhân: Nhập sai cấu trúc SĐT hoặc email.

Cách khắc phục: Kiểm tra lại và nhập chính xác.

Trường "Địa chỉ giao hàng"

Thông báo lỗi: "Địa chỉ giao hàng bắt buộc phải truyền một trong các thông tin: Tên khách hàng, Số điện thoại hoặc Địa chỉ".

Nguyên nhân: Khi bạn đã điền Tỉnh/Thành, Quận/Huyện, hệ thống yêu cầu phải có thông tin người nhận.

Cách khắc phục: Nếu đơn hàng cần giao, bạn phải điền ít nhất một trong các trường sau: Họ, Tên, SĐT giao hàng, hoặc Địa chỉ.


F. Lỗi thông tin bổ sung

Trường "Ghi chú"

Thông báo lỗi: "Ghi chú đơn hàng không được vượt quá 500 ký tự".

Nguyên nhân: Nội dung ghi chú quá dài.

Cách khắc phục: Rút gọn ghi chú dưới 500 ký tự.

Trường "Tags"

Thông báo lỗi: "Đơn hàng chỉ được ghi nhận tối đa 50 tag" hoặc "1 tag không được vượt quá 250 ký tự".

Nguyên nhân: Nhập quá nhiều tag hoặc một tag quá dài.

Cách khắc phục: Giảm số lượng tag và rút gọn các tag quá dài.

Trường "Tham chiếu"

Thông báo lỗi: "Tham chiếu không được vượt quá 50 ký tự".

Nguyên nhân: Mã tham chiếu quá dài.

Cách khắc phục: Rút gọn mã tham chiếu dưới 50 ký tự.