注意：以下文档只适用于TOP接口，请谨慎使用！
注意：以下文档只适用于TOP接口，请谨慎使用！
修改商品属性（SKU）是客服常见操作，而现实中很多商家由于业务不断扩大使用了ERP/订单管理等软件，修改商品属性往往需要登录ERP/订单管理后台进行操作，费时费力而且影响了消费者顺畅体验。
由此我们设计了整个开发链路：
当消费者下单付款后，发现商品信息拍错，通过订单列表 - 更换款式；订单详情- 更换款式；退款-我要退款-退款原因-订单信息拍错申请退款时，可以自动触发修改商品属性的弹窗，消费者可以点击提交修改。
三方工具打通后可以使买家修改商品属性的申请通过奇门接口传输给ERP/订单管理进行直接修改，修改后再同步修改卖家中心的订单信息，两步都完成后算作链路完成并返回给买家已完成修改的消息。中间如果其中一环失败则定义为修改失败，并通知告知让客服人工帮助修改。
修改SKU入口：
入口1： 客服聊天窗口 / 全部服务 / 修改商品规格
入口2： 订单列表 / 更换款式
入口3： 订单详情 / 更换款式
三方工具自动修改链路：
商家人工审核链路：
注意：
① 在整个流程当中平台需要通过ERP/订单管理去判断某个子订单是否满足修改SKU的条件，因此需要实现平台创建的修改SKU的奇门接口。
② 在ERP/订单管理返回平台当前订单允许修改SKU，平台侧可能因为其他原因导致SKU修改失败。因此ERP侧不应该直接修改订单状态并且发货，需要等待数据推送重新推送订单。
在奇门（qimen.taobao.com）内确认是否获得【官方场景】-【消费者下单自助修改商品属性】的选项（如果没有，请添加钉钉群，钉钉群号：32399792）
奇门接入流程文档
https://open.taobao.com/doc.htm?spm=a219a.15212433.0.0.42a3669awAZce2&docId=106849&docType=1
也可参考自助改地址奇门接入部分
1. 买家在退款原因选择为商品拍错时会引导买家到重新选择商品SKU的页面，选择新的SKU后提交。
2. 平台校验订单状态和库存等规则，当满足修改SKU的规则后会调用ERP接口继续判断是否满足修改条件。
3. ERP返回允许修改，平台更新库存和订单状态；ERP返回不允许修改则直接返回提示买家。
4. 服务商监听平台消息判断是否修改成功（见本文档回执消息部分）。
5. ERP等待订单推送后进行后续履约。
注意：如果修改SKU成功，订单会重新推送至服务商；如果修改SKU失败服务商在等待一段时间后（平常10分钟内，大促期间2小时内）且未收到重新推送的订单则按原有订单进行履约；或者服务商通过监听消息判断订单是否被修改。
qimen.taobao.open.modifysku
自助修改SKU错误码集合 |
||||||
错误分类 |
错误码 |
订单作业节点 |
建议返回结果 |
感知系统 |
无法改SKU错误描述 |
消费者侧错误透出 |
订单处理状态异常 |
1001 |
转单 |
Y |
ERP/订单管理 |
订单进入转单不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
1002 |
审单 |
Y |
ERP/订单管理 |
订单进入审单不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1003 |
规则转换(如绑增) |
Y |
ERP/订单管理 |
订单已进行绑赠不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1004 |
路由仓库 |
Y |
ERP/订单管理 |
订单已路由仓库不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1005 |
核单 |
Y |
ERP/订单管理 |
订单进入核单仓库不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1006 |
下发仓库 |
Y |
ERP/订单管理 |
订单已下发仓库不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1007 |
仓库接单 |
Y |
ERP/订单管理 |
仓库已接单不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1008 |
订单生成物流单 |
Y |
ERP/订单管理 |
订单对应的物流发货订单已生成不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1009 |
生成批次 |
Y |
WMS |
仓库捡货批次已生成不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1010 |
批次拣货 |
Y |
WMS |
仓库分批次捡货中不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1011 |
批次验货 |
Y |
WMS |
仓库分批次验货中不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1012 |
批次分拣 |
Y |
WMS |
仓库分批次捡货中不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1013 |
称重 |
Y |
WMS |
仓库称重中不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1014 |
打印快递面单 |
Y |
WMS |
仓库打印快递面单中不支持改SKU |
订单已安排发货无法修改，请联系商家修改 |
|
1015 |
出库 |
N |
ERP/订单管理/WMS |
订单已经发货无法修改SKU |
订单已经发货无法改SKU |
|
1016 |
快递揽收 |
N |
WMS/快递 |
订单已被快递揽收无法修改SKU |
订单已经发货无法修改SKU |
|
1017 |
分拨 |
N |
快递 |
订单已进入分拨无法修改SKU |
订单已经发货无法修改SKU |
|
1018 |
网点接单 |
N |
快递 |
订单已到达网点无法修改SKU |
订单已经发货无法修改SKU |
|
1019 |
快递配送 |
N |
快递 |
订单已经发货无法修改SKU |
订单已经发货无法修改SKU |
|
1020 |
消费者拒签 |
N |
快递 |
订单消费者已拒签无法修改SKU |
订单已经发货无法修改SKU |
|
1021 |
消费者签收 |
N |
快递 |
订单已经签收无法修改SKU |
订单已经发货无法修改SKU |
|
1030 |
库存不足 |
N |
ERP |
新SKU对应库存不足，无法修改 |
新SKU对应库存不足，无法修改 |
|
非订单处理状态异常 |
2001 |
订单未接收 |
N |
ERP/订单管理 |
订单不存在，请稍后重试 |
网络拥堵，请稍后重试 |
2002 |
订单非本系统处理 |
N |
ERP/订单管理 |
订单不是本系统处理，请稍后重试 |
网络拥堵，请稍后重试 |
|
系统异常 |
3001 |
系统异常（平台可重试） |
N |
ERP/订单管理 |
系统异常（平台可重试） |
商家处理中 |
3002 |
系统异常（平台不可重试） |
N |
ERP/订单管理 |
系统异常（平台不可重试） |
自助修改SKU失败，请联系商家修改 |
|
3003 |
订单状态异常 |
N |
ERP/订单管理 |
如以上订单状态无法覆盖，返回此错误码 |
订单状态异常，无法修改SKU |
|
3004 |
系统异常 |
N |
ERP/订单管理 |
参数(非SKU信息)错误 |
订单无法自助修改SKU，请联系商家处理 |
|
3005 |
系统异常 |
N |
ERP/订单管理 |
参数错误，原SKU或SKU信息缺失 |
订单无法自助修改SKU，请联系商家处理 |
|
当平台修改完订单后，不管是否修改成功都会发送消息，服务商可以通过在开放平台上监听回执消息从而判断订单SKU是否被修改。
消息接入文档：
https://open.taobao.com/doc.htm?docId=101663&docType=1
消息名称：
taobao_modifysku_ResultNotify
消息体：
其中 result 字段代表订单是否修改成功：true -- 修改成功；false -- 修改失败。
为了保证最终的发货单与修改后订单的最终一致性，追踪已发货订单，同时对于异常订单能够及时做出预警，平台要求服务商在发货后回传订单详情。
流程概述：服务商需要在订单发货后，调用平台提供的校验接口（top接口），以通知平台商品已发出。平台会比较修改后订单与实际发货订单的一致性，对于不一致的情况，会通过TMC消息的形式对服务商提示预警。
需订阅的消息： taobao_modifyorder_ConsistencyResult
TOP接口定义
taobao.modifyorder.order.check
入参
com.alibaba.modifyaddress.model.erp.ShippedOrderCheckRequest：
出参com.alibaba.modifyaddress.model.base.Result<com.alibaba.modifyaddress.model.erp.ShippedOrderCheckResponse>
名称 |
类型 |
描述 |
是否必须 |
示例 |
appkey |
String |
appkey |
是 |
|
biz_order_id |
String |
订单id |
是 |
|
sub_order_id |
String |
子订单id |
否 |
|
seller_nick |
String |
商家昵称 |
是 |
|
address_same |
boolean |
地址是否一致 |
是 |
|
sku_same |
boolean |
商品是否一致 |
是 |
