CRMKhách hàng
Cập nhật thông tin chung
Cập nhật các thông tin cơ bản của khách hàng.
Endpoint
POST /site/customers/updategeneralinfo
Headers
| Key | Value | Bắt buộc | Mô tả |
|---|---|---|---|
SiteTenantId | {tenant_id} | Có | ID của công ty/tenant. |
SiteAuthorization | {jwt_token} | Có | Token định danh khách hàng. |
Workflow & Logic
Cho phép khách hàng thay đổi thông tin cá nhân như họ tên, ngày sinh, email, địa chỉ.
Quy trình xử lý
-
Xác thực: Kiểm tra quyền truy cập thông qua JWT.
-
Kiểm tra tính hợp lệ (Validation):
full_namekhông được để trống.email(nếu có) phải đúng định dạng.- Mỗi ID trong
avatar_file_id_listphải là file thuộc shop hiện tại.
-
Lưu dữ liệu: Cập nhật toàn bộ các trường bên dưới (trường không gửi sẽ bị ghi đè thành rỗng/0, nên Frontend cần gửi đủ dữ liệu hiện tại).
-
Xóa Cache: Xóa cache thông tin khách hàng để đảm bảo các request sau lấy được dữ liệu mới nhất.
Request Body
{
"full_name": "Nguyễn Văn A",
"gender": 3,
"birthday": "20/05/1995",
"email": "khachhang@example.com",
"address": "123 Đường ABC",
"region_id": 1,
"sub_region_id": 10,
"sub_sub_region_id": 100,
"salutation": "Anh",
"address_line_2": "",
"delivery_note": "Giao giờ hành chính",
"legacy_province_name": "",
"legacy_district_name": "",
"legacy_ward_name": "",
"avatar_file_id_list": [12, 13],
"representative_id": ""
}Response Schema (200)
Trả về đối tượng Customer Object sau khi đã cập nhật.
Lỗi thường gặp (422)
| Mã lỗi | Mô tả |
|---|---|
error_full_name_required | Tên không được để trống. |
error_email_invalid | Email không hợp lệ. |
error_avatar_file_id_invalid | ID file ảnh đại diện không hợp lệ. |
error_avatar_file_not_found | File ảnh đại diện không tồn tại hoặc không thuộc shop. |
error_customer_not_found | Không tìm thấy khách hàng. |
Lỗi hệ thống (500): error_update_info.