Cập nhật một phần khách hàng
Chỉ cập nhật các trường được gửi lên của một khách hàng.
Endpoint
PATCH /v1/customers/:id
Quyền:
customer.manage
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID khách hàng |
Body Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty |
creator_id | int | Có | ID người thao tác |
Ngoài 2 trường trên, chỉ cần gửi các trường muốn thay đổi. Các trường được hỗ trợ (ý nghĩa giống Cập nhật khách hàng):
customer_type_id, full_name, internal_name, internal_note, source, zalo_id, facebook_id, instagram_id, tiktok_id, shopee_id, telegram_id, gender, birthday, email, phone, address, region_id, sub_region_id, sub_sub_region_id, salutation, address_line_2, delivery_note, legacy_province_name, legacy_district_name, legacy_ward_name, avatar_file_id_list, note, price_policy_id, tax_buyer_name, tax_buyer_address, tax_buyer_phone, tax_buyer_email, tax_buyer_account_bank, tax_buyer_account_number, tax_buyer_tax_number, tag, ignore_auto_upgrade, is_company, group, group_status, group_moderator_id, group_moderator_note, representative_name, representative_id, representative_file_id_list, group_data.
Lưu ý
API PATCH không kiểm tra trùng mã / email / số điện thoại và không kiểm tra định dạng như PUT. Nên dùng PUT khi cần thay đổi code, email, phone hoặc birthday.
Ví dụ JSON
{
"company_id": 10311,
"creator_id": 1,
"tag": "vip",
"group": 1
}Response Schema
HTTP 200 - JSON Object
Trả về object Customer đã cập nhật.
Error Codes
| HTTP | Code | Mô tả |
|---|---|---|
| 403 | error_role_not_available | Không có quyền customer.manage |
| 404 | error_not_found | Không tìm thấy khách hàng |
| 422 | error_company_id_required | ID công ty không được để trống |
| 422 | error_company_id_notfound | ID công ty không tìm thấy |
| 422 | error_user1_id_required | ID người thao tác không được để trống |
| 422 | error_user_id_notfound | ID người thao tác không tìm thấy |
| 422 | error_patch_list_empty | Không có trường nào để cập nhật |
| 500 | error_patch | Lỗi khi cập nhật |