妙手ERP TikTok产品发布

这个技能解决什么问题

从公共采集箱拿到商品后，它并不会直接出现在 TikTok 店铺里。发布前要确认商品已关联目标店铺、类目是叶子节点、必填属性和 SKU 齐全、价格与库存合法；被监管字段（制造商、认证、责任人）也必须有真值，不能由系统编造。同时，“发布”本身是高影响写操作——一旦提交就改变店铺上架状态，所以任何情况下都不能静默执行。

技能如何工作

技能按一条固定流水线推进：

• 确定目标店铺：查询 TikTok 店铺列表，拿到用户选择的 shopIds。
• 圈定候选商品：列出待发布商品，或按指定的 detailIds 查询。
• 关联检查：确认商品是否已关联目标店铺；未关联时拆成“先认领、后发布”两个独立确认。
• 就绪检查：逐项验证类目、必填商品属性、销售属性与 SKU、价格与库存、SKU 重量、包裹尺寸、仓库，以及元数据要求时的制造商/认证/合规字段。
• 确认后提交：任一项未就绪就停止并报告缺失字段，引导使用 miaoshou-erp-tiktok-product-edit；全部就绪后展示发布确认计划，只有明确确认才提交。
• 如实报告：分别说明已受理、失败、跳过、待处理的商品，并注明结果是即时返回还是服务器异步处理（后者需稍后查状态）。

调用妙手ERP开放平台 API 时，每个 POST 请求都带 x-app-key、x-timestamp、x-sign 签名头，其中 x-sign 是小写十六进制的 HMAC-SHA256，签名对象是纯 API 路径和实际发送的 JSON 请求体，不包含域名或查询串；时钟偏移超过 300 秒请求即过期。

适用边界与注意点

• 技能不编辑标题、描述、价格、库存、SKU、类目或属性，缺字段只停止并报错。
• 不编造仓库、责任人、制造商、认证或合规数据；列表接口能查到就查，查不到就报告缺失。
• 不发布也未认领的商品/店铺计划；认领同属写操作，需要单独确认。
• signExpired、appNoPermission、ipNotInWhitelist 等鉴权错误按文档显式处理，未经用户指示不做持续重试。
• 回复和日志里不出现 AppSecret、签名请求头或携带凭证的完整请求。