Kết nối sàn TMĐT
Cập nhật kênh sàn
Đổi tên, bật/tắt kênh, cửa hàng và kho nhận đơn của gian hàng sàn
Endpoint
PUT /v1/ecomplatforms/:id
Quyền:
setting.sale
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID kênh |
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 sửa |
title | string | Có | Tên kênh |
status | int | Có | 1 (Bật), 3 (Tắt) |
store | int | Có | ID cửa hàng Hubport (thuộc công ty) gán cho đơn từ kênh |
settings | object | Có | Cấu hình kênh, ví dụ { "receipt_warehouse": 3 } (kho thuộc công ty) |
Workflow & Logic
- Khoá
settingsdo Hubport quản lý (shopee_*,lazada_*,tiktok_*) không ghi đè được: giá trị gửi lên bị bỏ, giá trị đang lưu được giữ. settingsgửi lên thay thế các khoá do shop cấu hình (gửi đủ các khoá muốn giữ).api_key,api_secret, token không sửa được với kênh sàn.- Đặt
status=3để tạm dừng đồng bộ mà không xoá kênh.
Response Schema
HTTP 200 - JSON Object
EcomPlatform Object sau khi cập nhật.
Error Codes
| Mã lỗi | Mô tả |
|---|---|
error_title_required | Thiếu title (HTTP 422) |
error_status_invalid | status không hợp lệ (HTTP 422) |
error_store_is_required | Thiếu store (HTTP 422) |
error_store_invalid | Cửa hàng không thuộc công ty (HTTP 422) |
error_settings_property_is_required | Thiếu settings (HTTP 422) |
error_settings_property_must_be_array | settings phải là object (HTTP 422) |
error_receipt_warehouse_not_found | Kho receipt_warehouse không tồn tại (HTTP 422) |
error_receipt_warehouse_invalid | Kho không thuộc công ty (HTTP 422) |
error_not_found | Kênh không tồn tại hoặc không thuộc công ty của bạn (HTTP 404) |
error_role_not_available | Không có quyền setting.sale (HTTP 403) |
Ví dụ
{
"company_id": 1001,
"creator_id": 5,
"title": "Shopee - Shop Demo",
"status": 1,
"store": 2,
"settings": { "receipt_warehouse": 3 }
}