Nhà cung cấp

Mô tả

Các API hỗ trợ:

GET /suppliers: Danh sách
GET /suppliers/{id}: Chi tiết
POST /suppliers: Tạo
PUT /suppliers/{id}: Cập nhật

API

GET /api/suppliers

Danh sách nhà cung cấp:

Tham số query:

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
`keyword`	string	Mã, tên hoặc số điện thoại	Không
`status`	integer	`1` đang dùng \| `0` ngừng	Không
`page`	integer	Trang	Không
`size`	integer	Số bản ghi trên trang	Không
`sort`	string	Tên trường sắp xếp	Không
`order`	string	`asc` / `desc`	Không

GET /api/suppliers?page=1&size=10

Response Body
{
  "code": 200,
  "message": "Success",
  "result": [
    {
      "id": "{uuid}",
      "code": "NCC00001",
      "name": "Công ty A",
      "phone_number": "0901234567",
      "address": null,
      "status": 1,
      "description": null,
      "bank_name": null,
      "bank_account_holder": null,
      "bank_account_number": null,
      "created_at": "2026-10-13T09:00:00",
      "created_by": "merchant_user",
      "updated_at": "2026-10-13T09:00:00",
      "updated_by": null
    }
  ],
  "page": 1,
  "page_size": 10,
  "total": 1
}

GET /api/suppliers/{id}

Chi tiết một nhà cung cấp. Cùng các cột với danh sách.

GET /api/suppliers/\{id\}

Response Body
{
  "code": 200,
  "message": "Success",
  "result": {
    "id": "{uuid}",
    "code": "NCC00001",
    "name": "Công ty A",
    "phone_number": "0901234567",
    "address": null,
    "status": 1,
    "description": null,
    "bank_name": null,
    "bank_account_holder": null,
    "bank_account_number": null,
    "created_at": "2026-10-13T09:00:00",
    "created_by": "merchant_user",
    "updated_at": "2026-10-13T09:00:00",
    "updated_by": null
  }
}

POST /api/suppliers

Tạo nhà cung cấp. Mã code do hệ thống sinh (NCC00001).

Request Body

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
`name`	string	Tên (tối đa 255)	Có
`phone_number`	string	`0` hoặc `84` + 9 số, đầu số 3/5/7/8/9	Có
`address`	string	Địa chỉ	Không
`status`	integer	`1` đang dùng \| `0` ngừng. Mặc định `1`	Không
`description`	string	Mô tả	Không
`bank_name`	string	Ngân hàng (tối đa 255)	Không
`bank_account_holder`	string	Chủ tài khoản (tối đa 255)	Không
`bank_account_number`	string	Số tài khoản (tối đa 50)	Không

POST /api/suppliers

Request Body
{
  "name": "Công ty A",
  "phone_number": "0901234567",
  "status": 1
}

Response Body
{
  "code": 200,
  "message": "Success",
  "result": {
    "id": "{uuid}",
    "code": "NCC00001"
  }
}

PUT /api/suppliers/{id}

Cập nhật nhà cung cấp. Body giống POST. Response giống GET /suppliers/{id}.

PUT /api/suppliers/\{id\}

Mô tả​

API​

GET /api/suppliers​

GET /api/suppliers/{id}​

POST /api/suppliers​

Request Body​

PUT /api/suppliers/{id}​