注意：以下文档只适用于TOP接口，请谨慎使用！
注意：以下文档只适用于TOP接口，请谨慎使用！
随着越来越多的消费者进行淘宝会员名修改，为避免淘宝会员名（淘宝Nick）变更给开发者带来的消费者唯一标识的识别困扰，开放平台统一给开发者提供open_uid作为消费者唯一标识字段，代替原先的淘宝会员名（淘宝nick），无论消费者的淘系会员名是否修改，开发者使用同一个appkey获取的open_uid都不会发生变化。
本次改造涉及变更点：
1. 交易正逆向TOPAPI接口：出参新增字段buyer_open_uid,服务商需要通过接口获取该字段，并通过使用该字段完成对自身系统中消费者全局唯一标识的适配。
2. 交易正逆向官方消息：添加buyer_open_uid，服务商需要在订阅读取消息时获取该字段，并通过使用该字段完成对自身系统中消费者全局唯一标识的适配。
如有涉及使用到相关API或消息服务，可根据实际情况进行相关适配调整。
3. 2024年8月15日新增针对以下api的出参字段buyer_nick模糊化改造。
| apiName |
接口说明 |
| tmall.exchange.get |
获取单笔换货详情 |
| taobao.refunds.receive.get |
查询卖家收到的退款列表 |
| taobao.crm.members.search |
获取卖家会员（高级查询） |
| taobao.promotion.coupon.send |
店铺优惠券发放接口 |
1.本次改造主要是调整交易正逆向订单及消息服务相关接口出入参新增buyer_open_uid，后续通过此字段作为系统里面消费者身份的唯一标识取代buyer_nick。服务商从接口出参获取buyer_open_uid，同时将字段应用到之前buyer_nick覆盖的功能场景。
2.在服务商完成字段的适配和改造调整后，平台将在节点时间统一切流将原接口出参中buyer_nick字段做模糊化处理，在此期间服务商关注自身应用功能并完成检查，确保复核确认buyer_open_uid适配替换场景功能无阻塞，无缺陷。
3.模糊化针对的是接口出参中的buyer_nick，入参buyer_nick保留不受影响。
交易正逆向TOPAPI改造接口列表
2024年8月15日新增针对以下标红api的出参字段buyer_nick模糊化改造。
| apiName |
接口说明 |
入参变更 |
出参变更 |
备注 |
| taobao.refunds.receive.get |
查询卖家收到的退款列表 |
添加:buyer_open_uid |
添加:buyer_open_uid |
|
| taobao.trade.fullinfo.get |
订单信息查询 |
无变化 |
添加:buyer_open_uid |
|
| taobao.trade.get |
获取单笔交易信息 |
无变化 |
添加:buyer_open_uid |
|
| taobao.trades.sold.get |
查询卖家已卖出的交易数据（根据创建时间） |
添加:buyer_open_uid |
添加:buyer_open_uid |
|
| taobao.trades.sold.increment.get |
查询卖家已卖出的增量交易数据（根据修改时间） |
添加:buyer_open_uid |
添加:buyer_open_uid |
|
| taobao.trades.sold.incrementv.get |
查询卖家已卖出的增量交易数据（根据入库时间） |
无变化 |
添加:buyer_open_uid |
|
| taobao.trade.simple.get |
CRM获取交易订单的简易信息 |
无变化 |
添加:buyer_open_uid |
|
| taobao.trades.simple.sold.get |
查询卖家已卖出的交易简易数据 |
添加:buyer_open_uid |
|
|
| taobao.trades.simple.sold.increment.get |
查询卖家已卖出的增量交易简易数据（根据修改时间） |
添加:buyer_open_uid |
添加:buyer_open_uid |
|
| tmall.dispute.receive.get |
天猫逆向纠纷查询 |
添加:buyer_open_uid |
添加:buyer_open_uid |
|
| taobao.refunds.apply.get |
查询买家申请的退款列表 |
无变化 |
添加:buyer_open_uid |
|
| taobao.refund.get |
获取单笔退款详情 |
无变化 |
添加:buyer_open_uid |
|
| taobao.special.refunds.receive.get |
特殊退款类型的纠纷单列表查询 |
添加:buyer_open_uid |
添加:buyer_open_uid |
|
| taobao.special.refund.get |
特殊部分退纠纷单查询 |
无变化 |
添加:buyer_open_uid |
|
| taobao.refund.messages.get |
查询退款留言/凭证列表 |
无变化 |
添加:owner_open_uid
|
owner_open_uid同buyer_open_uid |
| tmall.exchange.get |
获取单笔换货详情 | 无变化 | 2024新增: buyer_open_uid | |
| taobao.refunds.receive.get | 查询卖家收到的退款列表 | 无变化 | 2024新增: buyer_open_uid | |
| taobao.crm.members.search | 获取卖家会员（高级查询） | 无变化 | 2024新增:open_uid | |
| taobao.promotion.coupon.send | 店铺优惠券发放接口 | 无变化 | 2024新增:open_uid |
交易正逆向相关消息服务改造列表
| topic_name |
消息说明 |
参数变更说明 |
备注 |
| taobao_refund_RefundBuyerModifyAgreement |
买家修改退款协议消息 |
添加:buyer_open_uid |
|
| taobao_refund_RefundBuyerReturnGoods |
买家退货给卖家消息 |
添加:buyer_open_uid |
|
| taobao_refund_RefundClosed |
退款关闭消息 |
添加:buyer_open_uid |
|
| taobao_refund_RefundCreated |
退款创建消息 |
添加:buyer_open_uid |
|
| taobao_refund_RefundSellerAgreeAgreement |
卖家同意退款协议消息 |
添加:buyer_open_uid |
|
| taobao_refund_RefundSellerRefuseAgreement |
卖家拒绝退款协议消息 |
添加:buyer_open_uid |
|
| taobao_refund_RefundSuccess |
退款成功消息 |
添加:buyer_open_uid |
|
| taobao_refund_TaobaoInterApplied |
申请淘宝介入消息 |
添加:buyer_open_uid |
|
| taobao_refund_TaobaoIntervened |
淘宝介入退款消息 |
添加:buyer_open_uid |
|
| taobao_trade_AdvanceDisburse |
订单极速放款成功消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeAlipayCreate |
创建支付宝订单消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeBuyerPay |
买家付完款，或万人团买家付完尾款 |
添加:buyer_open_uid |
|
| taobao_trade_TradeBuyerStepPay |
分阶段订单付定金 |
添加:buyer_open_uid |
|
| taobao_trade_TradeChanged |
订单信息变更消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeClose |
关闭交易消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeCloseAndModifyDetailOrder |
关闭或修改子订单消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeCreate |
创建淘宝交易消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeDelayConfirmPay |
延长收货时间消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeLogisticsAddressChanged |
修改交易收货地址消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeMemoModified |
交易备注修改消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeModifyFee |
修改交易费用消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradePartlyConfirmPay |
子订单打款成功消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradePartlyRefund |
子订单退款成功消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradePartlySellerShip |
交易的部分子订单发货消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeRated |
交易评价变更消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeSellerShip |
卖家发货消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeSuccess |
交易成功消息 |
添加:buyer_open_uid |
|
| taobao_trade_TradeTimeoutRemind |
交易超时提醒消息 |
添加:buyer_open_uid |
|
针对此次去Nick改造，目前平台已经发布了数据清理转化接口
1.通过订单号进行数据转换接口：点击查看。
2.通过NICK进行数据转换接口：点击查看。
目前平台已经对改造任务所涉及应用进行相应的接口使用授权。
接口错误码解析
sub_code: "isp.order.query.error" 查询失败，可尝试重试;
sub_code: "isv.openuid-convert-error" openuid转换服务异常，可尝试重试；
sub_code: "isv.invalid-order.error" 无效订单 tid入参有问题；
sub_code: "isv.invalid-usernick.error" usernick不存在；
sub_code: "isv.order.notfound" 订单未找到:tid 数据源未找到；
sub_code: "isv.order.buyer.inconsistent", 订单不属于当前买家:tid。
