升级改造要求

调用API的团长/第三方团长招商系统针对本次商品ID升级的改造要求：

1、订单明细API拉取时商品ID需兼容number和string类型：

 ●涉及接口：

 ○taobao.tbk.cp.order.details.get https://open.taobao.com/api.htm?docId=49610&docType=2&scopeId=19004

●为保障您调用联盟API服务不受影响，您需要在2022年9月前对您内部系统的字段类型进行调整，调整后的字段类型需要同时兼容number和string类型的商品ID；

2、需兼容动态的商品ID流通及数据分析：从2022年9月起，联盟陆续会有升级后的动态商品ID开始流通进入生态；9月初第三方系统需获取新老商品ID的关系，并自行实现同商品效果汇总

 ○温馨提醒：针对新老商品ID订单聚合需求，可在PUB后台转链工具区批量获取新老商品ID对应关系； 

五、附件

●《【商品ID升级】白皮书-0810版》https://www.yuque.com/docs/share/97b48f5f-a514-43f7-901e-f39fcf2dc2fa?#

●《【商品ID升级】联盟公告》：https://mo.m.taobao.com/union/page_20220701_150002_297

为了帮助各位团长理解平台新产品能力，平台将于9月5日下午2点对新上线的权限规则进行直播讲解，想要了解详情/需要官方答疑，未进入官方服务商群的团长可加入淘宝联盟官方服务商3群44521766（已经加入1群和2群的团长无需额外加入3群）。后续招商升级会在上线前以千牛公告、钉钉群通知等方式通知各位团长。

【常见问题】

1.这次功能升级有什么影响？

1）商品ID升级期间，平台将同时支持原始商品ID及新商品ID的流通及展现，请您注意识别商品ID格式的差异性，进行相关判断及处理

2）影响示例：批量导出的Excel中，可能同时包含原商品ID及新商品ID，可能会对您的excel数据处理带来一定影响

2.我的新商品ID是唯一的么？如何判定两个商品ID是否指向同一个商品？如何判定两个商品ID是否指向同一个Member？

针对同一个招商团长member+同一个商品，新商品ID后段保持不变；

3.为什么我的订单有一些展示原始的商品ID有些展示升级后的商品ID？如果我想对应原始的商品ID和升级后的商品ID是否是同一个商品，如何对应？

因为商品ID是逐渐被灰度的，被灰度到的商品ID才会改为升级后的商品ID，商品被灰度前的订单商品ID均展示为原始商品ID。如果团长想对比不同订单的商品是否为同一商品，可将商品原始ID在生态伙伴平台我的工具处做商品ID转换，转换后与升级后的商品ID后段对应如果一致则说明为同一商品。

4.什么时候会全量切换为新商品ID？

商品ID的升级通知将会更新于此公告内：https://mo.m.taobao.com/union/page_20220701_150002_297，请您关注公告信息更新