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ênKiểuBắt buộcMô tả
idintCóID kênh

Request Body

TrườngKiểuBắt buộcMô tả
company_idintCóID công ty
creator_idintCóID người sửa
titlestringCóTên kênh
statusintCó1 (Bật), 3 (Tắt)
storeintCóID cửa hàng Hubport (thuộc công ty) gán cho đơn từ kênh
settingsobjectCóCấu hình kênh, ví dụ { "receipt_warehouse": 3 } (kho thuộc công ty)

Workflow & Logic

  • Khoá settings do 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ữ.
  • settings gử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ỗiMô tả
error_title_requiredThiếu title (HTTP 422)
error_status_invalidstatus không hợp lệ (HTTP 422)
error_store_is_requiredThiếu store (HTTP 422)
error_store_invalidCửa hàng không thuộc công ty (HTTP 422)
error_settings_property_is_requiredThiếu settings (HTTP 422)
error_settings_property_must_be_arraysettings phải là object (HTTP 422)
error_receipt_warehouse_not_foundKho receipt_warehouse không tồn tại (HTTP 422)
error_receipt_warehouse_invalidKho không thuộc công ty (HTTP 422)
error_not_foundKê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_availableKhô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 }
}

On this page