Quản lý mua hàngNhà cung cấp
Danh sách nhà cung cấp
Lấy danh sách nhà cung cấp có phân trang và lọc
Endpoint
GET /v1/suppliers
Headers
| Tên | Bắt buộc | Mô tả |
|---|---|---|
Authorization | Có | <JWT> của người dùng |
Query Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty (tenant), phải trùng với công ty của phiên đăng nhập |
page | int | Không | Số trang (Mặc định: 1) |
limit | int | Không | Số lượng bản ghi mỗi trang (Mặc định và tối đa: 200) |
keyword | string | Không | Từ khóa tìm kiếm (Tên, Mã nhà cung cấp) |
id | int | Không | Lọc theo ID nhà cung cấp |
ids | string | Không | Lọc theo danh sách ID (tối đa 100, phân cách bằng dấu phẩy) |
code | string | Không | Lọc theo mã nhà cung cấp (exact match) |
name | string | Không | Lọc theo tên nhà cung cấp (exact match) |
status | int | Không | Lọc theo trạng thái |
sort_by | string | Không | Sắp xếp theo: id, name, product_type, status, date_created, date_modified. Mặc định: id |
sort_type | string | Không | 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 Supplier Object |
Mỗi item trong mảng items là một Supplier Object.
Error Codes
| HTTP | Mã lỗi | Mô tả |
|---|---|---|
| 401 | error_jwt_is_required | Thiếu token xác thực |