CRMKhách hàng
Cập nhật thuộc tính mở rộng khách hàng
Cập nhật các thuộc tính mở rộng (attribute_detail) của khách hàng.
Endpoint
POST /site/customers/updateattributedetail
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
API này cho phép đối tác bên thứ ba hoặc frontend cập nhật các thông tin thuộc tính mở rộng của khách hàng. Cấu trúc dữ liệu tương đương với phần cập nhật thuộc tính trong quản lý sản phẩm.
Quy trình xử lý
- Xác thực: Kiểm tra quyền truy cập thông qua JWT của khách hàng.
- Xác định khách hàng: Lấy thông tin khách hàng hiện tại từ session.
- Xử lý dữ liệu: Nhận mảng
attribute_detailtừ body và thay thế toàn bộ giá trị thuộc tính mở rộng hiện tại của khách hàng. - Phản hồi: Trả về Customer Object sau khi cập nhật. Nhóm thuộc tính áp dụng cho khách hàng website được cấu hình trong
website_customer_attribute_category_id(xem Cài đặt website).
Request Body
{
"attribute_detail": [
{
"id": 386,
"value": "175cm"
},
{
"id": 387,
"value": "70kg"
},
{
"id": 388,
"value": ["Tăng cân", "Giảm mỡ"]
}
]
}Response Schema (200)
Trả về đối tượng Customer Object sau khi cập nhật (trường attribute_detail chứa dữ liệu vừa lưu).
Lỗi thường gặp
| Mã lỗi | Mô tả |
|---|---|
error_customer_not_found | Không tìm thấy thông tin khách hàng trong hệ thống (404). |
error_update_failed | Lỗi trong quá trình xử lý cập nhật (500). |