技能介绍

要解决的问题

妙手ERP 的采集流程是两段式的：先用 miaoshou-erp-source-import 把货源链接采进公共采集箱，再认领到各平台专属采集箱，之后才做类目、属性、图片编辑和上架。这让同一批货源能分发到 TikTok、Ozon、Shopee、Temu、美客多等多个店铺，但也带来两个工程问题：

跨采集箱转移是一次写操作，会新建或映射平台专属记录，误触发就会改变工作流状态。
认领后公共采集箱明细 ID 与平台采集箱明细 ID 的对应关系若丢失，后续编辑、发布技能就接不上。

这个技能只负责前一段转移，并把映射关系交回调用方。

核心能力与关键步骤

必需输入只有两项：detailIds 和 platform。serialNumber 是内部兼容字段，业务用户无需关心，除非连接器或 API 文档另有说明，一律传 1。

平台代码要保持文档原始大小写，如 tiktokGlobal、pddkjChoice、shopeeGlobal。提示词层可以把「Temu 半托管」这类别名归一化，但最终载荷不能改大小写；只说「Temu」时要追问全托管还是半托管。

标准工作流：

解析 detailIds 与目标 platform，缺哪个追问哪个。
尽量反查每条公共采集箱明细详情。
展示商品预览：ID、标题、价格/SKU 数量/图片数量。
展示认领计划：数量、来源 ID、目标平台、迁移行为，并写明本次不做什么。
用户明确确认后调用接口。
分别报告成功、失败、部分成功，保留 ID 映射供后续平台技能使用。

接口为 POST /open/v1/product/common_collect_box/common_collect_box/claimed，请求体字段 detailSerialNumberPlatformList，列表项含 detailId、platform、serialNumber；响应返回 platformCollectBoxDetailIdMap。鉴权从本地 resources/config.json、环境变量 MIAOSHOU_APP_KEY / MIAOSHOU_APP_SECRET 或安全主机连接器取凭证，请求头带 x-app-key、x-timestamp、x-sign。签名使用精确 API 路径（非完整 URL）、秒级 Unix 时间戳、请求体实际发送的紧凑 JSON 字符串；AppSecret、签名头与含凭证的请求体都不要打印。

适用边界

只做跨采集箱转移，不碰三件事：采集货源链接到公共采集箱、编辑标题价格库存图片 SKU 类目属性、发布商品到店铺。用户没指定目标平台时不要替他决定。

认领和发布必须分开确认：它们是两次独立的写操作。出现 alreadyClaimed 时报告现状并建议去平台采集箱核对，而不是盲目重试；部分失败时把成功映射与失败 ID 分开展示，未经指示不要自动重试失败的写操作。

invalidSerialNumber 这类内部错误应上报为技术配置或 API 协议问题，不要让用户去猜。旧版平台代码如 lazada、amazon、shein 可能残留在已安装的旧技能或历史工作流中，但不在当前认领 API 文档里，使用前要先确认。

截图预览

使用场景

采完 12345、12346 等货源在公共采集箱后，需要把它们认领到 TikTok、Ozon 或 Shopee 专属采集箱，再走后续编辑发布。
Temu 全托管和半托管代码不同，用户只说“认领到 Temu”时要先追问模式，再按 pddkj 或 pddkjChoice 提交。
认领属于写操作，需要先反查商品详情并展示预览与计划，用户明确确认后才调用认领接口。
需要拿到 platformCollectBoxDetailIdMap，把公共采集箱明细 ID 和平台采集箱明细 ID 的对应关系交给后续编辑或发布技能。

适合人员

多平台铺货的跨境电商运营：手上有一批公共采集箱商品，需要按 TikTok、Ozon、Temu、Shopee、美客多分批认领到各店铺采集箱。
妙手ERP 工作流自动化工程师：要把采货、认领、编辑、发布拆成独立步骤，并用 platformCollectBoxDetailIdMap 串联前后技能。
店铺合规审核或技术负责人：需要在写操作前预览计划、确认目标平台，并审计签名鉴权、平台代码大小写和错误处理逻辑。

妙手ERP产品认领