妙手ERP Shopee产品发布
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-ko8itrop/miaoshou-erp-shopee-product-publish。
技能介绍
这个技能解决什么问题
Shopee 的商品上架并不只是把一条记录推过去。编辑完成的产品在真正发布时,仍然可能遇到店铺类型不匹配、发布路由不清楚、必填字段不全、任务提交成功但平台并未上架等风险。这类问题一旦在多店铺环境中发生,排查成本会迅速上升。
妙手ERP-Shopee产品发布 负责处理的是 Shopee 发布环节本身:它不参与产品内容的重新编辑,而是在产品数据已编辑并预览审批通过后,检查发布前置条件、构建发布计划,并按普通采集箱发布或 Shopee 全球发布的不同链路提交任务。
核心能力
- 发布就绪检查:在提交前核验
detailIds、shopIds、shopeeGlobalItemIds等关键参数,以及类目、标题、图片、重量、描述、品牌、物流、预售设置、价格、库存等详情字段是否完整。 - 发布计划构建:展示目标产品与发布店铺,并明确发布类型及风险提示。
- 两种发布路径:普通店铺可使用
publish-collectbox提交采集箱任务;Shopee 全球发布则使用shopeeGlobalItemIds、shopIds以及可选的isUseShopeeGlobalSetting。 - CB/CNSC 路由处理:CB/CNSC 子店铺不是直接本地发布,而是先发布至全球母店铺,再通过
publish-global将全球商品发布到子店铺。 - 阻断式执行:就绪检查失败时,技能停止执行,并将缺失信息路由回产品编辑、类目、尺码表、SKU 或内容处理环节。
- 任务状态区分:普通发布返回的是
result/code,全球发布返回的是moveCollectTaskDetailIds,二者都只是任务提交或任务 ID,不能直接理解为最终上架成功。
标准工作流程
- 通过
miaoshou-erp-shop-query查询目标店铺元数据,判断它是普通店铺还是 CB/CNSC 子店铺:
- CB=N、CNSC=N → 普通店铺。
- CB=Y、CNSC=Y → CB/CNSC 子店铺,需要接入全球母店铺链路。
- 普通店铺执行
publish-collectbox,将采集箱detailIds发布到本地店铺 ID。 - CB/CNSC 子店铺先执行
publish-collectbox,此时shopIds必须设置为全球母店铺 ID。 - 再通过
miaoshou-erp-shopee-global-product-manage确认商品已在全球母店铺上线,并获取globalItemId。 - 最后使用
shopeeGlobalItemIds=[globalItemId]和shopIds=[子店铺ID]执行publish-global。
适用边界与注意点
这个技能只负责发布执行,不做产品编辑,不自动补全缺失字段,也不认领通用采集箱产品。编辑问题应交由 miaoshou-erp-shopee-collectbox-product-edit 等技能处理;店铺查询也只能通过 miaoshou-erp-shop-query 完成。
三个容易踩坑的地方需要特别留意:
- 仅任务提交成功,不等于上架成功。普通发布响应只返回
result/code,全球发布响应只返回moveCollectTaskDetailIds。在后续通过在线商品查询确认之前,不能声称最终上架状态。 shopId只在发布时生效。在save_site_detail_data中设置shopId,并不会把商品绑定到该店铺。- API 认证方式固定。妙手 JCOP 请求使用 HMAC-SHA256 签名,凭据从
resources/config.json或MIAOSHOU_APP_KEY、MIAOSHOU_APP_SECRET获取,不使用 Bearer token。
脚本默认会先预览签名请求体;只有在凭据已配置、预览审批通过、用户已确认后才应添加 --execute --confirm 执行。一次完整的发布请求,其生命周期为:就绪检查 → 发布计划 → 用户确认 → 签名请求 → 任务响应 → 任务状态报告。
使用场景
- 采集箱产品编辑与预览已通过,需要按店铺类型提交普通发布任务并核对参数与阻断字段。
- 在CB/CNSC子店铺上架前,需要先发布到全球母店铺,再拿globalItemId执行全球发布。
- 店铺既有普通店又有子店铺时,需要分别确认母店与子店关系,避免把shopId当作绑定依据。
- 发布后只有任务ID或result/code时,需要继续查询线上商品状态,不能直接宣称上架成功。
适合人员
- 需要把已审批商品提交到Shopee店铺的运营工程师,关注发布类型与店铺路由是否正确。
- 需要排查发布失败并回填类目、尺码表或认证字段的数据工程师,关注阻断项与上游技能边界。
- 需要确认任务提交不等于最终上架的电商系统维护者,关注任务状态与线上确认流程。
- 需要组织发布审批与执行分离的团队负责人,关注预览、确认令牌与签名配置。