CRMSổ địa chỉ
Thêm mới địa chỉ
Thêm mới một địa chỉ cho khách hàng.
Endpoint
POST /v1/customeraddresses
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 tạo |
customer_id | int | Có | ID khách hàng |
full_name | string | Có | Tên người liên hệ |
display_name | string | Tên gợi nhớ (Nhà riêng, Công ty...) | |
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 khách hàng sẽ bị tắt mặc định. |
Lưu ý: Mỗi khách hàng tối đa 3 địa chỉ (nếu đã có customer context), 1 địa chỉ nếu chưa có.
Response Schema
HTTP 201 - JSON Object
Trả về object CustomerAddress vừa tạo.
Error Codes
| HTTP | Code | Mô tả |
|---|---|---|
| 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 tạo không được để trống |
| 422 | error_user_id_notfound | ID người tạo không tìm thấy |
| 422 | error_fullname_required | Thiếu tên người liên hệ |
| 422 | error_customer_address_limit_reached | Đã đạt giới hạn số lượng địa chỉ cho phép |
| 500 | error_add | Lỗi khi thêm mới |