CRMSổ địa chỉ
Danh sách địa chỉ
Lấy danh sách địa chỉ của một khách hàng.
Endpoint
GET /v1/customeraddresses
Query Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty (phải trùng với công ty của token; nếu không truyền, kết quả trả về rỗng) |
customer_id | int | ID khách hàng cần lấy danh sách địa chỉ | |
id | int | ID địa chỉ cụ thể | |
keyword | string | Từ khóa tìm kiếm (tên người liên hệ, SĐT, tên gợi nhớ) | |
page | int | Trang hiện tại (mặc định 1) | |
limit | int | Số bản ghi mỗi trang (mặc định 50, tối đa 50) | |
sort_by | string | Sắp xếp theo: id, date_created, date_modified; giá trị khác sẽ sắp theo is_default. Mặc định: id | |
sort_type | string | Kiểu sắp xếp: ASC, DESC. Mặc định: DESC |
Response Schema
HTTP 200 - JSON Object
| Trường | Kiểu | Mô tả |
|---|---|---|
total | int | Tổng số bản ghi |
currentpage | int | Trang hiện tại |
limit | int | Số bản ghi mỗi trang |
items | array | Mảng CustomerAddress Object (có enriched fields) |
Lưu ý: Mỗi item trong danh sách được enrich thêm
customer_full_name,customer_phone,customer_codetừ thông tin khách hàng. Xem Enriched fields.
Error Codes
| HTTP | Code | Mô tả |
|---|---|---|
| 403 | error_role_not_available | Không có quyền customer.view hoặc customer.manage |