渠道在线商品

Qingpu 在商品发布后保存渠道侧商品快照。在线商品与上架记录相互独立:上架记录描述过去执行过的一次提交,在线商品描述平台最近一次返回的真实状态。

用户入口位于店铺运营工作区 /user/ops/products。ops 只提供运营页面壳与跨域导航,在线商品事实仍由 channel-products 模块独立维护;旧地址 /user/channel-products 会跳转到新入口。

接口

GET /api/qingpu/channel-products

返回分页在线商品快照、状态数量、已绑定店铺以及每个店铺的同步新鲜度。

查询参数:

  • storeKey:可选店铺 ID。
  • status:active、pending、error、delisted、archived、unknown 或 out_of_stock。
  • search:按商品名称、货号、平台商品 ID 或 SKU 搜索。
  • unlinkedOnly:传 true 时只返回尚未关联 Qingpu 商品的平台商品。
  • page、limit:分页参数,limit 最大为 100。

POST /api/qingpu/channel-products/sync

请求体:

{ "storeKey": "123" }

使用 Qingpu 服务端保存的店铺凭证执行一次完整 Ozon 店铺同步,依次读取平台商品列表、商品详情和库存,并在单个数据库事务中更新 qingpu_channel_products。

同步失败只记录错误,保留最近一次成功快照。只有完整同步成功后,本轮未从 Ozon 返回的商品才会标记为 delisted。无法识别的平台状态会保留为 unknown,不会猜测为在售。

首版只读,不会修改平台价格、库存、归档或上下架状态。