Quản lý mua hàngNhà cung cấp
Tạo nhà cung cấp
Tạo mới một nhà cung cấp
Endpoint
POST /v1/suppliers
Quyền:
product.manage
Headers
| Tên | Bắt buộc | Mô tả |
|---|---|---|
Authorization | Có | <JWT> của người dùng có quyền product.manage |
Request Body
| Trường | 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 (người dùng của phiên đăng nhập) |
name | string | Có | Tên nhà cung cấp (duy nhất trong công ty) |
code | string | Không | Mã nhà cung cấp (duy nhất trong công ty) |
product_type | int | Không | Loại sản phẩm cung ứng: 1 (Hàng hóa), 3 (Dịch vụ) |
contact_fullname | string | Không | Tên người liên hệ |
contact_phone | string | Không | Số điện thoại liên hệ |
contact_email | string | Không | Email liên hệ |
note | string | Không | Ghi chú |
status | int | Có | Trạng thái: 1 (Hoạt động), 3 (Ngưng) |
Ví dụ JSON
{
"company_id": 1,
"creator_id": 10,
"name": "Công ty TNHH ABC",
"code": "NCC-001",
"product_type": 1,
"contact_fullname": "Nguyễn Văn A",
"contact_phone": "0901234567",
"contact_email": "[email protected]",
"note": "Nhà cung cấp chính",
"status": 1
}Response Schema
HTTP 201 - Created
Trả về Supplier Object vừa tạo.
Error Codes
Lỗi dữ liệu đầu vào trả về HTTP 422 kèm mảng các mã lỗi:
| Mã lỗi | Mô tả |
|---|---|
error_role_not_available | (HTTP 403) Tài khoản không có quyền product.manage |
error_name_required | Tên nhà cung cấp không được để trống |
error_name_existed | Tên nhà cung cấp đã tồn tại |
error_code_existed | Mã nhà cung cấp đã tồn tại |
error_company_id_required | ID công ty không được để trống |
error_company_id_notfound | ID công ty không tìm thấy |
error_user1_id_required | ID người tạo không được để trống |
error_user_id_notfound | ID người tạo không tìm thấy |
error_add | (HTTP 500) Lỗi khi lưu dữ liệu |