WMS - InventoryCửa hàng
Sửa cửa hàng
Cập nhật thông tin cửa hàng.
Endpoint
PUT /v1/stores/:id
Quyền:
setting.sale
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID cửa hàng |
Body Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty |
creator_id | int | Có | ID người thực hiện |
name | string | Có | Tên cửa hàng |
code | string | Có | Mã cửa hàng, không trùng với cửa hàng khác trong công ty |
phone | string | Số điện thoại | |
address | string | Địa chỉ | |
lat | float | Vĩ độ | |
long | float | Kinh độ | |
region_id | int | ID Tỉnh/Thành | |
sub_region_id | int | ID Quận/Huyện | |
embed_map | string | Mã nhúng bản đồ | |
open_time | string | Giờ mở cửa | |
close_time | string | Giờ đóng cửa | |
price_policy_id | int | ID chính sách giá | |
status | int | Trạng thái (1: Kích hoạt, 3: Vô hiệu hóa) | |
warehouse_ids | array | Danh sách ID kho hàng liên kết |
Gửi đầy đủ dữ liệu
API ghi đè toàn bộ các trường trong bảng trên bằng giá trị trong payload. Trường nào không gửi sẽ bị đặt về rỗng/0 (VD: không gửi status sẽ làm cửa hàng có status = 0, không gửi warehouse_ids sẽ xóa liên kết kho). Hãy gửi lại toàn bộ giá trị hiện tại cùng phần thay đổi.
Response Schema
HTTP 200 - JSON Object
Trả về object Store Object vừa cập nhật.
Error Codes
| HTTP | Code | Mô tả |
|---|---|---|
| 403 | error_role_not_available | Người dùng không có quyền setting.sale |
| 404 | (not found) | Không tìm thấy cửa hàng hoặc không thuộc công ty hiện tại |
| 422 | error_company_id_required | ID công ty không được để trống |
| 422 | error_company_id_notfound | Công ty không hợp lệ hoặc không thuộc phạm vi truy cập |
| 422 | error_user1_id_required | ID người thực hiện (creator_id) không được để trống |
| 422 | error_user_id_notfound | Người thực hiện không hợp lệ |
| 422 | error_name_required | Tên cửa hàng là bắt buộc |
| 422 | error_code_required | Mã cửa hàng là bắt buộc |
| 422 | error_code_exist | Mã cửa hàng đã tồn tại |
| 422 | error_code_invalid | Mã cửa hàng không hợp lệ (không chứa chữ cái, chữ số hoặc dấu chấm nào) |
| 500 | error_edit | Lỗi khi cập nhật |