Khách hàng

Mô tả

Các API hỗ trợ:

• GET /customers: Lấy danh sách các khách hàng.

• GET /customers/{id}: Lấy chi tiết 1 khách hàng.

• POST /customers: Thêm mới 1 khách hàng.

• POST /customers/list: Thêm mới nhiều khách hàng.

• PUT /customers/{id}: Cập nhật thông tin khách hàng.

API

---

GET /api/customers

Lấy danh sách các khách hàng, hỗ trợ các tham số filter sau:

Tên trường	Kiểu dữ liệu	Mô tả
name	string	Tên khách hàng
phone_number	string	Số điện thoại của khách hàng
email	string	Email của khách hàng
sort	integer	Tên trường sắp xếp
order	integer	Thứ tự sắp xếp
page	integer	Trang
size	integer	Số bản ghi trên trang

GET /api/customers?page=1&size=10&order=asc&sort=name&name=hung&phone_number=1111111111&email=

Response Body

{
  "code": 200,
  "message": "Success",
  "result": [
    {
      "id": "619295b1-17af-4873-829c-660973aa03e0",
      "name": "Hung",
      "phone_number": "1111111111",
      "email": null,
      "date_of_birth": "07/08/1994",
      "status": 1,
      "gender": 0,
      "full_address": null,
      "merchant_id": "00000000-0000-0000-0000-000000000004",
      "deleted": 0,
      "created_at": "2024-08-23T06:30:26.000Z",
      "created_by": "admin",
      "updated_at": null,
      "updated_by": null
    }
  ],
  "page": 1,
  "page_size": 10,
  "total": 1
}

---

GET /api/customers/{id}

Lấy chi tiết 1 khách hàng.

GET /api/customers/619295b1-17af-4873-829c-660973aa03e0

Response Body

{
  "code": 200,
  "message": "Thành công",
  "result": {
    "id": "619295b1-17af-4873-829c-660973aa03e0",
    "name": "Hung",
    "phone_number": "1111111111",
    "email": null,
    "date_of_birth": "07/08/1994",
    "status": 1,
    "gender": 0,
    "full_address": null,
    "merchant_id": "00000000-0000-0000-0000-000000000004",
    "deleted": 0,
    "created_at": "2024-08-23T06:30:26.000Z",
    "created_by": "admin",
    "updated_at": null,
    "updated_by": null,
    "orders": [
      {
        "id": "e080486b-67c9-42b3-b8c8-a63c0c38af0c",
        "code": "15032400000383",
        "subtotal": 55001445.0,
        "discount": 0.0,
        "total": 55001445.0,
        "created_at": "2024-03-15T10:05:06.000Z",
        "paid_at": "2024-03-15T10:05:06.000Z",
        "status": 0,
        "cancel_reason": null
      }
    ]
  }
}

---

POST /api/customers

Thêm mới khách hàng.

Request Body

• name: (string) Tên khách hàng.

• phone_number: (string) Số điện thoại.

• date_of_birth: (string) Ngày sinh.

• email: (string) Email khách hàng.

• full_address: (array) Địa chỉ của khách hàng.

• gender: (int) Giới tính. Giá trị là 0 | 1.

Request Body

{
  "name": "Hung",
  "phone_number": "1111111111",
  "date_of_birth": "07/08/1994",
  "email": "hung1994@gmail.com",
  "full_address": "",
  "gender": 0
}

POST /api/customers

---

POST /api/customers/list

Thêm mới nhiều khách hàng.

Request Body

• name: (string) Tên khách hàng.

• phone_number: (string) Số điện thoại.

• date_of_birth: (string) Ngày sinh.

• email: (string) Email khách hàng.

• full_address: (array) Địa chỉ của khách hàng.

• gender: (int) Giới tính. Giá trị là 0 | 1.

Request Body

[
  {
    "name": "Hung",
    "phone_number": "1111111111",
    "date_of_birth": "07/08/1994",
    "email": "hung1994@gmail.com",
    "full_address": "",
    "gender": 0
  },
  {
    "name": "Duy",
    "phone_number": "0000000000",
    "date_of_birth": "07/08/1995",
    "email": "duy1994@gmail.com",
    "full_address": "",
    "gender": 0
  }
]

POST /api/customers/list

---

PUT /api/customers/{id}

Cập nhật khách hàng.

Request Body

• name: (string) Tên khách hàng.

• phone_number: (string) Số điện thoại.

• date_of_birth: (string) Ngày sinh.

• email: (string) Email khách hàng.

• full_address: (array) Địa chỉ của khách hàng.

• gender: (int) Giới tính. Giá trị là 0 | 1.

Request Body

{
  "name": "Hung",
  "phone_number": "1111111111",
  "date_of_birth": "07/08/1994",
  "email": "hung1994@gmail.com",
  "full_address": "",
  "gender": 0
}

PUT /api/customers/619295b1-17af-4873-829c-660973aa03e0