Một số lỗi thường gặp khi nhập file khách hàng trên Sapo OmniAI

Trong quá trình nhập file khách hàng lên hệ thống khi tạo khách hàng mới hoặc cập nhật thông tin các khách hàng đã có, có một số lỗi thường gặp sau đây và cách để bạn xử lý.

STT	Mã lỗi	Nguyên nhân	Cách xử lý
1	Customer must have a first name, phone number or email address	Tạo KH không có ít nhất 1 thông tin first_name/email/phone	Nhập ít nhất 1 thông tin là Tên, Số điện thoại hoặc email của khách hàng
2	is invalid email format	Email không có định dạng hợp lệ	Nhập định dạng email hợp lệ
3	Email or phone is taken	Trùng email hoặc số điện thoại khi ghi đè khách hàng	Kiểm tra lại thông tin của khách hàng bị trùng
4	Email or phone is taken	Trùng email hoặc số điện thoại khi cập nhật thông tin	Kiểm tra lại thông tin của khách bị trùng
5	expected field bool value 'yes' or 'no', got cell value 'YES'	Nhập giá trị thông tin "Nhận email quảng cáo" ngoài 2 giá trị cho phép yes/no	Nhập giá trị “yes” hoặc “no”
6	expected field value in ['male, female, other'], got cell value 'Nam'	Nhập giá trị thông tin "Giới tính" ngoài 3 giá trị cho phép Nam, Nữ và Khác	Nhập giới tính của khách hàng là “Nam”, “Nữ” hoặc “Khác”
7	expected field date format 'yyyy-MM-dd', got cell value '30/08/2003'	Nhập giá trị thông tin "Ngày sinh" sao định dạng yyyy-MM-dd	Nhập ngày sinh theo định dạng dd/mm/yyyy. Ví dụ: 01/07/2026
8	Country is not supported	Nhập thông tin quốc gia không nằm trong danh sách được hỗ trợ	Nhập tên hoặc mã quốc gia hơp lệ
9	first_name: is too long (maximum is 50 characters), last_name: is too long (maximum is 50 characters)	Tên khách hàng > 50 ký tự	Nhập “tên” khách hàng nhỏ hơn 50 ký tự
10	last_name: is too long (maximum is 50 characters)	Họ khách hàng > 50 ký tự	Nhập “họ” khách hàng nhỏ hơn 50 ký tự
11	address1: is too long (maximum is 255 characters), company: is too long (maximum is 255 characters)	Địa chỉ address1 > 255 ký tự	Nhập địa chỉ có số lượng ký tự nhỏ hơn 255 ký tự
12	zip: is too long (maximum is 20 characters)	zip > 20 ký tự	Nhập mã Zip có số lượng ký tự nhỏ hơn 20 ký tự
13	phone: is invalid phone format	SĐT định dạng không hợp lệ	Kiểm tra định dạng số điện thoại
14	note: is too long (maximum is 255 characters)	Ghi chú > 255 ký tự	Nhập ghi chú có số lượng ký tự tối đa 255 ký tự
15	Province is not supported	Tên tỉnh thành hoặc Mã tỉnh thành không hợp lệ (2 Cấp và 3 cấp)	Nhập tên tỉnh thành hoặc mã tỉnh thành hợp lệ
16	District is not supported	Tên quận huyện hoặc mã quận huyện không hợp lệ (3 cấp)	Nhập tên quận huyện hoặc mã quận huyện hợp lệ
17	Ward is not supported	Tên phường xã hoặc Mã phường xã không hợp lệ (2 Cấp và 3 cấp)	Nhập tên phường xã hoặc mã phường xã hợp lệ

Các mã lỗi này sẽ được gửi thông báo về email của tài khoản thực hiện việc nhập file. Bạn có thể kiểm tra email của mình (trong vòng 7 ngày sau khi nhập file) để nhận thông báo chính xác về kết quả nhập và điều chỉnh kịp thời.
Sau khi chỉnh sửa dữ liệu trên file theo đúng yêu cầu, bạn thao tác nhập lại file khách hàng.

Lưu ý:

Để nhập giá trị địa chỉ hợp lệ: Thông tin địa chỉ nhập địa chỉ hành chính theo 2 cấp (Tỉnh/thành phố - Phường/Xã) hoặc địa chỉ hành chính theo 3 cấp (Tỉnh/thành phố - Quận/Huyện - Phường xã) cần chính xác theo danh sách tại đây để đảm bảo hệ thống ghi nhận đúng.

Trợ lý Sapo