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
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 |
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ụ). Mặc định: 1 |
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ề mảng các mã lỗi:
| Mã lỗi | Mô tả |
|---|---|
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 |