CRMSổ địa chỉ
Cập nhật địa chỉ
Cập nhật thông tin địa chỉ.
Endpoint
PUT /v1/customeraddresses/:id
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID địa chỉ |
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 thực hiện |
full_name | string | Có | Tên người liên hệ |
display_name | string | Tên gợi nhớ | |
type | int | Loại địa chỉ (1: Nhà riêng, 3: Văn phòng, 9: Khác) | |
phone | string | Số điện thoại | |
email | string | ||
address | string | Địa chỉ chi tiết | |
region_id | int | ID Tỉnh/Thành phố | |
sub_region_id | int | ID Quận/Huyện | |
sub_sub_region_id | int | ID Phường/Xã | |
address_line_2 | string | Địa chỉ phụ | |
delivery_note | string | Ghi chú giao hàng | |
legacy_province_name | string | Tên tỉnh/thành cũ | |
legacy_district_name | string | Tên quận/huyện cũ | |
legacy_ward_name | string | Tên phường/xã cũ | |
note | string | Ghi chú | |
is_default | int | Đặt làm mặc định (1: Có, 0: Không). Nếu đặt 1, các địa chỉ khác của cùng khách hàng sở hữu địa chỉ sẽ bị tắt mặc định. |
Lưu ý
API ghi đè toàn bộ các trường trong bảng trên: trường không được gửi sẽ bị đặt về giá trị rỗng / 0. Hãy gửi đầy đủ dữ liệu hiện tại kèm thay đổi. Không đổi được khách hàng sở hữu địa chỉ (customer_id gửi lên bị bỏ qua).
Phân quyền
Cần quyền customer.manage.
Response Schema
HTTP 200 - JSON Object
Trả về object CustomerAddress đã 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 địa chỉ |
| 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 thực hiện không được để trống |
| 422 | error_user_id_notfound | ID người thực hiện không tìm thấy |
| 422 | error_fullname_required | Thiếu tên người liên hệ |
| 500 | error_edit | Lỗi khi cập nhật |